uvd-x402-sdk 2.98.0 → 2.99.0

package/dist/{index-BUlo1dYN.d.ts → index-BiL4seGs.d.ts}

@@ -3733,6 +3733,13 @@ declare const USDC_DOMAIN_NAME: Record<number, string>;
  * resolve the real operator from the marketplace's own escrow config
  * ({@link EscrowNetworkConfig}) and pass it via `options.contracts`.
  * See {@link OPERATOR_FEE_BPS} for the commands.
+ *
+ * Arc (5042) and Arc Testnet (5042002) use the x402r canonical escrow
+ * (AuthCaptureEscrow `0xBdEA0D1b…`, PaymentOperatorFactory v1.0.2
+ * `0xc24153B7…`). Their `operator` is a PaymentOperator address: the one the
+ * factory's `computeAddress` returns, recorded on both chains in
+ * `src/fixtures/arc-escrow-d.rpc.json`. Their operator generation is `'v3'`
+ * ({@link OPERATOR_ABI_V3}).
  */
 declare const ESCROW_CONTRACTS: Record<number, AdvancedEscrowContracts>;
 /**
@@ -3914,7 +3921,8 @@ interface AdvancedEscrowClientOptions {
      * Chain ID (default: 8453 for Base Mainnet).
      * Supported chains: 8453 (Base), 84532 (Base Sepolia), 1 (Ethereum),
      * 11155111 (Ethereum Sepolia), 137 (Polygon), 42161 (Arbitrum),
-     * 10 (Optimism), 42220 (Celo), 143 (Monad), 43114 (Avalanche).
+     * 10 (Optimism), 42220 (Celo), 143 (Monad), 43114 (Avalanche),
+     * 1187947933 (SKALE Base), 5042 (Arc), 5042002 (Arc Testnet).
      */
     chainId?: number;
     /** Contract addresses (auto-resolved from chainId if not provided) */
@@ -3965,13 +3973,77 @@ declare const OPERATOR_ABI: string[];
  * on release() and refundInEscrow(). Pass empty bytes (0x) for the data parameter.
  */
 declare const OPERATOR_ABI_CREATE3: string[];
+/**
+ * PaymentOperator of the x402r canonical PaymentOperatorFactory v1.0.2
+ * (`0xc24153B7ED8DC03e551F29DDEeA5CadFe57e2716`), the operator generation of
+ * Arc and Arc Testnet. Source: BackTrackCo/x402r-contracts
+ * `src/operator/payment/PaymentOperator.sol` @ 8345776e.
+ *
+ * It has no `release` and no `refundInEscrow`:
+ * - `capture(paymentInfo, amount, data)` pays the receiver;
+ * - `void(paymentInfo, data)` takes NO amount: it returns the whole
+ *   `capturableAmount` to the payer;
+ * - `refund(...)` returns funds after a capture;
+ * - the owner is `FEE_RECEIVER()`.
+ *
+ * Every selector here is checked against the factory bytecode recorded on
+ * Arc (`src/fixtures/arc-escrow-d.rpc.json`): `capture` 0xf12b86f6, `void`
+ * 0xc3c5090e, `FEE_RECEIVER` 0xd3e78e4d.
+ */
+declare const OPERATOR_ABI_V3: string[];
+/**
+ * `refundInEscrow` on a v3 operator was given an amount other than the whole
+ * `capturableAmount`. `void` takes no amount, so sending it would return more
+ * than was asked. Nothing was sent. `errorCode` of the result.
+ */
+declare const ESCROW_VOID_AMOUNT_MISMATCH = "escrow_void_amount_mismatch";
+/**
+ * `refundInEscrow` on a v3 operator found `capturableAmount` = 0: nothing is
+ * left to return. Nothing was sent. `errorCode` of the result.
+ */
+declare const ESCROW_NOTHING_TO_VOID = "escrow_nothing_to_void";
+/**
+ * The v3 operator has no code on the chain. A call to it would succeed and
+ * move nothing, so the SDK does not send one. `errorCode` of the result.
+ */
+declare const ESCROW_OPERATOR_NOT_DEPLOYED = "escrow_operator_not_deployed";
+/**
+ * The call has no counterpart on the chain's operator generation (`charge` on
+ * a v3 operator). Nothing was signed or sent. `errorCode` of the result.
+ */
+declare const ESCROW_UNSUPPORTED_ON_GENERATION = "escrow_unsupported_on_generation";
+/**
+ * Which PaymentOperator ABI a chain's escrow operator speaks.
+ *
+ * - `'v1'`: {@link OPERATOR_ABI} — `release(PaymentInfo, amount)` and
+ *   `refundInEscrow(PaymentInfo, amount)`.
+ * - `'v2'`: {@link OPERATOR_ABI_CREATE3} — the same two with a trailing
+ *   `bytes data`.
+ * - `'v3'`: {@link OPERATOR_ABI_V3} — `capture(PaymentInfo, amount, data)` and
+ *   `void(PaymentInfo, data)`.
+ */
+type EscrowOperatorGeneration = 'v1' | 'v2' | 'v3';
+/**
+ * Operator generation per chain — the single source the escrow client reads
+ * to pick the operator ABI. A chain absent from this table is `'v1'`, which is
+ * what a custom `options.contracts` on an unlisted chain has always used.
+ */
+declare const ESCROW_OPERATOR_GENERATION: Record<number, EscrowOperatorGeneration>;
+/** Operator generation of a chain; `'v1'` when the chain is not listed. */
+declare function getEscrowOperatorGeneration(chainId: number): EscrowOperatorGeneration;
 /**
  * AdvancedEscrowClient provides the 5 Advanced Escrow flows via the
  * PaymentOperator contract on 9 supported EVM networks.
  *
  * Supported chains: Base (8453), Base Sepolia (84532), Ethereum (1),
  * Ethereum Sepolia (11155111), Polygon (137), Arbitrum (42161),
- * Optimism (10), Celo (42220), Monad (143), Avalanche (43114).
+ * Optimism (10), Celo (42220), Monad (143), Avalanche (43114),
+ * SKALE Base (1187947933), Arc (5042), Arc Testnet (5042002).
+ *
+ * The operator ABI follows the chain's {@link ESCROW_OPERATOR_GENERATION}.
+ * On Arc and Arc Testnet (`'v3'`) `release` sends `capture`, `refundInEscrow`
+ * sends `void` (whole capturable amount only), `refundPostEscrow` sends
+ * `refund`, and `charge` refuses without signing or sending.
  *
  * Contract addresses are auto-resolved from the chain ID.
  * Pass custom contracts to override.
@@ -4097,6 +4169,10 @@ declare class AdvancedEscrowClient {
      *
      * Calls PaymentOperator.release() -> escrow.capture()
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.capture(paymentInfo, amount, 0x)` instead, after checking
+     * that the operator has code ({@link ESCROW_OPERATOR_NOT_DEPLOYED}).
+     *
      * @param paymentInfo - PaymentInfo from the authorize step
      * @param amount - Amount to release (defaults to maxAmount)
      */
@@ -4106,6 +4182,16 @@ declare class AdvancedEscrowClient {
      *
      * Calls PaymentOperator.refundInEscrow() -> escrow.partialVoid()
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.void(paymentInfo, 0x)`, which takes no amount and returns
+     * the WHOLE `capturableAmount`. So it first reads that amount on-chain
+     * (`AuthCaptureEscrow.getHash` + `paymentState`) and sends only when
+     * `amount` equals it. Otherwise nothing is sent and `errorCode` says why:
+     * {@link ESCROW_NOTHING_TO_VOID} when it is 0,
+     * {@link ESCROW_VOID_AMOUNT_MISMATCH} for any other amount. To return part
+     * of an escrow on v3, `release` the part the receiver keeps, then
+     * `refundInEscrow` what is left.
+     *
      * @param paymentInfo - PaymentInfo from the authorize step
      * @param amount - Amount to refund (defaults to maxAmount)
      */
@@ -4223,6 +4309,9 @@ declare class AdvancedEscrowClient {
      * Calls PaymentOperator.charge() -> escrow.charge()
      * Funds go directly from payer to receiver.
      *
+     * Not available on a `'v3'` operator (Arc, Arc Testnet): it returns
+     * {@link ESCROW_UNSUPPORTED_ON_GENERATION} without signing or sending.
+     *
      * @param paymentInfo - PaymentInfo with receiver and amount
      * @param amount - Amount to charge (defaults to maxAmount)
      */
@@ -4242,12 +4331,32 @@ declare class AdvancedEscrowClient {
      *
      * Kept for future use when tokenCollector is implemented.
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.refund(paymentInfo, amount, tokenCollector, collectorData)`
+     * -> escrow.refund(), the same arguments, after checking that the operator
+     * has code ({@link ESCROW_OPERATOR_NOT_DEPLOYED}).
+     *
      * @param paymentInfo - PaymentInfo from the original authorization
      * @param amount - Amount to refund (defaults to maxAmount)
      * @param tokenCollector - Address of token collector for refund sourcing
      * @param collectorData - Data for the token collector
      */
     refundPostEscrow(paymentInfo: AdvancedPaymentInfo, amount?: string, tokenCollector?: string, collectorData?: string): Promise<AdvancedTransactionResult>;
+    /** The refusal of a call a 'v3' operator does not have, or null elsewhere. */
+    private unsupportedOnV3;
+    /** The provider a 'v3' call reads with before it sends anything. */
+    private v3Provider;
+    /**
+     * Send one OPERATOR_ABI_V3 call, once the operator is known to have code.
+     * A call to an address with no code succeeds and moves nothing, and would be
+     * reported as a success.
+     */
+    private sendV3OperatorCall;
+    /**
+     * `refundInEscrow` on a 'v3' operator: `void` returns the whole capturable
+     * amount, so it is sent only when that is exactly what was asked for.
+     */
+    private voidWholeCapturable;
     /**
      * Build an unsigned transaction, sign via SigningWalletAdapter, and broadcast.
      *
@@ -4263,4 +4372,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { buildSettleRequest as $, AMBIGUOUS_LEASE_REASONS as A, type BuildLifecycleAuthParams as B, REPLAYABLE_LEASE_REASONS as C, DEFAULT_FACILITATOR_RETRIES as D, type ResourceInfoV2 as E, type FacilitatorCallOptions as F, type SettleRequestV2 as G, type HonoMiddlewareOptions as H, IDEMPOTENCY_KEY_HEADER as I, type SettleResponse as J, type VerifyRequestV2 as K, LIFECYCLE_ACTIONS as L, MAX_RETRY_AFTER_SECONDS as M, type VerifyResponse as N, type WagmiLifecycleWalletClient as O, type ParsedFacilitatorErrorBody as P, type WriterLeaseReason as Q, RECEIPT_REQUEST_CONFLICT as R, SETTLEMENT_UNCONFIRMED as S, X402_HEADER_NAMES as T, buildLifecycleAuth as U, type VerifiedPaymentState as V, WRITER_LEASE_REASONS as W, X402_CORS_HEADERS as X, buildLifecycleTypedData as Y, buildPaymentConflictResponse as Z, buildPaymentRequirements as _, AUTHORIZATION_ALREADY_SETTLED as a, ESCROW_CONTRACTS as a$, buildSettleRequestForVersion as a0, buildSettleRequestV2 as a1, buildVerifyRequest as a2, buildVerifyRequestForVersion as a3, buildVerifyRequestV2 as a4, create402Response as a5, createHonoMiddleware as a6, createIdempotencyKey as a7, createPaymentMiddleware as a8, extractPaymentFromHeaders as a9, type AgentService as aA, type AtomStats as aB, BASE_MAINNET_CONTRACTS as aC, BazaarClient as aD, type BazaarClientOptions as aE, type BazaarDiscoverOptions as aF, type BazaarDiscoverResponse as aG, type BazaarRegisterOptions as aH, type BazaarResource as aI, type CreateEscrowOptions as aJ, DEPOSIT_LIMIT_USDC as aK, type DiscoveryAccepts as aL, type DiscoveryCuration as aM, type DiscoveryHealth as aN, type DiscoveryHealthStatus as aO, type DiscoveryListOptions as aP, type DiscoveryPagination as aQ, type DiscoveryRegisterOptions as aR, type DiscoveryResource as aS, type DiscoveryResponse as aT, type DiscoverySource as aU, type DiscoveryStats as aV, type DiscoveryTier as aW, type Dispute as aX, type DisputeOutcome as aY, ERC8004_CONTRACTS as aZ, ERC8004_EXTENSION_ID as a_, facilitatorFetch as aa, getCorsHeaders as ab, isAmbiguousLeaseReason as ac, isAuthorizationAlreadyUsed as ad, isAuthorizationInFlight as ae, isReplayableLeaseReason as af, isSettlementUnconfirmed as ag, lifecycleAuthFromSignature as ah, parseFacilitatorErrorBody as ai, parseRetryAfterSeconds as aj, readFacilitatorError as ak, resolveEnvelopeVersion as al, toPaymentRequirementsV2 as am, toResourceInfoV2 as an, wagmiLifecycleSigner as ao, type AdvancedAuthorizationResult as ap, AdvancedEscrowClient as aq, type AdvancedEscrowClientOptions as ar, type AdvancedEscrowContracts as as, type AdvancedEscrowTaskTier as at, type AdvancedPaymentInfo as au, type AdvancedTransactionResult as av, type AgentId as aw, type AgentIdentity as ax, type AgentRegistration as ay, type AgentRegistrationFile as az, AUTHORIZATION_IN_FLIGHT as b, epochToDate as b$, ESCROW_TIMEOUT_MS as b0, Erc8004Client as b1, type Erc8004ClientOptions as b2, Erc8004LookupError as b3, type Erc8004Network as b4, EscrowClient as b5, type EscrowClientOptions as b6, type EscrowPayment as b7, type EscrowStateResponse as b8, type EscrowStatus as b9, type RegisterAgentRequest as bA, type RegisterAgentResponse as bB, type RegisterJobResponse as bC, type RegisterJobStatus as bD, RegistrationPendingError as bE, type RelayAuthorizationParams as bF, type ReputationResponse as bG, type ReputationSummary as bH, type RequestRefundOptions as bI, SOLANA_FEEDBACK_NETWORKS as bJ, type SettleRequest as bK, type SettleResponseWithProof as bL, type SubmitRelayFeedbackRequest as bM, type SubmitRelayResponseRequest as bN, type SubmitSolanaFeedbackRequest as bO, TIER_FILTERS as bP, TIER_TIMINGS as bQ, USDC_DOMAIN_NAME as bR, type UnavailableBody as bS, type UnavailableResponse as bT, type VerifyRequest as bU, ZERO_ADDRESS as bV, buildErc8004PaymentRequirements as bW, buildUnavailableResponse as bX, canRefundEscrow as bY, canReleaseEscrow as bZ, carryFailureFields as b_, type FeedbackEntry as ba, type FeedbackParams as bb, type FeedbackRequest as bc, type FeedbackResponse as bd, HEALTH_FILTERS as be, type IdentityByOwnerResponse as bf, type IdentityMetadataResponse as bg, type IdentityTotalSupplyResponse as bh, type LifecycleAuthOptions as bi, MAX_SEARCH_LEN as bj, type MetadataEntryParam as bk, OPERATOR_ABI as bl, OPERATOR_ABI_CREATE3 as bm, PAYMENT_INFO_TYPEHASH as bn, type PaymentRequirementResolver as bo, type PaymentRequirements as bp, type PaymentRequirementsOptions as bq, type PrepareRelayFeedbackRequest as br, type PrepareRelayFeedbackResponse as bs, type PrepareRelayResponseRequest as bt, type PrepareSolanaFeedbackRequest as bu, type PrepareSolanaFeedbackResponse as bv, type ProofOfPayment as bw, RELAYED_FEEDBACK_NETWORKS as bx, type RefundRequest as by, type RefundStatus as bz, type AdmittedAuthorizationCode as c, escrowTimeRemaining as c0, getEscrowContractsByChainId as c1, getEscrowSupportedChainIds as c2, isAlive as c3, isEscrowExpired as c4, isEscrowSupportedOnChain as c5, isRegisterJobTerminal as c6, parsePaymentHeader as c7, supportsRelayedFeedback as c8, supportsSolanaFeedback as c9, wireNetwork as ca, DEFAULT_RETRY_AFTER_SECONDS as d, FacilitatorClient as e, type FacilitatorClientOptions as f, type FacilitatorErrorInfo as g, type FacilitatorFailureFields as h, type FacilitatorFetchOptions as i, IDEMPOTENT_REPLAYED_HEADER as j, LIFECYCLE_DEFAULT_DEADLINE_SECS as k, LIFECYCLE_DOMAIN_NAME as l, LIFECYCLE_DOMAIN_VERSION as m, LIFECYCLE_MAX_DEADLINE_SECS as n, LIFECYCLE_ORDER_TYPES as o, type LifecycleAction as p, type LifecycleAuth as q, type LifecyclePaymentInfo as r, type LifecycleSigner as s, type LifecycleTypedData as t, type LifecycleTypedDataParams as u, type PaymentAcceptance as v, type PaymentConflictResponse as w, type PaymentMiddlewareOptions as x, type PaymentPayloadV2 as y, type PaymentRequirementsV2 as z };
+export { buildSettleRequest as $, AMBIGUOUS_LEASE_REASONS as A, type BuildLifecycleAuthParams as B, REPLAYABLE_LEASE_REASONS as C, DEFAULT_FACILITATOR_RETRIES as D, type ResourceInfoV2 as E, type FacilitatorCallOptions as F, type SettleRequestV2 as G, type HonoMiddlewareOptions as H, IDEMPOTENCY_KEY_HEADER as I, type SettleResponse as J, type VerifyRequestV2 as K, LIFECYCLE_ACTIONS as L, MAX_RETRY_AFTER_SECONDS as M, type VerifyResponse as N, type WagmiLifecycleWalletClient as O, type ParsedFacilitatorErrorBody as P, type WriterLeaseReason as Q, RECEIPT_REQUEST_CONFLICT as R, SETTLEMENT_UNCONFIRMED as S, X402_HEADER_NAMES as T, buildLifecycleAuth as U, type VerifiedPaymentState as V, WRITER_LEASE_REASONS as W, X402_CORS_HEADERS as X, buildLifecycleTypedData as Y, buildPaymentConflictResponse as Z, buildPaymentRequirements as _, AUTHORIZATION_ALREADY_SETTLED as a, ESCROW_CONTRACTS as a$, buildSettleRequestForVersion as a0, buildSettleRequestV2 as a1, buildVerifyRequest as a2, buildVerifyRequestForVersion as a3, buildVerifyRequestV2 as a4, create402Response as a5, createHonoMiddleware as a6, createIdempotencyKey as a7, createPaymentMiddleware as a8, extractPaymentFromHeaders as a9, type AgentService as aA, type AtomStats as aB, BASE_MAINNET_CONTRACTS as aC, BazaarClient as aD, type BazaarClientOptions as aE, type BazaarDiscoverOptions as aF, type BazaarDiscoverResponse as aG, type BazaarRegisterOptions as aH, type BazaarResource as aI, type CreateEscrowOptions as aJ, DEPOSIT_LIMIT_USDC as aK, type DiscoveryAccepts as aL, type DiscoveryCuration as aM, type DiscoveryHealth as aN, type DiscoveryHealthStatus as aO, type DiscoveryListOptions as aP, type DiscoveryPagination as aQ, type DiscoveryRegisterOptions as aR, type DiscoveryResource as aS, type DiscoveryResponse as aT, type DiscoverySource as aU, type DiscoveryStats as aV, type DiscoveryTier as aW, type Dispute as aX, type DisputeOutcome as aY, ERC8004_CONTRACTS as aZ, ERC8004_EXTENSION_ID as a_, facilitatorFetch as aa, getCorsHeaders as ab, isAmbiguousLeaseReason as ac, isAuthorizationAlreadyUsed as ad, isAuthorizationInFlight as ae, isReplayableLeaseReason as af, isSettlementUnconfirmed as ag, lifecycleAuthFromSignature as ah, parseFacilitatorErrorBody as ai, parseRetryAfterSeconds as aj, readFacilitatorError as ak, resolveEnvelopeVersion as al, toPaymentRequirementsV2 as am, toResourceInfoV2 as an, wagmiLifecycleSigner as ao, type AdvancedAuthorizationResult as ap, AdvancedEscrowClient as aq, type AdvancedEscrowClientOptions as ar, type AdvancedEscrowContracts as as, type AdvancedEscrowTaskTier as at, type AdvancedPaymentInfo as au, type AdvancedTransactionResult as av, type AgentId as aw, type AgentIdentity as ax, type AgentRegistration as ay, type AgentRegistrationFile as az, AUTHORIZATION_IN_FLIGHT as b, type VerifyRequest as b$, ESCROW_NOTHING_TO_VOID as b0, ESCROW_OPERATOR_GENERATION as b1, ESCROW_OPERATOR_NOT_DEPLOYED as b2, ESCROW_TIMEOUT_MS as b3, ESCROW_UNSUPPORTED_ON_GENERATION as b4, ESCROW_VOID_AMOUNT_MISMATCH as b5, Erc8004Client as b6, type Erc8004ClientOptions as b7, Erc8004LookupError as b8, type Erc8004Network as b9, type PrepareRelayResponseRequest as bA, type PrepareSolanaFeedbackRequest as bB, type PrepareSolanaFeedbackResponse as bC, type ProofOfPayment as bD, RELAYED_FEEDBACK_NETWORKS as bE, type RefundRequest as bF, type RefundStatus as bG, type RegisterAgentRequest as bH, type RegisterAgentResponse as bI, type RegisterJobResponse as bJ, type RegisterJobStatus as bK, RegistrationPendingError as bL, type RelayAuthorizationParams as bM, type ReputationResponse as bN, type ReputationSummary as bO, type RequestRefundOptions as bP, SOLANA_FEEDBACK_NETWORKS as bQ, type SettleRequest as bR, type SettleResponseWithProof as bS, type SubmitRelayFeedbackRequest as bT, type SubmitRelayResponseRequest as bU, type SubmitSolanaFeedbackRequest as bV, TIER_FILTERS as bW, TIER_TIMINGS as bX, USDC_DOMAIN_NAME as bY, type UnavailableBody as bZ, type UnavailableResponse as b_, EscrowClient as ba, type EscrowClientOptions as bb, type EscrowOperatorGeneration as bc, type EscrowPayment as bd, type EscrowStateResponse as be, type EscrowStatus as bf, type FeedbackEntry as bg, type FeedbackParams as bh, type FeedbackRequest as bi, type FeedbackResponse as bj, HEALTH_FILTERS as bk, type IdentityByOwnerResponse as bl, type IdentityMetadataResponse as bm, type IdentityTotalSupplyResponse as bn, type LifecycleAuthOptions as bo, MAX_SEARCH_LEN as bp, type MetadataEntryParam as bq, OPERATOR_ABI as br, OPERATOR_ABI_CREATE3 as bs, OPERATOR_ABI_V3 as bt, PAYMENT_INFO_TYPEHASH as bu, type PaymentRequirementResolver as bv, type PaymentRequirements as bw, type PaymentRequirementsOptions as bx, type PrepareRelayFeedbackRequest as by, type PrepareRelayFeedbackResponse as bz, type AdmittedAuthorizationCode as c, ZERO_ADDRESS as c0, buildErc8004PaymentRequirements as c1, buildUnavailableResponse as c2, canRefundEscrow as c3, canReleaseEscrow as c4, carryFailureFields as c5, epochToDate as c6, escrowTimeRemaining as c7, getEscrowContractsByChainId as c8, getEscrowOperatorGeneration as c9, getEscrowSupportedChainIds as ca, isAlive as cb, isEscrowExpired as cc, isEscrowSupportedOnChain as cd, isRegisterJobTerminal as ce, parsePaymentHeader as cf, supportsRelayedFeedback as cg, supportsSolanaFeedback as ch, wireNetwork as ci, DEFAULT_RETRY_AFTER_SECONDS as d, FacilitatorClient as e, type FacilitatorClientOptions as f, type FacilitatorErrorInfo as g, type FacilitatorFailureFields as h, type FacilitatorFetchOptions as i, IDEMPOTENT_REPLAYED_HEADER as j, LIFECYCLE_DEFAULT_DEADLINE_SECS as k, LIFECYCLE_DOMAIN_NAME as l, LIFECYCLE_DOMAIN_VERSION as m, LIFECYCLE_MAX_DEADLINE_SECS as n, LIFECYCLE_ORDER_TYPES as o, type LifecycleAction as p, type LifecycleAuth as q, type LifecyclePaymentInfo as r, type LifecycleSigner as s, type LifecycleTypedData as t, type LifecycleTypedDataParams as u, type PaymentAcceptance as v, type PaymentConflictResponse as w, type PaymentMiddlewareOptions as x, type PaymentPayloadV2 as y, type PaymentRequirementsV2 as z };

package/dist/{index-Dy7eJ6hX.d.mts → index-SaqboHsK.d.mts}

@@ -3733,6 +3733,13 @@ declare const USDC_DOMAIN_NAME: Record<number, string>;
  * resolve the real operator from the marketplace's own escrow config
  * ({@link EscrowNetworkConfig}) and pass it via `options.contracts`.
  * See {@link OPERATOR_FEE_BPS} for the commands.
+ *
+ * Arc (5042) and Arc Testnet (5042002) use the x402r canonical escrow
+ * (AuthCaptureEscrow `0xBdEA0D1b…`, PaymentOperatorFactory v1.0.2
+ * `0xc24153B7…`). Their `operator` is a PaymentOperator address: the one the
+ * factory's `computeAddress` returns, recorded on both chains in
+ * `src/fixtures/arc-escrow-d.rpc.json`. Their operator generation is `'v3'`
+ * ({@link OPERATOR_ABI_V3}).
  */
 declare const ESCROW_CONTRACTS: Record<number, AdvancedEscrowContracts>;
 /**
@@ -3914,7 +3921,8 @@ interface AdvancedEscrowClientOptions {
      * Chain ID (default: 8453 for Base Mainnet).
      * Supported chains: 8453 (Base), 84532 (Base Sepolia), 1 (Ethereum),
      * 11155111 (Ethereum Sepolia), 137 (Polygon), 42161 (Arbitrum),
-     * 10 (Optimism), 42220 (Celo), 143 (Monad), 43114 (Avalanche).
+     * 10 (Optimism), 42220 (Celo), 143 (Monad), 43114 (Avalanche),
+     * 1187947933 (SKALE Base), 5042 (Arc), 5042002 (Arc Testnet).
      */
     chainId?: number;
     /** Contract addresses (auto-resolved from chainId if not provided) */
@@ -3965,13 +3973,77 @@ declare const OPERATOR_ABI: string[];
  * on release() and refundInEscrow(). Pass empty bytes (0x) for the data parameter.
  */
 declare const OPERATOR_ABI_CREATE3: string[];
+/**
+ * PaymentOperator of the x402r canonical PaymentOperatorFactory v1.0.2
+ * (`0xc24153B7ED8DC03e551F29DDEeA5CadFe57e2716`), the operator generation of
+ * Arc and Arc Testnet. Source: BackTrackCo/x402r-contracts
+ * `src/operator/payment/PaymentOperator.sol` @ 8345776e.
+ *
+ * It has no `release` and no `refundInEscrow`:
+ * - `capture(paymentInfo, amount, data)` pays the receiver;
+ * - `void(paymentInfo, data)` takes NO amount: it returns the whole
+ *   `capturableAmount` to the payer;
+ * - `refund(...)` returns funds after a capture;
+ * - the owner is `FEE_RECEIVER()`.
+ *
+ * Every selector here is checked against the factory bytecode recorded on
+ * Arc (`src/fixtures/arc-escrow-d.rpc.json`): `capture` 0xf12b86f6, `void`
+ * 0xc3c5090e, `FEE_RECEIVER` 0xd3e78e4d.
+ */
+declare const OPERATOR_ABI_V3: string[];
+/**
+ * `refundInEscrow` on a v3 operator was given an amount other than the whole
+ * `capturableAmount`. `void` takes no amount, so sending it would return more
+ * than was asked. Nothing was sent. `errorCode` of the result.
+ */
+declare const ESCROW_VOID_AMOUNT_MISMATCH = "escrow_void_amount_mismatch";
+/**
+ * `refundInEscrow` on a v3 operator found `capturableAmount` = 0: nothing is
+ * left to return. Nothing was sent. `errorCode` of the result.
+ */
+declare const ESCROW_NOTHING_TO_VOID = "escrow_nothing_to_void";
+/**
+ * The v3 operator has no code on the chain. A call to it would succeed and
+ * move nothing, so the SDK does not send one. `errorCode` of the result.
+ */
+declare const ESCROW_OPERATOR_NOT_DEPLOYED = "escrow_operator_not_deployed";
+/**
+ * The call has no counterpart on the chain's operator generation (`charge` on
+ * a v3 operator). Nothing was signed or sent. `errorCode` of the result.
+ */
+declare const ESCROW_UNSUPPORTED_ON_GENERATION = "escrow_unsupported_on_generation";
+/**
+ * Which PaymentOperator ABI a chain's escrow operator speaks.
+ *
+ * - `'v1'`: {@link OPERATOR_ABI} — `release(PaymentInfo, amount)` and
+ *   `refundInEscrow(PaymentInfo, amount)`.
+ * - `'v2'`: {@link OPERATOR_ABI_CREATE3} — the same two with a trailing
+ *   `bytes data`.
+ * - `'v3'`: {@link OPERATOR_ABI_V3} — `capture(PaymentInfo, amount, data)` and
+ *   `void(PaymentInfo, data)`.
+ */
+type EscrowOperatorGeneration = 'v1' | 'v2' | 'v3';
+/**
+ * Operator generation per chain — the single source the escrow client reads
+ * to pick the operator ABI. A chain absent from this table is `'v1'`, which is
+ * what a custom `options.contracts` on an unlisted chain has always used.
+ */
+declare const ESCROW_OPERATOR_GENERATION: Record<number, EscrowOperatorGeneration>;
+/** Operator generation of a chain; `'v1'` when the chain is not listed. */
+declare function getEscrowOperatorGeneration(chainId: number): EscrowOperatorGeneration;
 /**
  * AdvancedEscrowClient provides the 5 Advanced Escrow flows via the
  * PaymentOperator contract on 9 supported EVM networks.
  *
  * Supported chains: Base (8453), Base Sepolia (84532), Ethereum (1),
  * Ethereum Sepolia (11155111), Polygon (137), Arbitrum (42161),
- * Optimism (10), Celo (42220), Monad (143), Avalanche (43114).
+ * Optimism (10), Celo (42220), Monad (143), Avalanche (43114),
+ * SKALE Base (1187947933), Arc (5042), Arc Testnet (5042002).
+ *
+ * The operator ABI follows the chain's {@link ESCROW_OPERATOR_GENERATION}.
+ * On Arc and Arc Testnet (`'v3'`) `release` sends `capture`, `refundInEscrow`
+ * sends `void` (whole capturable amount only), `refundPostEscrow` sends
+ * `refund`, and `charge` refuses without signing or sending.
  *
  * Contract addresses are auto-resolved from the chain ID.
  * Pass custom contracts to override.
@@ -4097,6 +4169,10 @@ declare class AdvancedEscrowClient {
      *
      * Calls PaymentOperator.release() -> escrow.capture()
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.capture(paymentInfo, amount, 0x)` instead, after checking
+     * that the operator has code ({@link ESCROW_OPERATOR_NOT_DEPLOYED}).
+     *
      * @param paymentInfo - PaymentInfo from the authorize step
      * @param amount - Amount to release (defaults to maxAmount)
      */
@@ -4106,6 +4182,16 @@ declare class AdvancedEscrowClient {
      *
      * Calls PaymentOperator.refundInEscrow() -> escrow.partialVoid()
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.void(paymentInfo, 0x)`, which takes no amount and returns
+     * the WHOLE `capturableAmount`. So it first reads that amount on-chain
+     * (`AuthCaptureEscrow.getHash` + `paymentState`) and sends only when
+     * `amount` equals it. Otherwise nothing is sent and `errorCode` says why:
+     * {@link ESCROW_NOTHING_TO_VOID} when it is 0,
+     * {@link ESCROW_VOID_AMOUNT_MISMATCH} for any other amount. To return part
+     * of an escrow on v3, `release` the part the receiver keeps, then
+     * `refundInEscrow` what is left.
+     *
      * @param paymentInfo - PaymentInfo from the authorize step
      * @param amount - Amount to refund (defaults to maxAmount)
      */
@@ -4223,6 +4309,9 @@ declare class AdvancedEscrowClient {
      * Calls PaymentOperator.charge() -> escrow.charge()
      * Funds go directly from payer to receiver.
      *
+     * Not available on a `'v3'` operator (Arc, Arc Testnet): it returns
+     * {@link ESCROW_UNSUPPORTED_ON_GENERATION} without signing or sending.
+     *
      * @param paymentInfo - PaymentInfo with receiver and amount
      * @param amount - Amount to charge (defaults to maxAmount)
      */
@@ -4242,12 +4331,32 @@ declare class AdvancedEscrowClient {
      *
      * Kept for future use when tokenCollector is implemented.
      *
+     * On a `'v3'` operator (Arc, Arc Testnet) it calls
+     * `PaymentOperator.refund(paymentInfo, amount, tokenCollector, collectorData)`
+     * -> escrow.refund(), the same arguments, after checking that the operator
+     * has code ({@link ESCROW_OPERATOR_NOT_DEPLOYED}).
+     *
      * @param paymentInfo - PaymentInfo from the original authorization
      * @param amount - Amount to refund (defaults to maxAmount)
      * @param tokenCollector - Address of token collector for refund sourcing
      * @param collectorData - Data for the token collector
      */
     refundPostEscrow(paymentInfo: AdvancedPaymentInfo, amount?: string, tokenCollector?: string, collectorData?: string): Promise<AdvancedTransactionResult>;
+    /** The refusal of a call a 'v3' operator does not have, or null elsewhere. */
+    private unsupportedOnV3;
+    /** The provider a 'v3' call reads with before it sends anything. */
+    private v3Provider;
+    /**
+     * Send one OPERATOR_ABI_V3 call, once the operator is known to have code.
+     * A call to an address with no code succeeds and moves nothing, and would be
+     * reported as a success.
+     */
+    private sendV3OperatorCall;
+    /**
+     * `refundInEscrow` on a 'v3' operator: `void` returns the whole capturable
+     * amount, so it is sent only when that is exactly what was asked for.
+     */
+    private voidWholeCapturable;
     /**
      * Build an unsigned transaction, sign via SigningWalletAdapter, and broadcast.
      *
@@ -4263,4 +4372,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { buildSettleRequest as $, AMBIGUOUS_LEASE_REASONS as A, type BuildLifecycleAuthParams as B, REPLAYABLE_LEASE_REASONS as C, DEFAULT_FACILITATOR_RETRIES as D, type ResourceInfoV2 as E, type FacilitatorCallOptions as F, type SettleRequestV2 as G, type HonoMiddlewareOptions as H, IDEMPOTENCY_KEY_HEADER as I, type SettleResponse as J, type VerifyRequestV2 as K, LIFECYCLE_ACTIONS as L, MAX_RETRY_AFTER_SECONDS as M, type VerifyResponse as N, type WagmiLifecycleWalletClient as O, type ParsedFacilitatorErrorBody as P, type WriterLeaseReason as Q, RECEIPT_REQUEST_CONFLICT as R, SETTLEMENT_UNCONFIRMED as S, X402_HEADER_NAMES as T, buildLifecycleAuth as U, type VerifiedPaymentState as V, WRITER_LEASE_REASONS as W, X402_CORS_HEADERS as X, buildLifecycleTypedData as Y, buildPaymentConflictResponse as Z, buildPaymentRequirements as _, AUTHORIZATION_ALREADY_SETTLED as a, ESCROW_CONTRACTS as a$, buildSettleRequestForVersion as a0, buildSettleRequestV2 as a1, buildVerifyRequest as a2, buildVerifyRequestForVersion as a3, buildVerifyRequestV2 as a4, create402Response as a5, createHonoMiddleware as a6, createIdempotencyKey as a7, createPaymentMiddleware as a8, extractPaymentFromHeaders as a9, type AgentService as aA, type AtomStats as aB, BASE_MAINNET_CONTRACTS as aC, BazaarClient as aD, type BazaarClientOptions as aE, type BazaarDiscoverOptions as aF, type BazaarDiscoverResponse as aG, type BazaarRegisterOptions as aH, type BazaarResource as aI, type CreateEscrowOptions as aJ, DEPOSIT_LIMIT_USDC as aK, type DiscoveryAccepts as aL, type DiscoveryCuration as aM, type DiscoveryHealth as aN, type DiscoveryHealthStatus as aO, type DiscoveryListOptions as aP, type DiscoveryPagination as aQ, type DiscoveryRegisterOptions as aR, type DiscoveryResource as aS, type DiscoveryResponse as aT, type DiscoverySource as aU, type DiscoveryStats as aV, type DiscoveryTier as aW, type Dispute as aX, type DisputeOutcome as aY, ERC8004_CONTRACTS as aZ, ERC8004_EXTENSION_ID as a_, facilitatorFetch as aa, getCorsHeaders as ab, isAmbiguousLeaseReason as ac, isAuthorizationAlreadyUsed as ad, isAuthorizationInFlight as ae, isReplayableLeaseReason as af, isSettlementUnconfirmed as ag, lifecycleAuthFromSignature as ah, parseFacilitatorErrorBody as ai, parseRetryAfterSeconds as aj, readFacilitatorError as ak, resolveEnvelopeVersion as al, toPaymentRequirementsV2 as am, toResourceInfoV2 as an, wagmiLifecycleSigner as ao, type AdvancedAuthorizationResult as ap, AdvancedEscrowClient as aq, type AdvancedEscrowClientOptions as ar, type AdvancedEscrowContracts as as, type AdvancedEscrowTaskTier as at, type AdvancedPaymentInfo as au, type AdvancedTransactionResult as av, type AgentId as aw, type AgentIdentity as ax, type AgentRegistration as ay, type AgentRegistrationFile as az, AUTHORIZATION_IN_FLIGHT as b, epochToDate as b$, ESCROW_TIMEOUT_MS as b0, Erc8004Client as b1, type Erc8004ClientOptions as b2, Erc8004LookupError as b3, type Erc8004Network as b4, EscrowClient as b5, type EscrowClientOptions as b6, type EscrowPayment as b7, type EscrowStateResponse as b8, type EscrowStatus as b9, type RegisterAgentRequest as bA, type RegisterAgentResponse as bB, type RegisterJobResponse as bC, type RegisterJobStatus as bD, RegistrationPendingError as bE, type RelayAuthorizationParams as bF, type ReputationResponse as bG, type ReputationSummary as bH, type RequestRefundOptions as bI, SOLANA_FEEDBACK_NETWORKS as bJ, type SettleRequest as bK, type SettleResponseWithProof as bL, type SubmitRelayFeedbackRequest as bM, type SubmitRelayResponseRequest as bN, type SubmitSolanaFeedbackRequest as bO, TIER_FILTERS as bP, TIER_TIMINGS as bQ, USDC_DOMAIN_NAME as bR, type UnavailableBody as bS, type UnavailableResponse as bT, type VerifyRequest as bU, ZERO_ADDRESS as bV, buildErc8004PaymentRequirements as bW, buildUnavailableResponse as bX, canRefundEscrow as bY, canReleaseEscrow as bZ, carryFailureFields as b_, type FeedbackEntry as ba, type FeedbackParams as bb, type FeedbackRequest as bc, type FeedbackResponse as bd, HEALTH_FILTERS as be, type IdentityByOwnerResponse as bf, type IdentityMetadataResponse as bg, type IdentityTotalSupplyResponse as bh, type LifecycleAuthOptions as bi, MAX_SEARCH_LEN as bj, type MetadataEntryParam as bk, OPERATOR_ABI as bl, OPERATOR_ABI_CREATE3 as bm, PAYMENT_INFO_TYPEHASH as bn, type PaymentRequirementResolver as bo, type PaymentRequirements as bp, type PaymentRequirementsOptions as bq, type PrepareRelayFeedbackRequest as br, type PrepareRelayFeedbackResponse as bs, type PrepareRelayResponseRequest as bt, type PrepareSolanaFeedbackRequest as bu, type PrepareSolanaFeedbackResponse as bv, type ProofOfPayment as bw, RELAYED_FEEDBACK_NETWORKS as bx, type RefundRequest as by, type RefundStatus as bz, type AdmittedAuthorizationCode as c, escrowTimeRemaining as c0, getEscrowContractsByChainId as c1, getEscrowSupportedChainIds as c2, isAlive as c3, isEscrowExpired as c4, isEscrowSupportedOnChain as c5, isRegisterJobTerminal as c6, parsePaymentHeader as c7, supportsRelayedFeedback as c8, supportsSolanaFeedback as c9, wireNetwork as ca, DEFAULT_RETRY_AFTER_SECONDS as d, FacilitatorClient as e, type FacilitatorClientOptions as f, type FacilitatorErrorInfo as g, type FacilitatorFailureFields as h, type FacilitatorFetchOptions as i, IDEMPOTENT_REPLAYED_HEADER as j, LIFECYCLE_DEFAULT_DEADLINE_SECS as k, LIFECYCLE_DOMAIN_NAME as l, LIFECYCLE_DOMAIN_VERSION as m, LIFECYCLE_MAX_DEADLINE_SECS as n, LIFECYCLE_ORDER_TYPES as o, type LifecycleAction as p, type LifecycleAuth as q, type LifecyclePaymentInfo as r, type LifecycleSigner as s, type LifecycleTypedData as t, type LifecycleTypedDataParams as u, type PaymentAcceptance as v, type PaymentConflictResponse as w, type PaymentMiddlewareOptions as x, type PaymentPayloadV2 as y, type PaymentRequirementsV2 as z };
+export { buildSettleRequest as $, AMBIGUOUS_LEASE_REASONS as A, type BuildLifecycleAuthParams as B, REPLAYABLE_LEASE_REASONS as C, DEFAULT_FACILITATOR_RETRIES as D, type ResourceInfoV2 as E, type FacilitatorCallOptions as F, type SettleRequestV2 as G, type HonoMiddlewareOptions as H, IDEMPOTENCY_KEY_HEADER as I, type SettleResponse as J, type VerifyRequestV2 as K, LIFECYCLE_ACTIONS as L, MAX_RETRY_AFTER_SECONDS as M, type VerifyResponse as N, type WagmiLifecycleWalletClient as O, type ParsedFacilitatorErrorBody as P, type WriterLeaseReason as Q, RECEIPT_REQUEST_CONFLICT as R, SETTLEMENT_UNCONFIRMED as S, X402_HEADER_NAMES as T, buildLifecycleAuth as U, type VerifiedPaymentState as V, WRITER_LEASE_REASONS as W, X402_CORS_HEADERS as X, buildLifecycleTypedData as Y, buildPaymentConflictResponse as Z, buildPaymentRequirements as _, AUTHORIZATION_ALREADY_SETTLED as a, ESCROW_CONTRACTS as a$, buildSettleRequestForVersion as a0, buildSettleRequestV2 as a1, buildVerifyRequest as a2, buildVerifyRequestForVersion as a3, buildVerifyRequestV2 as a4, create402Response as a5, createHonoMiddleware as a6, createIdempotencyKey as a7, createPaymentMiddleware as a8, extractPaymentFromHeaders as a9, type AgentService as aA, type AtomStats as aB, BASE_MAINNET_CONTRACTS as aC, BazaarClient as aD, type BazaarClientOptions as aE, type BazaarDiscoverOptions as aF, type BazaarDiscoverResponse as aG, type BazaarRegisterOptions as aH, type BazaarResource as aI, type CreateEscrowOptions as aJ, DEPOSIT_LIMIT_USDC as aK, type DiscoveryAccepts as aL, type DiscoveryCuration as aM, type DiscoveryHealth as aN, type DiscoveryHealthStatus as aO, type DiscoveryListOptions as aP, type DiscoveryPagination as aQ, type DiscoveryRegisterOptions as aR, type DiscoveryResource as aS, type DiscoveryResponse as aT, type DiscoverySource as aU, type DiscoveryStats as aV, type DiscoveryTier as aW, type Dispute as aX, type DisputeOutcome as aY, ERC8004_CONTRACTS as aZ, ERC8004_EXTENSION_ID as a_, facilitatorFetch as aa, getCorsHeaders as ab, isAmbiguousLeaseReason as ac, isAuthorizationAlreadyUsed as ad, isAuthorizationInFlight as ae, isReplayableLeaseReason as af, isSettlementUnconfirmed as ag, lifecycleAuthFromSignature as ah, parseFacilitatorErrorBody as ai, parseRetryAfterSeconds as aj, readFacilitatorError as ak, resolveEnvelopeVersion as al, toPaymentRequirementsV2 as am, toResourceInfoV2 as an, wagmiLifecycleSigner as ao, type AdvancedAuthorizationResult as ap, AdvancedEscrowClient as aq, type AdvancedEscrowClientOptions as ar, type AdvancedEscrowContracts as as, type AdvancedEscrowTaskTier as at, type AdvancedPaymentInfo as au, type AdvancedTransactionResult as av, type AgentId as aw, type AgentIdentity as ax, type AgentRegistration as ay, type AgentRegistrationFile as az, AUTHORIZATION_IN_FLIGHT as b, type VerifyRequest as b$, ESCROW_NOTHING_TO_VOID as b0, ESCROW_OPERATOR_GENERATION as b1, ESCROW_OPERATOR_NOT_DEPLOYED as b2, ESCROW_TIMEOUT_MS as b3, ESCROW_UNSUPPORTED_ON_GENERATION as b4, ESCROW_VOID_AMOUNT_MISMATCH as b5, Erc8004Client as b6, type Erc8004ClientOptions as b7, Erc8004LookupError as b8, type Erc8004Network as b9, type PrepareRelayResponseRequest as bA, type PrepareSolanaFeedbackRequest as bB, type PrepareSolanaFeedbackResponse as bC, type ProofOfPayment as bD, RELAYED_FEEDBACK_NETWORKS as bE, type RefundRequest as bF, type RefundStatus as bG, type RegisterAgentRequest as bH, type RegisterAgentResponse as bI, type RegisterJobResponse as bJ, type RegisterJobStatus as bK, RegistrationPendingError as bL, type RelayAuthorizationParams as bM, type ReputationResponse as bN, type ReputationSummary as bO, type RequestRefundOptions as bP, SOLANA_FEEDBACK_NETWORKS as bQ, type SettleRequest as bR, type SettleResponseWithProof as bS, type SubmitRelayFeedbackRequest as bT, type SubmitRelayResponseRequest as bU, type SubmitSolanaFeedbackRequest as bV, TIER_FILTERS as bW, TIER_TIMINGS as bX, USDC_DOMAIN_NAME as bY, type UnavailableBody as bZ, type UnavailableResponse as b_, EscrowClient as ba, type EscrowClientOptions as bb, type EscrowOperatorGeneration as bc, type EscrowPayment as bd, type EscrowStateResponse as be, type EscrowStatus as bf, type FeedbackEntry as bg, type FeedbackParams as bh, type FeedbackRequest as bi, type FeedbackResponse as bj, HEALTH_FILTERS as bk, type IdentityByOwnerResponse as bl, type IdentityMetadataResponse as bm, type IdentityTotalSupplyResponse as bn, type LifecycleAuthOptions as bo, MAX_SEARCH_LEN as bp, type MetadataEntryParam as bq, OPERATOR_ABI as br, OPERATOR_ABI_CREATE3 as bs, OPERATOR_ABI_V3 as bt, PAYMENT_INFO_TYPEHASH as bu, type PaymentRequirementResolver as bv, type PaymentRequirements as bw, type PaymentRequirementsOptions as bx, type PrepareRelayFeedbackRequest as by, type PrepareRelayFeedbackResponse as bz, type AdmittedAuthorizationCode as c, ZERO_ADDRESS as c0, buildErc8004PaymentRequirements as c1, buildUnavailableResponse as c2, canRefundEscrow as c3, canReleaseEscrow as c4, carryFailureFields as c5, epochToDate as c6, escrowTimeRemaining as c7, getEscrowContractsByChainId as c8, getEscrowOperatorGeneration as c9, getEscrowSupportedChainIds as ca, isAlive as cb, isEscrowExpired as cc, isEscrowSupportedOnChain as cd, isRegisterJobTerminal as ce, parsePaymentHeader as cf, supportsRelayedFeedback as cg, supportsSolanaFeedback as ch, wireNetwork as ci, DEFAULT_RETRY_AFTER_SECONDS as d, FacilitatorClient as e, type FacilitatorClientOptions as f, type FacilitatorErrorInfo as g, type FacilitatorFailureFields as h, type FacilitatorFetchOptions as i, IDEMPOTENT_REPLAYED_HEADER as j, LIFECYCLE_DEFAULT_DEADLINE_SECS as k, LIFECYCLE_DOMAIN_NAME as l, LIFECYCLE_DOMAIN_VERSION as m, LIFECYCLE_MAX_DEADLINE_SECS as n, LIFECYCLE_ORDER_TYPES as o, type LifecycleAction as p, type LifecycleAuth as q, type LifecyclePaymentInfo as r, type LifecycleSigner as s, type LifecycleTypedData as t, type LifecycleTypedDataParams as u, type PaymentAcceptance as v, type PaymentConflictResponse as w, type PaymentMiddlewareOptions as x, type PaymentPayloadV2 as y, type PaymentRequirementsV2 as z };

package/dist/index.d.mts

@@ -4,7 +4,7 @@ export { D as DEFAULT_PAYMENT_HEADER, a as DEFAULT_VALIDITY_SECONDS, M as MAX_VA
 import { S as SigningWalletAdapter } from './wallet-w7BnImDG.mjs';
 export { a as EIP3009Authorization, E as EIP3009Params } from './wallet-w7BnImDG.mjs';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from './ows-Z9v4GxOZ.mjs';
-export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, B as BuildLifecycleAuthParams, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, L as LIFECYCLE_ACTIONS, k as LIFECYCLE_DEFAULT_DEADLINE_SECS, l as LIFECYCLE_DOMAIN_NAME, m as LIFECYCLE_DOMAIN_VERSION, n as LIFECYCLE_MAX_DEADLINE_SECS, o as LIFECYCLE_ORDER_TYPES, p as LifecycleAction, q as LifecycleAuth, r as LifecyclePaymentInfo, s as LifecycleSigner, t as LifecycleTypedData, u as LifecycleTypedDataParams, M as MAX_RETRY_AFTER_SECONDS, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, z as PaymentRequirementsV2, R as RECEIPT_REQUEST_CONFLICT, C as REPLAYABLE_LEASE_REASONS, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, G as SettleRequestV2, J as SettleResponse, V as VerifiedPaymentState, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, O as WagmiLifecycleWalletClient, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, U as buildLifecycleAuth, Y as buildLifecycleTypedData, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ah as lifecycleAuthFromSignature, ai as parseFacilitatorErrorBody, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, am as toPaymentRequirementsV2, an as toResourceInfoV2, ao as wagmiLifecycleSigner } from './index-Dy7eJ6hX.mjs';
+export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, B as BuildLifecycleAuthParams, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, L as LIFECYCLE_ACTIONS, k as LIFECYCLE_DEFAULT_DEADLINE_SECS, l as LIFECYCLE_DOMAIN_NAME, m as LIFECYCLE_DOMAIN_VERSION, n as LIFECYCLE_MAX_DEADLINE_SECS, o as LIFECYCLE_ORDER_TYPES, p as LifecycleAction, q as LifecycleAuth, r as LifecyclePaymentInfo, s as LifecycleSigner, t as LifecycleTypedData, u as LifecycleTypedDataParams, M as MAX_RETRY_AFTER_SECONDS, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, z as PaymentRequirementsV2, R as RECEIPT_REQUEST_CONFLICT, C as REPLAYABLE_LEASE_REASONS, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, G as SettleRequestV2, J as SettleResponse, V as VerifiedPaymentState, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, O as WagmiLifecycleWalletClient, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, U as buildLifecycleAuth, Y as buildLifecycleTypedData, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ah as lifecycleAuthFromSignature, ai as parseFacilitatorErrorBody, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, am as toPaymentRequirementsV2, an as toResourceInfoV2, ao as wagmiLifecycleSigner } from './index-SaqboHsK.mjs';
 export { HEDERA_NETWORKS, HederaNetwork, HederaPaymentPayload, HederaProvider, HederaRequirements, buildHederaRequest, buildHederaRequirements, validateHederaRequirements } from './providers/hedera/index.mjs';
 export { a as FacilitatorReceipt, F as FetchReceiptResult, P as PaymentState, b as PurchaseContext, c as RECEIPT_ISSUER, R as ReceiptFetchOptions, d as ReceiptKeys, e as canonicalReceiptJson, f as createPurchaseContext, g as fetchWithReceipt, h as getFacilitatorReceipt, m as mergeHeaderList, i as mergePaymentResponseHeaders, p as parseFacilitatorReceipt, j as paymentResponseHeaders, k as purchaseContextHeader, r as receiptCommitment, l as receiptFromErrorBody, n as receiptFromResponse, v as validatePurchaseContext, o as verifyFacilitatorReceipt } from './receipts-D0zg-8uK.mjs';
 
@@ -1060,8 +1060,9 @@ declare function isDelegated(address: string, network: string, resolver?: Delega
  * receiver fill" is on-chain unsound).
  *
  * Fail-loud policy: an incomplete network config, an unknown tier, a bounty
- * outside the on-chain deposit limit, or a `maxFeeBps` that cannot cover the
- * operator's static fee all throw instead of falling back — a silent
+ * outside the on-chain deposit limit, a `maxFeeBps` that cannot cover the
+ * operator's static fee, or a USDC domain that contradicts
+ * {@link VERIFIED_USDC_DOMAINS} all throw instead of falling back — a silent
  * fallback would sign an EIP-3009 authorization with the WRONG EIP-712
  * domain (chainId + verifyingContract): a mismatched, wallet-draining auth.
  *
@@ -1201,6 +1202,26 @@ interface EscrowPaymentInfo {
     /** 32-byte hex. */
     salt: string;
 }
+/**
+ * USDC EIP-712 domains VERIFIED ON-CHAIN, per chain ID.
+ *
+ * `usdc_domain_name` / `usdc_domain_version` arrive with the server's config,
+ * and they ARE the domain the authorization is signed under: a wrong pair
+ * produces an authorization that never settles. For a chain in this table,
+ * {@link buildEscrowPreAuth} refuses a config whose pair differs. A chain that
+ * is not in the table is signed exactly as before.
+ *
+ * Only chains whose domain this SDK checked against the token's own
+ * `DOMAIN_SEPARATOR()` are listed: Arc and Arc Testnet
+ * (`src/fixtures/arc-escrow-d.rpc.json`, pinned by
+ * `src/backend/escrow-arc-d.test.ts`). The values come from the chain
+ * registry (`src/chains`), not typed again here. Mirrors the refusal policy of
+ * the Python SDK's `escrow_signing.VERIFIED_USDC_DOMAINS`.
+ */
+declare const VERIFIED_USDC_DOMAINS: Record<number, {
+    name: string;
+    version: string;
+}>;
 /**
  * Compute the escrow EIP-3009 nonce = `AuthCaptureEscrow.getHash(paymentInfo)`.
  *
@@ -1280,9 +1301,10 @@ interface EscrowPreAuthParams {
  * `em_plugin_sdk.escrow_signing.build_escrow_pre_auth`.
  *
  * @throws {X402Error} `INVALID_CONFIG` on an incomplete network config,
- *   unknown tier, or a `maxFeeBps` that cannot cover the operator's static
- *   fee; `INVALID_AMOUNT` on a bounty outside (0, deposit limit].
+ *   unknown tier, a `maxFeeBps` that cannot cover the operator's static
+ *   fee, or a USDC domain that differs from {@link VERIFIED_USDC_DOMAINS};
+ *   `INVALID_AMOUNT` on a bounty outside (0, deposit limit].
  */
 declare function buildEscrowPreAuth(wallet: EscrowPreAuthSigner, params: EscrowPreAuthParams): Promise<string>;
 
-export { ANCHOR_MAX_REQUEST_BYTES, type AnchorOptions, type AnchoredEvidence, type BackendOffer, ContentHashMismatch, type CreateSignedFetchConfig, DEFAULT_MAX_FEE_BPS, DEFAULT_MIN_FEE_BPS, DELEGATE_PREFIX, DX402Error, type DelegationResolver, type DelegationVerdict, type ERC8128RequestOptions, ESCROW_DEPOSIT_LIMIT_USD, ESCROW_TIER_WINDOWS, EVENT_KINDS, EVIDENCE_HEADER, type EscrowNetworkConfig, type EscrowPaymentInfo, type EscrowPreAuthParams, type EscrowPreAuthSigner, type EscrowTierWindows, type EvidenceMode, EvidenceSkipped, FACILITATOR_ADDRESSES, type FacilitatorAddresses, KEEPALIVE_INTERVAL_MS, MAX_PROTOCOL_FEE_BPS, OPERATOR_FEE_BPS, type RecipientRole, SMA_WRAP_TARGETS, type SSEFrame, SSEParser, type SignRequestOptions, type SignRequestWithSignerOptions, type SignatureBaseParams, type SignatureHeaders, type SignatureParamsInput, SigningWalletAdapter, type StreamTrafficEventsOptions, type TrafficEvent, type TrafficEventKind, TrafficStreamError, ZERO_ADDRESS, anchorDigest, anchorEvidence, availableBackends, buildEscrowPreAuth, buildSignatureBase, buildSignatureParams, computeEscrowNonce, contentHash, createSignedFetch, delegateTarget, dereferencePointer, paymentId as dx402PaymentId, ed25519ToX25519, evidenceFromHeaders, evidenceHeader, fetchNonce, getFacilitatorAddress, isDelegated, isEndToEnd, matchesFilters, needsAccountWrap, parseEvidenceHeader, parseSealed, parseTrafficEvent, payerKeyFromEvmSignature, payerKeyFromSolanaAddress, recoverEvidence, replaySafeTypedData, resolveDelegation, rpcDelegationResolver, sealEvidence, sealEvidenceTo, sealedRoles, sellerDigestFor, signAnchorEd25519, signAnchorEvm, signRequest, signRequestWithSigner, signRequestWithWallet, streamTrafficEvents, unseal, wrapSignature };
+export { ANCHOR_MAX_REQUEST_BYTES, type AnchorOptions, type AnchoredEvidence, type BackendOffer, ContentHashMismatch, type CreateSignedFetchConfig, DEFAULT_MAX_FEE_BPS, DEFAULT_MIN_FEE_BPS, DELEGATE_PREFIX, DX402Error, type DelegationResolver, type DelegationVerdict, type ERC8128RequestOptions, ESCROW_DEPOSIT_LIMIT_USD, ESCROW_TIER_WINDOWS, EVENT_KINDS, EVIDENCE_HEADER, type EscrowNetworkConfig, type EscrowPaymentInfo, type EscrowPreAuthParams, type EscrowPreAuthSigner, type EscrowTierWindows, type EvidenceMode, EvidenceSkipped, FACILITATOR_ADDRESSES, type FacilitatorAddresses, KEEPALIVE_INTERVAL_MS, MAX_PROTOCOL_FEE_BPS, OPERATOR_FEE_BPS, type RecipientRole, SMA_WRAP_TARGETS, type SSEFrame, SSEParser, type SignRequestOptions, type SignRequestWithSignerOptions, type SignatureBaseParams, type SignatureHeaders, type SignatureParamsInput, SigningWalletAdapter, type StreamTrafficEventsOptions, type TrafficEvent, type TrafficEventKind, TrafficStreamError, VERIFIED_USDC_DOMAINS, ZERO_ADDRESS, anchorDigest, anchorEvidence, availableBackends, buildEscrowPreAuth, buildSignatureBase, buildSignatureParams, computeEscrowNonce, contentHash, createSignedFetch, delegateTarget, dereferencePointer, paymentId as dx402PaymentId, ed25519ToX25519, evidenceFromHeaders, evidenceHeader, fetchNonce, getFacilitatorAddress, isDelegated, isEndToEnd, matchesFilters, needsAccountWrap, parseEvidenceHeader, parseSealed, parseTrafficEvent, payerKeyFromEvmSignature, payerKeyFromSolanaAddress, recoverEvidence, replaySafeTypedData, resolveDelegation, rpcDelegationResolver, sealEvidence, sealEvidenceTo, sealedRoles, sellerDigestFor, signAnchorEd25519, signAnchorEvm, signRequest, signRequestWithSigner, signRequestWithWallet, streamTrafficEvents, unseal, wrapSignature };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { D as DEFAULT_PAYMENT_HEADER, a as DEFAULT_VALIDITY_SECONDS, M as MAX_VA
 import { S as SigningWalletAdapter } from './wallet-w7BnImDG.js';
 export { a as EIP3009Authorization, E as EIP3009Params } from './wallet-w7BnImDG.js';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from './ows-C-KmORG9.js';
-export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, B as BuildLifecycleAuthParams, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, L as LIFECYCLE_ACTIONS, k as LIFECYCLE_DEFAULT_DEADLINE_SECS, l as LIFECYCLE_DOMAIN_NAME, m as LIFECYCLE_DOMAIN_VERSION, n as LIFECYCLE_MAX_DEADLINE_SECS, o as LIFECYCLE_ORDER_TYPES, p as LifecycleAction, q as LifecycleAuth, r as LifecyclePaymentInfo, s as LifecycleSigner, t as LifecycleTypedData, u as LifecycleTypedDataParams, M as MAX_RETRY_AFTER_SECONDS, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, z as PaymentRequirementsV2, R as RECEIPT_REQUEST_CONFLICT, C as REPLAYABLE_LEASE_REASONS, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, G as SettleRequestV2, J as SettleResponse, V as VerifiedPaymentState, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, O as WagmiLifecycleWalletClient, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, U as buildLifecycleAuth, Y as buildLifecycleTypedData, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ah as lifecycleAuthFromSignature, ai as parseFacilitatorErrorBody, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, am as toPaymentRequirementsV2, an as toResourceInfoV2, ao as wagmiLifecycleSigner } from './index-BUlo1dYN.js';
+export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, B as BuildLifecycleAuthParams, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, L as LIFECYCLE_ACTIONS, k as LIFECYCLE_DEFAULT_DEADLINE_SECS, l as LIFECYCLE_DOMAIN_NAME, m as LIFECYCLE_DOMAIN_VERSION, n as LIFECYCLE_MAX_DEADLINE_SECS, o as LIFECYCLE_ORDER_TYPES, p as LifecycleAction, q as LifecycleAuth, r as LifecyclePaymentInfo, s as LifecycleSigner, t as LifecycleTypedData, u as LifecycleTypedDataParams, M as MAX_RETRY_AFTER_SECONDS, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, z as PaymentRequirementsV2, R as RECEIPT_REQUEST_CONFLICT, C as REPLAYABLE_LEASE_REASONS, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, G as SettleRequestV2, J as SettleResponse, V as VerifiedPaymentState, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, O as WagmiLifecycleWalletClient, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, U as buildLifecycleAuth, Y as buildLifecycleTypedData, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ah as lifecycleAuthFromSignature, ai as parseFacilitatorErrorBody, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, am as toPaymentRequirementsV2, an as toResourceInfoV2, ao as wagmiLifecycleSigner } from './index-BiL4seGs.js';
 export { HEDERA_NETWORKS, HederaNetwork, HederaPaymentPayload, HederaProvider, HederaRequirements, buildHederaRequest, buildHederaRequirements, validateHederaRequirements } from './providers/hedera/index.js';
 export { a as FacilitatorReceipt, F as FetchReceiptResult, P as PaymentState, b as PurchaseContext, c as RECEIPT_ISSUER, R as ReceiptFetchOptions, d as ReceiptKeys, e as canonicalReceiptJson, f as createPurchaseContext, g as fetchWithReceipt, h as getFacilitatorReceipt, m as mergeHeaderList, i as mergePaymentResponseHeaders, p as parseFacilitatorReceipt, j as paymentResponseHeaders, k as purchaseContextHeader, r as receiptCommitment, l as receiptFromErrorBody, n as receiptFromResponse, v as validatePurchaseContext, o as verifyFacilitatorReceipt } from './receipts-Co6C9FPO.js';
 
@@ -1060,8 +1060,9 @@ declare function isDelegated(address: string, network: string, resolver?: Delega
  * receiver fill" is on-chain unsound).
  *
  * Fail-loud policy: an incomplete network config, an unknown tier, a bounty
- * outside the on-chain deposit limit, or a `maxFeeBps` that cannot cover the
- * operator's static fee all throw instead of falling back — a silent
+ * outside the on-chain deposit limit, a `maxFeeBps` that cannot cover the
+ * operator's static fee, or a USDC domain that contradicts
+ * {@link VERIFIED_USDC_DOMAINS} all throw instead of falling back — a silent
  * fallback would sign an EIP-3009 authorization with the WRONG EIP-712
  * domain (chainId + verifyingContract): a mismatched, wallet-draining auth.
  *
@@ -1201,6 +1202,26 @@ interface EscrowPaymentInfo {
     /** 32-byte hex. */
     salt: string;
 }
+/**
+ * USDC EIP-712 domains VERIFIED ON-CHAIN, per chain ID.
+ *
+ * `usdc_domain_name` / `usdc_domain_version` arrive with the server's config,
+ * and they ARE the domain the authorization is signed under: a wrong pair
+ * produces an authorization that never settles. For a chain in this table,
+ * {@link buildEscrowPreAuth} refuses a config whose pair differs. A chain that
+ * is not in the table is signed exactly as before.
+ *
+ * Only chains whose domain this SDK checked against the token's own
+ * `DOMAIN_SEPARATOR()` are listed: Arc and Arc Testnet
+ * (`src/fixtures/arc-escrow-d.rpc.json`, pinned by
+ * `src/backend/escrow-arc-d.test.ts`). The values come from the chain
+ * registry (`src/chains`), not typed again here. Mirrors the refusal policy of
+ * the Python SDK's `escrow_signing.VERIFIED_USDC_DOMAINS`.
+ */
+declare const VERIFIED_USDC_DOMAINS: Record<number, {
+    name: string;
+    version: string;
+}>;
 /**
  * Compute the escrow EIP-3009 nonce = `AuthCaptureEscrow.getHash(paymentInfo)`.
  *
@@ -1280,9 +1301,10 @@ interface EscrowPreAuthParams {
  * `em_plugin_sdk.escrow_signing.build_escrow_pre_auth`.
  *
  * @throws {X402Error} `INVALID_CONFIG` on an incomplete network config,
- *   unknown tier, or a `maxFeeBps` that cannot cover the operator's static
- *   fee; `INVALID_AMOUNT` on a bounty outside (0, deposit limit].
+ *   unknown tier, a `maxFeeBps` that cannot cover the operator's static
+ *   fee, or a USDC domain that differs from {@link VERIFIED_USDC_DOMAINS};
+ *   `INVALID_AMOUNT` on a bounty outside (0, deposit limit].
  */
 declare function buildEscrowPreAuth(wallet: EscrowPreAuthSigner, params: EscrowPreAuthParams): Promise<string>;
 
-export { ANCHOR_MAX_REQUEST_BYTES, type AnchorOptions, type AnchoredEvidence, type BackendOffer, ContentHashMismatch, type CreateSignedFetchConfig, DEFAULT_MAX_FEE_BPS, DEFAULT_MIN_FEE_BPS, DELEGATE_PREFIX, DX402Error, type DelegationResolver, type DelegationVerdict, type ERC8128RequestOptions, ESCROW_DEPOSIT_LIMIT_USD, ESCROW_TIER_WINDOWS, EVENT_KINDS, EVIDENCE_HEADER, type EscrowNetworkConfig, type EscrowPaymentInfo, type EscrowPreAuthParams, type EscrowPreAuthSigner, type EscrowTierWindows, type EvidenceMode, EvidenceSkipped, FACILITATOR_ADDRESSES, type FacilitatorAddresses, KEEPALIVE_INTERVAL_MS, MAX_PROTOCOL_FEE_BPS, OPERATOR_FEE_BPS, type RecipientRole, SMA_WRAP_TARGETS, type SSEFrame, SSEParser, type SignRequestOptions, type SignRequestWithSignerOptions, type SignatureBaseParams, type SignatureHeaders, type SignatureParamsInput, SigningWalletAdapter, type StreamTrafficEventsOptions, type TrafficEvent, type TrafficEventKind, TrafficStreamError, ZERO_ADDRESS, anchorDigest, anchorEvidence, availableBackends, buildEscrowPreAuth, buildSignatureBase, buildSignatureParams, computeEscrowNonce, contentHash, createSignedFetch, delegateTarget, dereferencePointer, paymentId as dx402PaymentId, ed25519ToX25519, evidenceFromHeaders, evidenceHeader, fetchNonce, getFacilitatorAddress, isDelegated, isEndToEnd, matchesFilters, needsAccountWrap, parseEvidenceHeader, parseSealed, parseTrafficEvent, payerKeyFromEvmSignature, payerKeyFromSolanaAddress, recoverEvidence, replaySafeTypedData, resolveDelegation, rpcDelegationResolver, sealEvidence, sealEvidenceTo, sealedRoles, sellerDigestFor, signAnchorEd25519, signAnchorEvm, signRequest, signRequestWithSigner, signRequestWithWallet, streamTrafficEvents, unseal, wrapSignature };
+export { ANCHOR_MAX_REQUEST_BYTES, type AnchorOptions, type AnchoredEvidence, type BackendOffer, ContentHashMismatch, type CreateSignedFetchConfig, DEFAULT_MAX_FEE_BPS, DEFAULT_MIN_FEE_BPS, DELEGATE_PREFIX, DX402Error, type DelegationResolver, type DelegationVerdict, type ERC8128RequestOptions, ESCROW_DEPOSIT_LIMIT_USD, ESCROW_TIER_WINDOWS, EVENT_KINDS, EVIDENCE_HEADER, type EscrowNetworkConfig, type EscrowPaymentInfo, type EscrowPreAuthParams, type EscrowPreAuthSigner, type EscrowTierWindows, type EvidenceMode, EvidenceSkipped, FACILITATOR_ADDRESSES, type FacilitatorAddresses, KEEPALIVE_INTERVAL_MS, MAX_PROTOCOL_FEE_BPS, OPERATOR_FEE_BPS, type RecipientRole, SMA_WRAP_TARGETS, type SSEFrame, SSEParser, type SignRequestOptions, type SignRequestWithSignerOptions, type SignatureBaseParams, type SignatureHeaders, type SignatureParamsInput, SigningWalletAdapter, type StreamTrafficEventsOptions, type TrafficEvent, type TrafficEventKind, TrafficStreamError, VERIFIED_USDC_DOMAINS, ZERO_ADDRESS, anchorDigest, anchorEvidence, availableBackends, buildEscrowPreAuth, buildSignatureBase, buildSignatureParams, computeEscrowNonce, contentHash, createSignedFetch, delegateTarget, dereferencePointer, paymentId as dx402PaymentId, ed25519ToX25519, evidenceFromHeaders, evidenceHeader, fetchNonce, getFacilitatorAddress, isDelegated, isEndToEnd, matchesFilters, needsAccountWrap, parseEvidenceHeader, parseSealed, parseTrafficEvent, payerKeyFromEvmSignature, payerKeyFromSolanaAddress, recoverEvidence, replaySafeTypedData, resolveDelegation, rpcDelegationResolver, sealEvidence, sealEvidenceTo, sealedRoles, sellerDigestFor, signAnchorEd25519, signAnchorEvm, signRequest, signRequestWithSigner, signRequestWithWallet, streamTrafficEvents, unseal, wrapSignature };

package/dist/index.js

@@ -5038,6 +5038,7 @@ function buildSignatureParams(params) {
 }
 
 // src/escrow-preauth.ts
+init_chains();
 init_types();
 
 // src/erc7702.ts
@@ -5145,6 +5146,13 @@ var ESCROW_TIER_WINDOWS = {
 };
 var REVIEW_WINDOW_SEC = 7 * 24 * 3600;
 var REFUND_WINDOW_SEC = 7 * 24 * 3600;
+var VERIFIED_USDC_DOMAINS = Object.fromEntries(
+  ["arc", "arc-testnet"].map((network) => {
+    const chain = getChainByName(network);
+    if (!chain) throw new Error(`The chain registry has no '${network}'.`);
+    return [chain.chainId, { name: chain.usdc.name, version: chain.usdc.version }];
+  })
+);
 var REQUIRED_NETWORK_KEYS = [
   "chain_id",
   "operator",
@@ -5210,6 +5218,13 @@ async function buildEscrowPreAuth(wallet, params) {
       "INVALID_CONFIG"
     );
   }
+  const verified = VERIFIED_USDC_DOMAINS[cfg.chain_id];
+  if (verified && (cfg.usdc_domain_name !== verified.name || cfg.usdc_domain_version !== verified.version)) {
+    throw new exports.X402Error(
+      `The escrow config gives chain ${cfg.chain_id} the USDC domain '${cfg.usdc_domain_name}' / '${cfg.usdc_domain_version}', but the token's on-chain domain is '${verified.name}' / '${verified.version}' \u2014 refusing to sign an authorization that could never settle.`,
+      "INVALID_CONFIG"
+    );
+  }
   const maxAmount = BigInt(params.bountyAtomic);
   if (maxAmount <= 0n) {
     throw new exports.X402Error(
@@ -7118,6 +7133,28 @@ var ESCROW_TIMEOUT_MS = {
   143: 9e4
   // Monad: 90s
 };
+function arcUsdc(network) {
+  const chain = getChainByName(network);
+  if (!chain) throw new Error(`The chain registry has no '${network}'.`);
+  return chain.usdc;
+}
+({
+  // Monad
+  5042: arcUsdc("arc").name,
+  // Arc ('USDC', from src/chains)
+  5042002: arcUsdc("arc-testnet").name
+  // Arc Testnet ('USDC', from src/chains)
+});
+({
+  // Arc (chain 5042) - x402r canonical escrow, 'v3' operator
+  5042: {
+    usdc: arcUsdc("arc").address
+  },
+  // Arc Testnet (chain 5042002) - same canonical addresses as Arc
+  5042002: {
+    usdc: arcUsdc("arc-testnet").address
+  }
+});
 
 exports.AMBIGUOUS_LEASE_REASONS = AMBIGUOUS_LEASE_REASONS;
 exports.ANCHOR_MAX_REQUEST_BYTES = ANCHOR_MAX_REQUEST_BYTES;
@@ -7163,6 +7200,7 @@ exports.SETTLEMENT_UNCONFIRMED = SETTLEMENT_UNCONFIRMED;
 exports.SMA_WRAP_TARGETS = SMA_WRAP_TARGETS;
 exports.SSEParser = SSEParser;
 exports.TrafficStreamError = TrafficStreamError;
+exports.VERIFIED_USDC_DOMAINS = VERIFIED_USDC_DOMAINS;
 exports.WRITER_LEASE_REASONS = WRITER_LEASE_REASONS;
 exports.X402Client = X402Client;
 exports.X402_CORS_HEADERS = X402_CORS_HEADERS;