Failure reasons
Every reason a verifier returns, grouped by what failed. Python, Node and the browser verifier return the same reason for the same input.
verdock verify prints line N: FAIL reason for each problem and exits 1. The reasons below are fixed strings.
Line and chain#
| Reason | Meaning |
|---|---|
empty line | A blank line inside the log. |
invalid UTF-8, invalid JSON, not an object | The line is not a JSON object. |
non-integer number, integer out of range, invalid string | A number or string the format does not allow. |
missing member: NAME, wrong type: NAME | A required member is absent or has the wrong type. |
invalid hex: public_key, invalid hex: signature, invalid hex: prev_hash | A hex member has the wrong length or characters. |
signature invalid | The signature does not match the signed bytes. |
unexpected prev_hash on first line, missing prev_hash, chain break | The hash chain is wrong. |
untrusted public key | The line is signed by a key other than the one you trust. |
Approvals#
approval policy hash mismatch, action refused by approval policy, approval quorum differs from policy, duplicate or requester approval, approver key id mismatch, approval rejected, approval outside validity period, approver signature invalid, approval count below policy, invalid approval evidence, receipt action differs from approved operation, receipt differs from approved action, receipt outside approval validity period.
Delegation#
Verification reasons: delegation chain invalid, delegation signature invalid, delegation root untrusted, delegation widens parent: action kind, delegation widens parent: limit, delegation widens parent: currency, delegation widens parent: destinations, action outside delegated manifest: REASON.
Check reasons: manifest denies action kind, amount above manifest limit, currency not allowed by manifest, destination not allowed by manifest, unknown agent identity.
Exchange#
invalid exchange receipt, exchange hash mismatch, sender untrusted, sender signature invalid, approval missing, approver is the sender, approver untrusted, approver signature invalid, attestation untrusted, attestation signature invalid, approval mode unknown, acceptance missing, receiver untrusted, receiver signature invalid, payload hash mismatch, send policy differs, send outside policy.
Decisions#
The policy decision reasons (within limits, above limit and the rest) are on the checkpoint.
Test vectors in tests/vectors_v3.json and vectors/v3.json pin the Python and browser reasons.