uvd-x402-sdk 2.16.1 → 2.17.0

package/README.md

@@ -1,17 +1,19 @@
 # uvd-x402-sdk
 
-Gasless crypto payments across 16 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
 
-- **16 Networks**: EVM (10), Solana, Fogo, Stellar, NEAR, Algorand (2)
+- **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
 
@@ -36,6 +38,9 @@ npm install @near-wallet-selector/core @near-wallet-selector/my-near-wallet
 
 # Algorand
 npm install algosdk lute-connect
+
+# Sui
+npm install @mysten/sui
 ```
 
 ## Quick Start
@@ -98,6 +103,29 @@ Algorand uses atomic transaction groups:
 - Transaction 0: Fee payment (unsigned, facilitator signs)
 - Transaction 1: USDC ASA transfer (signed by user)
 
+### Sui
+
+```typescript
+import { SuiProvider } from 'uvd-x402-sdk/sui';
+import { getChainByName } from 'uvd-x402-sdk';
+
+const sui = new SuiProvider();
+const address = await sui.connect(); // Sui Wallet
+const chainConfig = getChainByName('sui')!;
+
+const payload = await sui.signPayment({
+  recipient: '0x1234...', // 66-char Sui address
+  amount: '10.00',
+}, chainConfig);
+
+const header = sui.encodePaymentHeader(payload, chainConfig);
+```
+
+Sui uses sponsored transactions:
+- User creates and signs a programmable transaction block
+- Facilitator sponsors gas (pays in SUI)
+- User pays zero gas fees
+
 ### Stellar
 
 ```typescript
@@ -406,7 +434,7 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 
 ## Supported Networks
 
-### EVM (10)
+### EVM (13)
 
 | Network | Chain ID | Tokens |
 |---------|----------|--------|
@@ -414,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)
 
@@ -428,14 +459,19 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | Solana | USDC, AUSD | Phantom |
 | Fogo | USDC | Phantom |
 
-### Algorand (2)
+### Algorand
 
 | Network | USDC ASA | Wallet |
 |---------|----------|--------|
 | Algorand | 31566704 | Lute, Pera |
-| Algorand Testnet | 10458941 | Lute, Pera |
 
-### Other (2)
+### Sui
+
+| Network | Tokens | Wallet |
+|---------|--------|--------|
+| Sui | USDC, AUSD | Sui Wallet |
+
+### Other
 
 | Network | Wallet |
 |---------|--------|
@@ -455,10 +491,12 @@ FACILITATOR_ADDRESSES.solana;   // F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq
 FACILITATOR_ADDRESSES.algorand; // KIMS5H6QLCUDL65L5UBTOXDPWLMTS7N3AAC3I6B2NCONEI5QIVK7LH2C2I
 FACILITATOR_ADDRESSES.stellar;  // GCHPGXJT2WFFRFCA5TV4G4E3PMMXLNIDUH27PKDYA4QJ2XGYZWGFZNHB
 FACILITATOR_ADDRESSES.near;     // uvd-facilitator.near
+FACILITATOR_ADDRESSES.sui;      // 0xe7bbf2b13f7d72714760aa16e024fa1b35a978793f9893d0568a4fbf356a764a
 
 // Or get by chain name
 getFacilitatorAddress('algorand'); // KIMS5H6...
 getFacilitatorAddress('base', 'evm'); // 0x1030...
+getFacilitatorAddress('sui'); // 0xe7bbf...
 ```
 
 ## Backend
@@ -551,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.d.mts

@@ -1,4 +1,4 @@
-import { m as X402Version, f as PaymentResult } from '../index-B_reIs-L.mjs';
+import { m as X402Version, f as PaymentResult } from '../index-BE5cH7oS.mjs';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { m as X402Version, f as PaymentResult } from '../index-B_reIs-L.js';
+import { m as X402Version, f as PaymentResult } from '../index-BE5cH7oS.js';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

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",