@peac/adapter-x402 0.12.4 → 0.12.6

package/dist/normalize-v2.d.ts

@@ -0,0 +1,102 @@
+/**
+ * x402 V2 semantic normalization (Layer B)
+ *
+ * V2 transport is JWS-primary with no EIP-712 placeholder semantics.
+ * Optional fields are truly optional in V2, so placeholder normalization
+ * (the core of V1 Layer B) is not needed.
+ *
+ * Instead, V2 normalization:
+ * 1. Flattens the transport structure (PaymentRequired -> per-offer)
+ * 2. Preserves all upstream fields including V2-specific ones
+ *    (maxTimeoutSeconds, extra, resource metadata)
+ * 3. Produces V2-specific normalized types that carry forward all semantics
+ *
+ * These V2 normalized types are NOT forced into V1 NormalizedOfferPayload.
+ * Downstream mapping (map.ts) and verification (verify.ts) will handle
+ * the V1/V2 split explicitly. That work belongs in the full PR5.
+ */
+import type { RawV2PaymentRequired, RawV2PaymentRequiredAccept, RawV2Resource, RawV2SettlementResponse } from './raw-v2.js';
+/**
+ * V2 normalized offer (preserves all upstream semantics).
+ *
+ * Unlike V1 NormalizedOfferPayload, this carries V2-specific fields
+ * like maxTimeoutSeconds, extra, and resource metadata.
+ */
+export interface NormalizedV2Offer {
+    /** Protocol version (always 2) */
+    version: 2;
+    /** Resource being offered */
+    resource: RawV2Resource;
+    /** Settlement scheme */
+    scheme: string;
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Payment asset identifier */
+    asset: string;
+    /** Payment recipient address */
+    payTo: string;
+    /** Payment amount in minor units */
+    amount: string;
+    /**
+     * Maximum timeout for payment settlement in seconds.
+     * V2-specific: NOT an epoch timestamp (unlike V1 validUntil).
+     * Represents a duration, not an absolute time.
+     */
+    maxTimeoutSeconds: number;
+    /** Scheme-specific additional data (preserved from upstream) */
+    extra: Record<string, unknown>;
+}
+/**
+ * V2 normalized receipt (preserves all upstream semantics).
+ *
+ * The upstream SettlementResponse does not carry resourceUrl or issuedAt;
+ * those must be supplied by the caller from request context.
+ */
+export interface NormalizedV2Receipt {
+    /** Protocol version (always 2) */
+    version: 2;
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Payer address */
+    payer: string;
+    /** On-chain transaction hash (present on success) */
+    transaction?: string;
+    /** Resource URL (caller-supplied from request context) */
+    resourceUrl: string;
+    /** Receipt issuance timestamp in epoch seconds (caller-supplied from response timing) */
+    issuedAt: number;
+}
+/**
+ * Normalize a V2 PaymentRequired accept entry into a NormalizedV2Offer.
+ *
+ * V2 offers are per-accept-entry (each entry in accepts[] is one offer).
+ * All upstream fields are preserved, including maxTimeoutSeconds and extra.
+ *
+ * @param accept - A single accept entry from PaymentRequired.accepts[]
+ * @param resource - The PaymentRequired resource descriptor
+ * @returns Normalized V2 offer with all upstream semantics preserved
+ */
+export declare function normalizeV2Offer(accept: RawV2PaymentRequiredAccept, resource: RawV2Resource): NormalizedV2Offer;
+/**
+ * Normalize all offers from a V2 PaymentRequired challenge.
+ *
+ * @param challenge - The full V2 PaymentRequired object
+ * @returns Array of normalized V2 offers (one per accept entry)
+ */
+export declare function normalizeV2Offers(challenge: RawV2PaymentRequired): NormalizedV2Offer[];
+/**
+ * Normalize a V2 SettlementResponse into a NormalizedV2Receipt.
+ *
+ * Only successful settlements produce meaningful receipt payloads.
+ * Failed settlements should be handled as errors, not receipts.
+ *
+ * The upstream SettlementResponse does not carry resourceUrl or issuedAt;
+ * callers must supply these from request context and response timing.
+ *
+ * @param settlement - The V2 SettlementResponse (success or failure)
+ * @param resourceUrl - Resource URL from the original request context
+ * @param issuedAt - Receipt issuance timestamp (epoch seconds, from response timing)
+ * @returns Normalized V2 receipt, or null if settlement failed
+ */
+export declare function normalizeV2Receipt(settlement: RawV2SettlementResponse, resourceUrl: string, issuedAt: number): NormalizedV2Receipt | null;
+//# sourceMappingURL=normalize-v2.d.ts.map

package/dist/normalize-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-v2.d.ts","sourceRoot":"","sources":["../src/normalize-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,EACb,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAMrB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,6BAA6B;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,0BAA0B,EAClC,QAAQ,EAAE,aAAa,GACtB,iBAAiB,CAYnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,iBAAiB,EAAE,CAEtF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,uBAAuB,EACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,mBAAmB,GAAG,IAAI,CAa5B"}

package/dist/normalize-v2.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * x402 V2 semantic normalization (Layer B)
+ *
+ * V2 transport is JWS-primary with no EIP-712 placeholder semantics.
+ * Optional fields are truly optional in V2, so placeholder normalization
+ * (the core of V1 Layer B) is not needed.
+ *
+ * Instead, V2 normalization:
+ * 1. Flattens the transport structure (PaymentRequired -> per-offer)
+ * 2. Preserves all upstream fields including V2-specific ones
+ *    (maxTimeoutSeconds, extra, resource metadata)
+ * 3. Produces V2-specific normalized types that carry forward all semantics
+ *
+ * These V2 normalized types are NOT forced into V1 NormalizedOfferPayload.
+ * Downstream mapping (map.ts) and verification (verify.ts) will handle
+ * the V1/V2 split explicitly. That work belongs in the full PR5.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeV2Offer = normalizeV2Offer;
+exports.normalizeV2Offers = normalizeV2Offers;
+exports.normalizeV2Receipt = normalizeV2Receipt;
+// ---------------------------------------------------------------------------
+// V2 Offer Normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a V2 PaymentRequired accept entry into a NormalizedV2Offer.
+ *
+ * V2 offers are per-accept-entry (each entry in accepts[] is one offer).
+ * All upstream fields are preserved, including maxTimeoutSeconds and extra.
+ *
+ * @param accept - A single accept entry from PaymentRequired.accepts[]
+ * @param resource - The PaymentRequired resource descriptor
+ * @returns Normalized V2 offer with all upstream semantics preserved
+ */
+function normalizeV2Offer(accept, resource) {
+    return {
+        version: 2,
+        resource,
+        scheme: accept.scheme,
+        network: accept.network,
+        asset: accept.asset,
+        payTo: accept.payTo,
+        amount: accept.amount,
+        maxTimeoutSeconds: accept.maxTimeoutSeconds,
+        extra: accept.extra,
+    };
+}
+/**
+ * Normalize all offers from a V2 PaymentRequired challenge.
+ *
+ * @param challenge - The full V2 PaymentRequired object
+ * @returns Array of normalized V2 offers (one per accept entry)
+ */
+function normalizeV2Offers(challenge) {
+    return challenge.accepts.map((accept) => normalizeV2Offer(accept, challenge.resource));
+}
+// ---------------------------------------------------------------------------
+// V2 Receipt Normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a V2 SettlementResponse into a NormalizedV2Receipt.
+ *
+ * Only successful settlements produce meaningful receipt payloads.
+ * Failed settlements should be handled as errors, not receipts.
+ *
+ * The upstream SettlementResponse does not carry resourceUrl or issuedAt;
+ * callers must supply these from request context and response timing.
+ *
+ * @param settlement - The V2 SettlementResponse (success or failure)
+ * @param resourceUrl - Resource URL from the original request context
+ * @param issuedAt - Receipt issuance timestamp (epoch seconds, from response timing)
+ * @returns Normalized V2 receipt, or null if settlement failed
+ */
+function normalizeV2Receipt(settlement, resourceUrl, issuedAt) {
+    if (!settlement.success) {
+        return null;
+    }
+    return {
+        version: 2,
+        network: settlement.network,
+        payer: settlement.payer,
+        resourceUrl,
+        issuedAt,
+        ...(settlement.transaction && { transaction: settlement.transaction }),
+    };
+}
+//# sourceMappingURL=normalize-v2.js.map

package/dist/normalize-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-v2.js","sourceRoot":"","sources":["../src/normalize-v2.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AA+EH,4CAeC;AAQD,8CAEC;AAoBD,gDAiBC;AA5ED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAC9B,MAAkC,EAClC,QAAuB;IAEvB,OAAO;QACL,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,SAA+B;IAC/D,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAChC,UAAmC,EACnC,WAAmB,EACnB,QAAgB;IAEhB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,WAAW;QACX,QAAQ;QACR,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/raw-v2.d.ts

@@ -0,0 +1,156 @@
+/**
+ * x402 V2 raw HTTP transport types (Layer A)
+ *
+ * Exact mirror of upstream coinbase/x402 V2 HTTP transport spec at
+ * specs/transports-v2/http.md.
+ *
+ * V2 moves all protocol data to HTTP headers (Base64-encoded JSON):
+ * - PAYMENT-REQUIRED: challenge (server -> client)
+ * - PAYMENT-SIGNATURE: payment proof (client -> server)
+ * - PAYMENT-RESPONSE: settlement result (server -> client)
+ *
+ * These are decoded raw transport objects. Base64 header decoding is
+ * transport-boundary handling and is NOT part of these type definitions.
+ *
+ * Types in this file MUST match upstream V2 transport spec exactly.
+ * Do NOT rename fields, add PEAC-specific fields, or change types.
+ * Normalization belongs in Layer B (normalize-v2.ts, PR5).
+ *
+ * Upstream pin: coinbase/x402 specs/transports-v2/http.md
+ * Weekly drift CI: .github/workflows/x402-drift.yml
+ */
+/**
+ * Resource descriptor (shared across challenge, payment, and response).
+ * Describes the resource being accessed behind the 402 paywall.
+ */
+export interface RawV2Resource {
+    url: string;
+    description: string;
+    mimeType: string;
+}
+/**
+ * Accept entry in a V2 payment challenge.
+ * Each entry describes one acceptable payment method.
+ */
+export interface RawV2PaymentRequiredAccept {
+    /** Payment scheme (e.g., "exact") */
+    scheme: string;
+    /** CAIP-2 network identifier (e.g., "eip155:84532") */
+    network: string;
+    /** Payment amount in minor units */
+    amount: string;
+    /** Token/asset identifier (e.g., hex token address) */
+    asset: string;
+    /** Payment recipient address */
+    payTo: string;
+    /** Maximum timeout for payment settlement in seconds */
+    maxTimeoutSeconds: number;
+    /** Scheme-specific additional data */
+    extra: Record<string, unknown>;
+}
+/**
+ * V2 PaymentRequired payload.
+ *
+ * Sent in the PAYMENT-REQUIRED header (Base64-encoded JSON) as part
+ * of a 402 Payment Required response. This is the challenge that tells
+ * the client what payment is needed.
+ */
+export interface RawV2PaymentRequired {
+    /** Protocol version (V2: always 2) */
+    x402Version: 2;
+    /** Error message describing why payment is required */
+    error: string;
+    /** Resource being accessed */
+    resource: RawV2Resource;
+    /** Array of acceptable payment methods */
+    accepts: RawV2PaymentRequiredAccept[];
+}
+/**
+ * Authorization data within a V2 payment payload.
+ * Contains the on-chain authorization details for the payment.
+ */
+export interface RawV2PaymentAuthorization {
+    /** Payer address */
+    from: string;
+    /** Payee address */
+    to: string;
+    /** Payment amount */
+    value: string;
+    /** Valid-after timestamp (unix) */
+    validAfter: string;
+    /** Valid-before timestamp (unix) */
+    validBefore: string;
+    /** Nonce (hex string) */
+    nonce: string;
+}
+/**
+ * Payment proof body within a V2 payment payload.
+ */
+export interface RawV2PaymentProofBody {
+    /** Hex-encoded signature */
+    signature: string;
+    /** On-chain authorization details */
+    authorization: RawV2PaymentAuthorization;
+}
+/**
+ * V2 PaymentPayload.
+ *
+ * Sent in the PAYMENT-SIGNATURE header (Base64-encoded JSON) alongside
+ * the actual HTTP request. Contains the payment proof.
+ */
+export interface RawV2PaymentPayload {
+    /** Protocol version (V2: always 2) */
+    x402Version: 2;
+    /** Resource being paid for */
+    resource: RawV2Resource;
+    /** The accepted payment method (single entry from accepts[]) */
+    accepted: RawV2PaymentRequiredAccept;
+    /** Payment proof data */
+    payload: RawV2PaymentProofBody;
+}
+/**
+ * V2 SettlementResponse (success).
+ *
+ * Sent in the PAYMENT-RESPONSE header (Base64-encoded JSON) when
+ * payment settlement succeeds.
+ */
+export interface RawV2SettlementResponseSuccess {
+    success: true;
+    /** On-chain transaction hash */
+    transaction: string;
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Payer address */
+    payer: string;
+}
+/**
+ * V2 SettlementResponse (failure).
+ *
+ * Sent in the PAYMENT-RESPONSE header when settlement fails.
+ */
+export interface RawV2SettlementResponseFailure {
+    success: false;
+    /** Error reason (e.g., "insufficient_funds") */
+    errorReason: string;
+    /** Empty string on failure */
+    transaction: string;
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Payer address */
+    payer: string;
+}
+/** Discriminated union of V2 settlement response outcomes */
+export type RawV2SettlementResponse = RawV2SettlementResponseSuccess | RawV2SettlementResponseFailure;
+/**
+ * V2 HTTP header names (lowercase for case-insensitive matching).
+ * All carry Base64-encoded JSON payloads.
+ */
+export declare const X402_V2_HEADERS: {
+    /** Server challenge header (402 response) */
+    readonly PAYMENT_REQUIRED: "payment-required";
+    /** Client payment proof header (request) */
+    readonly PAYMENT_SIGNATURE: "payment-signature";
+    /** Server settlement result header (response) */
+    readonly PAYMENT_RESPONSE: "payment-response";
+};
+//# sourceMappingURL=raw-v2.d.ts.map

package/dist/raw-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-v2.d.ts","sourceRoot":"","sources":["../src/raw-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,WAAW,EAAE,CAAC,CAAC;IACf,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,0CAA0C;IAC1C,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACvC;AAMD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,aAAa,EAAE,yBAAyB,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,WAAW,EAAE,CAAC,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,gEAAgE;IAChE,QAAQ,EAAE,0BAA0B,CAAC;IACrC,yBAAyB;IACzB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,KAAK,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,8BAA8B,CAAC;AAMnC;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,6CAA6C;;IAE7C,4CAA4C;;IAE5C,iDAAiD;;CAEzC,CAAC"}

package/dist/raw-v2.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * x402 V2 raw HTTP transport types (Layer A)
+ *
+ * Exact mirror of upstream coinbase/x402 V2 HTTP transport spec at
+ * specs/transports-v2/http.md.
+ *
+ * V2 moves all protocol data to HTTP headers (Base64-encoded JSON):
+ * - PAYMENT-REQUIRED: challenge (server -> client)
+ * - PAYMENT-SIGNATURE: payment proof (client -> server)
+ * - PAYMENT-RESPONSE: settlement result (server -> client)
+ *
+ * These are decoded raw transport objects. Base64 header decoding is
+ * transport-boundary handling and is NOT part of these type definitions.
+ *
+ * Types in this file MUST match upstream V2 transport spec exactly.
+ * Do NOT rename fields, add PEAC-specific fields, or change types.
+ * Normalization belongs in Layer B (normalize-v2.ts, PR5).
+ *
+ * Upstream pin: coinbase/x402 specs/transports-v2/http.md
+ * Weekly drift CI: .github/workflows/x402-drift.yml
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402_V2_HEADERS = void 0;
+// ---------------------------------------------------------------------------
+// V2 Header Constants
+// ---------------------------------------------------------------------------
+/**
+ * V2 HTTP header names (lowercase for case-insensitive matching).
+ * All carry Base64-encoded JSON payloads.
+ */
+exports.X402_V2_HEADERS = {
+    /** Server challenge header (402 response) */
+    PAYMENT_REQUIRED: 'payment-required',
+    /** Client payment proof header (request) */
+    PAYMENT_SIGNATURE: 'payment-signature',
+    /** Server settlement result header (response) */
+    PAYMENT_RESPONSE: 'payment-response',
+};
+//# sourceMappingURL=raw-v2.js.map

package/dist/raw-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-v2.js","sourceRoot":"","sources":["../src/raw-v2.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAuJH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,6CAA6C;IAC7C,gBAAgB,EAAE,kBAAkB;IACpC,4CAA4C;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,iDAAiD;IACjD,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/types.d.ts

@@ -307,6 +307,10 @@ export interface X402PeacRecord {
         transaction?: string;
         /** Schema version (from receipt, if present) */
         receiptVersion?: number;
+        /** V2: maximum settlement timeout in seconds (duration, not epoch) */
+        maxTimeoutSeconds?: number;
+        /** V2: settlement scheme identifier */
+        scheme?: string;
     };
     /** Unsigned metadata and verification status */
     hints: {
@@ -381,6 +385,11 @@ export declare function defaultAddressComparator(a: string, b: string, network:
 export interface X402AdapterConfig {
     /** Supported offer/receipt versions (default: [1]) */
     supportedVersions?: number[];
+    /**
+     * Wire version for the current flow (default: 1).
+     * When set to 2, public entrypoints dispatch to V2 verification/mapping.
+     */
+    wireVersion?: 1 | 2;
     /** Clock skew tolerance in seconds for validUntil (default: 60) */
     clockSkewSeconds?: number;
     /** Current time override for testing (epoch seconds) */

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA4bH,4DAKC;AA3aD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,6BAAsC,CAAC;AAEjF,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACU,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,UAAU;AAE7D;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAyXpC;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,CAAS,EAAE,CAAS,EAAE,OAAe;IAC5E,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAgcH,4DAKC;AA/aD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,6BAAsC,CAAC;AAEjF,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACU,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,UAAU;AAE7D;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,EAAE,CAAC;AA6XpC;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,CAAS,EAAE,CAAS,EAAE,OAAe;IAC5E,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}

package/dist/verify.d.ts

@@ -15,7 +15,8 @@
  */
 import type { RawSignedOffer, RawSignedReceipt } from './raw.js';
 import type { NormalizedOfferPayload, NormalizedReceiptPayload } from './normalize.js';
-import type { AcceptEntry, OfferVerification, ReceiptVerification, ConsistencyVerification, ConsistencyOptions, WireVerification, X402AdapterConfig, AddressComparator } from './types.js';
+import type { NormalizedV2Offer, NormalizedV2Receipt } from './normalize-v2.js';
+import type { AcceptEntry, OfferVerification, ReceiptVerification, ConsistencyVerification, ConsistencyOptions, WireVerification, VerificationError, X402AdapterConfig, AddressComparator } from './types.js';
 /**
  * Validate raw wire structure of a signed offer
  *
@@ -86,4 +87,58 @@ export declare function selectAccept(payload: NormalizedOfferPayload, accepts: A
     index: number;
     usedHint: boolean;
 };
+/**
+ * V2 offer verification result
+ */
+export interface V2OfferVerification {
+    valid: boolean;
+    errors: VerificationError[];
+}
+/**
+ * V2 receipt verification result
+ */
+export interface V2ReceiptVerification {
+    valid: boolean;
+    errors: VerificationError[];
+}
+/**
+ * Verify a normalized V2 offer.
+ *
+ * V2 uses maxTimeoutSeconds (duration) instead of validUntil (epoch).
+ * In strict mode, unknown V2 shapes are rejected (fail-closed).
+ *
+ * @param offer - Normalized V2 offer
+ * @param config - Adapter config (supportedVersions must include 2)
+ * @returns Verification result
+ */
+export declare function verifyOfferV2(offer: NormalizedV2Offer, config?: X402AdapterConfig): V2OfferVerification;
+/**
+ * Verify a normalized V2 receipt.
+ *
+ * V2 receipts require caller-supplied resourceUrl and issuedAt.
+ * In strict mode, unknown V2 shapes are rejected (fail-closed).
+ *
+ * @param receipt - Normalized V2 receipt
+ * @param config - Adapter config (supportedVersions must include 2)
+ * @returns Verification result
+ */
+export declare function verifyReceiptV2(receipt: NormalizedV2Receipt, config?: X402AdapterConfig): V2ReceiptVerification;
+/**
+ * Unified offer verification: dispatches to V1 or V2 based on config.wireVersion.
+ *
+ * When wireVersion is 2, accepts a NormalizedV2Offer and routes to verifyOfferV2().
+ * When wireVersion is 1 (default), accepts a RawSignedOffer and routes to verifyOffer().
+ *
+ * This is the canonical public entrypoint for version-aware verification.
+ */
+export declare function verifyOfferUnified(offer: RawSignedOffer | NormalizedV2Offer, accepts: AcceptEntry[], config?: X402AdapterConfig): OfferVerification | V2OfferVerification;
+/**
+ * Unified receipt verification: dispatches to V1 or V2 based on config.wireVersion.
+ *
+ * When wireVersion is 2, accepts a NormalizedV2Receipt and routes to verifyReceiptV2().
+ * When wireVersion is 1 (default), accepts a RawSignedReceipt and routes to verifyReceipt().
+ *
+ * This is the canonical public entrypoint for version-aware verification.
+ */
+export declare function verifyReceiptUnified(receipt: RawSignedReceipt | NormalizedV2Receipt, config?: X402AdapterConfig): ReceiptVerification | V2ReceiptVerification;
 //# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,cAAc,EAEd,gBAAgB,EAIjB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEvF,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAEhB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAsMpB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAgEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CA8C7E;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,CAAC,EAAE,iBAAiB,GACzB,iBAAiB,CA8KnB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,iBAAiB,GACzB,mBAAmB,CAsFrB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,sBAAsB,EACpC,cAAc,EAAE,wBAAwB,EACxC,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,uBAAuB,CAqDzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,WAAW,EACnB,iBAAiB,GAAE,iBAA4C,GAC9D,MAAM,EAAE,CAsBV;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,GAAE,iBAA4C,GAC9D;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAyD1D"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,cAAc,EAEd,gBAAgB,EAIjB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAsMpB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAgEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CA8C7E;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,CAAC,EAAE,iBAAiB,GACzB,iBAAiB,CA8KnB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,iBAAiB,GACzB,mBAAmB,CAsFrB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,sBAAsB,EACpC,cAAc,EAAE,wBAAwB,EACxC,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,uBAAuB,CAqDzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,WAAW,EACnB,iBAAiB,GAAE,iBAA4C,GAC9D,MAAM,EAAE,CAsBV;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,GAAE,iBAA4C,GAC9D;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAyD1D;AA0SD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,EACxB,MAAM,CAAC,EAAE,iBAAiB,GACzB,mBAAmB,CAoFrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,iBAAiB,GACzB,qBAAqB,CA0EvB;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,GAAG,iBAAiB,EACzC,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,CAAC,EAAE,iBAAiB,GACzB,iBAAiB,GAAG,mBAAmB,CAKzC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,EAC/C,MAAM,CAAC,EAAE,iBAAiB,GACzB,mBAAmB,GAAG,qBAAqB,CAK7C"}