chit402-verify 0.3.5 → 0.4.0

package/dist/receipt-lane.js

@@ -0,0 +1,446 @@
+"use strict";
+/**
+ * Unsigned receipt-lane decision beside book_seq.
+ *
+ * Design by Turbo on 1F916 (post 6579, comments 88201 and 88403):
+ * freeze a receipt-lane row only when seq is present, settled_by is
+ * `receipt`, the anchored tree head changed after that row was bound, and
+ * the row is not settled. anchor_changed_since_binding alone does not freeze.
+ *
+ * Comment 88596 freezes that ordering — seq + settled_by + (anchor_changed
+ * AND not settled) — and states the boundary: complete over registry marks,
+ * blind to payments the registry never joined. A binding past expiry with
+ * settled_by, receipt_id, observed_tx_hash, and observed_transfer_id all
+ * null is unverifiable_from_registry, not unpaid.
+ *
+ * These fields are derived. They are not inside the payment JWS and not
+ * inside the signed book_seq claims. payload_version is unchanged.
+ *
+ * Keep this rule in lockstep with services/gateway/src/receipt-lane.js.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_USDC_ADDRESS = exports.RECEIPT_LANE_BOUNDARY = exports.RECEIPT_LANE_ORDERING = exports.RECEIPT_LANE_RULE = exports.RECEIPT_LANE_SCHEMA = void 0;
+exports.normalizeRoot = normalizeRoot;
+exports.anchorIdentity = anchorIdentity;
+exports.anchorChangedSinceBinding = anchorChangedSinceBinding;
+exports.isPayoutBinding = isPayoutBinding;
+exports.expiryMillis = expiryMillis;
+exports.isPastExpiry = isPastExpiry;
+exports.classifyReceiptLane = classifyReceiptLane;
+exports.baseUsdcLocalCheckHint = baseUsdcLocalCheckHint;
+exports.deriveSettledBy = deriveSettledBy;
+exports.deriveSettled = deriveSettled;
+exports.bookSeqOf = bookSeqOf;
+exports.receiptLaneDecision = receiptLaneDecision;
+exports.buildReceiptLane = buildReceiptLane;
+exports.receiptLaneFromVerification = receiptLaneFromVerification;
+exports.RECEIPT_LANE_SCHEMA = 'chit402.receipt_lane.v1';
+exports.RECEIPT_LANE_RULE = 'Freeze when book_seq is present, settled_by is receipt, anchor_changed_since_binding is true, and settled is false. '
+    + 'anchor_changed_since_binding alone does not freeze. observed_transfer is outside the receipt lane.';
+/** Frozen partition order. `settled_by` here is the receipt-lane conjunct (value `receipt`). */
+exports.RECEIPT_LANE_ORDERING = 'seq + settled_by + (anchor_changed AND not settled)';
+/** The ordering reads registry marks only. A transfer the registry never joined is outside it. */
+exports.RECEIPT_LANE_BOUNDARY = 'complete over registry marks, blind to payments the registry never joined';
+/**
+ * Base mainnet USDC. Same contract as USDC_ADDRESSES.base in
+ * services/gateway/src/foreign-x402-ingest.js. The hint does not call RPC.
+ */
+exports.BASE_USDC_ADDRESS = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const BASE_CHAIN_ID = 8453;
+const SETTLED_STATUS = new Set(['settled', 'idempotent_replay']);
+const SETTLED_EVIDENCE = new Set([
+    'collected',
+    'foreign_ingest',
+    'refund_owed',
+    'board_close',
+]);
+const UNSETTLED_EVIDENCE = new Set([
+    'policy_blocked',
+    'UNVERIFIED',
+    'ARRIVAL_UNVERIFIED',
+    'inflow_claimed',
+    'inflow_correction',
+    'RECORDED_BY_SETTLE',
+    'openrouter_reported',
+    'a2a_escrow',
+]);
+const RECEIPT_ASSERTION_EVIDENCE = new Set([
+    'collected',
+    'RECORDED_BY_SETTLE',
+    'refund_owed',
+    'board_stamp',
+    'board_close',
+]);
+function normalizeRoot(root) {
+    if (root == null || root === '')
+        return null;
+    const hex = String(root).replace(/^0x/i, '').toLowerCase();
+    return /^[0-9a-f]{64}$/.test(hex) ? hex : String(root);
+}
+function anchorIdentity(head) {
+    if (!head || typeof head !== 'object')
+        return null;
+    const base = head.anchors?.base || head.anchor || null;
+    const sol = head.anchors?.solana || null;
+    const baseAnchored = !base || base.status == null || base.status === 'anchored';
+    const solAnchored = Boolean(sol && (sol.status == null || sol.status === 'anchored'));
+    const tx = baseAnchored ? (base?.tx || head.anchor_tx || null) : null;
+    const sig = solAnchored ? (sol?.signature || null) : null;
+    const root = head.root != null && head.root !== '' ? normalizeRoot(head.root) : null;
+    const size = Number(head.tree_size);
+    const treeSize = Number.isInteger(size) ? size : null;
+    if (root == null && !tx && !sig && treeSize == null)
+        return null;
+    return {
+        root,
+        tree_size: treeSize,
+        anchor_tx: tx || null,
+        solana_signature: sig || null,
+    };
+}
+function sameIdentity(a, b) {
+    if (!a || !b)
+        return null;
+    if (a.root == null || b.root == null)
+        return null;
+    return a.root === b.root
+        && (a.anchor_tx || null) === (b.anchor_tx || null)
+        && (a.solana_signature || null) === (b.solana_signature || null);
+}
+function anchorChangedSinceBinding(heads, leafIndex) {
+    if (!Array.isArray(heads) || heads.length === 0) {
+        return { changed: null, at: null, current: null };
+    }
+    const current = anchorIdentity(heads[heads.length - 1]);
+    const index = Number(leafIndex);
+    if (!Number.isInteger(index) || index < 0) {
+        return { changed: null, at: null, current };
+    }
+    let binding = null;
+    for (const head of heads) {
+        const size = Number(head?.tree_size);
+        if (Number.isInteger(size) && size > index) {
+            binding = head;
+            break;
+        }
+    }
+    if (!binding)
+        return { changed: null, at: null, current };
+    const at = anchorIdentity(binding);
+    const same = sameIdentity(at, current);
+    return { changed: same == null ? null : same === false, at, current };
+}
+function paymentRefOf(input) {
+    const ref = input?.payment?.ref ?? input?.payment_ref ?? null;
+    if (ref == null)
+        return null;
+    const text = String(ref).trim();
+    return text || null;
+}
+function hasIngress(input) {
+    if (input.arrival_status === 'confirmed')
+        return true;
+    const ingress = input.ingress_receipt;
+    if (!ingress || typeof ingress !== 'object')
+        return false;
+    const ref = ingress.ref != null ? String(ingress.ref).trim() : '';
+    return ref.length > 0;
+}
+function isReported(input) {
+    if (input.evidence === 'openrouter_reported')
+        return true;
+    if (input.source === 'openrouter_broadcast')
+        return true;
+    const rail = String(input.rail || input.payment?.rail || '').toLowerCase();
+    return rail === 'reported';
+}
+const PAYOUT_BINDING_KEYS = [
+    'payout_address',
+    'address',
+    'docket_id',
+    'receipt_id',
+    'observed_tx_hash',
+    'observed_transfer_id',
+    'settled_by',
+];
+/** A 1F916 payout binding carries expiry plus a registry mark key. A book row does not. */
+function isPayoutBinding(input) {
+    if (!input || typeof input !== 'object')
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(input, 'expiry'))
+        return false;
+    return PAYOUT_BINDING_KEYS.some((key) => Object.prototype.hasOwnProperty.call(input, key));
+}
+function explicitSettledBy(input) {
+    const value = input?.settled_by;
+    if (value === 'observed_transfer' || value === 'receipt')
+        return value;
+    return null;
+}
+function blankMark(value) {
+    return value == null || String(value).trim() === '';
+}
+/** Unix seconds, unix ms, or an ISO timestamp. Null when the field is absent or not a time. */
+function expiryMillis(expiry) {
+    if (blankMark(expiry))
+        return null;
+    if (typeof expiry === 'string' && /[T-]/.test(expiry)) {
+        const parsed = Date.parse(expiry);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    const n = Number(expiry);
+    if (!Number.isFinite(n))
+        return null;
+    return n < 1e12 ? n * 1000 : n;
+}
+function isPastExpiry(expiry, nowMs = Date.now()) {
+    const at = expiryMillis(expiry);
+    if (at == null)
+        return false;
+    return nowMs >= at;
+}
+function registryUnmarked(input, settledBy) {
+    return settledBy == null
+        && blankMark(input?.receipt_id)
+        && blankMark(input?.observed_tx_hash)
+        && blankMark(input?.observed_transfer_id);
+}
+/**
+ * Partition a row. Expired and unmarked is unverifiable_from_registry, ahead
+ * of the clean-unsettled and anchor-changed buckets, and behind a joined
+ * settled_by (receipt or observed_transfer).
+ */
+function classifyReceiptLane({ entry = null, settled_by = null, settled = null, anchor_changed_since_binding = null, now = Date.now(), } = {}) {
+    if (settled_by === 'receipt')
+        return 'receipt';
+    if (settled_by === 'observed_transfer')
+        return 'observed_transfer';
+    if (isPastExpiry(entry?.expiry, now) && registryUnmarked(entry, settled_by)) {
+        return 'unverifiable_from_registry';
+    }
+    if (anchor_changed_since_binding === true && settled !== true)
+        return 'anchor_changed_unsettled';
+    return 'unsettled';
+}
+/**
+ * Payee and amount a stranger can feed to the existing per-tx Base USDC check.
+ * Null unless this row is Base mainnet USDC. Does not claim the transfer happened
+ * and does not read the chain.
+ */
+function baseUsdcLocalCheckHint(entry) {
+    if (!entry || typeof entry !== 'object')
+        return null;
+    const chain = entry.chain_id ?? entry.chainId ?? null;
+    const chainName = String(chain ?? '').toLowerCase();
+    const chainOk = chain === BASE_CHAIN_ID
+        || chainName === String(BASE_CHAIN_ID)
+        || chainName === 'base'
+        || chainName === 'eip155:8453';
+    if (!chainOk)
+        return null;
+    const token = entry.token ?? entry.asset ?? null;
+    if (token == null || String(token).toLowerCase() !== exports.BASE_USDC_ADDRESS.toLowerCase())
+        return null;
+    const payee = entry.payout_address || entry.address || entry.payee || null;
+    const amount = entry.amount_atomic ?? null;
+    if (blankMark(payee) || blankMark(amount))
+        return null;
+    return {
+        method: 'base_usdc_transfer',
+        chain_id: BASE_CHAIN_ID,
+        token: exports.BASE_USDC_ADDRESS,
+        payee: String(payee),
+        amount_atomic: String(amount),
+        claims_paid: false,
+    };
+}
+function deriveSettledBy(input, { payer = null, issuerAssertsSettlement = null } = {}) {
+    if (!input || typeof input !== 'object')
+        return null;
+    if (isPayoutBinding(input))
+        return explicitSettledBy(input);
+    if (payer?.checked === true && payer.valid === true)
+        return 'observed_transfer';
+    if (isReported(input))
+        return null;
+    const ref = paymentRefOf(input);
+    const evidence = input.evidence || null;
+    if (ref && (evidence === 'foreign_ingest' || input.source === 'foreign_ingest' || input.foreign_x402 === true)) {
+        return 'observed_transfer';
+    }
+    if (hasIngress(input))
+        return 'observed_transfer';
+    if (issuerAssertsSettlement === true && ref)
+        return 'receipt';
+    if (issuerAssertsSettlement === false)
+        return null;
+    if (!ref)
+        return null;
+    if (input.payment?.collected === true || input.collected === true)
+        return 'receipt';
+    const status = input.settlement_status || input.usage_settled?.settlement_status || null;
+    if (status && SETTLED_STATUS.has(status))
+        return 'receipt';
+    if (evidence && RECEIPT_ASSERTION_EVIDENCE.has(evidence))
+        return 'receipt';
+    return null;
+}
+function deriveSettled(input, { payer = null } = {}) {
+    if (!input || typeof input !== 'object')
+        return null;
+    if (isPayoutBinding(input))
+        return explicitSettledBy(input) ? true : null;
+    if (payer?.checked === true && payer.valid === true)
+        return true;
+    if (payer?.checked === true && payer.valid === false)
+        return false;
+    if (isReported(input))
+        return false;
+    const status = input.settlement_status || input.usage_settled?.settlement_status || null;
+    if (status && SETTLED_STATUS.has(status))
+        return true;
+    const evidence = input.evidence || null;
+    if (evidence && UNSETTLED_EVIDENCE.has(evidence))
+        return false;
+    if (evidence && SETTLED_EVIDENCE.has(evidence))
+        return true;
+    if (input.payment?.collected === true || input.collected === true)
+        return true;
+    if (input.payment?.collected === false || input.collected === false)
+        return false;
+    return null;
+}
+function bookSeqOf(input) {
+    const raw = input?.book_seq ?? input?.seq ?? input?.book_chain?.seq ?? null;
+    if (raw == null || raw === '')
+        return null;
+    const n = Number(raw);
+    return Number.isInteger(n) && n > 0 ? n : null;
+}
+function receiptLaneDecision(input) {
+    const hasSeq = Number.isInteger(input.book_seq) && input.book_seq > 0;
+    const freeze = hasSeq
+        && input.settled_by === 'receipt'
+        && input.anchor_changed_since_binding === true
+        && input.settled === false;
+    return {
+        freeze,
+        reason: freeze ? 'unsettled_anchor_changed' : null,
+    };
+}
+function changedFromIdentities(at, current) {
+    const same = sameIdentity(at, current);
+    return {
+        changed: same == null ? null : same === false,
+        at: at || null,
+        current: current || null,
+    };
+}
+function buildReceiptLane({ entry = null, payer = null, leafIndex = null, heads = null, issuerAssertsSettlement = null, anchorAtBinding = null, anchorCurrent = null, now = Date.now(), } = {}) {
+    const book_seq = bookSeqOf(entry);
+    const settled_by = deriveSettledBy(entry, { payer, issuerAssertsSettlement });
+    const settled = deriveSettled(entry, { payer });
+    let anchor;
+    if (Array.isArray(heads) && heads.length > 0 && leafIndex != null) {
+        anchor = anchorChangedSinceBinding(heads, leafIndex);
+    }
+    else if (anchorAtBinding || anchorCurrent) {
+        anchor = changedFromIdentities(anchorAtBinding ?? null, anchorCurrent ?? null);
+    }
+    else if (typeof entry?.anchor_changed_since_binding === 'boolean') {
+        anchor = { changed: entry.anchor_changed_since_binding, at: null, current: null };
+    }
+    else {
+        anchor = changedFromIdentities(anchorAtBinding ?? null, anchorCurrent ?? null);
+    }
+    const decision = receiptLaneDecision({
+        book_seq,
+        settled_by,
+        settled,
+        anchor_changed_since_binding: anchor.changed,
+    });
+    const classification = classifyReceiptLane({
+        entry,
+        settled_by,
+        settled,
+        anchor_changed_since_binding: anchor.changed,
+        now,
+    });
+    return {
+        schema: exports.RECEIPT_LANE_SCHEMA,
+        signed: false,
+        book_seq,
+        settled_by,
+        settled,
+        anchor_at_binding: anchor.at,
+        anchor_current: anchor.current,
+        anchor_changed_since_binding: anchor.changed,
+        freeze: decision.freeze,
+        reason: decision.reason,
+        rule: exports.RECEIPT_LANE_RULE,
+        ordering: exports.RECEIPT_LANE_ORDERING,
+        boundary: exports.RECEIPT_LANE_BOUNDARY,
+        classification,
+        local_check: classification === 'unverifiable_from_registry' ? baseUsdcLocalCheckHint(entry) : null,
+    };
+}
+/**
+ * Stranger view. Uses verified signed claims and an on-chain payer check.
+ * Ignores a stamped freeze bit. Unsigned payment.ref is not an assertion.
+ */
+function receiptLaneFromVerification({ receipt, claims = null, issuerValid = false, payer = null, head = null, now = Date.now(), }) {
+    const kind = claims?.settlement?.kind ?? null;
+    const signedRef = claims?.payment?.ref ?? null;
+    const reported = kind === 'reported';
+    const foreignPayout = issuerValid === true && claims?.schema === 'chit402.foreign_payout.v1';
+    const asserts = issuerValid === true && !!signedRef && !reported && !foreignPayout;
+    const collected = kind === 'settled' || kind === 'inherited'
+        ? true
+        : (kind === 'unsettled' || reported ? false : (claims?.payment?.collected ?? null));
+    const binding = receipt
+        && Object.prototype.hasOwnProperty.call(receipt, 'expiry')
+        && (Object.prototype.hasOwnProperty.call(receipt, 'docket_id')
+            || Object.prototype.hasOwnProperty.call(receipt, 'payout_address')
+            || Object.prototype.hasOwnProperty.call(receipt, 'authorization_hash'))
+        ? receipt
+        : null;
+    const entry = {
+        book_seq: receipt?.book_seq ?? null,
+        book_chain: receipt?.book_chain ?? null,
+        payment: issuerValid ? {
+            ref: signedRef,
+            rail: claims?.payment?.rail ?? null,
+            collected,
+        } : null,
+        collected,
+        evidence: foreignPayout ? 'foreign_ingest' : (reported ? 'openrouter_reported' : null),
+        source: foreignPayout ? 'foreign_ingest' : null,
+        foreign_x402: foreignPayout ? true : undefined,
+        ...(binding ? {
+            expiry: binding.expiry ?? null,
+            receipt_id: binding.receipt_id ?? null,
+            observed_tx_hash: binding.observed_tx_hash ?? null,
+            observed_transfer_id: binding.observed_transfer_id ?? null,
+            settled_by: binding.settled_by ?? null,
+            anchor_changed_since_binding: binding.anchor_changed_since_binding,
+            chain_id: binding.chain_id ?? null,
+            token: binding.token ?? null,
+            payout_address: binding.payout_address ?? binding.address ?? null,
+            amount_atomic: binding.amount_atomic ?? null,
+            docket_id: binding.docket_id ?? null,
+        } : {}),
+    };
+    const stamped = receipt?.receipt_lane || null;
+    const currentHead = head || receipt?.tree_head || receipt?.head || null;
+    const anchorCurrent = currentHead ? anchorIdentity(currentHead) : (stamped?.anchor_current ?? null);
+    const anchorAtBinding = stamped?.anchor_at_binding ?? null;
+    return buildReceiptLane({
+        entry,
+        payer,
+        issuerAssertsSettlement: asserts,
+        anchorAtBinding,
+        anchorCurrent,
+        now,
+    });
+}
+//# sourceMappingURL=receipt-lane.js.map

package/dist/receipt-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-lane.js","sourceRoot":"","sources":["../src/receipt-lane.ts"],"names":[],"mappings":"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"}

package/dist/receipt-version.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Exact-type allowlist for receipt versions.
+ *
+ * The signed JWS payload is the only version that counts. `Number()` and
+ * `parseInt` are not used: strings, booleans, arrays, null, and non-integers
+ * are unsupported. JSON `11.0` and `1.1e1` are the number 11 after parse.
+ *
+ * `hmac_attestation.payload_version` is the HMAC field-list version (5 or 8).
+ * It is not a copy of the JWS payload version. chit-1ebc5616 is signed
+ * payload_version 6 with HMAC 8. That pair still verifies.
+ */
+export declare const LEGACY_PAYLOAD_VERSIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+export declare const ISSUER_ROOT_PAYLOAD_VERSION = 11;
+export declare const V11_VERSION = 11;
+export declare const UNVERSIONED_OUTER_VERSIONS: readonly [4, 5];
+export declare const REFUSAL_EXACT_VERSIONS: readonly [1, 2, 3];
+export declare const SUPPORTED_RECEIPT_VERSIONS: {
+    readonly v: readonly [11];
+    readonly payload_version: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
+    readonly refusal_payload_version: readonly [1, 2, 3];
+    readonly legacy_unversioned_outer: readonly [4, 5];
+};
+export declare const VERIFIER_MIN = "0.3.5";
+export declare const UNSUPPORTED_VERSION = "unsupported_version";
+export declare const VERSION_MISMATCH = "version_mismatch";
+export declare const INVALID_JWS = "invalid_jws";
+export declare const UPGRADE_HINT = "this receipt requires a verifier newer than @xfuel/verify 0.3.5";
+export type VersionReason = typeof UNSUPPORTED_VERSION | typeof VERSION_MISMATCH | typeof INVALID_JWS;
+export type ReceiptVersionDecision = {
+    ok: true;
+    family: 'unsigned';
+} | {
+    ok: true;
+    family: 'v11';
+    version: 11;
+    version_source: 'signed';
+} | {
+    ok: true;
+    family: 'legacy';
+    version: number;
+    version_source: 'signed' | 'inferred';
+} | {
+    ok: false;
+    reason: VersionReason;
+    errors: string[];
+};
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** JSON number that is a whole integer. Rejects strings, booleans, arrays, and floats. */
+export declare function isJsonInteger(value: unknown): value is number;
+/** True when every claim key belongs to the v4/v5 object, before v6 fields existed. */
+export declare function claimsAreUnversionedV4V5(claims: Record<string, unknown>): boolean;
+/**
+ * Outer payload_version slots that may name a v4/v5 receipt whose JWS
+ * itself has no version. They must all be the same integer, 4 or 5.
+ */
+export declare function unversionedOuterVersion(receipt: Record<string, unknown>): number | null;
+export declare function readSignedClaims(jws: unknown): {
+    ok: true;
+    claims: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: typeof INVALID_JWS | typeof UNSUPPORTED_VERSION;
+};
+/**
+ * Allowlist on the signed claims. `outer` is the receipt document.
+ * Pass null to ignore outer copies (builders, claims-only checks).
+ */
+export declare function classifySignedClaims(claims: unknown, outer: Record<string, unknown> | null): ReceiptVersionDecision;
+/** True when the signed claims are on the allowlist. Outer copies are not checked. */
+export declare function signedClaimsOnAllowlist(claims: unknown): boolean;
+/**
+ * UUID ids must match the receipt version. Non-uuid task ids are documented
+ * legacy formats and are not this check. A wrong prefix is reported even
+ * when the version is otherwise unsupported.
+ */
+export declare function legacyIdentityErrors(receipt: unknown): string[];
+export declare function classifyReceiptDocument(receipt: unknown): ReceiptVersionDecision;
+/**
+ * Public shell with no holder JWS. Exact types. Unknown versions are not
+ * INCLUDED_SHELL. null payload_version is not a version.
+ */
+export declare function classifyShellDocument(shell: unknown): {
+    ok: true;
+} | {
+    ok: false;
+    reason: VersionReason;
+    errors: string[];
+};
+export declare function formatSupportedReceiptVersions(): string;
+/** Legacy refusal versions. Exact integers. v11 refusals use the v: 11 rule. */
+export declare function refusalPayloadVersion(claims: unknown): {
+    ok: true;
+    version: 1 | 2 | 3;
+} | {
+    ok: false;
+    reason: typeof UNSUPPORTED_VERSION;
+};
+//# sourceMappingURL=receipt-version.d.ts.map

package/dist/receipt-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-version.d.ts","sourceRoot":"","sources":["../src/receipt-version.ts"],"names":[],"mappings":"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"}