uvd-x402-sdk 2.92.0 → 2.93.0

package/README.md

@@ -1,14 +1,16 @@
 # uvd-x402-sdk
 
-Gasless crypto payments across 27 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

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,6 +5,38 @@ 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 (16 enabled + BSC, disabled)
   // ============================================================================
@@ -1074,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"
 };
@@ -1084,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",
@@ -1169,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",
@@ -1241,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(