uvd-x402-sdk 2.16.2 → 2.17.0

package/README.md

@@ -1,17 +1,19 @@
 # uvd-x402-sdk
 
-Gasless crypto payments across 17 blockchain networks using the x402 protocol.
+Gasless crypto payments across 21 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.
 
 ## Features
 
-- **17 Networks**: EVM (10), Solana, Fogo, Stellar, NEAR, Algorand, Sui
+- **21 Networks**: EVM (13 including Scroll, SKALE), Solana, Fogo, Stellar, NEAR, Algorand, Sui
 - **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, USDT
 - **x402 v1 & v2**: Both protocol versions with auto-detection
 - **Gasless**: Facilitator pays all network fees
 - **Type-Safe**: Full TypeScript support
 - **React & Wagmi**: First-class integrations
+- **ERC-8004 Trustless Agents**: On-chain reputation and identity
+- **Escrow & Refunds**: Hold payments with dispute resolution
 
 ## Installation
 
@@ -432,7 +434,7 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 
 ## Supported Networks
 
-### EVM (10)
+### EVM (13)
 
 | Network | Chain ID | Tokens |
 |---------|----------|--------|
@@ -440,12 +442,15 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | Ethereum | 1 | USDC, EURC, AUSD, PYUSD, USDT |
 | Polygon | 137 | USDC, AUSD |
 | Arbitrum | 42161 | USDC, AUSD, USDT |
-| Optimism | 10 | USDC |
+| Optimism | 10 | USDC, USDT |
 | Avalanche | 43114 | USDC, EURC, AUSD |
-| Celo | 42220 | USDC |
+| Celo | 42220 | USDC, USDT |
 | HyperEVM | 999 | USDC |
 | Unichain | 130 | USDC |
 | Monad | 143 | USDC, AUSD |
+| Scroll | 534352 | USDC |
+| SKALE | 1187947933 | USDC |
+| SKALE Testnet | 324705682 | USDC |
 
 ### SVM (2)
 
@@ -584,6 +589,66 @@ try {
 }
 ```
 
+## ERC-8004 Trustless Agents
+
+Build verifiable on-chain reputation for AI agents and services.
+
+```typescript
+import { Erc8004Client } from 'uvd-x402-sdk/backend';
+
+const erc8004 = new Erc8004Client();
+
+// Get agent identity
+const identity = await erc8004.getIdentity('ethereum', 42);
+console.log(identity.agentUri);
+
+// Get agent reputation
+const reputation = await erc8004.getReputation('ethereum', 42);
+console.log(`Score: ${reputation.summary.summaryValue}`);
+
+// Submit feedback after payment
+const result = await erc8004.submitFeedback({
+  x402Version: 1,
+  network: 'ethereum',
+  feedback: {
+    agentId: 42,
+    value: 95,
+    valueDecimals: 0,
+    tag1: 'quality',
+    proof: settleResponse.proofOfPayment,
+  },
+});
+
+// Respond to feedback (agents only)
+await erc8004.appendResponse('ethereum', 42, 1, 'Thank you for your feedback!');
+```
+
+## Escrow & Refunds
+
+Hold payments in escrow with dispute resolution.
+
+```typescript
+import { EscrowClient } from 'uvd-x402-sdk/backend';
+
+const escrow = new EscrowClient();
+
+// Create escrow payment
+const escrowPayment = await escrow.createEscrow({
+  paymentHeader: req.headers['x-payment'],
+  requirements: paymentRequirements,
+  escrowDuration: 86400, // 24 hours
+});
+
+// Release after service delivery
+await escrow.release(escrowPayment.id);
+
+// Or request refund if service failed
+await escrow.requestRefund({
+  escrowId: escrowPayment.id,
+  reason: 'Service not delivered',
+});
+```
+
 ## Links
 
 - [x402 Protocol](https://x402.org)

package/dist/adapters/index.js

@@ -407,6 +407,106 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
+  scroll: {
+    chainId: 534352,
+    chainIdHex: "0x82750",
+    name: "scroll",
+    displayName: "Scroll",
+    networkType: "evm",
+    rpcUrl: "https://rpc.scroll.io",
+    explorerUrl: "https://scrollscan.com",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  skale: {
+    chainId: 1187947933,
+    chainIdHex: "0x46cea59d",
+    name: "skale",
+    displayName: "SKALE",
+    networkType: "evm",
+    rpcUrl: "https://mainnet.skalenodes.com/v1/honorable-steel-rasalhague",
+    explorerUrl: "https://honorable-steel-rasalhague.explorer.mainnet.skalenodes.com",
+    nativeCurrency: {
+      name: "sFUEL",
+      symbol: "sFUEL",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+      decimals: 6,
+      name: "USDC",
+      // SKALE uses "USDC"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+        decimals: 6,
+        name: "USDC",
+        // SKALE uses "USDC"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  "skale-testnet": {
+    chainId: 324705682,
+    chainIdHex: "0x135a9d92",
+    name: "skale-testnet",
+    displayName: "SKALE Testnet",
+    networkType: "evm",
+    rpcUrl: "https://testnet.skalenodes.com/v1/lanky-ill-funny-testnet",
+    explorerUrl: "https://lanky-ill-funny-testnet.explorer.testnet.skalenodes.com",
+    nativeCurrency: {
+      name: "sFUEL",
+      symbol: "sFUEL",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+      decimals: 6,
+      name: "USDC",
+      // SKALE testnet uses "USDC"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+        decimals: 6,
+        name: "USDC",
+        // SKALE testnet uses "USDC"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
   // ============================================================================
   // SVM CHAINS (2 networks) - Solana Virtual Machine
   // ============================================================================
@@ -710,6 +810,9 @@ var CAIP2_IDENTIFIERS = {
   hyperevm: "eip155:999",
   unichain: "eip155:130",
   monad: "eip155:143",
+  scroll: "eip155:534352",
+  skale: "eip155:1187947933",
+  "skale-testnet": "eip155:324705682",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",