Verify Paxiom Receipt (Structured JSON)
verify_receiptValidate an Ed25519-signed paxiom.receipt.v0 API delivery receipt (JSON Schema, Ed25519 signature, signer authorization via expectedIssuerPublicKeys / expectedPayTo, JCS or raw SHA-256 output binding, expiry, and settlement trust state) and return structured JSON fields. Use this instead of explain_receipt when automated code branches on valid or trustState; use explain_receipt when presenting human-readable guidance, or get_x402_verifier_info for live on-chain settlement endpoints. Deterministic, offline, and free with no auth: invalid or tampered receipts return isError=false with valid=false and the failing trustState, omitting output caps trustState at valid_signature_only, and omitting trustedVerifierPublicKeys trusts the host counter-attestation key by default.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"receipt": "<receipt>"
},
"name": "verify_receipt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | No | Optional delivered HTTP response payload (JSON value for jcs-sha256, or UTF-8 string for raw-sha256); required to reach trustState="verified". | |
| receipt | Yes | Parsed paxiom.receipt.v0 JSON envelope (decoded from Payment-Receipt or X-Paxiom-Receipt HTTP header). | |
| expectedPayTo | No | Optional expected seller payTo address from the 402 quote. Mismatch returns trustState="unauthorized_issuer". | |
| trustedPaxiomPublicKeys | No | Backward-compatible alias for trustedVerifierPublicKeys. | |
| expectedIssuerPublicKeys | No | Optional pinned base64 Ed25519 seller public keys (e.g. from /.well-known/x402-keys.json). Mismatch returns trustState="unauthorized_issuer". | |
| trustedVerifierPublicKeys | No | Optional canonical base64 32-byte Ed25519 public keys trusted to assert settlement.checkedByVerifier=true (defaults to the host key). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| valid | Yes | True only when trustState is "verified" (valid signature, authorized signer if pinned, matching outputHash, non-expired, and confirmed or verify_only settlement). | |
| checks | Yes | Per-stage cryptographic and structural check statuses. | |
| summary | Yes | One-sentence diagnostic summary of the verification outcome. | |
| trustState | Yes | Machine-readable verification outcome classification. | |
| receiptHash | Yes | Hex SHA-256 digest of the canonical signing input, or null if schema validation failed. |