Tracked in Linear as QUI-825.
Problem
The miner starts attempting to mine before the validator has finished synchronizing, and exits with wallet-underfunded on a zero balance:
quip-miner: error: wallet-underfunded ... balance=0 threshold=2000000000000
The error is misleading. The wallet is not the problem during initial sync; the miner is just asking a validator that cannot answer yet. Operators read it as a funding problem and go looking for a faucet.
Requested action
- Gate the miner so it does not attempt to mine until the validator is confirmed synchronized, so the sync window does not surface as a funding failure.
- Confirm the testnet funding path is discoverable. The original reporter could not find a faucet in the docs.
nodes.quip.network does document the faucet profile, so this half may already be addressed — worth verifying against what a new operator actually sees.
Notes
Filed against this repo because the gating belongs in the miner's startup path. The compose bundle in nodes.quip.network has no validator healthcheck and the miner has a soft depends_on, so a compose-side gate is possible but would only mask the timing rather than fix the error's cause.
Reported by Madhu Mondal, 2026-07-07. Reports were still arriving as of that date.
Tracked in Linear as QUI-825.
Problem
The miner starts attempting to mine before the validator has finished synchronizing, and exits with
wallet-underfundedon a zero balance:The error is misleading. The wallet is not the problem during initial sync; the miner is just asking a validator that cannot answer yet. Operators read it as a funding problem and go looking for a faucet.
Requested action
nodes.quip.networkdoes document the faucet profile, so this half may already be addressed — worth verifying against what a new operator actually sees.Notes
Filed against this repo because the gating belongs in the miner's startup path. The compose bundle in
nodes.quip.networkhas no validator healthcheck and the miner has a softdepends_on, so a compose-side gate is possible but would only mask the timing rather than fix the error's cause.Reported by Madhu Mondal, 2026-07-07. Reports were still arriving as of that date.