uvd-x402-sdk 2.0.1

package/dist/providers/evm/index.js

@@ -0,0 +1,740 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var ethers = require('ethers');
+
+// src/providers/evm/index.ts
+
+// src/types/index.ts
+var CAIP2_IDENTIFIERS = {
+  // EVM chains
+  base: "eip155:8453",
+  ethereum: "eip155:1",
+  polygon: "eip155:137",
+  arbitrum: "eip155:42161",
+  optimism: "eip155:10",
+  avalanche: "eip155:43114",
+  celo: "eip155:42220",
+  hyperevm: "eip155:999",
+  unichain: "eip155:130",
+  monad: "eip155:143",
+  bsc: "eip155:56",
+  // SVM chains
+  solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  fogo: "svm:fogo",
+  // Stellar
+  stellar: "stellar:pubnet",
+  // NEAR
+  near: "near:mainnet"
+};
+Object.fromEntries(
+  Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])
+);
+var X402Error = class _X402Error extends Error {
+  code;
+  details;
+  constructor(message, code, details) {
+    super(message);
+    this.name = "X402Error";
+    this.code = code;
+    this.details = details;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _X402Error);
+    }
+  }
+};
+
+// src/chains/index.ts
+var DEFAULT_FACILITATOR_URL = "https://facilitator.ultravioletadao.xyz";
+var SUPPORTED_CHAINS = {
+  // ============================================================================
+  // EVM CHAINS (11 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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    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"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  // BSC disabled: USDC doesn't support ERC-3009 transferWithAuthorization
+  bsc: {
+    chainId: 56,
+    chainIdHex: "0x38",
+    name: "bsc",
+    displayName: "BNB Smart Chain",
+    networkType: "evm",
+    rpcUrl: "https://binance.llamarpc.com",
+    explorerUrl: "https://bscscan.com",
+    nativeCurrency: {
+      name: "Binance Coin",
+      symbol: "BNB",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+      decimals: 18,
+      // BSC USDC uses 18 decimals
+      name: "USD Coin",
+      version: "2"
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: false
+      // Disabled: BSC USDC doesn't support ERC-3009
+    }
+  },
+  // ============================================================================
+  // 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 getChainById(chainId) {
+  return Object.values(SUPPORTED_CHAINS).find((chain) => chain.chainId === chainId);
+}
+function getChainByName(name) {
+  return SUPPORTED_CHAINS[name.toLowerCase()];
+}
+
+// src/providers/evm/index.ts
+var EVMProvider = class {
+  id = "injected";
+  name = "EVM Wallet";
+  networkType = "evm";
+  provider = null;
+  signer = null;
+  address = null;
+  chainId = null;
+  chainName = null;
+  /**
+   * Check if an EVM wallet is available
+   */
+  isAvailable() {
+    if (typeof window === "undefined") return false;
+    return typeof window.ethereum !== "undefined";
+  }
+  /**
+   * Connect to an EVM wallet
+   */
+  async connect(chainName) {
+    const targetChainName = chainName || "base";
+    const chain = getChainByName(targetChainName);
+    if (!chain) {
+      throw new X402Error(`Unsupported chain: ${targetChainName}`, "CHAIN_NOT_SUPPORTED");
+    }
+    if (chain.networkType !== "evm") {
+      throw new X402Error(`${targetChainName} is not an EVM chain`, "CHAIN_NOT_SUPPORTED");
+    }
+    const ethereum = window.ethereum;
+    if (!ethereum) {
+      throw new X402Error(
+        "No Ethereum wallet found. Please install MetaMask or another EVM wallet.",
+        "WALLET_NOT_FOUND"
+      );
+    }
+    try {
+      this.provider = new ethers.ethers.BrowserProvider(ethereum);
+      await this.provider.send("eth_requestAccounts", []);
+      await this.switchChain(targetChainName);
+      this.signer = await this.provider.getSigner();
+      this.address = await this.signer.getAddress();
+      return this.address;
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("User rejected") || error.code === 4001) {
+          throw new X402Error("Connection rejected by user", "WALLET_CONNECTION_REJECTED");
+        }
+      }
+      throw new X402Error(
+        `Failed to connect wallet: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "UNKNOWN_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Disconnect from wallet
+   */
+  async disconnect() {
+    this.provider = null;
+    this.signer = null;
+    this.address = null;
+    this.chainId = null;
+    this.chainName = null;
+  }
+  /**
+   * Switch to a different EVM chain
+   */
+  async switchChain(chainName) {
+    const chain = getChainByName(chainName);
+    if (!chain) {
+      throw new X402Error(`Unsupported chain: ${chainName}`, "CHAIN_NOT_SUPPORTED");
+    }
+    if (!this.provider) {
+      throw new X402Error("Wallet not connected", "WALLET_NOT_CONNECTED");
+    }
+    try {
+      await this.provider.send("wallet_switchEthereumChain", [{ chainId: chain.chainIdHex }]);
+    } catch (switchError) {
+      if (switchError.code === 4902) {
+        try {
+          await this.provider.send("wallet_addEthereumChain", [
+            {
+              chainId: chain.chainIdHex,
+              chainName: chain.displayName,
+              nativeCurrency: chain.nativeCurrency,
+              rpcUrls: [chain.rpcUrl],
+              blockExplorerUrls: [chain.explorerUrl]
+            }
+          ]);
+        } catch (addError) {
+          throw new X402Error(
+            `Failed to add ${chain.displayName} network`,
+            "CHAIN_SWITCH_REJECTED",
+            addError
+          );
+        }
+      } else if (switchError.code === 4001) {
+        throw new X402Error("Network switch rejected by user", "CHAIN_SWITCH_REJECTED");
+      } else {
+        throw new X402Error(
+          `Failed to switch to ${chain.displayName}`,
+          "CHAIN_SWITCH_REJECTED",
+          switchError
+        );
+      }
+    }
+    this.chainId = chain.chainId;
+    this.chainName = chain.name;
+  }
+  /**
+   * Get current address
+   */
+  getAddress() {
+    return this.address;
+  }
+  /**
+   * Get current chain ID
+   */
+  getChainId() {
+    return this.chainId;
+  }
+  /**
+   * Get current chain name
+   */
+  getChainName() {
+    return this.chainName;
+  }
+  /**
+   * Get USDC balance
+   */
+  async getBalance(chainConfig) {
+    if (!this.address) {
+      throw new X402Error("Wallet not connected", "WALLET_NOT_CONNECTED");
+    }
+    const publicProvider = new ethers.ethers.JsonRpcProvider(chainConfig.rpcUrl);
+    const usdcAbi = ["function balanceOf(address owner) view returns (uint256)"];
+    const usdcContract = new ethers.ethers.Contract(chainConfig.usdc.address, usdcAbi, publicProvider);
+    try {
+      const balance = await usdcContract.balanceOf(this.address);
+      const formatted = ethers.ethers.formatUnits(balance, chainConfig.usdc.decimals);
+      return parseFloat(formatted).toFixed(2);
+    } catch {
+      return "0.00";
+    }
+  }
+  /**
+   * Create EVM payment (EIP-712 TransferWithAuthorization)
+   */
+  async signPayment(paymentInfo, chainConfig) {
+    if (!this.signer || !this.address) {
+      throw new X402Error("Wallet not connected", "WALLET_NOT_CONNECTED");
+    }
+    const recipient = paymentInfo.recipients?.evm || paymentInfo.recipient;
+    const nonceBytes = new Uint8Array(32);
+    if (typeof window !== "undefined" && window.crypto) {
+      window.crypto.getRandomValues(nonceBytes);
+    } else {
+      for (let i = 0; i < 32; i++) {
+        nonceBytes[i] = Math.floor(Math.random() * 256);
+      }
+    }
+    const nonce = ethers.ethers.hexlify(nonceBytes);
+    const validAfter = 0;
+    const validityWindowSeconds = chainConfig.name === "base" ? 300 : 60;
+    const validBefore = Math.floor(Date.now() / 1e3) + validityWindowSeconds;
+    const domain = {
+      name: chainConfig.usdc.name,
+      version: chainConfig.usdc.version,
+      chainId: chainConfig.chainId,
+      verifyingContract: chainConfig.usdc.address
+    };
+    const types = {
+      TransferWithAuthorization: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "validAfter", type: "uint256" },
+        { name: "validBefore", type: "uint256" },
+        { name: "nonce", type: "bytes32" }
+      ]
+    };
+    const value = ethers.ethers.parseUnits(paymentInfo.amount, chainConfig.usdc.decimals);
+    const from = this.address;
+    const to = ethers.ethers.getAddress(recipient);
+    const message = {
+      from,
+      to,
+      value,
+      validAfter,
+      validBefore,
+      nonce
+    };
+    let signature;
+    try {
+      signature = await this.signer.signTypedData(domain, types, message);
+    } catch (error) {
+      if (error instanceof Error && (error.message.includes("User rejected") || error.code === 4001)) {
+        throw new X402Error("Signature rejected by user", "SIGNATURE_REJECTED");
+      }
+      throw new X402Error(
+        `Failed to sign payment: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "PAYMENT_FAILED",
+        error
+      );
+    }
+    const sig = ethers.ethers.Signature.from(signature);
+    const payload = {
+      from,
+      to,
+      value: value.toString(),
+      validAfter,
+      validBefore,
+      nonce,
+      v: sig.v,
+      r: sig.r,
+      s: sig.s,
+      chainId: chainConfig.chainId,
+      token: chainConfig.usdc.address
+    };
+    return JSON.stringify(payload);
+  }
+  /**
+   * Encode EVM payment as X-PAYMENT header
+   */
+  encodePaymentHeader(paymentPayload, chainConfig) {
+    const payload = JSON.parse(paymentPayload);
+    const fullSignature = payload.r + payload.s.slice(2) + payload.v.toString(16).padStart(2, "0");
+    const x402Payload = {
+      x402Version: 1,
+      scheme: "exact",
+      network: chainConfig.name,
+      payload: {
+        signature: fullSignature,
+        authorization: {
+          from: payload.from,
+          to: payload.to,
+          value: payload.value,
+          validAfter: payload.validAfter.toString(),
+          validBefore: payload.validBefore.toString(),
+          nonce: payload.nonce
+        }
+      }
+    };
+    return btoa(JSON.stringify(x402Payload));
+  }
+  /**
+   * Setup event listeners for wallet events
+   */
+  setupEventListeners(onAccountsChanged, onChainChanged) {
+    const ethereum = window.ethereum;
+    if (!ethereum?.on || !ethereum?.removeListener) {
+      return () => {
+      };
+    }
+    const handleAccountsChanged = (accounts) => {
+      if (Array.isArray(accounts)) {
+        if (accounts.length === 0) {
+          this.disconnect();
+        } else if (accounts[0] !== this.address) {
+          this.address = accounts[0];
+        }
+        onAccountsChanged?.(accounts);
+      }
+    };
+    const handleChainChanged = (chainIdHex) => {
+      if (typeof chainIdHex === "string") {
+        const chainId = parseInt(chainIdHex, 16);
+        const chain = getChainById(chainId);
+        if (chain) {
+          this.chainId = chainId;
+          this.chainName = chain.name;
+        }
+        onChainChanged?.(chainId);
+      }
+    };
+    ethereum.on("accountsChanged", handleAccountsChanged);
+    ethereum.on("chainChanged", handleChainChanged);
+    return () => {
+      ethereum.removeListener("accountsChanged", handleAccountsChanged);
+      ethereum.removeListener("chainChanged", handleChainChanged);
+    };
+  }
+};
+var evm_default = EVMProvider;
+
+exports.EVMProvider = EVMProvider;
+exports.default = evm_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map