uvd-x402-sdk 2.3.0 → 2.5.0

package/dist/providers/stellar/index.mjs

@@ -36,6 +36,551 @@ var X402Error = class _X402Error extends Error {
   }
 };
 
+// src/chains/index.ts
+var DEFAULT_FACILITATOR_URL = "https://facilitator.ultravioletadao.xyz";
+var SUPPORTED_CHAINS = {
+  // ============================================================================
+  // EVM CHAINS (10 networks)
+  // ============================================================================
+  base: {
+    chainId: 8453,
+    chainIdHex: "0x2105",
+    name: "base",
+    displayName: "Base",
+    networkType: "evm",
+    rpcUrl: "https://mainnet.base.org",
+    explorerUrl: "https://basescan.org",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+        decimals: 6,
+        name: "EURC",
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  avalanche: {
+    chainId: 43114,
+    chainIdHex: "0xa86a",
+    name: "avalanche",
+    displayName: "Avalanche C-Chain",
+    networkType: "evm",
+    rpcUrl: "https://avalanche-c-chain-rpc.publicnode.com",
+    explorerUrl: "https://snowtrace.io",
+    nativeCurrency: {
+      name: "Avalanche",
+      symbol: "AVAX",
+      decimals: 18
+    },
+    usdc: {
+      address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0xC891EB4cbdEFf6e073e859e987815Ed1505c2ACD",
+        decimals: 6,
+        name: "EURC",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora Dollar",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  ethereum: {
+    chainId: 1,
+    chainIdHex: "0x1",
+    name: "ethereum",
+    displayName: "Ethereum",
+    networkType: "evm",
+    rpcUrl: "https://eth.llamarpc.com",
+    explorerUrl: "https://etherscan.io",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c",
+        decimals: 6,
+        name: "Euro Coin",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora Dollar",
+        version: "1"
+      },
+      pyusd: {
+        address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8",
+        decimals: 6,
+        name: "PayPal USD",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  polygon: {
+    chainId: 137,
+    chainIdHex: "0x89",
+    name: "polygon",
+    displayName: "Polygon",
+    networkType: "evm",
+    rpcUrl: "https://polygon-rpc.com",
+    explorerUrl: "https://polygonscan.com",
+    nativeCurrency: {
+      name: "Polygon",
+      symbol: "POL",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora Dollar",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  arbitrum: {
+    chainId: 42161,
+    chainIdHex: "0xa4b1",
+    name: "arbitrum",
+    displayName: "Arbitrum One",
+    networkType: "evm",
+    rpcUrl: "https://arb1.arbitrum.io/rpc",
+    explorerUrl: "https://arbiscan.io",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora Dollar",
+        version: "1"
+      },
+      usdt: {
+        address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+        decimals: 6,
+        name: "USD\u20AE0",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  optimism: {
+    chainId: 10,
+    chainIdHex: "0xa",
+    name: "optimism",
+    displayName: "Optimism",
+    networkType: "evm",
+    rpcUrl: "https://mainnet.optimism.io",
+    explorerUrl: "https://optimistic.etherscan.io",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      usdt: {
+        address: "0x01bff41798a0bcf287b996046ca68b395dbc1071",
+        decimals: 6,
+        name: "USD\u20AE0",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  celo: {
+    chainId: 42220,
+    chainIdHex: "0xa4ec",
+    name: "celo",
+    displayName: "Celo",
+    networkType: "evm",
+    rpcUrl: "https://forno.celo.org",
+    explorerUrl: "https://celoscan.io",
+    nativeCurrency: {
+      name: "Celo",
+      symbol: "CELO",
+      decimals: 18
+    },
+    usdc: {
+      address: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+      decimals: 6,
+      name: "USDC",
+      // Celo uses "USDC" not "USD Coin" for EIP-712
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+        decimals: 6,
+        name: "USDC",
+        // Celo uses "USDC" not "USD Coin" for EIP-712
+        version: "2"
+      },
+      usdt: {
+        address: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+        decimals: 6,
+        name: "Tether USD",
+        // Celo USDT uses "Tether USD" for EIP-712
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  hyperevm: {
+    chainId: 999,
+    chainIdHex: "0x3e7",
+    name: "hyperevm",
+    displayName: "HyperEVM",
+    networkType: "evm",
+    rpcUrl: "https://rpc.hyperliquid.xyz/evm",
+    explorerUrl: "https://hyperevmscan.io",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+      decimals: 6,
+      name: "USDC",
+      // HyperEVM uses "USDC" not "USD Coin"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+        decimals: 6,
+        name: "USDC",
+        // HyperEVM uses "USDC" not "USD Coin"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  unichain: {
+    chainId: 130,
+    chainIdHex: "0x82",
+    name: "unichain",
+    displayName: "Unichain",
+    networkType: "evm",
+    rpcUrl: "https://unichain-rpc.publicnode.com",
+    explorerUrl: "https://uniscan.xyz",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x078d782b760474a361dda0af3839290b0ef57ad6",
+      decimals: 6,
+      name: "USDC",
+      // Unichain uses "USDC" not "USD Coin"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x078d782b760474a361dda0af3839290b0ef57ad6",
+        decimals: 6,
+        name: "USDC",
+        // Unichain uses "USDC" not "USD Coin"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  monad: {
+    chainId: 143,
+    chainIdHex: "0x8f",
+    name: "monad",
+    displayName: "Monad",
+    networkType: "evm",
+    rpcUrl: "https://rpc.monad.xyz",
+    explorerUrl: "https://monad.socialscan.io",
+    nativeCurrency: {
+      name: "Monad",
+      symbol: "MON",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x754704bc059f8c67012fed69bc8a327a5aafb603",
+      decimals: 6,
+      name: "USDC",
+      // Monad uses "USDC" not "USD Coin"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x754704bc059f8c67012fed69bc8a327a5aafb603",
+        decimals: 6,
+        name: "USDC",
+        // Monad uses "USDC" not "USD Coin"
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora Dollar",
+        version: "1"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  // ============================================================================
+  // SVM CHAINS (2 networks) - Solana Virtual Machine
+  // ============================================================================
+  solana: {
+    chainId: 0,
+    // Non-EVM
+    chainIdHex: "0x0",
+    name: "solana",
+    displayName: "Solana",
+    networkType: "svm",
+    rpcUrl: "https://api.mainnet-beta.solana.com",
+    explorerUrl: "https://solscan.io",
+    nativeCurrency: {
+      name: "Solana",
+      symbol: "SOL",
+      decimals: 9
+    },
+    usdc: {
+      address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+      // USDC SPL token mint
+      decimals: 6,
+      name: "USD Coin",
+      version: "1"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  fogo: {
+    chainId: 0,
+    // Non-EVM (SVM)
+    chainIdHex: "0x0",
+    name: "fogo",
+    displayName: "Fogo",
+    networkType: "svm",
+    rpcUrl: "https://rpc.fogo.nightly.app/",
+    explorerUrl: "https://explorer.fogo.nightly.app",
+    nativeCurrency: {
+      name: "Fogo",
+      symbol: "FOGO",
+      decimals: 9
+    },
+    usdc: {
+      address: "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
+      // Fogo USDC mint
+      decimals: 6,
+      name: "USDC",
+      version: "1"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  // ============================================================================
+  // STELLAR (1 network)
+  // ============================================================================
+  stellar: {
+    chainId: 0,
+    // Non-EVM
+    chainIdHex: "0x0",
+    name: "stellar",
+    displayName: "Stellar",
+    networkType: "stellar",
+    rpcUrl: "https://horizon.stellar.org",
+    explorerUrl: "https://stellar.expert/explorer/public",
+    nativeCurrency: {
+      name: "Lumens",
+      symbol: "XLM",
+      decimals: 7
+      // Stellar uses 7 decimals (stroops)
+    },
+    usdc: {
+      address: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
+      // Soroban Asset Contract
+      decimals: 7,
+      // Stellar USDC uses 7 decimals
+      name: "USDC",
+      version: "1"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  // ============================================================================
+  // NEAR (1 network) - Uses NEP-366 meta-transactions
+  // ============================================================================
+  near: {
+    chainId: 0,
+    // Non-EVM
+    chainIdHex: "0x0",
+    name: "near",
+    displayName: "NEAR Protocol",
+    networkType: "near",
+    rpcUrl: "https://rpc.mainnet.near.org",
+    explorerUrl: "https://nearblocks.io",
+    nativeCurrency: {
+      name: "NEAR",
+      symbol: "NEAR",
+      decimals: 24
+      // NEAR uses 24 decimals (yoctoNEAR)
+    },
+    usdc: {
+      address: "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
+      // Native Circle USDC
+      decimals: 6,
+      name: "USDC",
+      version: "1"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+      // NEP-366 meta-transactions supported
+    }
+  }
+};
+function getChainByName(name) {
+  return SUPPORTED_CHAINS[name.toLowerCase()];
+}
+
+// src/utils/x402.ts
+function chainToCAIP2(chainName) {
+  const caip2 = CAIP2_IDENTIFIERS[chainName.toLowerCase()];
+  if (caip2) {
+    return caip2;
+  }
+  const chain = getChainByName(chainName);
+  if (chain) {
+    if (chain.networkType === "evm") {
+      return `eip155:${chain.chainId}`;
+    }
+    return `${chain.networkType}:${chainName}`;
+  }
+  return chainName;
+}
+
 // src/providers/stellar/index.ts
 function stringToUint8Array(str) {
   return new TextEncoder().encode(str);
@@ -268,22 +813,34 @@ var StellarProvider = class {
   }
   /**
    * Encode Stellar payment as X-PAYMENT header
+   *
+   * @param paymentPayload - JSON-encoded payment payload from signPayment()
+   * @param version - x402 protocol version (1 or 2, defaults to 1)
+   * @returns Base64-encoded X-PAYMENT header value
    */
-  encodePaymentHeader(paymentPayload) {
+  encodePaymentHeader(paymentPayload, version = 1) {
     const payload = JSON.parse(paymentPayload);
-    const x402Payload = {
+    const payloadData = {
+      from: payload.from,
+      to: payload.to,
+      amount: payload.amount,
+      tokenContract: payload.tokenContract,
+      authorizationEntryXdr: payload.authorizationEntryXdr,
+      nonce: payload.nonce,
+      signatureExpirationLedger: payload.signatureExpirationLedger
+    };
+    const x402Payload = version === 2 ? {
+      x402Version: 2,
+      scheme: "exact",
+      network: chainToCAIP2("stellar"),
+      // CAIP-2 format for v2
+      payload: payloadData
+    } : {
       x402Version: 1,
       scheme: "exact",
       network: "stellar",
-      payload: {
-        from: payload.from,
-        to: payload.to,
-        amount: payload.amount,
-        tokenContract: payload.tokenContract,
-        authorizationEntryXdr: payload.authorizationEntryXdr,
-        nonce: payload.nonce,
-        signatureExpirationLedger: payload.signatureExpirationLedger
-      }
+      // Plain chain name for v1
+      payload: payloadData
     };
     return btoa(JSON.stringify(x402Payload));
   }