How-to guides > Run keeper

Run the keeper

Operate the permissionless settlement keeper.

Run the keeper

The keeper submits proofs. It does not decide outcomes.

Dry run

bash
cd app
npm run keeper:settle

Use dry run before enabling live execution.

Live execution

bash
cd app
SOLANA_KEYPAIR=~/.config/solana/quovra-dev.json npm run keeper:settle -- --execute

Watch mode

bash
cd app
SOLANA_KEYPAIR=~/.config/solana/quovra-dev.json npm run keeper:watch

Required environment

bash
TXLINE_ORIGIN=https://txline-dev.txodds.com
TXLINE_JWT=[redacted]
TXLINE_API_TOKEN=[redacted]
SOLANA_RPC=https://api.devnet.solana.com
SOLANA_KEYPAIR=/path/to/devnet-keypair.json

Best practices

  • Run dry-run before live mode.
  • Use a funded devnet keypair with only the funds needed for fees.
  • Keep TxLINE credentials outside source control.
  • Log every submitted settlement signature.
  • Alert on repeated proof-unavailable states after fixture completion.

Related pages

Search keywords

keeper, cron, settlement bot, TxLINE credentials, proof submitter

Last updated: [YYYY-MM-DD]