uvd-x402-sdk 2.26.0 → 2.29.0

package/README.md

@@ -6,14 +6,17 @@ Users sign a message or transaction, and the Ultravioleta facilitator handles on
 
 ## Features
 
-- **21 Networks**: EVM (13 including Scroll, SKALE), Solana, Fogo, Stellar, NEAR, Algorand, Sui
+- **21 Networks**: EVM (13 including Scroll, SKALE Base), 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
+- **ERC-8004 Trustless Agents**: On-chain reputation and identity (EVM + Solana)
 - **Escrow & Refunds**: Hold payments with dispute resolution
+- **`/accepts` Negotiation**: Discover facilitator capabilities before constructing payments
+- **Bazaar Discovery**: Register and discover paid resources across the x402 network
+- **Facilitator Info**: Query version, supported networks, blacklist, and health
 
 ## Installation
 
@@ -449,8 +452,8 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | Unichain | 130 | USDC |
 | Monad | 143 | USDC, AUSD |
 | Scroll | 534352 | USDC |
-| SKALE | 1187947933 | USDC |
-| SKALE Testnet | 324705682 | USDC |
+| SKALE Base | 1187947933 | USDC.e |
+| SKALE Base Sepolia | 324705682 | USDC.e |
 
 ### SVM (2)
 
@@ -591,17 +594,23 @@ try {
 
 ## ERC-8004 Trustless Agents
 
-Build verifiable on-chain reputation for AI agents and services.
+Build verifiable on-chain reputation for AI agents and services. Supports **18 networks** (16 EVM + Solana + Solana devnet).
+
+On EVM networks, agent IDs are sequential numbers. On Solana, agent IDs are base58 pubkey strings. The `AgentId` type (`number | string`) handles both.
 
 ```typescript
-import { Erc8004Client } from 'uvd-x402-sdk/backend';
+import { Erc8004Client, AgentId } from 'uvd-x402-sdk/backend';
 
 const erc8004 = new Erc8004Client();
 
-// Get agent identity
+// EVM: agent ID is a number
 const identity = await erc8004.getIdentity('ethereum', 42);
 console.log(identity.agentUri);
 
+// Solana: agent ID is a base58 pubkey string
+const solIdentity = await erc8004.getIdentity('solana', '8oo4dC4JvBLwy5...');
+console.log(solIdentity.agentUri);
+
 // Get agent reputation
 const reputation = await erc8004.getReputation('ethereum', 42);
 console.log(`Score: ${reputation.summary.summaryValue}`);
@@ -620,9 +629,32 @@ const result = await erc8004.submitFeedback({
 });
 
 // Respond to feedback (agents only)
+// sealHash is required for Solana, optional for EVM
 await erc8004.appendResponse('ethereum', 42, 1, 'Thank you for your feedback!');
 ```
 
+## `/accepts` Negotiation
+
+Discover what the facilitator can settle before constructing payment authorizations. Used by Faremeter middleware and clients.
+
+```typescript
+import { FacilitatorClient } from 'uvd-x402-sdk/backend';
+
+const client = new FacilitatorClient();
+
+// Ask facilitator what it can settle
+const enriched = await client.accepts([
+  {
+    scheme: 'exact',
+    network: 'base-mainnet',
+    maxAmountRequired: '1000000',
+    resource: 'https://api.example.com/data',
+    payTo: '0xMerchant...',
+  },
+]);
+// enriched[0].extra now has feePayer, tokens, escrow config
+```
+
 ## Escrow & Refunds
 
 Hold payments in escrow with dispute resolution.
@@ -647,6 +679,73 @@ await escrow.requestRefund({
   escrowId: escrowPayment.id,
   reason: 'Service not delivered',
 });
+
+// Query on-chain escrow state
+const state = await escrow.getEscrowState({
+  network: 'base-mainnet',
+  payer: '0xPayer...',
+  recipient: '0xRecipient...',
+  nonce: '0x1234...',
+});
+```
+
+## Bazaar Discovery
+
+Register and discover paid x402 resources across the network.
+
+```typescript
+import { BazaarClient } from 'uvd-x402-sdk/backend';
+
+const bazaar = new BazaarClient({ apiKey: 'your-api-key' });
+
+// Discover resources
+const results = await bazaar.discover({
+  category: 'ai',
+  network: 'base',
+  maxPrice: '0.10',
+});
+
+for (const resource of results.resources) {
+  console.log(`${resource.name}: ${resource.url}`);
+}
+
+// Register a resource
+const resource = await bazaar.register({
+  url: 'https://api.example.com/v1/generate',
+  name: 'Image Generator API',
+  description: 'Generate images with AI',
+  category: 'ai',
+  networks: ['base', 'ethereum'],
+  price: '0.05',
+  payTo: '0x1234...',
+});
+```
+
+## Facilitator Info
+
+Query the facilitator for version, supported networks, and compliance data.
+
+```typescript
+import { FacilitatorClient } from 'uvd-x402-sdk/backend';
+
+const client = new FacilitatorClient();
+
+// Check version
+const { version } = await client.getVersion();
+console.log(`Facilitator: v${version}`);
+
+// List supported networks
+const supported = await client.getSupported();
+for (const kind of supported.kinds) {
+  console.log(`  ${kind.network} - ${kind.scheme}`);
+}
+
+// Check blacklist
+const bl = await client.getBlacklist();
+console.log(`Blocked addresses: ${bl.totalBlocked}`);
+
+// Health check
+const isHealthy = await client.healthCheck();
 ```
 
 ## Links

package/dist/adapters/index.d.mts

@@ -1,4 +1,4 @@
-import { K as X402Version, k as PaymentResult } from '../index-B49n9gXd.mjs';
+import { L as X402Version, k as PaymentResult } from '../index-MNVg3WMv.mjs';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { K as X402Version, k as PaymentResult } from '../index-B49n9gXd.js';
+import { L as X402Version, k as PaymentResult } from '../index-MNVg3WMv.js';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

package/dist/adapters/index.js

@@ -446,32 +446,32 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
-  skale: {
+  "skale-base": {
     chainId: 1187947933,
     chainIdHex: "0x46cea59d",
-    name: "skale",
-    displayName: "SKALE",
+    name: "skale-base",
+    displayName: "SKALE Base",
     networkType: "evm",
-    rpcUrl: "https://mainnet.skalenodes.com/v1/honorable-steel-rasalhague",
-    explorerUrl: "https://honorable-steel-rasalhague.explorer.mainnet.skalenodes.com",
+    rpcUrl: "https://skale-base.skalenodes.com/v1/base",
+    explorerUrl: "https://skale-base-explorer.skalenodes.com",
     nativeCurrency: {
-      name: "sFUEL",
-      symbol: "sFUEL",
+      name: "CREDIT",
+      symbol: "CREDIT",
       decimals: 18
     },
     usdc: {
       address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
       decimals: 6,
-      name: "USDC",
-      // SKALE uses "USDC"
+      name: "Bridged USDC (SKALE Bridge)",
+      // Must match on-chain EIP-712 domain exactly
       version: "2"
     },
     tokens: {
       usdc: {
         address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
         decimals: 6,
-        name: "USDC",
-        // SKALE uses "USDC"
+        name: "Bridged USDC (SKALE Bridge)",
+        // Must match on-chain EIP-712 domain exactly
         version: "2"
       }
     },
@@ -480,32 +480,32 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
-  "skale-testnet": {
+  "skale-base-sepolia": {
     chainId: 324705682,
     chainIdHex: "0x135a9d92",
-    name: "skale-testnet",
-    displayName: "SKALE Testnet",
+    name: "skale-base-sepolia",
+    displayName: "SKALE Base Sepolia",
     networkType: "evm",
-    rpcUrl: "https://testnet.skalenodes.com/v1/lanky-ill-funny-testnet",
-    explorerUrl: "https://lanky-ill-funny-testnet.explorer.testnet.skalenodes.com",
+    rpcUrl: "https://base-sepolia-testnet.skalenodes.com/v1/jubilant-horrible-ancha",
+    explorerUrl: "https://base-sepolia-testnet-explorer.skalenodes.com",
     nativeCurrency: {
-      name: "sFUEL",
-      symbol: "sFUEL",
+      name: "CREDIT",
+      symbol: "CREDIT",
       decimals: 18
     },
     usdc: {
       address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
       decimals: 6,
-      name: "USDC",
-      // SKALE testnet uses "USDC"
+      name: "Bridged USDC (SKALE Bridge)",
+      // Must match on-chain EIP-712 domain exactly
       version: "2"
     },
     tokens: {
       usdc: {
         address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
         decimals: 6,
-        name: "USDC",
-        // SKALE testnet uses "USDC"
+        name: "Bridged USDC (SKALE Bridge)",
+        // Must match on-chain EIP-712 domain exactly
         version: "2"
       }
     },
@@ -818,8 +818,8 @@ var CAIP2_IDENTIFIERS = {
   unichain: "eip155:130",
   monad: "eip155:143",
   scroll: "eip155:534352",
-  skale: "eip155:1187947933",
-  "skale-testnet": "eip155:324705682",
+  "skale-base": "eip155:1187947933",
+  "skale-base-sepolia": "eip155:324705682",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",