uvd-x402-sdk 2.0.3 → 2.2.0

package/dist/adapters/index.js

@@ -0,0 +1,724 @@
+'use strict';
+
+// 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"
+      },
+      gho: {
+        address: "0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      }
+    },
+    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 USD",
+        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: "EURC",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      },
+      pyusd: {
+        address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8",
+        decimals: 6,
+        name: "PayPal USD",
+        version: "1"
+      },
+      gho: {
+        address: "0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      },
+      crvusd: {
+        address: "0xf939E0A03FB07F59A73314E73794Be0E57ac1b4E",
+        decimals: 18,
+        name: "Curve.Fi USD Stablecoin",
+        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 USD",
+        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 USD",
+        version: "1"
+      },
+      gho: {
+        address: "0x7dfF72693f6A4149b17e7C6314655f6A9F7c8B33",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      },
+      crvusd: {
+        address: "0x498Bf2B1e120FeD3ad3D42EA2165E9b73f99C1e5",
+        decimals: 18,
+        name: "Curve.Fi USD Stablecoin",
+        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"
+      }
+    },
+    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"
+      }
+    },
+    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 USD",
+        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/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",
+  // 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/utils/x402.ts
+function encodeX402Header(header) {
+  return btoa(JSON.stringify(header));
+}
+function createX402V1Header(network, payload) {
+  return {
+    x402Version: 1,
+    scheme: "exact",
+    network,
+    payload
+  };
+}
+
+// src/adapters/wagmi.ts
+function generateNonce() {
+  const bytes = new Uint8Array(32);
+  if (typeof globalThis !== "undefined" && globalThis.crypto?.getRandomValues) {
+    globalThis.crypto.getRandomValues(bytes);
+  } else if (typeof window !== "undefined" && window.crypto?.getRandomValues) {
+    window.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < 32; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return "0x" + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function parseUnits(amount, decimals) {
+  const [integer, fraction = ""] = amount.split(".");
+  const paddedFraction = fraction.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(integer + paddedFraction);
+}
+async function createPaymentFromWalletClient(walletClient, options) {
+  if (!walletClient) {
+    throw new X402Error("WalletClient is not available. Make sure wallet is connected.", "WALLET_NOT_CONNECTED");
+  }
+  const {
+    recipient,
+    amount,
+    chainName = "base",
+    validitySeconds = 300
+  } = options;
+  const chain = getChainByName(chainName);
+  if (!chain) {
+    throw new X402Error(`Unsupported chain: ${chainName}`, "CHAIN_NOT_SUPPORTED");
+  }
+  if (chain.networkType !== "evm") {
+    throw new X402Error(
+      `wagmi adapter only supports EVM chains. For ${chain.networkType}, use the appropriate provider.`,
+      "CHAIN_NOT_SUPPORTED"
+    );
+  }
+  const from = walletClient.account.address;
+  const to = recipient;
+  const nonce = generateNonce();
+  const validAfter = 0;
+  const validBefore = Math.floor(Date.now() / 1e3) + validitySeconds;
+  const value = parseUnits(amount, chain.usdc.decimals);
+  const domain = {
+    name: chain.usdc.name,
+    version: chain.usdc.version,
+    chainId: chain.chainId,
+    verifyingContract: chain.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 message = {
+    from,
+    to,
+    value,
+    validAfter: BigInt(validAfter),
+    validBefore: BigInt(validBefore),
+    nonce
+  };
+  let signature;
+  try {
+    signature = await walletClient.signTypedData({
+      domain,
+      types,
+      primaryType: "TransferWithAuthorization",
+      message
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes("User rejected") || error.message.includes("denied")) {
+        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 header = createX402V1Header(chainName, {
+    signature,
+    authorization: {
+      from,
+      to: recipient,
+      value: value.toString(),
+      validAfter: validAfter.toString(),
+      validBefore: validBefore.toString(),
+      nonce
+    }
+  });
+  return encodeX402Header(header);
+}
+async function createPaymentWithResult(walletClient, options) {
+  const paymentHeader = await createPaymentFromWalletClient(walletClient, options);
+  return {
+    success: true,
+    paymentHeader,
+    network: options.chainName || "base",
+    payer: walletClient?.account.address
+  };
+}
+function useX402Wagmi(walletClient) {
+  const isReady = !!walletClient;
+  const createPayment = async (options) => {
+    return createPaymentFromWalletClient(walletClient, options);
+  };
+  const createPaymentFull = async (options) => {
+    return createPaymentWithResult(walletClient, options);
+  };
+  return {
+    isReady,
+    createPayment,
+    createPaymentFull
+  };
+}
+
+exports.createPaymentFromWalletClient = createPaymentFromWalletClient;
+exports.createPaymentWithResult = createPaymentWithResult;
+exports.useX402Wagmi = useX402Wagmi;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map