How-to guides > Debugging

Debug Quovra

Diagnose common local, RPC, wallet, keeper, and settlement failures.

Debug Quovra

Use this guide when local builds, wallet actions, RPC reads, faucet calls, or settlement jobs fail.

Check repo state

bash
git status --short
git branch --show-current

Expected result:

  • You know whether local files are modified.
  • You know which branch you are testing.

Check app health

bash
cd app
npm run lint
npm run test
npm run build

Expected result:

  • Lint exits 0.
  • Tests exit 0.
  • Build exits 0.

Check RPC

bash
solana balance --url https://api.devnet.solana.com

Expected result:

  • The CLI can reach devnet.

Check faucet

bash
curl -X POST http://localhost:3000/api/faucet \
  -H 'Content-Type: application/json' \
  -d '{"wallet":"<SOLANA_WALLET_ADDRESS>"}'

Expected result:

  • 200 with signature when configured.
  • 503 when faucet secret is missing.
  • 400 for invalid wallet.

Check keeper dry-run

bash
cd app
npm run keeper:settle

Expected result:

  • Prints market scan results.
  • Does not submit transactions.

Related pages

Search keywords

debug, diagnostics, build failure, RPC failure, faucet failure

Last updated: [YYYY-MM-DD]