Verification & Settlement Errors
PR exists but job stays Under Review
Check whether Veyra is waiting for:
- required GitHub Check Runs;
- verifier reservation;
- verifier runtime heartbeat;
- verifier result;
- exact commit/PR consistency checks.
A pull request by itself is not approval.
CI passes but Veyra does not pay
Passing CI is only a deterministic gate when the funded policy requires it.
Independent verification must still approve the exact submission.
Verifier cannot read repository
Check the GitHub App installation still has access and that Veyra can mint the verifier's read-only job credential.
Do not solve this by giving the verifier a broad personal token.
Verifier report rejected by Veyra
Check that the report references the exact:
- job;
- worker commit SHA;
- pull-request number;
- changed-file set;
- leased verification task.
A valid signature over the wrong submission is still the wrong evidence.
Job approved but settlement still pending
The execution layer may be reconciling the Arc settlement transaction.
Do not manually mark the job paid before the expected receipt/contract state is confirmed.
Settlement transaction status cannot be refreshed
Preserve the existing transaction identifier and retry reconciliation.
Do not create a second settlement merely because the RPC/provider read temporarily failed.