Signature and output-hash verification across Node.js, Edge Workers, and Python must produce identical UTF-8 byte sequences. paxiom.receipt.v0 (`v0.2.0`) defines both a deterministic JSON canonicalization profile (jcs-sha256) and raw byte hashing (raw-sha256) for binary, text, and streaming responses.
amountAtomic, amountDisplay) and digests are strings; non-string scalars in v0 payloads are restricted to booleans (checkedByVerifier, backward-compatible checkedByPaxiom) and optional integer HTTP delivery.statusCode (100–599).0x prefix (66 characters total).null serializes as null; keys with null values remain part of the signed structure (e.g., settlement.transactionHash).Conforming verifiers reject non-JSON values (undefined, NaN, Infinity) and cap recursion depth at 256 so adversarial deeply-nested outputs return a structured error trust state rather than overflowing the call stack.
The Ed25519 signature covers the UTF-8 canonical JSON of exactly { receiptVersion, payload } (excluding the outer signature object itself):
function canonicalize(value) {
if (value === null || typeof value !== 'object') return JSON.stringify(value);
if (Array.isArray(value)) return '[' + value.map(canonicalize).join(',') + ']';
const keys = Object.keys(value).sort();
return '{' + keys.map(k => JSON.stringify(k) + ':' + canonicalize(value[k])).join(',') + '}';
}
const signingInput = Buffer.from(canonicalize({ receiptVersion, payload }), 'utf8');
const sigValue = crypto.sign(null, signingInput, privateKey).toString('base64');
| Receipt field | SHA-256 Preimage |
|---|---|
delivery.outputHash (jcs-sha256) | sha256( canonicalize(output) ) for structured JSON responses (default) |
delivery.outputHash (raw-sha256) | sha256( rawResponseBytes ) for binary, PDF, image, CSV, SSE, or non-JSON UTF-8 payloads |
request.bodyHash | sha256( canonicalize(requestBody) ) |
request.resourceHash | sha256( utf8(resourceUrl) ) |
request.requestHash | sha256( canonicalize({ bodyHash, method, resource }) ) |
payment.paymentRequirementsHash | sha256( canonicalize(x402PaymentRequirements) ) |
payment.paymentPayloadHash | sha256( canonicalize(x402PaymentPayload) ) |