uvd-x402-sdk 2.106.0 → 2.108.0

package/README.md

@@ -10,7 +10,9 @@ Users sign a message or transaction, and the Ultravioleta facilitator handles on
 
 ## Features
 
-- **29 Networks**: EVM (17 including Arc, Scroll, SKALE Base, Robinhood Chain), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger, Hedera (mainnet + testnet)
+**Arras NEAR escrow (v2.108.0):** offline local-key NEP-366 authorization, canonical Rust payment IDs and pull lifecycle helpers through `uvd-x402-sdk/near`. [Guide and agent example](docs/near-escrow.md). As of 2026-11-02 the facilitator advertises escrow only on testnet, and the SDK's escrow contract registry has no mainnet row yet.
+
+- **31 Networks**: EVM (19 including HashKey Chain, 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**: Protocol auto-detection; native Hedera supports v2/exact only
 - **Gasless**: Facilitator pays all network fees
@@ -813,6 +815,8 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | Scroll | 534352 | USDC |
 | SKALE Base | 1187947933 | USDC.e |
 | SKALE Base Sepolia | 324705682 | USDC.e |
+| HashKey Chain | 177 | USDC |
+| HashKey Chain Testnet | 133 | USDC |
 | Robinhood Chain | 4663 | USDG |
 | Robinhood Chain Testnet | 46630 | USDG |
 | Arc | 5042 | USDC, EURC |
@@ -820,6 +824,8 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 
 > **Arc mainnet and testnet:** payment amounts use 6 decimals. USDC signs with the `USDC` / `2` domain; EURC (`0xbEf5…21c1` mainnet, `0x89B5…D72a` testnet) signs with `EURC` / `2` and its amounts are **euros**, not dollars (`tokenType: 'eurc'`, `usdPegged: false`). 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).
 
+> **HashKey Chain / USDC:** Use `hashkey` (177) or `hashkey-testnet` (133). Gas is HSK; payments use 6-decimal USDC. Mainnet's EIP-712 name is `Bridged USDC` and testnet's is `USD Coin`, both version `2`. HashKey USDT is unsupported because it has no EIP-3009. [Network configuration and measured domains](docs/networks/hashkey.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).
 
 ### SVM (2)
@@ -882,6 +888,8 @@ getFacilitatorAddress('xrpl-mainnet'); // rfADKk...
 
 ## Backend
 
+Payment headers follow one rule in Express, Hono and `createFetchPaywall`: send `X-PAYMENT`, `PAYMENT-SIGNATURE`, or both with the same value. Names are case-insensitive and surrounding HTTP spaces/tabs are ignored. Distinct values return **400** (`Conflicting payment headers`) before verification or settlement. Empty or malformed payment headers, including payments with no network in either `network` or `accepted.network`, return **400**; absent payment headers return **402**. The extractor returns `null` for invalid or conflicting headers. Standard v2 payments carry their network in `accepted.network`; a top-level string `network` takes precedence when present. Empty or whitespace-padded networks are invalid. Verification and settlement use the same parsed payment, including manual settlement.
+
 ```typescript
 import {
   FacilitatorClient,

package/dist/adapters/index.js

@@ -36,7 +36,7 @@ var SUPPORTED_CHAINS = {
     x402: { facilitatorUrl: DEFAULT_FACILITATOR_URL, enabled: true }
   },
   // ============================================================================
-  // EVM CHAINS (16 enabled + BSC, disabled)
+  // EVM CHAINS (19 enabled + BSC, disabled)
   // ============================================================================
   base: {
     chainId: 8453,
@@ -441,8 +441,8 @@ var SUPPORTED_CHAINS = {
       usdt: {
         address: "0xe7cd86e13AC4309349F30B3435a9d337750fC82D",
         decimals: 6,
-        name: "USD\u20AE0",
-        // USD₮0 (USDT0 omnichain via LayerZero)
+        name: "USDT0",
+        // ASCII on Monad, unlike USD₮0 on Arbitrum/Optimism (src/usdt-domains.test.ts)
         version: "1"
       }
     },
@@ -594,6 +594,57 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
+  // HashKey Chain: USDC supports EIP-3009; HashKey USDT does not.
+  hashkey: {
+    chainId: 177,
+    chainIdHex: "0xb1",
+    name: "hashkey",
+    displayName: "HashKey Chain",
+    networkType: "evm",
+    rpcUrl: "https://mainnet.hsk.xyz",
+    explorerUrl: "https://hsk.blockscout.com",
+    nativeCurrency: { name: "HashKey", symbol: "HSK", decimals: 18 },
+    usdc: {
+      address: "0x054ed45810DbBAb8B27668922D110669c9D88D0a",
+      decimals: 6,
+      name: "Bridged USDC",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x054ed45810DbBAb8B27668922D110669c9D88D0a",
+        decimals: 6,
+        name: "Bridged USDC",
+        version: "2"
+      }
+    },
+    x402: { facilitatorUrl: DEFAULT_FACILITATOR_URL, enabled: true }
+  },
+  "hashkey-testnet": {
+    chainId: 133,
+    chainIdHex: "0x85",
+    name: "hashkey-testnet",
+    displayName: "HashKey Chain Testnet",
+    networkType: "evm",
+    rpcUrl: "https://testnet.hsk.xyz",
+    explorerUrl: "https://testnet-explorer.hskchain.net",
+    nativeCurrency: { name: "HashKey", symbol: "HSK", decimals: 18 },
+    usdc: {
+      address: "0x8FE3cB719Ee4410E236Cd6b72ab1fCDC06eF53c6",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x8FE3cB719Ee4410E236Cd6b72ab1fCDC06eF53c6",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      }
+    },
+    x402: { facilitatorUrl: DEFAULT_FACILITATOR_URL, enabled: true }
+  },
   // Robinhood Chain (Arbitrum Orbit L2). NOTE: there is NO USDC on this chain -
   // the settlement stablecoin is Paxos USDG (Global Dollar). The `usdc` field
   // below carries USDG for interface compatibility (same pattern as XRPL's native
@@ -1156,6 +1207,8 @@ var CAIP2_IDENTIFIERS = {
   scroll: "eip155:534352",
   "skale-base": "eip155:1187947933",
   "skale-base-sepolia": "eip155:324705682",
+  hashkey: "eip155:177",
+  "hashkey-testnet": "eip155:133",
   robinhood: "eip155:4663",
   "robinhood-testnet": "eip155:46630",
   arc: "eip155:5042",