A conforming paxiom.receipt.v0 verifier consumes a receipt (and, where supplied, the delivered output and expected seller keys) and emits exactly one trust state plus a structured per-check breakdown. Trust states are the honesty contract: they separate what was independently verified from what was merely claimed.
| Trust state | Meaning |
|---|---|
verified | Everything the offline verifier can check passed, optional signer pinning matched, and settlement is either counter-attested by a trusted verifier key or not an unconfirmed on-chain claim. |
valid_signature_only | Signature is valid, but the verifier could not reach verified for a non-fatal reason (e.g., delivered output was not supplied, or settlement.status = unknown). |
schema_invalid | Receipt does not conform to paxiom.receipt.v0.schema.json. |
unsupported_format | receiptVersion is not paxiom.receipt.v0. |
invalid_signature | Ed25519 signature does not verify against the embedded public key over the canonical signing input. |
unauthorized_issuer | Signature is mathematically valid, but signature.publicKey is not in expectedIssuerPublicKeys (from the seller's HTTPS /.well-known/x402-keys.json) or payTo mismatches expectedPayTo. |
request_binding_missing | Required request binding fields absent or malformed. |
payment_binding_missing | Required payment binding fields absent or malformed. |
output_hash_mismatch | Supplied output's jcs-sha256 or raw-sha256 digest does not equal delivery.outputHash. |
settlement_claimed_not_checked | Signature and output hash verified, but the receipt asserts an on-chain settlement that this verifier did not independently confirm. |
settlement_failed | settlement.status = failed. |
proof_not_provided | Evidence array is empty or all not_provided (informational in check breakdown; does not by itself block verified). |
proof_unavailable | An evidence record references an external artifact the verifier could not retrieve. |
proof_invalid | An evidence record was retrieved and failed verification. |
expired | expiresAt is present and in the past relative to verifier evaluation time. |
error | The verifier itself encountered an unexpected failure (e.g., nesting depth > 256 or I/O error). |
Evaluate top-to-bottom and return the first rule that applies. This guarantees, for example, that key-substitution attacks surface as unauthorized_issuer and tampered payloads always surface as output_hash_mismatch:
error.receiptVersion unrecognized → unsupported_format.schema_invalid.canonicalize({ receiptVersion, payload }) → invalid_signature.expectedIssuerPublicKeys or expectedPayTo supplied and mismatched → unauthorized_issuer.expiresAt present and past → expired.request bindings missing or malformed → request_binding_missing.payment bindings missing or malformed → payment_binding_missing.delivery.outputHash → output_hash_mismatch.settlement.status = failed → settlement_failed.proof_invalid; referenced but unreachable → proof_unavailable.settlement.status ∈ { claimed_not_checked, verified_settled } without a pinned key in trustedVerifierPublicKeys (or alias trustedPaxiomPublicKeys) → settlement_claimed_not_checked (issuer self-assertions never self-promote to verified settlement).settlement.status = unknown → valid_signature_only.verified.Calling the free public reference endpoint POST https://api.paxiom.org/v1/receipt/verify-live verifies canonical Base USDC Transfer event logs directly on-chain and returns a counter-signed Payment-Receipt verifiable offline when the published verifier key (/.well-known/x402-keys.json) is passed in trustedVerifierPublicKeys.
| Receipt fixture | Output supplied | Expected trust state |
|---|---|---|
valid.receipt.json | valid.output.json | verified |
valid.receipt.json | output-mismatch.output.json | output_hash_mismatch |
valid.receipt.json | (none) | valid_signature_only |
settlement-claimed-not-checked.receipt.json | valid.output.json | settlement_claimed_not_checked |
{
"trustState": "settlement_claimed_not_checked",
"checks": {
"schema": "pass",
"signature": "pass",
"outputHash": "pass",
"requestBinding": "pass",
"paymentBinding": "pass",
"settlement": "claimed_not_checked",
"proof": "not_provided"
},
"summary": "Signature and output hash verified. Receipt claims an onchain settlement that this verifier did not check."
}