uvd-x402-sdk 2.98.0 → 2.99.0

package/dist/backend/index.mjs

@@ -1519,6 +1519,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;
@@ -4940,6 +4947,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
@@ -4957,8 +4969,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)
@@ -5059,6 +5075,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];
@@ -5108,7 +5142,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;
@@ -5414,6 +5497,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)
    */
@@ -5421,10 +5508,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]);
@@ -5448,6 +5539,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)
    */
@@ -5455,10 +5556,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]);
@@ -5793,10 +5898,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');
@@ -5857,6 +5967,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
@@ -5868,6 +5983,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", [
@@ -5898,6 +6021,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
   // ==========================================================================
   /**
@@ -5941,6 +6147,6 @@ var AdvancedEscrowClient = class {
   }
 };
 
-export { AMBIGUOUS_LEASE_REASONS, AUTHORIZATION_ALREADY_SETTLED, AUTHORIZATION_IN_FLIGHT, AdvancedEscrowClient, BASE_MAINNET_CONTRACTS, BazaarClient, DEFAULT_FACILITATOR_RETRIES, DEFAULT_RETRY_AFTER_SECONDS, DEPOSIT_LIMIT_USDC, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, Erc8004LookupError, EscrowClient, FacilitatorClient, HEALTH_FILTERS, IDEMPOTENCY_KEY_HEADER, IDEMPOTENT_REPLAYED_HEADER, MAX_RETRY_AFTER_SECONDS, MAX_SEARCH_LEN, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, RECEIPT_ISSUER, RECEIPT_REQUEST_CONFLICT, RELAYED_FEEDBACK_NETWORKS, REPLAYABLE_LEASE_REASONS, RegistrationPendingError, SETTLEMENT_UNCONFIRMED, SOLANA_FEEDBACK_NETWORKS, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, WRITER_LEASE_REASONS, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentConflictResponse, buildPaymentRequirements, buildSettleRequest, buildSettleRequestForVersion, buildSettleRequestV2, buildUnavailableResponse, buildVerifyRequest, buildVerifyRequestForVersion, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, canonicalReceiptJson, carryFailureFields, create402Response, createHonoMiddleware, createIdempotencyKey, createPaymentMiddleware, createPurchaseContext, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, facilitatorFetch, fetchWithReceipt, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, getFacilitatorReceipt, isAlive, isAmbiguousLeaseReason, isAuthorizationAlreadyUsed, isAuthorizationInFlight, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, isReplayableLeaseReason, isSettlementUnconfirmed, mergeHeaderList, mergePaymentResponseHeaders, parseFacilitatorErrorBody, parseFacilitatorReceipt, parsePaymentHeader, parseRetryAfterSeconds, paymentResponseHeaders, purchaseContextHeader, readFacilitatorError, receiptCommitment, receiptFromErrorBody, receiptFromResponse, resolveEnvelopeVersion, supportsRelayedFeedback, supportsSolanaFeedback, toPaymentRequirementsV2, toResourceInfoV2, validatePurchaseContext, verifyFacilitatorReceipt, wireNetwork };
+export { AMBIGUOUS_LEASE_REASONS, AUTHORIZATION_ALREADY_SETTLED, AUTHORIZATION_IN_FLIGHT, AdvancedEscrowClient, BASE_MAINNET_CONTRACTS, BazaarClient, DEFAULT_FACILITATOR_RETRIES, DEFAULT_RETRY_AFTER_SECONDS, DEPOSIT_LIMIT_USDC, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_NOTHING_TO_VOID, ESCROW_OPERATOR_GENERATION, ESCROW_OPERATOR_NOT_DEPLOYED, ESCROW_TIMEOUT_MS, ESCROW_UNSUPPORTED_ON_GENERATION, ESCROW_VOID_AMOUNT_MISMATCH, Erc8004Client, Erc8004LookupError, EscrowClient, FacilitatorClient, HEALTH_FILTERS, IDEMPOTENCY_KEY_HEADER, IDEMPOTENT_REPLAYED_HEADER, MAX_RETRY_AFTER_SECONDS, MAX_SEARCH_LEN, OPERATOR_ABI, OPERATOR_ABI_CREATE3, OPERATOR_ABI_V3, PAYMENT_INFO_TYPEHASH, RECEIPT_ISSUER, RECEIPT_REQUEST_CONFLICT, RELAYED_FEEDBACK_NETWORKS, REPLAYABLE_LEASE_REASONS, RegistrationPendingError, SETTLEMENT_UNCONFIRMED, SOLANA_FEEDBACK_NETWORKS, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, WRITER_LEASE_REASONS, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentConflictResponse, buildPaymentRequirements, buildSettleRequest, buildSettleRequestForVersion, buildSettleRequestV2, buildUnavailableResponse, buildVerifyRequest, buildVerifyRequestForVersion, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, canonicalReceiptJson, carryFailureFields, create402Response, createHonoMiddleware, createIdempotencyKey, createPaymentMiddleware, createPurchaseContext, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, facilitatorFetch, fetchWithReceipt, getCorsHeaders, getEscrowContractsByChainId, getEscrowOperatorGeneration, getEscrowSupportedChainIds, getFacilitatorReceipt, isAlive, isAmbiguousLeaseReason, isAuthorizationAlreadyUsed, isAuthorizationInFlight, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, isReplayableLeaseReason, isSettlementUnconfirmed, mergeHeaderList, mergePaymentResponseHeaders, parseFacilitatorErrorBody, parseFacilitatorReceipt, parsePaymentHeader, parseRetryAfterSeconds, paymentResponseHeaders, purchaseContextHeader, readFacilitatorError, receiptCommitment, receiptFromErrorBody, receiptFromResponse, resolveEnvelopeVersion, supportsRelayedFeedback, supportsSolanaFeedback, toPaymentRequirementsV2, toResourceInfoV2, validatePurchaseContext, verifyFacilitatorReceipt, wireNetwork };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map