Format Human-Readable Receipt Explanation
explain_receiptFormat a plain-text trust breakdown and next-action remediation checklist for an Ed25519-signed paxiom.receipt.v0 API delivery receipt. Use this instead of verify_receipt when displaying a readable verdict to a user or operator; use verify_receipt when code needs raw check fields for programmatic gating, or get_x402_verifier_info to discover live Base USDC settlement endpoints. Runs deterministically offline for free with no auth: tampered, unauthorized, expired, or unconfirmed receipts return isError=false with an actionable diagnostic explanation rather than throwing, and omitting trustedVerifierPublicKeys trusts the host counter-attestation key by default. Pass output with the delivered HTTP response body to check SHA-256 payload binding (omitting output caps trustState at valid_signature_only).
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": "explain_receipt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | No | Optional delivered HTTP response payload; pass whenever available so SHA-256 payload binding is evaluated alongside the Ed25519 signature. | |
| 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. | |
| trustedPaxiomPublicKeys | No | Backward-compatible alias for trustedVerifierPublicKeys. | |
| expectedIssuerPublicKeys | No | Optional pinned base64 Ed25519 seller public keys (e.g. from /.well-known/x402-keys.json). | |
| 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 reaches "verified". | |
| trustState | Yes | Underlying verification state explained in the report. | |
| explanation | Yes | Multi-line human-readable trust breakdown, failed/skipped check details, and next-step remediation guidance. | |
| receiptHash | Yes | Hex SHA-256 digest of the canonical signing input, or null when schema validation failed. |