uvd-x402-sdk 2.40.0 → 2.42.0

package/README.md

@@ -1,13 +1,13 @@
 # uvd-x402-sdk
 
-Gasless crypto payments across 23 blockchain networks using the x402 protocol.
+Gasless crypto payments across 25 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
 
-- **23 Networks**: EVM (13 including Scroll, SKALE Base), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger (mainnet + testnet)
-- **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, USDT
+- **25 Networks**: EVM (15 including Scroll, SKALE Base, Robinhood Chain), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger (mainnet + testnet)
+- **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, USDT, USDG (Robinhood Chain)
 - **x402 v1 & v2**: Both protocol versions with auto-detection
 - **Gasless**: Facilitator pays all network fees
 - **Type-Safe**: Full TypeScript support
@@ -624,7 +624,7 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 
 ## Supported Networks
 
-### EVM (13)
+### EVM (15)
 
 | Network | Chain ID | Tokens |
 |---------|----------|--------|
@@ -641,6 +641,10 @@ const header = svm.encodePaymentHeader(payload, chainConfig);
 | Scroll | 534352 | USDC |
 | SKALE Base | 1187947933 | USDC.e |
 | SKALE Base Sepolia | 324705682 | USDC.e |
+| Robinhood Chain | 4663 | USDG |
+| Robinhood Chain Testnet | 46630 | USDG |
+
+> **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)
 
@@ -1010,34 +1014,58 @@ The facilitator's `/supported` endpoint advertises both `'escrow'` and `'commerc
 
 Register and discover paid x402 resources across the network.
 
+The Bazaar is served by the facilitator itself under `/discovery/*`. No API key, no separate host.
+
 ```typescript
-import { BazaarClient } from 'uvd-x402-sdk/backend';
+import { BazaarClient, isAlive } from 'uvd-x402-sdk/backend';
 
-const bazaar = new BazaarClient({ apiKey: 'your-api-key' });
+const bazaar = new BazaarClient();
 
-// Discover resources
-const results = await bazaar.discover({
-  category: 'ai',
-  network: 'base',
-  maxPrice: '0.10',
+// List resources. Every filter is applied server-side over the whole catalog,
+// so `pagination.total` is the real number of matches -- filtering one page
+// locally is not the same thing and will under-report.
+const page = await bazaar.listResources({
+  network: 'eip155:8453',
+  health: 'alive',   // only endpoints a probe actually reached
+  tier: 'vip',       // first_party | vip | verified | listed
+  limit: 20,
 });
 
-for (const resource of results.resources) {
-  console.log(`${resource.name}: ${resource.url}`);
+for (const r of page.items) {
+  console.log(r.url, r.health?.status, `${r.health?.latencyMs}ms`, r.curation?.label);
+}
+console.log(`${page.items.length} of ${page.pagination.total}`);
+
+// Free-text search. The parameter is `q`; anything else is rejected with a 400.
+const hits = await bazaar.listResources({ q: 'logs' });
+
+// Walk the whole filtered catalog, one page at a time
+for await (const r of bazaar.iterateResources({ health: 'alive' })) {
+  if (isAlive(r)) console.log(r.url);
 }
 
-// Register a resource
-const resource = await bazaar.register({
+// Register a resource. Registration is open and rate limited.
+await bazaar.registerResource({
   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...',
+  accepts: [{
+    scheme: 'exact',
+    network: 'eip155:8453',
+    asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    amount: '50000',
+    payTo: '0x1234...',
+    maxTimeoutSeconds: 60,
+  }],
+  metadata: { category: 'ai', tags: ['image'] },
 });
+
+// Aggregate catalog metrics
+const stats = await bazaar.getStats();
+console.log(stats.total, stats.visible, stats.byHealth.alive);
 ```
 
+Timestamps (`firstSeen`, `lastSeen`, `lastUpdated`, `health.lastChecked`) are Unix epoch **seconds**. Use `epochToDate()` to get a `Date`.
+
 ## Facilitator Info
 
 Query the facilitator for version, supported networks, and compliance data.

package/dist/adapters/index.d.mts

@@ -1,4 +1,4 @@
-import { O as X402Version, k as PaymentResult } from '../index-DNcDDyee.mjs';
+import { O as X402Version, k as PaymentResult } from '../index-DBCFd6mO.mjs';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-CYIVd4xO.mjs';
 import '../wallet-0cX9Pw2F.mjs';
 

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { O as X402Version, k as PaymentResult } from '../index-DNcDDyee.js';
+import { O as X402Version, k as PaymentResult } from '../index-DBCFd6mO.js';
 export { E as EnvKeyAdapter, O as OWSWallet, a as OWSWalletAdapter } from '../ows-DTDixPzO.js';
 import '../wallet-0cX9Pw2F.js';
 

package/dist/adapters/index.js

@@ -6,7 +6,7 @@ var ethers = require('ethers');
 var DEFAULT_FACILITATOR_URL = "https://facilitator.ultravioletadao.xyz";
 var SUPPORTED_CHAINS = {
   // ============================================================================
-  // EVM CHAINS (10 networks)
+  // EVM CHAINS (15 networks)
   // ============================================================================
   base: {
     chainId: 8453,
@@ -516,6 +516,83 @@ var SUPPORTED_CHAINS = {
       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
+  // asset), and `tokens.usdg` is the canonical entry.
+  // CRITICAL: USDG's on-chain version() getter REVERTS, so the EIP-712 domain
+  // { name: 'Global Dollar', version: '1' } can NEVER be resolved on-chain and
+  // MUST come from this config (mirrored into PaymentRequirements.extra by callers).
+  robinhood: {
+    chainId: 4663,
+    chainIdHex: "0x1237",
+    name: "robinhood",
+    displayName: "Robinhood Chain",
+    networkType: "evm",
+    rpcUrl: "https://rpc.mainnet.chain.robinhood.com",
+    explorerUrl: "https://robinhoodchain.blockscout.com",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+      // Paxos USDG (no USDC on this chain)
+      decimals: 6,
+      name: "Global Dollar",
+      // on-chain version() reverts; domain must be supplied off-chain
+      version: "1"
+    },
+    tokens: {
+      usdg: {
+        address: "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+        decimals: 6,
+        name: "Global Dollar",
+        // on-chain version() reverts; domain must be supplied off-chain
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  "robinhood-testnet": {
+    chainId: 46630,
+    chainIdHex: "0xb626",
+    name: "robinhood-testnet",
+    displayName: "Robinhood Chain Testnet",
+    networkType: "evm",
+    rpcUrl: "https://rpc.testnet.chain.robinhood.com",
+    explorerUrl: "https://explorer.testnet.chain.robinhood.com",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x7E955252E15c84f5768B83c41a71F9eba181802F",
+      // Paxos USDG testnet (no USDC on this chain)
+      decimals: 6,
+      name: "Global Dollar",
+      // on-chain version() reverts; domain must be supplied off-chain
+      version: "1"
+    },
+    tokens: {
+      usdg: {
+        address: "0x7E955252E15c84f5768B83c41a71F9eba181802F",
+        decimals: 6,
+        name: "Global Dollar",
+        // on-chain version() reverts; domain must be supplied off-chain
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
   // ============================================================================
   // SVM CHAINS (2 networks) - Solana Virtual Machine
   // ============================================================================
@@ -881,6 +958,8 @@ var CAIP2_IDENTIFIERS = {
   scroll: "eip155:534352",
   "skale-base": "eip155:1187947933",
   "skale-base-sepolia": "eip155:324705682",
+  robinhood: "eip155:4663",
+  "robinhood-testnet": "eip155:46630",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",