uvd-x402-sdk 2.43.0 → 2.44.0

package/README.md

@@ -1067,6 +1067,37 @@ console.log(stats.total, stats.visible, stats.byHealth.alive);
 
 Timestamps (`firstSeen`, `lastSeen`, `lastUpdated`, `health.lastChecked`) are Unix epoch **seconds**. Use `epochToDate()` to get a `Date`.
 
+## x402 v2 requests (`buildVerifyRequestV2` / `buildSettleRequestV2`)
+
+If your 402 advertises CAIP-2 networks (`eip155:8453`), you are speaking v2 and
+must send the **v2 envelope**. `buildVerifyRequest` emits the v1 one and cannot
+express v2:
+
+```typescript
+import { buildVerifyRequestV2 } from 'uvd-x402-sdk';
+
+const body = buildVerifyRequestV2(
+  payment.payload,
+  { url: 'https://api.example.com/thing', description: 'Thing', mimeType: 'application/json' },
+  { scheme: 'exact', network: 'eip155:8453', asset: '0x8335...', amount: '100000',
+    payTo: '0xabc...', maxTimeoutSeconds: 300 }
+);
+```
+
+| | v1 envelope | v2 envelope |
+|---|---|---|
+| top level | `{x402Version, paymentPayload, paymentRequirements}` | `{x402Version, paymentPayload, resource, accepted}` |
+| network | plain name — `base` | CAIP-2 — `eip155:8453` |
+| amount field | `maxAmountRequired` | `amount` |
+| `resource` | URL **string** | **object** `{url, description, mimeType}` |
+
+> **Do not mix levels.** Each version demands its own network format and its own
+> envelope. A v2 payload inside a v1 envelope — or a plain network name inside a
+> v2 request — matches no variant at the facilitator and fails with
+> `data did not match any variant of untagged enum VerifyRequestEnvelope`, an
+> error that names no field. If you see it, check the envelope shape first, not
+> the fields inside it.
+
 ## Live Traffic Stream (`GET /events`)
 
 The facilitator emits one Server-Sent Event per operation it handles, so you can

package/dist/adapters/index.d.mts

@@ -1,4 +1,4 @@
-import { X as X402Version, b as PaymentResult } from '../index-NDRI_c7e.mjs';
+import { X as X402Version, b as PaymentResult } from '../index-DgChnK_c.mjs';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-CYIVd4xO.mjs';
 import '../wallet-0cX9Pw2F.mjs';
 

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { X as X402Version, b as PaymentResult } from '../index-NDRI_c7e.js';
+import { X as X402Version, b as PaymentResult } from '../index-DgChnK_c.js';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-DTDixPzO.js';
 import '../wallet-0cX9Pw2F.js';
 

package/dist/backend/index.d.mts

@@ -1,5 +1,5 @@
 import { S as SigningWalletAdapter } from '../wallet-0cX9Pw2F.mjs';
-import { e as X402Header, X as X402Version } from '../index-NDRI_c7e.mjs';
+import { e as X402Header, X as X402Version, f as X402PayloadData } from '../index-DgChnK_c.mjs';
 
 /**
  * Payment requirements sent to the facilitator
@@ -93,6 +93,15 @@ interface PaymentAcceptance {
     network: string;
     asset: string;
     amount: string;
+    /**
+     * Payment scheme. REQUIRED by the facilitator's v2 `PaymentRequirementsV2`.
+     *
+     * Optional here only so existing callers keep compiling — when it is absent,
+     * `buildRequirementFromAcceptance` defaults it to `'exact'`. Do not treat its
+     * optionality as "the facilitator does not need it": an accepts[] entry that
+     * reaches a v2 client without a scheme is unpayable.
+     */
+    scheme?: string;
     payTo?: string;
     facilitator?: string;
     resource?: string;
@@ -203,6 +212,84 @@ declare function buildVerifyRequest(paymentHeader: X402Header, requirements: Pay
  * @param requirements - Payment requirements
  * @returns SettleRequest body ready for fetch/axios
  */
+/**
+ * Describes the protected resource, as x402 v2 expects it.
+ *
+ * Note this is an OBJECT in v2. Sending a bare URL string here is the single
+ * most common v2 mistake and it fails as an unhelpful "no variant matched"
+ * deserialization error at the facilitator, naming no field.
+ */
+interface ResourceInfoV2 {
+    url: string;
+    description: string;
+    mimeType: string;
+}
+/**
+ * Payment requirements in x402 v2 form.
+ *
+ * Differences from v1 that actually bite:
+ * - `network` is CAIP-2 (`eip155:8453`), NOT a plain name (`base`). Mixing a v1
+ *   name into a v2 request fails deserialization, and vice versa.
+ * - `maxAmountRequired` is renamed to `amount`.
+ * - `resource` / `description` / `mimeType` moved out to {@link ResourceInfoV2}.
+ */
+interface PaymentRequirementsV2 {
+    scheme: string;
+    /** CAIP-2 chain id, e.g. `eip155:8453`. */
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: unknown;
+}
+/** The v2 payment payload — note it carries no top-level scheme/network. */
+interface PaymentPayloadV2 {
+    x402Version: 2;
+    resource: ResourceInfoV2;
+    accepted: PaymentRequirementsV2;
+    payload: X402PayloadData;
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Verify request body in x402 v2 form.
+ *
+ * There is deliberately NO `paymentRequirements` key: that is the v1 envelope.
+ * v2 carries `resource` and `accepted` at the top level instead.
+ */
+interface VerifyRequestV2 {
+    x402Version: 2;
+    paymentPayload: PaymentPayloadV2;
+    resource: ResourceInfoV2;
+    accepted: PaymentRequirementsV2;
+}
+/** Settle request body in x402 v2 form. Same shape as {@link VerifyRequestV2}. */
+type SettleRequestV2 = VerifyRequestV2;
+/**
+ * Build a verify request for the facilitator `/verify` endpoint, in **v2** form.
+ *
+ * Use this whenever your 402 advertises CAIP-2 networks. {@link buildVerifyRequest}
+ * emits the v1 envelope `{x402Version, paymentPayload, paymentRequirements}` and
+ * cannot express v2 — putting a v2 payload inside it matches no variant at the
+ * facilitator and fails with an error that names no field.
+ *
+ * @example
+ * ```ts
+ * const body = buildVerifyRequestV2(
+ *   payment.payload,
+ *   { url: 'https://api.example.com/thing', description: 'Thing', mimeType: 'application/json' },
+ *   { scheme: 'exact', network: 'eip155:8453', asset: '0x8335...', amount: '100000',
+ *     payTo: '0xabc...', maxTimeoutSeconds: 300 }
+ * );
+ * ```
+ */
+declare function buildVerifyRequestV2(payload: X402PayloadData, resource: ResourceInfoV2, accepted: PaymentRequirementsV2): VerifyRequestV2;
+/**
+ * Build a settle request for the facilitator `/settle` endpoint, in **v2** form.
+ *
+ * See {@link buildVerifyRequestV2} — the envelope is identical.
+ */
+declare function buildSettleRequestV2(payload: X402PayloadData, resource: ResourceInfoV2, accepted: PaymentRequirementsV2): SettleRequestV2;
 declare function buildSettleRequest(paymentHeader: X402Header, requirements: PaymentRequirements): SettleRequest;
 /**
  * Recommended CORS headers for x402 payment APIs
@@ -2186,4 +2273,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };
+export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };

package/dist/backend/index.d.ts

@@ -1,5 +1,5 @@
 import { S as SigningWalletAdapter } from '../wallet-0cX9Pw2F.js';
-import { e as X402Header, X as X402Version } from '../index-NDRI_c7e.js';
+import { e as X402Header, X as X402Version, f as X402PayloadData } from '../index-DgChnK_c.js';
 
 /**
  * Payment requirements sent to the facilitator
@@ -93,6 +93,15 @@ interface PaymentAcceptance {
     network: string;
     asset: string;
     amount: string;
+    /**
+     * Payment scheme. REQUIRED by the facilitator's v2 `PaymentRequirementsV2`.
+     *
+     * Optional here only so existing callers keep compiling — when it is absent,
+     * `buildRequirementFromAcceptance` defaults it to `'exact'`. Do not treat its
+     * optionality as "the facilitator does not need it": an accepts[] entry that
+     * reaches a v2 client without a scheme is unpayable.
+     */
+    scheme?: string;
     payTo?: string;
     facilitator?: string;
     resource?: string;
@@ -203,6 +212,84 @@ declare function buildVerifyRequest(paymentHeader: X402Header, requirements: Pay
  * @param requirements - Payment requirements
  * @returns SettleRequest body ready for fetch/axios
  */
+/**
+ * Describes the protected resource, as x402 v2 expects it.
+ *
+ * Note this is an OBJECT in v2. Sending a bare URL string here is the single
+ * most common v2 mistake and it fails as an unhelpful "no variant matched"
+ * deserialization error at the facilitator, naming no field.
+ */
+interface ResourceInfoV2 {
+    url: string;
+    description: string;
+    mimeType: string;
+}
+/**
+ * Payment requirements in x402 v2 form.
+ *
+ * Differences from v1 that actually bite:
+ * - `network` is CAIP-2 (`eip155:8453`), NOT a plain name (`base`). Mixing a v1
+ *   name into a v2 request fails deserialization, and vice versa.
+ * - `maxAmountRequired` is renamed to `amount`.
+ * - `resource` / `description` / `mimeType` moved out to {@link ResourceInfoV2}.
+ */
+interface PaymentRequirementsV2 {
+    scheme: string;
+    /** CAIP-2 chain id, e.g. `eip155:8453`. */
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: unknown;
+}
+/** The v2 payment payload — note it carries no top-level scheme/network. */
+interface PaymentPayloadV2 {
+    x402Version: 2;
+    resource: ResourceInfoV2;
+    accepted: PaymentRequirementsV2;
+    payload: X402PayloadData;
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Verify request body in x402 v2 form.
+ *
+ * There is deliberately NO `paymentRequirements` key: that is the v1 envelope.
+ * v2 carries `resource` and `accepted` at the top level instead.
+ */
+interface VerifyRequestV2 {
+    x402Version: 2;
+    paymentPayload: PaymentPayloadV2;
+    resource: ResourceInfoV2;
+    accepted: PaymentRequirementsV2;
+}
+/** Settle request body in x402 v2 form. Same shape as {@link VerifyRequestV2}. */
+type SettleRequestV2 = VerifyRequestV2;
+/**
+ * Build a verify request for the facilitator `/verify` endpoint, in **v2** form.
+ *
+ * Use this whenever your 402 advertises CAIP-2 networks. {@link buildVerifyRequest}
+ * emits the v1 envelope `{x402Version, paymentPayload, paymentRequirements}` and
+ * cannot express v2 — putting a v2 payload inside it matches no variant at the
+ * facilitator and fails with an error that names no field.
+ *
+ * @example
+ * ```ts
+ * const body = buildVerifyRequestV2(
+ *   payment.payload,
+ *   { url: 'https://api.example.com/thing', description: 'Thing', mimeType: 'application/json' },
+ *   { scheme: 'exact', network: 'eip155:8453', asset: '0x8335...', amount: '100000',
+ *     payTo: '0xabc...', maxTimeoutSeconds: 300 }
+ * );
+ * ```
+ */
+declare function buildVerifyRequestV2(payload: X402PayloadData, resource: ResourceInfoV2, accepted: PaymentRequirementsV2): VerifyRequestV2;
+/**
+ * Build a settle request for the facilitator `/settle` endpoint, in **v2** form.
+ *
+ * See {@link buildVerifyRequestV2} — the envelope is identical.
+ */
+declare function buildSettleRequestV2(payload: X402PayloadData, resource: ResourceInfoV2, accepted: PaymentRequirementsV2): SettleRequestV2;
 declare function buildSettleRequest(paymentHeader: X402Header, requirements: PaymentRequirements): SettleRequest;
 /**
  * Recommended CORS headers for x402 payment APIs
@@ -2186,4 +2273,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };
+export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };

package/dist/backend/index.js

@@ -1096,6 +1096,22 @@ function buildVerifyRequest(paymentHeader, requirements) {
     paymentRequirements: requirements
   };
 }
+function buildV2Envelope(payload, resource, accepted) {
+  return {
+    x402Version: 2,
+    // The facilitator reads the payload from here; `resource` and `accepted` are
+    // repeated at the top level because the v2 envelope declares both.
+    paymentPayload: { x402Version: 2, resource, accepted, payload },
+    resource,
+    accepted
+  };
+}
+function buildVerifyRequestV2(payload, resource, accepted) {
+  return buildV2Envelope(payload, resource, accepted);
+}
+function buildSettleRequestV2(payload, resource, accepted) {
+  return buildV2Envelope(payload, resource, accepted);
+}
 function buildSettleRequest(paymentHeader, requirements) {
   return {
     x402Version: paymentHeader.x402Version,
@@ -1425,7 +1441,9 @@ function buildRequirementFromAcceptance(accept, resource, version, defaults) {
     throw new Error("Payment accepts entries must include payTo");
   }
   return normalizeRequirementForVersion({
-    scheme: "exact",
+    // Honour a caller-supplied scheme; 'exact' is the default, not an override.
+    // Hardcoding it silently discarded 'escrow' / 'commerce' accepts.
+    scheme: accept.scheme ?? "exact",
     network: accept.network,
     maxAmountRequired: accept.amount,
     resource: accept.resource ?? defaults?.resource ?? resource,
@@ -1443,6 +1461,11 @@ function toPaymentAcceptance(requirements, facilitator) {
     network: requirements.network,
     asset: requirements.asset,
     amount: requirements.maxAmountRequired,
+    // scheme is REQUIRED by the facilitator's v2 PaymentRequirementsV2. Dropping it
+    // here produced an accepts[] entry that no v2 client could pay: the spec makes
+    // the client echo the accept verbatim, so the omission travelled downstream and
+    // died in deserialization with an error naming no field.
+    scheme: requirements.scheme,
     payTo: requirements.payTo,
     resource: requirements.resource,
     description: requirements.description,
@@ -3887,7 +3910,9 @@ exports.ZERO_ADDRESS = ZERO_ADDRESS;
 exports.buildErc8004PaymentRequirements = buildErc8004PaymentRequirements;
 exports.buildPaymentRequirements = buildPaymentRequirements;
 exports.buildSettleRequest = buildSettleRequest;
+exports.buildSettleRequestV2 = buildSettleRequestV2;
 exports.buildVerifyRequest = buildVerifyRequest;
+exports.buildVerifyRequestV2 = buildVerifyRequestV2;
 exports.canRefundEscrow = canRefundEscrow;
 exports.canReleaseEscrow = canReleaseEscrow;
 exports.create402Response = create402Response;