uvd-x402-sdk 2.97.0 → 2.99.0

package/README.md

@@ -19,7 +19,7 @@ Users sign a message or transaction, and the Ultravioleta facilitator handles on
 - **React & Wagmi**: First-class integrations
 - **Signing Wallet Adapters**: EnvKeyAdapter (server/CLI), OWSWalletAdapter (Open Wallet Standard), or bring your own
 - **ERC-8128 Signed Requests**: Authenticate HTTP requests with a wallet (RFC 9421 + EIP-191) — no API keys
-- **ERC-8004 Trustless Agents**: On-chain reputation and identity across 21 networks (19 EVM + 2 Solana)
+- **ERC-8004 Trustless Agents**: On-chain reputation and identity across 23 networks (21 EVM + 2 Solana)
 - **Escrow & Refunds**: Hold payments with dispute resolution
 - **Advanced Escrow**: Full escrow lifecycle (authorize, release, refund, charge) with SigningWalletAdapter support
 - **Escrow Pre-Auth**: Sign-on-assignment `X-Payment-Auth` builder (`buildEscrowPreAuth`) — vector-pinned parity with the Python SDK and Execution Market
@@ -1229,16 +1229,19 @@ response.
 
 ## ERC-8004 Trustless Agents
 
-Build verifiable on-chain reputation for AI agents and services. Supports **21 networks** (19 EVM + 2 Solana).
+Build verifiable on-chain reputation for AI agents and services. Supports **23 networks** (21 EVM + 2 Solana).
 
 > Name Base as `'base'`. The old `'base-mainnet'` spelling is rejected by the facilitator
 > (`400 Invalid network`); the SDK now rewrites it for you, but new code should use `'base'`.
 
 On EVM networks, agent IDs are sequential numbers. On Solana, agent IDs are base58 pubkey strings. The `AgentId` type (`number | string`) handles both.
 
-### EVM Networks (18)
+### EVM Networks (21)
 
-ethereum, base-mainnet, polygon, arbitrum, optimism, celo, bsc, monad, avalanche, skale-base, ethereum-sepolia, base-sepolia, polygon-amoy, arbitrum-sepolia, optimism-sepolia, celo-sepolia, avalanche-fuji, skale-base-sepolia
+ethereum, base, polygon, arbitrum, optimism, celo, bsc, monad, avalanche, scroll, skale-base, arc, ethereum-sepolia, base-sepolia, polygon-amoy, arbitrum-sepolia, optimism-sepolia, celo-sepolia, avalanche-fuji, skale-base-sepolia, arc-testnet
+
+Arc (`arc`, `arc-testnet`) since 2.98.0, with the canonical registries on both; see
+[ERC-8004 on Arc](docs/networks/arc.md#erc-8004-on-arc-2980).
 
 ### Solana Networks (2)
 
@@ -1356,14 +1359,16 @@ Pass the **same** feedback parameters, `deadline` and `nonce` back to
 registry calldata from them and refuses to relay anything the rater's signature
 does not cover.
 
-Available on the nine networks in `RELAYED_FEEDBACK_NETWORKS` -- the eight
+Available on the ten networks in `RELAYED_FEEDBACK_NETWORKS` -- the nine
 mainnets with a deployed `FeedbackDelegate` (base, ethereum, polygon, arbitrum,
-optimism, celo, bsc, monad) plus base-sepolia. **Avalanche is not one of them
+optimism, celo, bsc, monad, arc) plus base-sepolia. **Avalanche is not one of them
 and is not waiting to become one**: its C-Chain rejects the transaction type
 itself (`-32000 transaction type not supported`), so anchor the rating on a
 chain that supports EIP-7702 -- the payment stays where it was made.
+`arc-testnet` serves ERC-8004 reads but not this rail: no delegate is deployed
+there, and `prepare` answers 400.
 
-Requires facilitator v1.93.0+ for the mainnets; base-sepolia since v1.74.0.
+Requires facilitator v1.93.0+ for the mainnets (2.38.0+ for arc); base-sepolia since v1.74.0.
 
 ### The same thing on Solana, without a delegate
 
@@ -1488,7 +1493,7 @@ const state = await escrow.getEscrowState({
 
 Full escrow lifecycle management for EVM chains. Supports both `ethers.Signer` and `SigningWalletAdapter` (EnvKey, OWS) for signing.
 
-Supported on 10 EVM networks: Base, Base Sepolia, Ethereum, Ethereum Sepolia, Polygon, Arbitrum, Optimism, Celo, Monad, Avalanche.
+Supported on 10 EVM networks: Base, Base Sepolia, Ethereum, Ethereum Sepolia, Polygon, Arbitrum, Optimism, Celo, Monad, Avalanche. Since 2.99.0 also on Arc and Arc Testnet, on the x402r canonical escrow: there `release` sends `capture` and `refundInEscrow` sends `void`, which only returns the whole capturable amount. See [Escrow on Arc](docs/networks/arc.md#escrow-on-arc-2990).
 
 ### With Private Key (ethers.Signer)
 

package/dist/backend/index.d.mts

@@ -1,4 +1,4 @@
 import '../wallet-w7BnImDG.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';
 import '../index-BsKsZzP3.mjs';
-export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, ap as AdvancedAuthorizationResult, aq as AdvancedEscrowClient, ar as AdvancedEscrowClientOptions, as as AdvancedEscrowContracts, at as AdvancedEscrowTaskTier, au as AdvancedPaymentInfo, av as AdvancedTransactionResult, aw as AgentId, ax as AgentIdentity, ay as AgentRegistration, az as AgentRegistrationFile, aA as AgentService, aB as AtomStats, aC as BASE_MAINNET_CONTRACTS, aD as BazaarClient, aE as BazaarClientOptions, aF as BazaarDiscoverOptions, aG as BazaarDiscoverResponse, aH as BazaarRegisterOptions, aI as BazaarResource, aJ as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, aK as DEPOSIT_LIMIT_USDC, aL as DiscoveryAccepts, aM as DiscoveryCuration, aN as DiscoveryHealth, aO as DiscoveryHealthStatus, aP as DiscoveryListOptions, aQ as DiscoveryPagination, aR as DiscoveryRegisterOptions, aS as DiscoveryResource, aT as DiscoveryResponse, aU as DiscoverySource, aV as DiscoveryStats, aW as DiscoveryTier, aX as Dispute, aY as DisputeOutcome, aZ as ERC8004_CONTRACTS, a_ as ERC8004_EXTENSION_ID, a$ as ESCROW_CONTRACTS, b0 as ESCROW_TIMEOUT_MS, b1 as Erc8004Client, b2 as Erc8004ClientOptions, b3 as Erc8004LookupError, b4 as Erc8004Network, b5 as EscrowClient, b6 as EscrowClientOptions, b7 as EscrowPayment, b8 as EscrowStateResponse, b9 as EscrowStatus, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, ba as FeedbackEntry, bb as FeedbackParams, bc as FeedbackRequest, bd as FeedbackResponse, be as HEALTH_FILTERS, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, bf as IdentityByOwnerResponse, bg as IdentityMetadataResponse, bh as IdentityTotalSupplyResponse, bi as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, bj as MAX_SEARCH_LEN, bk as MetadataEntryParam, bl as OPERATOR_ABI, bm as OPERATOR_ABI_CREATE3, bn as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, bo as PaymentRequirementResolver, bp as PaymentRequirements, bq as PaymentRequirementsOptions, z as PaymentRequirementsV2, br as PrepareRelayFeedbackRequest, bs as PrepareRelayFeedbackResponse, bt as PrepareRelayResponseRequest, bu as PrepareSolanaFeedbackRequest, bv as PrepareSolanaFeedbackResponse, bw as ProofOfPayment, R as RECEIPT_REQUEST_CONFLICT, bx as RELAYED_FEEDBACK_NETWORKS, C as REPLAYABLE_LEASE_REASONS, by as RefundRequest, bz as RefundStatus, bA as RegisterAgentRequest, bB as RegisterAgentResponse, bC as RegisterJobResponse, bD as RegisterJobStatus, bE as RegistrationPendingError, bF as RelayAuthorizationParams, bG as ReputationResponse, bH as ReputationSummary, bI as RequestRefundOptions, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bJ as SOLANA_FEEDBACK_NETWORKS, bK as SettleRequest, G as SettleRequestV2, J as SettleResponse, bL as SettleResponseWithProof, bM as SubmitRelayFeedbackRequest, bN as SubmitRelayResponseRequest, bO as SubmitSolanaFeedbackRequest, bP as TIER_FILTERS, bQ as TIER_TIMINGS, bR as USDC_DOMAIN_NAME, bS as UnavailableBody, bT as UnavailableResponse, V as VerifiedPaymentState, bU as VerifyRequest, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, bV as ZERO_ADDRESS, bW as buildErc8004PaymentRequirements, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, bX as buildUnavailableResponse, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, bY as canRefundEscrow, bZ as canReleaseEscrow, b_ as carryFailureFields, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, b$ as epochToDate, c0 as escrowTimeRemaining, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, c1 as getEscrowContractsByChainId, c2 as getEscrowSupportedChainIds, c3 as isAlive, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, c4 as isEscrowExpired, c5 as isEscrowSupportedOnChain, c6 as isRegisterJobTerminal, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ai as parseFacilitatorErrorBody, c7 as parsePaymentHeader, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, c8 as supportsRelayedFeedback, c9 as supportsSolanaFeedback, am as toPaymentRequirementsV2, an as toResourceInfoV2, ca as wireNetwork } from '../index-ClOAmprt.mjs';
+export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, ap as AdvancedAuthorizationResult, aq as AdvancedEscrowClient, ar as AdvancedEscrowClientOptions, as as AdvancedEscrowContracts, at as AdvancedEscrowTaskTier, au as AdvancedPaymentInfo, av as AdvancedTransactionResult, aw as AgentId, ax as AgentIdentity, ay as AgentRegistration, az as AgentRegistrationFile, aA as AgentService, aB as AtomStats, aC as BASE_MAINNET_CONTRACTS, aD as BazaarClient, aE as BazaarClientOptions, aF as BazaarDiscoverOptions, aG as BazaarDiscoverResponse, aH as BazaarRegisterOptions, aI as BazaarResource, aJ as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, aK as DEPOSIT_LIMIT_USDC, aL as DiscoveryAccepts, aM as DiscoveryCuration, aN as DiscoveryHealth, aO as DiscoveryHealthStatus, aP as DiscoveryListOptions, aQ as DiscoveryPagination, aR as DiscoveryRegisterOptions, aS as DiscoveryResource, aT as DiscoveryResponse, aU as DiscoverySource, aV as DiscoveryStats, aW as DiscoveryTier, aX as Dispute, aY as DisputeOutcome, aZ as ERC8004_CONTRACTS, a_ as ERC8004_EXTENSION_ID, a$ as ESCROW_CONTRACTS, b0 as ESCROW_NOTHING_TO_VOID, b1 as ESCROW_OPERATOR_GENERATION, b2 as ESCROW_OPERATOR_NOT_DEPLOYED, b3 as ESCROW_TIMEOUT_MS, b4 as ESCROW_UNSUPPORTED_ON_GENERATION, b5 as ESCROW_VOID_AMOUNT_MISMATCH, b6 as Erc8004Client, b7 as Erc8004ClientOptions, b8 as Erc8004LookupError, b9 as Erc8004Network, ba as EscrowClient, bb as EscrowClientOptions, bc as EscrowOperatorGeneration, bd as EscrowPayment, be as EscrowStateResponse, bf as EscrowStatus, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, bg as FeedbackEntry, bh as FeedbackParams, bi as FeedbackRequest, bj as FeedbackResponse, bk as HEALTH_FILTERS, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, bl as IdentityByOwnerResponse, bm as IdentityMetadataResponse, bn as IdentityTotalSupplyResponse, bo as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, bp as MAX_SEARCH_LEN, bq as MetadataEntryParam, br as OPERATOR_ABI, bs as OPERATOR_ABI_CREATE3, bt as OPERATOR_ABI_V3, bu as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, bv as PaymentRequirementResolver, bw as PaymentRequirements, bx as PaymentRequirementsOptions, z as PaymentRequirementsV2, by as PrepareRelayFeedbackRequest, bz as PrepareRelayFeedbackResponse, bA as PrepareRelayResponseRequest, bB as PrepareSolanaFeedbackRequest, bC as PrepareSolanaFeedbackResponse, bD as ProofOfPayment, R as RECEIPT_REQUEST_CONFLICT, bE as RELAYED_FEEDBACK_NETWORKS, C as REPLAYABLE_LEASE_REASONS, bF as RefundRequest, bG as RefundStatus, bH as RegisterAgentRequest, bI as RegisterAgentResponse, bJ as RegisterJobResponse, bK as RegisterJobStatus, bL as RegistrationPendingError, bM as RelayAuthorizationParams, bN as ReputationResponse, bO as ReputationSummary, bP as RequestRefundOptions, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bQ as SOLANA_FEEDBACK_NETWORKS, bR as SettleRequest, G as SettleRequestV2, J as SettleResponse, bS as SettleResponseWithProof, bT as SubmitRelayFeedbackRequest, bU as SubmitRelayResponseRequest, bV as SubmitSolanaFeedbackRequest, bW as TIER_FILTERS, bX as TIER_TIMINGS, bY as USDC_DOMAIN_NAME, bZ as UnavailableBody, b_ as UnavailableResponse, V as VerifiedPaymentState, b$ as VerifyRequest, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, c0 as ZERO_ADDRESS, c1 as buildErc8004PaymentRequirements, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, c2 as buildUnavailableResponse, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, c3 as canRefundEscrow, c4 as canReleaseEscrow, c5 as carryFailureFields, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, c6 as epochToDate, c7 as escrowTimeRemaining, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, c8 as getEscrowContractsByChainId, c9 as getEscrowOperatorGeneration, ca as getEscrowSupportedChainIds, cb as isAlive, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, cc as isEscrowExpired, cd as isEscrowSupportedOnChain, ce as isRegisterJobTerminal, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ai as parseFacilitatorErrorBody, cf as parsePaymentHeader, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, cg as supportsRelayedFeedback, ch as supportsSolanaFeedback, am as toPaymentRequirementsV2, an as toResourceInfoV2, ci as wireNetwork } from '../index-SaqboHsK.mjs';

package/dist/backend/index.d.ts

@@ -1,4 +1,4 @@
 import '../wallet-w7BnImDG.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';
 import '../index-BsKsZzP3.js';
-export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, ap as AdvancedAuthorizationResult, aq as AdvancedEscrowClient, ar as AdvancedEscrowClientOptions, as as AdvancedEscrowContracts, at as AdvancedEscrowTaskTier, au as AdvancedPaymentInfo, av as AdvancedTransactionResult, aw as AgentId, ax as AgentIdentity, ay as AgentRegistration, az as AgentRegistrationFile, aA as AgentService, aB as AtomStats, aC as BASE_MAINNET_CONTRACTS, aD as BazaarClient, aE as BazaarClientOptions, aF as BazaarDiscoverOptions, aG as BazaarDiscoverResponse, aH as BazaarRegisterOptions, aI as BazaarResource, aJ as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, aK as DEPOSIT_LIMIT_USDC, aL as DiscoveryAccepts, aM as DiscoveryCuration, aN as DiscoveryHealth, aO as DiscoveryHealthStatus, aP as DiscoveryListOptions, aQ as DiscoveryPagination, aR as DiscoveryRegisterOptions, aS as DiscoveryResource, aT as DiscoveryResponse, aU as DiscoverySource, aV as DiscoveryStats, aW as DiscoveryTier, aX as Dispute, aY as DisputeOutcome, aZ as ERC8004_CONTRACTS, a_ as ERC8004_EXTENSION_ID, a$ as ESCROW_CONTRACTS, b0 as ESCROW_TIMEOUT_MS, b1 as Erc8004Client, b2 as Erc8004ClientOptions, b3 as Erc8004LookupError, b4 as Erc8004Network, b5 as EscrowClient, b6 as EscrowClientOptions, b7 as EscrowPayment, b8 as EscrowStateResponse, b9 as EscrowStatus, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, ba as FeedbackEntry, bb as FeedbackParams, bc as FeedbackRequest, bd as FeedbackResponse, be as HEALTH_FILTERS, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, bf as IdentityByOwnerResponse, bg as IdentityMetadataResponse, bh as IdentityTotalSupplyResponse, bi as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, bj as MAX_SEARCH_LEN, bk as MetadataEntryParam, bl as OPERATOR_ABI, bm as OPERATOR_ABI_CREATE3, bn as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, bo as PaymentRequirementResolver, bp as PaymentRequirements, bq as PaymentRequirementsOptions, z as PaymentRequirementsV2, br as PrepareRelayFeedbackRequest, bs as PrepareRelayFeedbackResponse, bt as PrepareRelayResponseRequest, bu as PrepareSolanaFeedbackRequest, bv as PrepareSolanaFeedbackResponse, bw as ProofOfPayment, R as RECEIPT_REQUEST_CONFLICT, bx as RELAYED_FEEDBACK_NETWORKS, C as REPLAYABLE_LEASE_REASONS, by as RefundRequest, bz as RefundStatus, bA as RegisterAgentRequest, bB as RegisterAgentResponse, bC as RegisterJobResponse, bD as RegisterJobStatus, bE as RegistrationPendingError, bF as RelayAuthorizationParams, bG as ReputationResponse, bH as ReputationSummary, bI as RequestRefundOptions, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bJ as SOLANA_FEEDBACK_NETWORKS, bK as SettleRequest, G as SettleRequestV2, J as SettleResponse, bL as SettleResponseWithProof, bM as SubmitRelayFeedbackRequest, bN as SubmitRelayResponseRequest, bO as SubmitSolanaFeedbackRequest, bP as TIER_FILTERS, bQ as TIER_TIMINGS, bR as USDC_DOMAIN_NAME, bS as UnavailableBody, bT as UnavailableResponse, V as VerifiedPaymentState, bU as VerifyRequest, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, bV as ZERO_ADDRESS, bW as buildErc8004PaymentRequirements, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, bX as buildUnavailableResponse, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, bY as canRefundEscrow, bZ as canReleaseEscrow, b_ as carryFailureFields, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, b$ as epochToDate, c0 as escrowTimeRemaining, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, c1 as getEscrowContractsByChainId, c2 as getEscrowSupportedChainIds, c3 as isAlive, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, c4 as isEscrowExpired, c5 as isEscrowSupportedOnChain, c6 as isRegisterJobTerminal, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ai as parseFacilitatorErrorBody, c7 as parsePaymentHeader, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, c8 as supportsRelayedFeedback, c9 as supportsSolanaFeedback, am as toPaymentRequirementsV2, an as toResourceInfoV2, ca as wireNetwork } from '../index-DNTFp6WT.js';
+export { A as AMBIGUOUS_LEASE_REASONS, a as AUTHORIZATION_ALREADY_SETTLED, b as AUTHORIZATION_IN_FLIGHT, c as AdmittedAuthorizationCode, ap as AdvancedAuthorizationResult, aq as AdvancedEscrowClient, ar as AdvancedEscrowClientOptions, as as AdvancedEscrowContracts, at as AdvancedEscrowTaskTier, au as AdvancedPaymentInfo, av as AdvancedTransactionResult, aw as AgentId, ax as AgentIdentity, ay as AgentRegistration, az as AgentRegistrationFile, aA as AgentService, aB as AtomStats, aC as BASE_MAINNET_CONTRACTS, aD as BazaarClient, aE as BazaarClientOptions, aF as BazaarDiscoverOptions, aG as BazaarDiscoverResponse, aH as BazaarRegisterOptions, aI as BazaarResource, aJ as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, d as DEFAULT_RETRY_AFTER_SECONDS, aK as DEPOSIT_LIMIT_USDC, aL as DiscoveryAccepts, aM as DiscoveryCuration, aN as DiscoveryHealth, aO as DiscoveryHealthStatus, aP as DiscoveryListOptions, aQ as DiscoveryPagination, aR as DiscoveryRegisterOptions, aS as DiscoveryResource, aT as DiscoveryResponse, aU as DiscoverySource, aV as DiscoveryStats, aW as DiscoveryTier, aX as Dispute, aY as DisputeOutcome, aZ as ERC8004_CONTRACTS, a_ as ERC8004_EXTENSION_ID, a$ as ESCROW_CONTRACTS, b0 as ESCROW_NOTHING_TO_VOID, b1 as ESCROW_OPERATOR_GENERATION, b2 as ESCROW_OPERATOR_NOT_DEPLOYED, b3 as ESCROW_TIMEOUT_MS, b4 as ESCROW_UNSUPPORTED_ON_GENERATION, b5 as ESCROW_VOID_AMOUNT_MISMATCH, b6 as Erc8004Client, b7 as Erc8004ClientOptions, b8 as Erc8004LookupError, b9 as Erc8004Network, ba as EscrowClient, bb as EscrowClientOptions, bc as EscrowOperatorGeneration, bd as EscrowPayment, be as EscrowStateResponse, bf as EscrowStatus, F as FacilitatorCallOptions, e as FacilitatorClient, f as FacilitatorClientOptions, g as FacilitatorErrorInfo, h as FacilitatorFailureFields, i as FacilitatorFetchOptions, bg as FeedbackEntry, bh as FeedbackParams, bi as FeedbackRequest, bj as FeedbackResponse, bk as HEALTH_FILTERS, H as HonoMiddlewareOptions, I as IDEMPOTENCY_KEY_HEADER, j as IDEMPOTENT_REPLAYED_HEADER, bl as IdentityByOwnerResponse, bm as IdentityMetadataResponse, bn as IdentityTotalSupplyResponse, bo as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, bp as MAX_SEARCH_LEN, bq as MetadataEntryParam, br as OPERATOR_ABI, bs as OPERATOR_ABI_CREATE3, bt as OPERATOR_ABI_V3, bu as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, v as PaymentAcceptance, w as PaymentConflictResponse, x as PaymentMiddlewareOptions, y as PaymentPayloadV2, bv as PaymentRequirementResolver, bw as PaymentRequirements, bx as PaymentRequirementsOptions, z as PaymentRequirementsV2, by as PrepareRelayFeedbackRequest, bz as PrepareRelayFeedbackResponse, bA as PrepareRelayResponseRequest, bB as PrepareSolanaFeedbackRequest, bC as PrepareSolanaFeedbackResponse, bD as ProofOfPayment, R as RECEIPT_REQUEST_CONFLICT, bE as RELAYED_FEEDBACK_NETWORKS, C as REPLAYABLE_LEASE_REASONS, bF as RefundRequest, bG as RefundStatus, bH as RegisterAgentRequest, bI as RegisterAgentResponse, bJ as RegisterJobResponse, bK as RegisterJobStatus, bL as RegistrationPendingError, bM as RelayAuthorizationParams, bN as ReputationResponse, bO as ReputationSummary, bP as RequestRefundOptions, E as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bQ as SOLANA_FEEDBACK_NETWORKS, bR as SettleRequest, G as SettleRequestV2, J as SettleResponse, bS as SettleResponseWithProof, bT as SubmitRelayFeedbackRequest, bU as SubmitRelayResponseRequest, bV as SubmitSolanaFeedbackRequest, bW as TIER_FILTERS, bX as TIER_TIMINGS, bY as USDC_DOMAIN_NAME, bZ as UnavailableBody, b_ as UnavailableResponse, V as VerifiedPaymentState, b$ as VerifyRequest, K as VerifyRequestV2, N as VerifyResponse, W as WRITER_LEASE_REASONS, Q as WriterLeaseReason, X as X402_CORS_HEADERS, T as X402_HEADER_NAMES, c0 as ZERO_ADDRESS, c1 as buildErc8004PaymentRequirements, Z as buildPaymentConflictResponse, _ as buildPaymentRequirements, $ as buildSettleRequest, a0 as buildSettleRequestForVersion, a1 as buildSettleRequestV2, c2 as buildUnavailableResponse, a2 as buildVerifyRequest, a3 as buildVerifyRequestForVersion, a4 as buildVerifyRequestV2, c3 as canRefundEscrow, c4 as canReleaseEscrow, c5 as carryFailureFields, a5 as create402Response, a6 as createHonoMiddleware, a7 as createIdempotencyKey, a8 as createPaymentMiddleware, c6 as epochToDate, c7 as escrowTimeRemaining, a9 as extractPaymentFromHeaders, aa as facilitatorFetch, ab as getCorsHeaders, c8 as getEscrowContractsByChainId, c9 as getEscrowOperatorGeneration, ca as getEscrowSupportedChainIds, cb as isAlive, ac as isAmbiguousLeaseReason, ad as isAuthorizationAlreadyUsed, ae as isAuthorizationInFlight, cc as isEscrowExpired, cd as isEscrowSupportedOnChain, ce as isRegisterJobTerminal, af as isReplayableLeaseReason, ag as isSettlementUnconfirmed, ai as parseFacilitatorErrorBody, cf as parsePaymentHeader, aj as parseRetryAfterSeconds, ak as readFacilitatorError, al as resolveEnvelopeVersion, cg as supportsRelayedFeedback, ch as supportsSolanaFeedback, am as toPaymentRequirementsV2, an as toResourceInfoV2, ci as wireNetwork } from '../index-BiL4seGs.js';

package/dist/backend/index.js

@@ -1521,6 +1521,13 @@ var DEFAULT_MIN_FEE_BPS = 0;
 var DEFAULT_MAX_FEE_BPS = OPERATOR_FEE_BPS + MAX_PROTOCOL_FEE_BPS;
 var REVIEW_WINDOW_SEC = 7 * 24 * 3600;
 var REFUND_WINDOW_SEC = 7 * 24 * 3600;
+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 LIFECYCLE_DOMAIN_NAME = "x402 escrow lifecycle";
 var LIFECYCLE_DOMAIN_VERSION = "1";
 var LIFECYCLE_MAX_DEADLINE_SECS = 900;
@@ -3679,7 +3686,7 @@ var TESTNET_VALIDATION = "0x8004Cb1BF31DAf7788923b405b754f57acEB4272";
 var SOLANA_AGENT_REGISTRY = "8oo4dC4JvBLwy5tGgiH3WwK4B9PWxL9Z4XjA2jzkQMbQ";
 var SOLANA_ATOM_ENGINE = "AToMw53aiPQ8j7iHVb4fGt6nzUNxUhcPc3tbPBZuzVVb";
 var ERC8004_CONTRACTS = {
-  // Mainnets (11)
+  // Mainnets (12)
   ethereum: {
     identityRegistry: MAINNET_IDENTITY,
     reputationRegistry: MAINNET_REPUTATION,
@@ -3736,13 +3743,22 @@ var ERC8004_CONTRACTS = {
     identityRegistry: MAINNET_IDENTITY,
     reputationRegistry: MAINNET_REPUTATION
   },
+  // Arc (Circle, chain 5042). The facilitator names these three in
+  // ARC_MAINNET_CONTRACTS (x402-rs 2.37.0+). Read on 2026-09-23 against
+  // rpc.mainnet.arc.io: each is a 130-byte EIP-1967 proxy whose implementation
+  // is the one Base runs, and getVersion() answers 2.0.0.
+  arc: {
+    identityRegistry: MAINNET_IDENTITY,
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
+  },
   // Deprecated alias for 'base' -- kept so existing lookups keep resolving.
   "base-mainnet": {
     identityRegistry: MAINNET_IDENTITY,
     reputationRegistry: MAINNET_REPUTATION,
     validationRegistry: MAINNET_VALIDATION
   },
-  // Testnets (8)
+  // Testnets (9)
   "ethereum-sepolia": {
     identityRegistry: TESTNET_IDENTITY,
     reputationRegistry: TESTNET_REPUTATION,
@@ -3783,6 +3799,15 @@ var ERC8004_CONTRACTS = {
     reputationRegistry: TESTNET_REPUTATION,
     validationRegistry: TESTNET_VALIDATION
   },
+  // Arc testnet (chain 5042002), ARC_TESTNET_CONTRACTS in the facilitator. Read
+  // on 2026-09-23 against rpc.testnet.arc.io and rpc.testnet.arc.network: the
+  // proxies Base Sepolia runs, validation registry included. Reads only -- no
+  // FeedbackDelegate is deployed here, so it is not in RELAYED_FEEDBACK_NETWORKS.
+  "arc-testnet": {
+    identityRegistry: TESTNET_IDENTITY,
+    reputationRegistry: TESTNET_REPUTATION,
+    validationRegistry: TESTNET_VALIDATION
+  },
   // Solana (2) - uses QuantuLabs 8004-solana Anchor program + ATOM Engine
   solana: {
     agentRegistryProgram: SOLANA_AGENT_REGISTRY,
@@ -3805,6 +3830,7 @@ var RELAYED_FEEDBACK_NETWORKS = [
   "celo",
   "bsc",
   "monad",
+  "arc",
   "base-sepolia"
 ];
 function supportsRelayedFeedback(network) {
@@ -4923,6 +4949,11 @@ var ESCROW_TIMEOUT_MS = {
   // Monad: 90s
 };
 var DEFAULT_ESCROW_TIMEOUT_MS = 3e4;
+function arcUsdc(network) {
+  const chain = getChainByName(network);
+  if (!chain) throw new Error(`The chain registry has no '${network}'.`);
+  return chain.usdc;
+}
 var USDC_DOMAIN_NAME = {
   8453: "USD Coin",
   // Base Mainnet
@@ -4940,8 +4971,12 @@ var USDC_DOMAIN_NAME = {
   // Avalanche
   42220: "USDC",
   // Celo
-  143: "USDC"
+  143: "USDC",
   // Monad
+  5042: arcUsdc("arc").name,
+  // Arc ('USDC', from src/chains)
+  5042002: arcUsdc("arc-testnet").name
+  // Arc Testnet ('USDC', from src/chains)
 };
 var ESCROW_CONTRACTS = {
   // Base Sepolia (testnet, chain 84532)
@@ -5042,6 +5077,24 @@ var ESCROW_CONTRACTS = {
     protocolFeeConfig: "0xf62788834C99B2E85a6891C0b46D1EB996f8f596",
     refundRequest: "0x69e9BF2b40Ed472b55E47e9D4205d93Ed673093F",
     usdc: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
+  },
+  // Arc (chain 5042) - x402r canonical escrow, 'v3' operator
+  5042: {
+    operator: "0x0258472A1410Ac3Ad720f1BC83f22B3c0af1Fd9D",
+    escrow: "0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff",
+    tokenCollector: "0x0E3dF9510de65469C4518D7843919c0b8C7A7757",
+    protocolFeeConfig: "0xBe2d24614F339a1eB103A399F93AA2a39Ca815Bc",
+    refundRequest: "0xe971C674fD5c3462023f3F891dF6289DFbC9CEFC",
+    usdc: arcUsdc("arc").address
+  },
+  // Arc Testnet (chain 5042002) - same canonical addresses as Arc
+  5042002: {
+    operator: "0x0258472A1410Ac3Ad720f1BC83f22B3c0af1Fd9D",
+    escrow: "0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff",
+    tokenCollector: "0x0E3dF9510de65469C4518D7843919c0b8C7A7757",
+    protocolFeeConfig: "0xBe2d24614F339a1eB103A399F93AA2a39Ca815Bc",
+    refundRequest: "0xe971C674fD5c3462023f3F891dF6289DFbC9CEFC",
+    usdc: arcUsdc("arc-testnet").address
   }
 };
 var BASE_MAINNET_CONTRACTS = ESCROW_CONTRACTS[8453];
@@ -5091,7 +5144,56 @@ var OPERATOR_ABI_CREATE3 = [
   "function charge(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint256 amount, address tokenCollector, bytes collectorData)",
   "function refundPostEscrow(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint256 amount, address tokenCollector, bytes collectorData)"
 ];
-var CREATE3_CHAIN_IDS = /* @__PURE__ */ new Set([1187947933]);
+var OPERATOR_ABI_V3 = [
+  "function capture(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint256 amount, bytes data)",
+  "function void(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, bytes data)",
+  "function refund(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint256 amount, address tokenCollector, bytes collectorData)",
+  "function FEE_RECEIVER() view returns (address)",
+  "function AUTHORIZE_PRE_ACTION_CONDITION() view returns (address)",
+  "function CHARGE_PRE_ACTION_CONDITION() view returns (address)",
+  "function CAPTURE_PRE_ACTION_CONDITION() view returns (address)",
+  "function VOID_PRE_ACTION_CONDITION() view returns (address)",
+  "function REFUND_PRE_ACTION_CONDITION() view returns (address)"
+];
+var AUTH_CAPTURE_ESCROW_STATE_ABI = [
+  "function getHash(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo) view returns (bytes32)",
+  "function paymentState(bytes32 paymentInfoHash) view returns (bool hasCollectedPayment, uint120 capturableAmount, uint120 refundableAmount)"
+];
+var ESCROW_VOID_AMOUNT_MISMATCH = "escrow_void_amount_mismatch";
+var ESCROW_NOTHING_TO_VOID = "escrow_nothing_to_void";
+var ESCROW_OPERATOR_NOT_DEPLOYED = "escrow_operator_not_deployed";
+var ESCROW_UNSUPPORTED_ON_GENERATION = "escrow_unsupported_on_generation";
+var ESCROW_OPERATOR_GENERATION = {
+  84532: "v1",
+  // Base Sepolia
+  8453: "v1",
+  // Base
+  11155111: "v1",
+  // Ethereum Sepolia
+  1: "v1",
+  // Ethereum
+  137: "v1",
+  // Polygon
+  42161: "v1",
+  // Arbitrum
+  42220: "v1",
+  // Celo
+  143: "v1",
+  // Monad
+  43114: "v1",
+  // Avalanche
+  10: "v1",
+  // Optimism
+  1187947933: "v2",
+  // SKALE Base
+  5042: "v3",
+  // Arc
+  5042002: "v3"
+  // Arc Testnet
+};
+function getEscrowOperatorGeneration(chainId) {
+  return ESCROW_OPERATOR_GENERATION[chainId] ?? "v1";
+}
 var AdvancedEscrowClient = class {
   facilitatorUrl;
   chainId;
@@ -5397,6 +5499,10 @@ var AdvancedEscrowClient = class {
    *
    * 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)
    */
@@ -5404,10 +5510,14 @@ var AdvancedEscrowClient = class {
     if (!this.payerAddress) await this.init();
     try {
       const { ethers: ethers4 } = await import('ethers');
-      const isCreate3 = CREATE3_CHAIN_IDS.has(this.chainId);
+      const generation = getEscrowOperatorGeneration(this.chainId);
+      const isCreate3 = generation === "v2";
       const abi = isCreate3 ? OPERATOR_ABI_CREATE3 : OPERATOR_ABI;
       const amt = amount || paymentInfo.maxAmount;
       const tuple = this.buildTuple(paymentInfo);
+      if (generation === "v3") {
+        return await this.sendV3OperatorCall(ethers4, this.v3Provider(ethers4), "capture", [tuple, amt, "0x"]);
+      }
       if (this.walletAdapter) {
         return this.sendViaAdapter(ethers4, abi, (iface) => {
           return isCreate3 ? iface.encodeFunctionData("release", [tuple, amt, "0x"]) : iface.encodeFunctionData("release", [tuple, amt]);
@@ -5431,6 +5541,16 @@ var AdvancedEscrowClient = class {
    *
    * 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)
    */
@@ -5438,10 +5558,14 @@ var AdvancedEscrowClient = class {
     if (!this.payerAddress) await this.init();
     try {
       const { ethers: ethers4 } = await import('ethers');
-      const isCreate3 = CREATE3_CHAIN_IDS.has(this.chainId);
+      const generation = getEscrowOperatorGeneration(this.chainId);
+      const isCreate3 = generation === "v2";
       const abi = isCreate3 ? OPERATOR_ABI_CREATE3 : OPERATOR_ABI;
       const amt = amount || paymentInfo.maxAmount;
       const tuple = this.buildTuple(paymentInfo);
+      if (generation === "v3") {
+        return await this.voidWholeCapturable(ethers4, tuple, amt);
+      }
       if (this.walletAdapter) {
         return this.sendViaAdapter(ethers4, abi, (iface) => {
           return isCreate3 ? iface.encodeFunctionData("refundInEscrow", [tuple, amt, "0x"]) : iface.encodeFunctionData("refundInEscrow", [tuple, amt]);
@@ -5776,10 +5900,15 @@ var AdvancedEscrowClient = class {
    * 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)
    */
   async charge(paymentInfo, amount) {
+    const unsupported = this.unsupportedOnV3("charge");
+    if (unsupported) return unsupported;
     if (!this.payerAddress) await this.init();
     try {
       const { ethers: ethers4 } = await import('ethers');
@@ -5840,6 +5969,11 @@ var AdvancedEscrowClient = class {
    *
    * 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
@@ -5851,6 +5985,14 @@ var AdvancedEscrowClient = class {
       const { ethers: ethers4 } = await import('ethers');
       const amt = amount || paymentInfo.maxAmount;
       const tuple = this.buildTuple(paymentInfo);
+      if (getEscrowOperatorGeneration(this.chainId) === "v3") {
+        return await this.sendV3OperatorCall(ethers4, this.v3Provider(ethers4), "refund", [
+          tuple,
+          amt,
+          tokenCollector || ZERO_ADDRESS,
+          collectorData || "0x"
+        ]);
+      }
       if (this.walletAdapter) {
         return this.sendViaAdapter(ethers4, OPERATOR_ABI, (iface) => {
           return iface.encodeFunctionData("refundPostEscrow", [
@@ -5881,6 +6023,89 @@ var AdvancedEscrowClient = class {
     }
   }
   // ==========================================================================
+  // INTERNAL: 'v3' operator (Arc, Arc Testnet)
+  // ==========================================================================
+  /** The refusal of a call a 'v3' operator does not have, or null elsewhere. */
+  unsupportedOnV3(method) {
+    if (getEscrowOperatorGeneration(this.chainId) !== "v3") return null;
+    return {
+      success: false,
+      errorCode: ESCROW_UNSUPPORTED_ON_GENERATION,
+      error: `${method} is not available on the v3 escrow operator of chain ${this.chainId} (OPERATOR_ABI_V3). Nothing was signed or sent.`
+    };
+  }
+  /** The provider a 'v3' call reads with before it sends anything. */
+  v3Provider(ethersModule) {
+    const provider = this.walletAdapter ? new ethersModule.JsonRpcProvider(this.rpcUrl) : this.signer?.provider;
+    if (!provider) {
+      throw new Error(
+        `AdvancedEscrowClient: chain ${this.chainId} uses a v3 escrow operator, which is read on-chain before any call; the signer has no provider to read with.`
+      );
+    }
+    return provider;
+  }
+  /**
+   * 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.
+   */
+  async sendV3OperatorCall(ethersModule, provider, method, args) {
+    const code = await provider.getCode(this.contracts.operator);
+    if (!code || code === "0x") {
+      return {
+        success: false,
+        errorCode: ESCROW_OPERATOR_NOT_DEPLOYED,
+        error: `The escrow operator ${this.contracts.operator} has no code on chain ${this.chainId}. Nothing was sent.`
+      };
+    }
+    if (this.walletAdapter) {
+      return await this.sendViaAdapter(
+        ethersModule,
+        OPERATOR_ABI_V3,
+        (iface) => iface.encodeFunctionData(method, args)
+      );
+    }
+    const contract = new ethersModule.Contract(this.contracts.operator, OPERATOR_ABI_V3, this.signer);
+    const tx = await contract.getFunction(method)(...args, { gasLimit: this.gasLimit });
+    const receipt = await tx.wait();
+    return {
+      success: receipt.status === 1,
+      transactionHash: receipt.hash,
+      gasUsed: Number(receipt.gasUsed),
+      error: receipt.status !== 1 ? "Transaction reverted" : void 0
+    };
+  }
+  /**
+   * `refundInEscrow` on a 'v3' operator: `void` returns the whole capturable
+   * amount, so it is sent only when that is exactly what was asked for.
+   */
+  async voidWholeCapturable(ethersModule, tuple, amount) {
+    const requested = BigInt(amount);
+    if (requested <= 0n) {
+      return { success: false, error: `refundInEscrow amount must be positive, got ${amount}. Nothing was sent.` };
+    }
+    const provider = this.v3Provider(ethersModule);
+    const escrow = new ethersModule.Contract(this.contracts.escrow, AUTH_CAPTURE_ESCROW_STATE_ABI, provider);
+    const paymentInfoHash = await escrow.getHash(tuple);
+    const [, capturable] = await escrow.paymentState(paymentInfoHash);
+    const capturableAmount = BigInt(capturable);
+    if (capturableAmount === 0n) {
+      return {
+        success: false,
+        errorCode: ESCROW_NOTHING_TO_VOID,
+        error: `Nothing to void on chain ${this.chainId}: capturableAmount is 0 for payment ${paymentInfoHash}. Nothing was sent.`
+      };
+    }
+    if (requested !== capturableAmount) {
+      return {
+        success: false,
+        errorCode: ESCROW_VOID_AMOUNT_MISMATCH,
+        error: `refundInEscrow asked for ${requested} but the v3 operator's void() returns the whole capturableAmount, ${capturableAmount}. Pass ${capturableAmount}, or release the part the receiver keeps first. Nothing was sent.`
+      };
+    }
+    return await this.sendV3OperatorCall(ethersModule, provider, "void", [tuple, "0x"]);
+  }
+  // ==========================================================================
   // INTERNAL: Adapter-based transaction signing and broadcast
   // ==========================================================================
   /**
@@ -5936,7 +6161,12 @@ exports.DEPOSIT_LIMIT_USDC = DEPOSIT_LIMIT_USDC;
 exports.ERC8004_CONTRACTS = ERC8004_CONTRACTS;
 exports.ERC8004_EXTENSION_ID = ERC8004_EXTENSION_ID;
 exports.ESCROW_CONTRACTS = ESCROW_CONTRACTS;
+exports.ESCROW_NOTHING_TO_VOID = ESCROW_NOTHING_TO_VOID;
+exports.ESCROW_OPERATOR_GENERATION = ESCROW_OPERATOR_GENERATION;
+exports.ESCROW_OPERATOR_NOT_DEPLOYED = ESCROW_OPERATOR_NOT_DEPLOYED;
 exports.ESCROW_TIMEOUT_MS = ESCROW_TIMEOUT_MS;
+exports.ESCROW_UNSUPPORTED_ON_GENERATION = ESCROW_UNSUPPORTED_ON_GENERATION;
+exports.ESCROW_VOID_AMOUNT_MISMATCH = ESCROW_VOID_AMOUNT_MISMATCH;
 exports.Erc8004Client = Erc8004Client;
 exports.Erc8004LookupError = Erc8004LookupError;
 exports.EscrowClient = EscrowClient;
@@ -5948,6 +6178,7 @@ exports.MAX_RETRY_AFTER_SECONDS = MAX_RETRY_AFTER_SECONDS;
 exports.MAX_SEARCH_LEN = MAX_SEARCH_LEN;
 exports.OPERATOR_ABI = OPERATOR_ABI;
 exports.OPERATOR_ABI_CREATE3 = OPERATOR_ABI_CREATE3;
+exports.OPERATOR_ABI_V3 = OPERATOR_ABI_V3;
 exports.PAYMENT_INFO_TYPEHASH = PAYMENT_INFO_TYPEHASH;
 exports.RECEIPT_ISSUER = RECEIPT_ISSUER;
 exports.RECEIPT_REQUEST_CONFLICT = RECEIPT_REQUEST_CONFLICT;
@@ -5989,6 +6220,7 @@ exports.facilitatorFetch = facilitatorFetch;
 exports.fetchWithReceipt = fetchWithReceipt;
 exports.getCorsHeaders = getCorsHeaders;
 exports.getEscrowContractsByChainId = getEscrowContractsByChainId;
+exports.getEscrowOperatorGeneration = getEscrowOperatorGeneration;
 exports.getEscrowSupportedChainIds = getEscrowSupportedChainIds;
 exports.getFacilitatorReceipt = getFacilitatorReceipt;
 exports.isAlive = isAlive;