uvd-x402-sdk 2.91.0 → 2.93.0

package/README.md

@@ -1,14 +1,16 @@
 # uvd-x402-sdk
 
-Gasless crypto payments across 25 blockchain networks using the x402 protocol.
+Gasless crypto payments across 29 blockchain networks using the x402 protocol.
 
 Users sign a message or transaction, and the Ultravioleta facilitator handles on-chain settlement. No gas fees for users.
 
+**New in v2.93.0**: Native Hedera mainnet and testnet with sponsored HBAR/USDC payments, offline signing and buyer/merchant helpers. [Hedera guide](docs/networks/hedera.md). Arc USDC remains supported on mainnet and testnet.
+
 ## Features
 
-- **25 Networks**: EVM (15 including Scroll, SKALE Base, Robinhood Chain), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger (mainnet + testnet)
+- **29 Networks**: EVM (17 including Arc, Scroll, SKALE Base, Robinhood Chain), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger, Hedera (mainnet + testnet)
 - **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, USDT, USDG (Robinhood Chain)
-- **x402 v1 & v2**: Both protocol versions with auto-detection
+- **x402 v1 & v2**: Protocol auto-detection; native Hedera supports v2/exact only
 - **Gasless**: Facilitator pays all network fees
 - **Buyer Policy**: Per-payment and cumulative budgets, payee allowlist and offer expiry, evaluated against the offer in hand **before signing** — six closed refusal codes in a fixed order
 - **Type-Safe**: Full TypeScript support
@@ -723,7 +725,7 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 
 ## Supported Networks
 
-### EVM (15)
+### EVM (16)
 
 | Network | Chain ID | Tokens |
 |---------|----------|--------|
@@ -742,6 +744,10 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | SKALE Base Sepolia | 324705682 | USDC.e |
 | Robinhood Chain | 4663 | USDG |
 | Robinhood Chain Testnet | 46630 | USDG |
+| Arc | 5042 | USDC |
+| Arc Testnet | 5042002 | USDC |
+
+> **Arc mainnet and testnet:** payment amounts use 6 decimals and the `USDC` / `2` domain. Native gas uses 18 decimals on the same balance. Use `arc` / `eip155:5042` for mainnet and `arc-testnet` / `eip155:5042002` for testnet. See [Arc usage and validation](docs/networks/arc.md).
 
 > **Robinhood Chain / USDG:** Robinhood Chain has no USDC — the settlement stablecoin is Paxos **USDG** (Global Dollar, 6 decimals, EIP-3009). Its on-chain `version()` getter reverts, so the EIP-712 domain `{ name: "Global Dollar", version: "1" }` can never be resolved on-chain. The SDK carries this domain in the chain config; when constructing `PaymentRequirements` yourself, send it in `extra`: `{ "name": "Global Dollar", "version": "1" }`. Use `tokenType: 'usdg'` (or the default, which resolves to USDG on these networks).
 

package/dist/adapters/index.d.mts

@@ -1,4 +1,4 @@
-import { X as X402Version, a as PaymentResult } from '../index-DbauIMV2.mjs';
+import { X as X402Version, a as PaymentResult } from '../index-CBjEM00M.mjs';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-Z9v4GxOZ.mjs';
 import '../wallet-w7BnImDG.mjs';
 

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { X as X402Version, a as PaymentResult } from '../index-DbauIMV2.js';
+import { X as X402Version, a as PaymentResult } from '../index-CBjEM00M.js';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-C-KmORG9.js';
 import '../wallet-w7BnImDG.js';
 

package/dist/adapters/index.js

@@ -5,8 +5,40 @@ var ethers = require('ethers');
 // src/chains/index.ts
 var DEFAULT_FACILITATOR_URL = "https://facilitator.ultravioletadao.xyz";
 var SUPPORTED_CHAINS = {
+  "hedera:mainnet": {
+    chainId: 0,
+    chainIdHex: "0x0",
+    name: "hedera:mainnet",
+    displayName: "Hedera",
+    networkType: "hedera",
+    rpcUrl: "https://mainnet-public.mirrornode.hedera.com",
+    explorerUrl: "https://hashscan.io/mainnet",
+    nativeCurrency: { name: "HBAR", symbol: "HBAR", decimals: 8 },
+    usdc: { address: "0.0.456858", decimals: 6, name: "USDC", version: "" },
+    tokens: {
+      usdc: { address: "0.0.456858", decimals: 6, name: "USDC", version: "" },
+      hbar: { address: "0.0.0", decimals: 8, name: "HBAR", version: "", usdPegged: false }
+    },
+    x402: { facilitatorUrl: DEFAULT_FACILITATOR_URL, enabled: true }
+  },
+  "hedera:testnet": {
+    chainId: 0,
+    chainIdHex: "0x0",
+    name: "hedera:testnet",
+    displayName: "Hedera Testnet",
+    networkType: "hedera",
+    rpcUrl: "https://testnet.mirrornode.hedera.com",
+    explorerUrl: "https://hashscan.io/testnet",
+    nativeCurrency: { name: "HBAR", symbol: "HBAR", decimals: 8 },
+    usdc: { address: "0.0.429274", decimals: 6, name: "USDC", version: "" },
+    tokens: {
+      usdc: { address: "0.0.429274", decimals: 6, name: "USDC", version: "" },
+      hbar: { address: "0.0.0", decimals: 8, name: "HBAR", version: "", usdPegged: false }
+    },
+    x402: { facilitatorUrl: DEFAULT_FACILITATOR_URL, enabled: true }
+  },
   // ============================================================================
-  // EVM CHAINS (15 networks)
+  // EVM CHAINS (16 enabled + BSC, disabled)
   // ============================================================================
   base: {
     chainId: 8453,
@@ -636,6 +668,91 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
+  // Arc testnet (Circle). The stablecoin IS the chain's native asset, so the SAME
+  // balance is readable at TWO precisions:
+  //   - native / gas, via eth_getBalance and EIP-1559 fees: 18 decimals
+  //   - ERC-20 interface, via balanceOf and transferWithAuthorization: 6 decimals
+  //     (the ERC-20 view is floor(native / 10^12))
+  // An x402 payment is an EIP-3009 authorization against the ERC-20 interface, so
+  // its `value` is ALWAYS in the 6 of `tokens.usdc.decimals`. Scaling a price with
+  // `nativeCurrency.decimals` instead charges 10^12 times the amount: $0.01 would
+  // be signed as 10000000000000000 units, i.e. 10 billion USDC. `nativeCurrency`
+  // below is correct where it is actually used -- the wallet_addEthereumChain
+  // params -- and must never reach `parseUnits` for a payment.
+  // Pinned by src/arc-testnet.test.ts.
+  //
+  // Mainnet (5042) and testnet (5042002) were verified independently against
+  // their official RPCs on 2026-09-16. EURC is not registered without its E2E proof.
+  arc: {
+    chainId: 5042,
+    chainIdHex: "0x13b2",
+    name: "arc",
+    displayName: "Arc",
+    networkType: "evm",
+    rpcUrl: "https://rpc.mainnet.arc.io",
+    explorerUrl: "https://explorer.arc.io",
+    nativeCurrency: {
+      name: "USD Coin",
+      symbol: "USDC",
+      decimals: 18
+      // gas precision ONLY -- never the scale of a payment
+    },
+    usdc: {
+      address: "0x3600000000000000000000000000000000000000",
+      decimals: 6,
+      // ERC-20 interface, which is what an EIP-3009 value is denominated in
+      name: "USDC",
+      // on-chain name(); must match the EIP-712 domain exactly
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x3600000000000000000000000000000000000000",
+        decimals: 6,
+        name: "USDC",
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  "arc-testnet": {
+    chainId: 5042002,
+    chainIdHex: "0x4cef52",
+    name: "arc-testnet",
+    displayName: "Arc Testnet",
+    networkType: "evm",
+    rpcUrl: "https://rpc.testnet.arc.io",
+    explorerUrl: "https://explorer.testnet.arc.io",
+    nativeCurrency: {
+      name: "USD Coin",
+      symbol: "USDC",
+      decimals: 18
+      // gas precision ONLY -- never the scale of a payment
+    },
+    usdc: {
+      address: "0x3600000000000000000000000000000000000000",
+      decimals: 6,
+      // ERC-20 interface, which is what an EIP-3009 value is denominated in
+      name: "USDC",
+      // on-chain name(); must match the EIP-712 domain exactly
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x3600000000000000000000000000000000000000",
+        decimals: 6,
+        name: "USDC",
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
   // ============================================================================
   // SVM CHAINS (2 networks) - Solana Virtual Machine
   // ============================================================================
@@ -989,6 +1106,8 @@ var SUPPORTED_CHAINS = {
   }
 };
 var CHAIN_ALIASES = {
+  hedera: "hedera:mainnet",
+  "hedera-testnet": "hedera:testnet",
   // Renamed in 2.85.0: the facilitator advertises the mainnet as `xrpl`.
   "xrpl-mainnet": "xrpl"
 };
@@ -999,6 +1118,8 @@ function getChainByName(name) {
 
 // src/types/index.ts
 var CAIP2_IDENTIFIERS = {
+  "hedera:mainnet": "hedera:mainnet",
+  "hedera:testnet": "hedera:testnet",
   // EVM chains
   base: "eip155:8453",
   ethereum: "eip155:1",
@@ -1016,6 +1137,8 @@ var CAIP2_IDENTIFIERS = {
   "skale-base-sepolia": "eip155:324705682",
   robinhood: "eip155:4663",
   "robinhood-testnet": "eip155:46630",
+  arc: "eip155:5042",
+  "arc-testnet": "eip155:5042002",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",
@@ -1082,6 +1205,7 @@ function encodeX402Header(header) {
   return encodeBase64Json(header);
 }
 function createX402V1Header(network, payload) {
+  if (getChainByName(network)?.networkType === "hedera") throw new Error("Native Hedera supports only x402 v2");
   return {
     x402Version: 1,
     scheme: "exact",
@@ -1154,6 +1278,11 @@ function validateRecipient(recipient, networkType) {
           );
         }
         break;
+      case "hedera":
+        if (!/^0\.0\.[1-9][0-9]*$/.test(trimmed)) {
+          throw new X402Error("Hedera recipient must be a native numeric account ID", "INVALID_RECIPIENT");
+        }
+        break;
       case "xrpl":
         if (!XRPL_ADDRESS_REGEX.test(trimmed)) {
           throw new X402Error(