sf-x402x 0.6.6-patch.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/README.md +60 -0
  2. package/dist/cjs/client/index.d.ts +64 -0
  3. package/dist/cjs/client/index.js +811 -0
  4. package/dist/cjs/client/index.js.map +1 -0
  5. package/dist/cjs/config-CFBSAuxW.d.ts +10 -0
  6. package/dist/cjs/config-Dfuvno71.d.ts +19 -0
  7. package/dist/cjs/facilitator/index.d.ts +42 -0
  8. package/dist/cjs/facilitator/index.js +1827 -0
  9. package/dist/cjs/facilitator/index.js.map +1 -0
  10. package/dist/cjs/index.d.ts +16 -0
  11. package/dist/cjs/index.js +2207 -0
  12. package/dist/cjs/index.js.map +1 -0
  13. package/dist/cjs/middleware-BcYD9vqv.d.ts +93 -0
  14. package/dist/cjs/middleware-DagbDyNz.d.ts +93 -0
  15. package/dist/cjs/network--RYzQfBg.d.ts +11 -0
  16. package/dist/cjs/network-BGTUrx-D.d.ts +11 -0
  17. package/dist/cjs/paywall/index.d.ts +30 -0
  18. package/dist/cjs/paywall/index.js +141 -0
  19. package/dist/cjs/paywall/index.js.map +1 -0
  20. package/dist/cjs/rpc-De2c0oKR.d.ts +35 -0
  21. package/dist/cjs/rpc-TVntAK7V.d.ts +35 -0
  22. package/dist/cjs/schemes/index.d.ts +298 -0
  23. package/dist/cjs/schemes/index.js +2121 -0
  24. package/dist/cjs/schemes/index.js.map +1 -0
  25. package/dist/cjs/shared/evm/index.d.ts +55 -0
  26. package/dist/cjs/shared/evm/index.js +910 -0
  27. package/dist/cjs/shared/evm/index.js.map +1 -0
  28. package/dist/cjs/shared/index.d.ts +181 -0
  29. package/dist/cjs/shared/index.js +667 -0
  30. package/dist/cjs/shared/index.js.map +1 -0
  31. package/dist/cjs/types/index.d.ts +1214 -0
  32. package/dist/cjs/types/index.js +1408 -0
  33. package/dist/cjs/types/index.js.map +1 -0
  34. package/dist/cjs/verify/index.d.ts +7 -0
  35. package/dist/cjs/verify/index.js +427 -0
  36. package/dist/cjs/verify/index.js.map +1 -0
  37. package/dist/cjs/wallet-BReyvAJs.d.ts +151 -0
  38. package/dist/cjs/wallet-BTqCm9Zp.d.ts +27 -0
  39. package/dist/cjs/wallet-DndoTf1_.d.ts +48 -0
  40. package/dist/cjs/x402Specs-7OH8g851.d.ts +1306 -0
  41. package/dist/cjs/x402Specs-CFX8TBKR.d.ts +1306 -0
  42. package/dist/esm/chunk-5UPAZUO6.mjs +90 -0
  43. package/dist/esm/chunk-5UPAZUO6.mjs.map +1 -0
  44. package/dist/esm/chunk-7CWEZNFA.mjs +812 -0
  45. package/dist/esm/chunk-7CWEZNFA.mjs.map +1 -0
  46. package/dist/esm/chunk-MWDK4RSB.mjs +620 -0
  47. package/dist/esm/chunk-MWDK4RSB.mjs.map +1 -0
  48. package/dist/esm/chunk-R2NI44QI.mjs +327 -0
  49. package/dist/esm/chunk-R2NI44QI.mjs.map +1 -0
  50. package/dist/esm/chunk-WS2W5DJT.mjs +58 -0
  51. package/dist/esm/chunk-WS2W5DJT.mjs.map +1 -0
  52. package/dist/esm/chunk-XZA3USQF.mjs +784 -0
  53. package/dist/esm/chunk-XZA3USQF.mjs.map +1 -0
  54. package/dist/esm/chunk-Z3INM7T4.mjs +106 -0
  55. package/dist/esm/chunk-Z3INM7T4.mjs.map +1 -0
  56. package/dist/esm/client/index.d.mts +64 -0
  57. package/dist/esm/client/index.mjs +17 -0
  58. package/dist/esm/client/index.mjs.map +1 -0
  59. package/dist/esm/config-CFBSAuxW.d.mts +10 -0
  60. package/dist/esm/config-Dfuvno71.d.mts +19 -0
  61. package/dist/esm/facilitator/index.d.mts +42 -0
  62. package/dist/esm/facilitator/index.mjs +14 -0
  63. package/dist/esm/facilitator/index.mjs.map +1 -0
  64. package/dist/esm/index.d.mts +16 -0
  65. package/dist/esm/index.mjs +28 -0
  66. package/dist/esm/index.mjs.map +1 -0
  67. package/dist/esm/middleware-CAOp-bv4.d.mts +93 -0
  68. package/dist/esm/network--RYzQfBg.d.mts +11 -0
  69. package/dist/esm/paywall/index.d.mts +30 -0
  70. package/dist/esm/paywall/index.mjs +46 -0
  71. package/dist/esm/paywall/index.mjs.map +1 -0
  72. package/dist/esm/rpc-22QIQWIu.d.mts +35 -0
  73. package/dist/esm/schemes/index.d.mts +298 -0
  74. package/dist/esm/schemes/index.mjs +16 -0
  75. package/dist/esm/schemes/index.mjs.map +1 -0
  76. package/dist/esm/shared/evm/index.d.mts +55 -0
  77. package/dist/esm/shared/evm/index.mjs +18 -0
  78. package/dist/esm/shared/evm/index.mjs.map +1 -0
  79. package/dist/esm/shared/index.d.mts +181 -0
  80. package/dist/esm/shared/index.mjs +31 -0
  81. package/dist/esm/shared/index.mjs.map +1 -0
  82. package/dist/esm/types/index.d.mts +1214 -0
  83. package/dist/esm/types/index.mjs +81 -0
  84. package/dist/esm/types/index.mjs.map +1 -0
  85. package/dist/esm/verify/index.d.mts +7 -0
  86. package/dist/esm/verify/index.mjs +105 -0
  87. package/dist/esm/verify/index.mjs.map +1 -0
  88. package/dist/esm/wallet-BReyvAJs.d.mts +151 -0
  89. package/dist/esm/wallet-BTqCm9Zp.d.mts +27 -0
  90. package/dist/esm/wallet-C9iHSQbd.d.mts +48 -0
  91. package/dist/esm/x402Specs-7OH8g851.d.mts +1306 -0
  92. package/package.json +152 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/types/shared/money.ts","../../src/types/shared/network.ts","../../src/types/shared/evm/wallet.ts","../../src/shared/svm/wallet.ts","../../src/shared/svm/rpc.ts","../../src/types/shared/wallet.ts","../../src/types/shared/evm/index.ts","../../src/types/shared/evm/eip3009.ts","../../src/types/shared/svm/index.ts","../../src/types/shared/svm/regex.ts","../../src/types/verify/x402Specs.ts","../../src/shared/base64.ts","../../src/types/verify/facilitator.ts","../../src/shared/json.ts","../../src/shared/network.ts","../../src/shared/middleware.ts","../../src/shared/svm/index.ts","../../src/shared/svm/transaction.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const moneySchema = z\n .union([z.string().transform(x => x.replace(/[^0-9.-]+/g, \"\")), z.number()])\n .pipe(z.coerce.number().min(0.0001).max(999999999));\n\nexport type Money = z.input<typeof moneySchema>;\n","import { z } from \"zod\";\n\nexport const NetworkSchema = z.enum([\n \"base-sepolia\",\n \"base\",\n \"avalanche-fuji\",\n \"avalanche\",\n \"iotex\",\n \"solana-devnet\",\n \"solana\",\n \"sei\",\n \"sei-testnet\",\n \"polygon\",\n \"polygon-amoy\",\n \"peaq\",\n \"x-layer\",\n \"x-layer-testnet\",\n \"sepolia\",\n \"filecoin-calibration\",\n]);\nexport type Network = z.infer<typeof NetworkSchema>;\n\n// evm\nexport const SupportedEVMNetworks: Network[] = [\n \"base-sepolia\",\n \"base\",\n \"avalanche-fuji\",\n \"avalanche\",\n \"iotex\",\n \"sei\",\n \"sei-testnet\",\n \"polygon\",\n \"polygon-amoy\",\n \"peaq\",\n \"x-layer\",\n \"x-layer-testnet\",\n \"sepolia\",\n \"filecoin-calibration\",\n];\nexport const EvmNetworkToChainId = new Map<Network, number>([\n [\"base-sepolia\", 84532],\n [\"base\", 8453],\n [\"avalanche-fuji\", 43113],\n [\"avalanche\", 43114],\n [\"iotex\", 4689],\n [\"sei\", 1329],\n [\"sei-testnet\", 1328],\n [\"polygon\", 137],\n [\"polygon-amoy\", 80002],\n [\"peaq\", 3338],\n [\"x-layer\", 196],\n [\"x-layer-testnet\", 1952],\n [\"sepolia\", 11155111],\n [\"filecoin-calibration\", 314159],\n]);\n\n// svm\nexport const SupportedSVMNetworks: Network[] = [\"solana-devnet\", \"solana\"];\nexport const SvmNetworkToChainId = new Map<Network, number>([\n [\"solana-devnet\", 103],\n [\"solana\", 101],\n]);\n\nexport const ChainIdToNetwork = Object.fromEntries(\n [...SupportedEVMNetworks, ...SupportedSVMNetworks].map(network => [\n EvmNetworkToChainId.get(network),\n network,\n ]),\n) as Record<number, Network>;\n","import { createPublicClient, createWalletClient, http, publicActions, defineChain } from \"viem\";\nimport type {\n Chain,\n Transport,\n Client,\n Account,\n RpcSchema,\n PublicActions,\n WalletActions,\n PublicClient,\n LocalAccount,\n} from \"viem\";\nimport {\n baseSepolia,\n avalancheFuji,\n base,\n sei,\n seiTestnet,\n polygon,\n polygonAmoy,\n peaq,\n avalanche,\n iotexTestnet,\n iotex,\n} from \"viem/chains\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { Hex } from \"viem\";\n\n// X-Layer Mainnet Chain Definition\nexport const xLayer = defineChain({\n id: 196,\n name: \"X Layer\",\n nativeCurrency: { name: \"OKB\", symbol: \"OKB\", decimals: 18 },\n rpcUrls: {\n default: { http: [\"https://rpc.xlayer.tech\"] },\n },\n blockExplorers: {\n default: { name: \"OKLink\", url: \"https://www.oklink.com/xlayer\" },\n },\n});\n\n// X-Layer Testnet Chain Definition\nexport const xLayerTestnet = defineChain({\n id: 1952,\n name: \"X Layer Testnet\",\n nativeCurrency: { name: \"OKB\", symbol: \"OKB\", decimals: 18 },\n rpcUrls: {\n default: { http: [\"https://testrpc.xlayer.tech/terigon\"] },\n },\n blockExplorers: {\n default: { name: \"OKLink\", url: \"https://www.oklink.com/xlayer-test\" },\n },\n testnet: true,\n});\n\n// Create a public client for reading data\nexport type SignerWallet<\n chain extends Chain = Chain,\n transport extends Transport = Transport,\n account extends Account = Account,\n> = Client<\n transport,\n chain,\n account,\n RpcSchema,\n PublicActions<transport, chain, account> & WalletActions<chain, account>\n>;\n\nexport type ConnectedClient<\n transport extends Transport = Transport,\n chain extends Chain | undefined = Chain,\n account extends Account | undefined = undefined,\n> = PublicClient<transport, chain, account>;\n\nexport type EvmSigner = SignerWallet<Chain, Transport, Account> | LocalAccount;\n\n/**\n * Creates a public client configured for the specified network\n *\n * @param network - The network to connect to\n * @returns A public client instance connected to the specified chain\n */\nexport function createConnectedClient(\n network: string,\n): ConnectedClient<Transport, Chain, undefined> {\n const chain = getChainFromNetwork(network);\n return createPublicClient({\n chain,\n transport: http(),\n }).extend(publicActions);\n}\n\n/**\n * Creates a public client configured for the Base Sepolia testnet\n *\n * @deprecated Use `createConnectedClient(\"base-sepolia\")` instead\n * @returns A public client instance connected to Base Sepolia\n */\nexport function createClientSepolia(): ConnectedClient<Transport, typeof baseSepolia, undefined> {\n return createConnectedClient(\"base-sepolia\") as ConnectedClient<\n Transport,\n typeof baseSepolia,\n undefined\n >;\n}\n\n/**\n * Creates a public client configured for the Avalanche Fuji testnet\n *\n * @deprecated Use `createConnectedClient(\"avalanche-fuji\")` instead\n * @returns A public client instance connected to Avalanche Fuji\n */\nexport function createClientAvalancheFuji(): ConnectedClient<\n Transport,\n typeof avalancheFuji,\n undefined\n> {\n return createConnectedClient(\"avalanche-fuji\") as ConnectedClient<\n Transport,\n typeof avalancheFuji,\n undefined\n >;\n}\n\n/**\n * Creates a wallet client configured for the specified chain with a private key\n *\n * @param network - The network to connect to\n * @param privateKey - The private key to use for signing transactions\n * @returns A wallet client instance connected to the specified chain with the provided private key\n */\nexport function createSigner(network: string, privateKey: Hex): SignerWallet<Chain> {\n const chain = getChainFromNetwork(network);\n return createWalletClient({\n chain,\n transport: http(),\n account: privateKeyToAccount(privateKey),\n }).extend(publicActions);\n}\n\n/**\n * Creates a wallet client configured for the Base Sepolia testnet with a private key\n *\n * @deprecated Use `createSigner(\"base-sepolia\", privateKey)` instead\n * @param privateKey - The private key to use for signing transactions\n * @returns A wallet client instance connected to Base Sepolia with the provided private key\n */\nexport function createSignerSepolia(privateKey: Hex): SignerWallet<typeof baseSepolia> {\n return createSigner(\"base-sepolia\", privateKey) as SignerWallet<typeof baseSepolia>;\n}\n\n/**\n * Creates a wallet client configured for the Avalanche Fuji testnet with a private key\n *\n * @deprecated Use `createSigner(\"avalanche-fuji\", privateKey)` instead\n * @param privateKey - The private key to use for signing transactions\n * @returns A wallet client instance connected to Avalanche Fuji with the provided private key\n */\nexport function createSignerAvalancheFuji(privateKey: Hex): SignerWallet<typeof avalancheFuji> {\n return createSigner(\"avalanche-fuji\", privateKey) as SignerWallet<typeof avalancheFuji>;\n}\n\n/**\n * Checks if a wallet is a signer wallet\n *\n * @param wallet - The wallet to check\n * @returns True if the wallet is a signer wallet, false otherwise\n */\nexport function isSignerWallet<\n TChain extends Chain = Chain,\n TTransport extends Transport = Transport,\n TAccount extends Account = Account,\n>(\n wallet: SignerWallet<TChain, TTransport, TAccount> | LocalAccount,\n): wallet is SignerWallet<TChain, TTransport, TAccount> {\n return (\n typeof wallet === \"object\" && wallet !== null && \"chain\" in wallet && \"transport\" in wallet\n );\n}\n\n/**\n * Checks if a wallet is an account\n *\n * @param wallet - The wallet to check\n * @returns True if the wallet is an account, false otherwise\n */\nexport function isAccount<\n TChain extends Chain = Chain,\n TTransport extends Transport = Transport,\n TAccount extends Account = Account,\n>(wallet: SignerWallet<TChain, TTransport, TAccount> | LocalAccount): wallet is LocalAccount {\n const w = wallet as LocalAccount;\n return (\n typeof wallet === \"object\" &&\n wallet !== null &&\n typeof w.address === \"string\" &&\n typeof w.type === \"string\" &&\n // Check for essential signing capabilities\n typeof w.sign === \"function\" &&\n typeof w.signMessage === \"function\" &&\n typeof w.signTypedData === \"function\" &&\n // Check for transaction signing (required by LocalAccount)\n typeof w.signTransaction === \"function\"\n );\n}\n\n/**\n * Maps network strings to Chain objects\n *\n * @param network - The network string to convert to a Chain object\n * @returns The corresponding Chain object\n */\nexport function getChainFromNetwork(network: string | undefined): Chain {\n if (!network) {\n throw new Error(\"NETWORK environment variable is not set\");\n }\n\n switch (network) {\n case \"base\":\n return base;\n case \"base-sepolia\":\n return baseSepolia;\n case \"avalanche\":\n return avalanche;\n case \"avalanche-fuji\":\n return avalancheFuji;\n case \"sei\":\n return sei;\n case \"sei-testnet\":\n return seiTestnet;\n case \"polygon\":\n return polygon;\n case \"polygon-amoy\":\n return polygonAmoy;\n case \"peaq\":\n return peaq;\n case \"iotex\":\n return iotex;\n case \"iotex-testnet\":\n return iotexTestnet;\n case \"x-layer\":\n return xLayer;\n case \"x-layer-testnet\":\n return xLayerTestnet;\n default:\n throw new Error(`Unsupported network: ${network}`);\n }\n}\n","import {\n createKeyPairSignerFromBytes,\n type KeyPairSigner,\n createKeyPairSignerFromPrivateKeyBytes,\n type RpcDevnet,\n type SolanaRpcApiDevnet,\n type RpcMainnet,\n type SolanaRpcApiMainnet,\n isKeyPairSigner,\n} from \"@solana/kit\";\nimport { base58 } from \"@scure/base\";\nimport { getRpcClient } from \"./rpc\";\nimport { Network, SupportedSVMNetworks } from \"../../types/shared\";\nexport type { KeyPairSigner } from \"@solana/kit\";\n\nexport type SvmConnectedClient = RpcDevnet<SolanaRpcApiDevnet> | RpcMainnet<SolanaRpcApiMainnet>;\nexport type SvmSigner = KeyPairSigner;\n\n/**\n * Creates a public client configured for the specified SVM network\n *\n * @param network - The network to connect to\n * @returns A public client instance connected to the specified chain\n */\nexport function createSvmConnectedClient(network: string): SvmConnectedClient {\n if (!SupportedSVMNetworks.find(n => n === network)) {\n throw new Error(`Unsupported SVM network: ${network}`);\n }\n return getRpcClient(network as Network);\n}\n\n/**\n * Creates a Solana signer from a private key.\n *\n * @param privateKey - The base58 encoded private key to create a signer from.\n * @returns A Solana signer.\n */\nexport async function createSignerFromBase58(privateKey: string): Promise<KeyPairSigner> {\n // decode the base58 encoded private key\n const bytes = base58.decode(privateKey);\n\n // generate a keypair signer from the bytes based on the byte-length\n // 64 bytes represents concatenated private + public key\n if (bytes.length === 64) {\n return await createKeyPairSignerFromBytes(bytes);\n }\n // 32 bytes represents only the private key\n if (bytes.length === 32) {\n return await createKeyPairSignerFromPrivateKeyBytes(bytes);\n }\n throw new Error(`Unexpected key length: ${bytes.length}. Expected 32 or 64 bytes.`);\n}\n\n/**\n * Checks if the given wallet is a solana KeyPairSigner wallet.\n *\n * @param wallet - The object wallet to check.\n * @returns True if the wallet is a solana KeyPairSigner wallet, false otherwise.\n */\nexport function isSignerWallet(wallet: SvmSigner): wallet is SvmSigner {\n return isKeyPairSigner(wallet);\n}\n","import {\n createSolanaRpc,\n devnet,\n mainnet,\n RpcDevnet,\n SolanaRpcApiDevnet,\n SolanaRpcApiMainnet,\n RpcMainnet,\n createSolanaRpcSubscriptions,\n RpcSubscriptionsFromTransport,\n SolanaRpcSubscriptionsApi,\n RpcSubscriptionsTransportFromClusterUrl,\n ClusterUrl,\n} from \"@solana/kit\";\nimport { Network } from \"../../types/shared\";\n\n/**\n * Default public RPC endpoint for Solana devnet\n */\nconst DEVNET_RPC_URL = \"https://api.devnet.solana.com\";\n\n/**\n * Default public RPC endpoint for Solana mainnet\n */\nconst MAINNET_RPC_URL = \"https://api.mainnet-beta.solana.com\";\n\n/**\n * Default public WebSocket endpoint for Solana devnet\n */\nconst DEVNET_WS_URL = \"wss://api.devnet.solana.com\";\n\n/**\n * Default public WebSocket endpoint for Solana mainnet\n */\nconst MAINNET_WS_URL = \"wss://api.mainnet-beta.solana.com\";\n\n/**\n * Creates a Solana RPC client for the devnet network.\n *\n * @param url - Optional URL of the devnet network.\n * @returns A Solana RPC client.\n */\nexport function createDevnetRpcClient(url?: string): RpcDevnet<SolanaRpcApiDevnet> {\n return createSolanaRpc(\n url ? devnet(url) : devnet(DEVNET_RPC_URL),\n ) as RpcDevnet<SolanaRpcApiDevnet>;\n}\n\n/**\n * Creates a Solana RPC client for the mainnet network.\n *\n * @param url - Optional URL of the mainnet network.\n * @returns A Solana RPC client.\n */\nexport function createMainnetRpcClient(url?: string): RpcMainnet<SolanaRpcApiMainnet> {\n return createSolanaRpc(\n url ? mainnet(url) : mainnet(MAINNET_RPC_URL),\n ) as RpcMainnet<SolanaRpcApiMainnet>;\n}\n\n/**\n * Gets the RPC client for the given network.\n *\n * @param network - The network to get the RPC client for\n * @param url - Optional URL of the network. If not provided, the default URL will be used.\n * @returns The RPC client for the given network\n */\nexport function getRpcClient(\n network: Network,\n url?: string,\n): RpcDevnet<SolanaRpcApiDevnet> | RpcMainnet<SolanaRpcApiMainnet> {\n // TODO: should the networks be replaced with enum references?\n if (network === \"solana-devnet\") {\n return createDevnetRpcClient(url);\n } else if (network === \"solana\") {\n return createMainnetRpcClient(url);\n } else {\n throw new Error(\"Invalid network\");\n }\n}\n\n/**\n * Gets the RPC subscriptions for the given network.\n *\n * @param network - The network to get the RPC subscriptions for\n * @param url - Optional URL of the network. If not provided, the default URL will be used.\n * @returns The RPC subscriptions for the given network\n */\nexport function getRpcSubscriptions(\n network: Network,\n url?: string,\n): RpcSubscriptionsFromTransport<\n SolanaRpcSubscriptionsApi,\n RpcSubscriptionsTransportFromClusterUrl<ClusterUrl>\n> {\n // TODO: should the networks be replaced with enum references?\n if (network === \"solana-devnet\") {\n return createSolanaRpcSubscriptions(devnet(url ? httpToWs(url) : DEVNET_WS_URL));\n } else if (network === \"solana\") {\n return createSolanaRpcSubscriptions(mainnet(url ? httpToWs(url) : MAINNET_WS_URL));\n } else {\n throw new Error(\"Invalid network\");\n }\n}\n\n/**\n *\n * Converts an HTTP URL to a WebSocket URL\n *\n * @param url - The URL to convert to a WebSocket URL\n * @returns The WebSocket URL\n */\nfunction httpToWs(url: string): string {\n if (url.startsWith(\"http\")) {\n return url.replace(\"http\", \"ws\");\n }\n return url;\n}\n","import * as evm from \"./evm/wallet\";\nimport * as svm from \"../../shared/svm/wallet\";\nimport { SupportedEVMNetworks, SupportedSVMNetworks } from \"./network\";\nimport { Hex } from \"viem\";\n\nexport type ConnectedClient = evm.ConnectedClient | svm.SvmConnectedClient;\nexport type Signer = evm.EvmSigner | svm.SvmSigner;\nexport type MultiNetworkSigner = { evm: evm.EvmSigner; svm: svm.SvmSigner };\n\n/**\n * Creates a public client configured for the specified network.\n *\n * @param network - The network to connect to.\n * @returns A public client instance connected to the specified chain.\n */\nexport function createConnectedClient(network: string): ConnectedClient {\n if (SupportedEVMNetworks.find(n => n === network)) {\n return evm.createConnectedClient(network);\n }\n\n if (SupportedSVMNetworks.find(n => n === network)) {\n return svm.createSvmConnectedClient(network);\n }\n\n throw new Error(`Unsupported network: ${network}`);\n}\n\n/**\n * Creates a wallet client configured for the specified chain with a private key.\n *\n * @param network - The network to connect to.\n * @param privateKey - The private key to use for signing transactions. This should be a hex string for EVM or a base58 encoded string for SVM.\n * @returns A wallet client instance connected to the specified chain with the provided private key.\n */\nexport function createSigner(network: string, privateKey: Hex | string): Promise<Signer> {\n // evm\n if (SupportedEVMNetworks.find(n => n === network)) {\n return Promise.resolve(evm.createSigner(network, privateKey as Hex));\n }\n\n // svm\n if (SupportedSVMNetworks.find(n => n === network)) {\n return svm.createSignerFromBase58(privateKey as string);\n }\n\n throw new Error(`Unsupported network: ${network}`);\n}\n\n/**\n * Checks if the given wallet is an EVM signer wallet.\n *\n * @param wallet - The object wallet to check.\n * @returns True if the wallet is an EVM signer wallet, false otherwise.\n */\nexport function isEvmSignerWallet(wallet: Signer): wallet is evm.EvmSigner {\n return evm.isSignerWallet(wallet as evm.EvmSigner) || evm.isAccount(wallet as evm.EvmSigner);\n}\n\n/**\n * Checks if the given wallet is an SVM signer wallet\n *\n * @param wallet - The object wallet to check\n * @returns True if the wallet is an SVM signer wallet, false otherwise\n */\nexport function isSvmSignerWallet(wallet: Signer): wallet is svm.SvmSigner {\n return svm.isSignerWallet(wallet as svm.SvmSigner);\n}\n\n/**\n * Checks if the given wallet is a multi network signer wallet\n *\n * @param wallet - The object wallet to check\n * @returns True if the wallet is a multi network signer wallet, false otherwise\n */\nexport function isMultiNetworkSigner(wallet: object): wallet is MultiNetworkSigner {\n return \"evm\" in wallet && \"svm\" in wallet;\n}\n","export * from \"./config\";\nexport * from \"./eip3009\";\nexport * from \"./erc20PermitABI\";\nexport * from \"./wallet\";\n","export const authorizationTypes = {\n TransferWithAuthorization: [\n { name: \"from\", type: \"address\" },\n { name: \"to\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"validAfter\", type: \"uint256\" },\n { name: \"validBefore\", type: \"uint256\" },\n { name: \"nonce\", type: \"bytes32\" },\n ],\n};\n\nexport const authorizationPrimaryType = \"TransferWithAuthorization\";\n","export * from \"./regex\";\n","export const SvmAddressRegex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n","import { z } from \"zod\";\nimport { NetworkSchema } from \"../shared\";\nimport { SvmAddressRegex } from \"../shared/svm\";\nimport { Base64EncodedRegex } from \"../../shared/base64\";\n\n// Constants\nconst EvmMaxAtomicUnits = 18;\nconst EvmAddressRegex = /^0x[0-9a-fA-F]{40}$/;\nconst MixedAddressRegex = /^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$/;\nconst HexEncoded64ByteRegex = /^0x[0-9a-fA-F]{64}$/;\nconst EvmSignatureRegex = /^0x[0-9a-fA-F]+$/; // Flexible hex signature validation\n// Enums\nexport const schemes = [\"exact\"] as const;\nexport const x402Versions = [1] as const;\nexport const ErrorReasons = [\n \"insufficient_funds\",\n \"invalid_exact_evm_payload_authorization_valid_after\",\n \"invalid_exact_evm_payload_authorization_valid_before\",\n \"invalid_exact_evm_payload_authorization_value\",\n \"invalid_exact_evm_payload_signature\",\n \"invalid_exact_evm_payload_recipient_mismatch\",\n \"invalid_exact_svm_payload_transaction\",\n \"invalid_exact_svm_payload_transaction_amount_mismatch\",\n \"invalid_exact_svm_payload_transaction_create_ata_instruction\",\n \"invalid_exact_svm_payload_transaction_create_ata_instruction_incorrect_payee\",\n \"invalid_exact_svm_payload_transaction_create_ata_instruction_incorrect_asset\",\n \"invalid_exact_svm_payload_transaction_instructions\",\n \"invalid_exact_svm_payload_transaction_instructions_length\",\n \"invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction\",\n \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction\",\n \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction_too_high\",\n \"invalid_exact_svm_payload_transaction_instruction_not_spl_token_transfer_checked\",\n \"invalid_exact_svm_payload_transaction_instruction_not_token_2022_transfer_checked\",\n \"invalid_exact_svm_payload_transaction_not_a_transfer_instruction\",\n \"invalid_exact_svm_payload_transaction_receiver_ata_not_found\",\n \"invalid_exact_svm_payload_transaction_sender_ata_not_found\",\n \"invalid_exact_svm_payload_transaction_simulation_failed\",\n \"invalid_exact_svm_payload_transaction_transfer_to_incorrect_ata\",\n \"invalid_network\",\n \"invalid_payload\",\n \"invalid_payment_requirements\",\n \"invalid_scheme\",\n \"invalid_payment\",\n \"payment_expired\",\n \"unsupported_scheme\",\n \"invalid_x402_version\",\n \"invalid_transaction_state\",\n \"invalid_x402_version\",\n \"settle_exact_svm_block_height_exceeded\",\n \"settle_exact_svm_transaction_confirmation_timed_out\",\n \"unsupported_scheme\",\n \"unexpected_settle_error\",\n \"unexpected_verify_error\",\n] as const;\n\n// Refiners\nconst isInteger: (value: string) => boolean = value =>\n Number.isInteger(Number(value)) && Number(value) >= 0;\nconst hasMaxLength = (maxLength: number) => (value: string) => value.length <= maxLength;\n\n// x402PaymentRequirements\nconst EvmOrSvmAddress = z.string().regex(EvmAddressRegex).or(z.string().regex(SvmAddressRegex));\nconst mixedAddressOrSvmAddress = z\n .string()\n .regex(MixedAddressRegex)\n .or(z.string().regex(SvmAddressRegex));\nexport const PaymentRequirementsSchema = z.object({\n scheme: z.enum(schemes),\n network: NetworkSchema,\n maxAmountRequired: z.string().refine(isInteger),\n resource: z.string().url(),\n description: z.string(),\n mimeType: z.string(),\n outputSchema: z.record(z.any()).optional(),\n payTo: EvmOrSvmAddress,\n maxTimeoutSeconds: z.number().int(),\n asset: mixedAddressOrSvmAddress,\n extra: z.record(z.any()).optional(),\n});\nexport type PaymentRequirements = z.infer<typeof PaymentRequirementsSchema>;\n\n// x402ExactEvmPayload\nexport const ExactEvmPayloadAuthorizationSchema = z.object({\n from: z.string().regex(EvmAddressRegex),\n to: z.string().regex(EvmAddressRegex),\n value: z.string().refine(isInteger).refine(hasMaxLength(EvmMaxAtomicUnits)),\n validAfter: z.string().refine(isInteger),\n validBefore: z.string().refine(isInteger),\n nonce: z.string().regex(HexEncoded64ByteRegex),\n});\nexport type ExactEvmPayloadAuthorization = z.infer<typeof ExactEvmPayloadAuthorizationSchema>;\n\nexport const ExactEvmPayloadSchema = z.object({\n signature: z.string().regex(EvmSignatureRegex),\n authorization: ExactEvmPayloadAuthorizationSchema,\n});\nexport type ExactEvmPayload = z.infer<typeof ExactEvmPayloadSchema>;\n\n// x402ExactSvmPayload\nexport const ExactSvmPayloadSchema = z.object({\n transaction: z.string().regex(Base64EncodedRegex),\n});\nexport type ExactSvmPayload = z.infer<typeof ExactSvmPayloadSchema>;\n\n// x402PaymentPayload\nexport const PaymentPayloadSchema = z.object({\n x402Version: z.number().refine(val => x402Versions.includes(val as 1)),\n scheme: z.enum(schemes),\n network: NetworkSchema,\n payload: z.union([ExactEvmPayloadSchema, ExactSvmPayloadSchema]),\n paymentRequirements: PaymentRequirementsSchema.optional(),\n});\nexport type PaymentPayload = z.infer<typeof PaymentPayloadSchema>;\nexport type UnsignedPaymentPayload = Omit<PaymentPayload, \"payload\"> & {\n payload: Omit<ExactEvmPayload, \"signature\"> & { signature: undefined };\n};\n\n// x402 Resource Server Response\nexport const x402ResponseSchema = z.object({\n x402Version: z.number().refine(val => x402Versions.includes(val as 1)),\n error: z.enum(ErrorReasons).optional(),\n accepts: z.array(PaymentRequirementsSchema).optional(),\n payer: z.string().regex(MixedAddressRegex).optional(),\n});\nexport type x402Response = z.infer<typeof x402ResponseSchema>;\n\n// x402RequestStructure\nconst HTTPVerbsSchema = z.enum([\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\", \"OPTIONS\", \"HEAD\"]);\nexport type HTTPVerbs = z.infer<typeof HTTPVerbsSchema>;\n\nexport const HTTPRequestStructureSchema = z.object({\n type: z.literal(\"http\"),\n method: HTTPVerbsSchema,\n queryParams: z.record(z.string(), z.string()).optional(),\n bodyType: z.enum([\"json\", \"form-data\", \"multipart-form-data\", \"text\", \"binary\"]).optional(),\n bodyFields: z.record(z.string(), z.any()).optional(),\n headerFields: z.record(z.string(), z.any()).optional(),\n});\n\n// export const MCPRequestStructureSchema = z.object({\n// type: z.literal(\"mcp\"),\n// sessionIsPayed: z.boolean(),\n// payedAction: z.object({\n// kind: z.enum([\"prompts\", \"resources\", \"tools\"]),\n// name: z.string(),\n// }).optional(),\n// });\n\n// export const OpenAPIRequestStructureSchema = z.object({\n// type: z.literal(\"openapi\"),\n// openApiUrl: z.string().url(),\n// path: z.string(),\n// });\n\nexport const RequestStructureSchema = z.discriminatedUnion(\"type\", [\n HTTPRequestStructureSchema,\n // MCPRequestStructureSchema,\n // OpenAPIRequestStructureSchema,\n]);\n\nexport type HTTPRequestStructure = z.infer<typeof HTTPRequestStructureSchema>;\n// export type MCPRequestStructure = z.infer<typeof MCPRequestStructureSchema>;\n// export type OpenAPIRequestStructure = z.infer<typeof OpenAPIRequestStructureSchema>;\nexport type RequestStructure = z.infer<typeof RequestStructureSchema>;\n\n// x402DiscoveryResource\nexport const DiscoveredResourceSchema = z.object({\n resource: z.string(),\n type: z.enum([\"http\"]),\n x402Version: z.number().refine(val => x402Versions.includes(val as 1)),\n accepts: z.array(PaymentRequirementsSchema),\n lastUpdated: z.date(),\n metadata: z.record(z.any()).optional(),\n});\nexport type DiscoveredResource = z.infer<typeof DiscoveredResourceSchema>;\n\n// x402SettleRequest\nexport const SettleRequestSchema = z.object({\n paymentPayload: PaymentPayloadSchema,\n paymentRequirements: PaymentRequirementsSchema,\n});\nexport type SettleRequest = z.infer<typeof SettleRequestSchema>;\n\n// x402VerifyRequest\nexport const VerifyRequestSchema = z.object({\n paymentPayload: PaymentPayloadSchema,\n paymentRequirements: PaymentRequirementsSchema,\n});\nexport type VerifyRequest = z.infer<typeof VerifyRequestSchema>;\n\n// x402VerifyResponse\nexport const VerifyResponseSchema = z.object({\n isValid: z.boolean(),\n invalidReason: z.enum(ErrorReasons).optional(),\n payer: EvmOrSvmAddress.optional(),\n});\nexport type VerifyResponse = z.infer<typeof VerifyResponseSchema>;\n\n// x402SettleResponse\nexport const SettleResponseSchema = z.object({\n success: z.boolean(),\n errorReason: z.enum(ErrorReasons).optional(),\n payer: EvmOrSvmAddress.optional(),\n transaction: z.string().regex(MixedAddressRegex),\n network: NetworkSchema,\n});\nexport type SettleResponse = z.infer<typeof SettleResponseSchema>;\n\n// x402DiscoverListRequest\nexport const ListDiscoveryResourcesRequestSchema = z.object({\n type: z.string().optional(),\n limit: z.number().optional(),\n offset: z.number().optional(),\n});\nexport type ListDiscoveryResourcesRequest = z.infer<typeof ListDiscoveryResourcesRequestSchema>;\n\n// x402ListDiscoveryResourcesResponse\nexport const ListDiscoveryResourcesResponseSchema = z.object({\n x402Version: z.number().refine(val => x402Versions.includes(val as 1)),\n items: z.array(DiscoveredResourceSchema),\n pagination: z.object({\n limit: z.number(),\n offset: z.number(),\n total: z.number(),\n }),\n});\nexport type ListDiscoveryResourcesResponse = z.infer<typeof ListDiscoveryResourcesResponseSchema>;\n\n// x402SupportedPaymentKind\nexport const SupportedPaymentKindSchema = z.object({\n x402Version: z.number().refine(val => x402Versions.includes(val as 1)),\n scheme: z.enum(schemes),\n network: NetworkSchema,\n extra: z.record(z.any()).optional(),\n});\nexport type SupportedPaymentKind = z.infer<typeof SupportedPaymentKindSchema>;\n\n// x402SupportedPaymentKindsResponse\nexport const SupportedPaymentKindsResponseSchema = z.object({\n kinds: z.array(SupportedPaymentKindSchema),\n});\nexport type SupportedPaymentKindsResponse = z.infer<typeof SupportedPaymentKindsResponseSchema>;\n","export const Base64EncodedRegex = /^[A-Za-z0-9+/]*={0,2}$/;\n\n/**\n * Encodes a string to base64 format\n *\n * @param data - The string to be encoded to base64\n * @returns The base64 encoded string\n */\nexport function safeBase64Encode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.btoa === \"function\") {\n return globalThis.btoa(data);\n }\n return Buffer.from(data).toString(\"base64\");\n}\n\n/**\n * Decodes a base64 string back to its original format\n *\n * @param data - The base64 encoded string to be decoded\n * @returns The decoded string in UTF-8 format\n */\nexport function safeBase64Decode(data: string): string {\n if (typeof globalThis !== \"undefined\" && typeof globalThis.atob === \"function\") {\n return globalThis.atob(data);\n }\n return Buffer.from(data, \"base64\").toString(\"utf-8\");\n}\n","import { z } from \"zod\";\nimport { safeBase64Decode, safeBase64Encode } from \"../../shared\";\nimport { PaymentRequirementsSchema, SettleResponse } from \"./x402Specs\";\n\nexport const facilitatorRequestSchema = z.object({\n paymentHeader: z.string(),\n paymentRequirements: PaymentRequirementsSchema,\n});\n\nexport type FacilitatorRequest = z.infer<typeof facilitatorRequestSchema>;\n\n/**\n * Encodes a settlement response into a base64 header string\n *\n * @param response - The settlement response to encode\n * @returns A base64 encoded string containing the settlement response\n */\nexport function settleResponseHeader(response: SettleResponse): string {\n return safeBase64Encode(JSON.stringify(response));\n}\n\n/**\n * Decodes a base64 header string back into a settlement response\n *\n * @param header - The base64 encoded settlement response header\n * @returns The decoded settlement response object\n */\nexport function settleResponseFromHeader(header: string): SettleResponse {\n const decoded = safeBase64Decode(header);\n return JSON.parse(decoded) as SettleResponse;\n}\n","/**\n * Converts an object to a JSON-safe format by converting bigint values to strings\n * and recursively processing nested objects and arrays\n *\n * @param data - The object to convert to JSON-safe format\n * @returns A new object with all bigint values converted to strings\n */\nexport function toJsonSafe<T extends object>(data: T): object {\n if (typeof data !== \"object\") {\n throw new Error(\"Data is not an object\");\n }\n\n /**\n * Recursively converts values to JSON-safe format\n *\n * @param value - The value to convert\n * @returns The converted value with bigints as strings\n */\n function convert(value: unknown): unknown {\n if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, convert(val)]));\n }\n\n if (Array.isArray(value)) {\n return value.map(convert);\n }\n\n if (typeof value === \"bigint\") {\n return value.toString();\n }\n return value;\n }\n\n return convert(data) as object;\n}\n","import { EvmNetworkToChainId, Network, SvmNetworkToChainId } from \"../types/shared\";\n\n/**\n * Converts a network name to its corresponding chain ID\n *\n * @param network - The network name to convert to a chain ID\n * @returns The chain ID for the specified network\n * @throws Error if the network is not supported\n */\nexport function getNetworkId(network: Network): number {\n if (EvmNetworkToChainId.has(network)) {\n return EvmNetworkToChainId.get(network)!;\n }\n if (SvmNetworkToChainId.has(network)) {\n return SvmNetworkToChainId.get(network)!;\n }\n throw new Error(`Unsupported network: ${network}`);\n}\n","import { Address, Hex } from \"viem\";\nimport {\n moneySchema,\n Network,\n Price,\n RouteConfig,\n RoutePattern,\n ERC20TokenAmount,\n PaymentRequirements,\n PaymentPayload,\n SPLTokenAmount,\n} from \"../types\";\nimport { RoutesConfig } from \"../types\";\nimport { safeBase64Decode } from \"./base64\";\nimport { getUsdcChainConfigForChain } from \"./evm\";\nimport { getNetworkId } from \"./network\";\n\n/**\n * Computes the route patterns for the given routes config\n *\n * @param routes - The routes config to compute the patterns for\n * @returns The route patterns\n */\nexport function computeRoutePatterns(routes: RoutesConfig): RoutePattern[] {\n const normalizedRoutes = Object.fromEntries(\n Object.entries(routes).map(([pattern, value]) => [\n pattern,\n typeof value === \"string\" || typeof value === \"number\"\n ? ({ price: value, network: \"base-sepolia\" } as RouteConfig)\n : (value as RouteConfig),\n ]),\n );\n\n return Object.entries(normalizedRoutes).map(([pattern, routeConfig]) => {\n // Split pattern into verb and path, defaulting to \"*\" for verb if not specified\n const [verb, path] = pattern.includes(\" \") ? pattern.split(/\\s+/) : [\"*\", pattern];\n if (!path) {\n throw new Error(`Invalid route pattern: ${pattern}`);\n }\n return {\n verb: verb.toUpperCase(),\n pattern: new RegExp(\n `^${\n path\n // First escape all special regex characters except * and []\n .replace(/[$()+.?^{|}]/g, \"\\\\$&\")\n // Then handle our special pattern characters\n .replace(/\\*/g, \".*?\") // Make wildcard non-greedy and optional\n .replace(/\\[([^\\]]+)\\]/g, \"[^/]+\") // Convert [param] to regex capture\n .replace(/\\//g, \"\\\\/\") // Escape slashes\n }$`,\n \"i\",\n ),\n config: routeConfig,\n };\n });\n}\n\n/**\n * Finds the matching route pattern for the given path and method\n *\n * @param routePatterns - The route patterns to search through\n * @param path - The path to match against\n * @param method - The HTTP method to match against\n * @returns The matching route pattern or undefined if no match is found\n */\nexport function findMatchingRoute(\n routePatterns: RoutePattern[],\n path: string,\n method: string,\n): RoutePattern | undefined {\n // Normalize the path:\n // 1. Remove query parameters and hash fragments\n // 2. Replace backslashes with forward slashes\n // 3. Replace multiple consecutive slashes with a single slash\n // 4. Keep trailing slash if path is not root\n let normalizedPath: string;\n try {\n // First split off query parameters and hash fragments\n const pathWithoutQuery = path.split(/[?#]/)[0];\n\n // Then decode the path - this needs to happen before any normalization\n // so encoded characters are properly handled\n const decodedPath = decodeURIComponent(pathWithoutQuery);\n\n // Normalize the path (just clean up slashes)\n normalizedPath = decodedPath\n .replace(/\\\\/g, \"/\") // replace backslashes\n .replace(/\\/+/g, \"/\") // collapse slashes\n .replace(/(.+?)\\/+$/, \"$1\"); // trim trailing slashes\n } catch {\n // If decoding fails (e.g., invalid % encoding), return undefined\n return undefined;\n }\n\n // Find matching route pattern\n const matchingRoutes = routePatterns.filter(({ pattern, verb }) => {\n const matchesPath = pattern.test(normalizedPath);\n const upperMethod = method.toUpperCase();\n const matchesVerb = verb === \"*\" || upperMethod === verb;\n\n const result = matchesPath && matchesVerb;\n return result;\n });\n\n if (matchingRoutes.length === 0) {\n return undefined;\n }\n\n // Use the most specific route (longest path pattern)\n const matchingRoute = matchingRoutes.reduce((a, b) =>\n b.pattern.source.length > a.pattern.source.length ? b : a,\n );\n\n return matchingRoute;\n}\n\n/**\n * Gets the default asset (USDC) for the given network\n *\n * @param network - The network to get the default asset for\n * @returns The default asset\n */\nexport function getDefaultAsset(network: Network) {\n const chainId = getNetworkId(network);\n const usdc = getUsdcChainConfigForChain(chainId);\n if (!usdc) {\n throw new Error(`Unable to get default asset on ${network}`);\n }\n return {\n address: usdc.usdcAddress,\n decimals: 6,\n eip712: {\n name: usdc.usdcName,\n version: \"2\",\n },\n };\n}\n\n/**\n * Parses the amount from the given price\n *\n * @param price - The price to parse\n * @param network - The network to get the default asset for\n * @returns The parsed amount or an error message\n */\nexport function processPriceToAtomicAmount(\n price: Price,\n network: Network,\n):\n | { maxAmountRequired: string; asset: ERC20TokenAmount[\"asset\"] | SPLTokenAmount[\"asset\"] }\n | { error: string } {\n // Handle USDC amount (string) or token amount (ERC20TokenAmount)\n let maxAmountRequired: string;\n let asset: ERC20TokenAmount[\"asset\"] | SPLTokenAmount[\"asset\"];\n\n if (typeof price === \"string\" || typeof price === \"number\") {\n // USDC amount in dollars\n const parsedAmount = moneySchema.safeParse(price);\n if (!parsedAmount.success) {\n return {\n error: `Invalid price (price: ${price}). Must be in the form \"$3.10\", 0.10, \"0.001\", ${parsedAmount.error}`,\n };\n }\n const parsedUsdAmount = parsedAmount.data;\n asset = getDefaultAsset(network);\n maxAmountRequired = (parsedUsdAmount * 10 ** asset.decimals).toString();\n } else {\n // Token amount in atomic units\n maxAmountRequired = price.amount;\n asset = price.asset;\n }\n\n return {\n maxAmountRequired,\n asset,\n };\n}\n\n/**\n * Finds the matching payment requirements for the given payment\n *\n * @param paymentRequirements - The payment requirements to search through\n * @param payment - The payment to match against\n * @returns The matching payment requirements or undefined if no match is found\n */\nexport function findMatchingPaymentRequirements(\n paymentRequirements: PaymentRequirements[],\n payment: PaymentPayload,\n) {\n return paymentRequirements.find(\n value => value.scheme === payment.scheme && value.network === payment.network,\n );\n}\n\n/**\n * Decodes the X-PAYMENT-RESPONSE header\n *\n * @param header - The X-PAYMENT-RESPONSE header to decode\n * @returns The decoded payment response\n */\nexport function decodeXPaymentResponse(header: string) {\n const decoded = safeBase64Decode(header);\n return JSON.parse(decoded) as {\n success: boolean;\n transaction: Hex;\n network: Network;\n payer: Address;\n };\n}\n","export * from \"./rpc\";\nexport * from \"./wallet\";\nexport * from \"./transaction\";\n","import { ExactSvmPayload } from \"../../types/verify/x402Specs\";\nimport {\n getBase64EncodedWireTransaction,\n getBase64Encoder,\n getTransactionDecoder,\n getCompiledTransactionMessageDecoder,\n KeyPairSigner,\n partiallySignTransaction,\n RpcDevnet,\n SolanaRpcApiDevnet,\n RpcMainnet,\n SolanaRpcApiMainnet,\n Transaction,\n CompiledTransactionMessage,\n} from \"@solana/kit\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport { TOKEN_2022_PROGRAM_ADDRESS } from \"@solana-program/token-2022\";\n\n/**\n * Given an object with a base64 encoded transaction, decode the\n * base64 encoded transaction into a solana transaction object.\n *\n * @param svmPayload - The SVM payload to decode\n * @returns The decoded transaction\n */\nexport function decodeTransactionFromPayload(svmPayload: ExactSvmPayload): Transaction {\n try {\n const base64Encoder = getBase64Encoder();\n const transactionBytes = base64Encoder.encode(svmPayload.transaction);\n const transactionDecoder = getTransactionDecoder();\n return transactionDecoder.decode(transactionBytes);\n } catch (error) {\n console.error(\"error\", error);\n throw new Error(\"invalid_exact_svm_payload_transaction\");\n }\n}\n\n/**\n * Extract the token sender (owner of the source token account)\n * from the TransferChecked instruction.\n *\n * @param transaction - The transaction to extract the token payer from\n * @returns The token payer address as a base58 string\n */\nexport function getTokenPayerFromTransaction(transaction: Transaction): string {\n const compiled = getCompiledTransactionMessageDecoder().decode(\n transaction.messageBytes,\n ) as CompiledTransactionMessage;\n const staticAccounts = compiled.staticAccounts ?? [];\n const instructions = compiled.instructions ?? [];\n\n for (const ix of instructions) {\n const programIndex = ix.programAddressIndex;\n const programAddress = staticAccounts[programIndex].toString();\n if (\n programAddress === TOKEN_PROGRAM_ADDRESS.toString() ||\n programAddress === TOKEN_2022_PROGRAM_ADDRESS.toString()\n ) {\n const accountIndices: number[] = ix.accountIndices ?? [];\n if (accountIndices.length >= 4) {\n // TransferChecked account order: [source, mint, destination, owner, ...]\n const ownerIndex = accountIndices[3];\n const ownerAddress = staticAccounts[ownerIndex].toString();\n if (ownerAddress) return ownerAddress;\n }\n }\n }\n\n return \"\";\n}\n\n/**\n * Sign and simulate a transaction.\n *\n * @param signer - The signer that will sign the transaction\n * @param transaction - The transaction to sign and simulate\n * @param rpc - The RPC client to use to simulate the transaction\n * @returns The transaction simulation result\n */\nexport async function signAndSimulateTransaction(\n signer: KeyPairSigner,\n transaction: Transaction,\n rpc: RpcDevnet<SolanaRpcApiDevnet> | RpcMainnet<SolanaRpcApiMainnet>,\n) {\n // sign the transaction as the fee payer\n const signedTransaction = await partiallySignTransaction([signer.keyPair], transaction);\n\n // serialize the signed transaction into a base64 encoded wire transaction\n const base64EncodedTransaction = getBase64EncodedWireTransaction(signedTransaction);\n\n // simulate the transaction and verify that it will succeed\n const simulateTxConfig = {\n sigVerify: true,\n replaceRecentBlockhash: false,\n commitment: \"confirmed\",\n encoding: \"base64\",\n accounts: undefined,\n innerInstructions: undefined,\n minContextSlot: undefined,\n } as const;\n\n const simulateResult = await rpc\n .simulateTransaction(base64EncodedTransaction, simulateTxConfig)\n .send();\n\n return simulateResult;\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,SAAS;AAEX,IAAM,cAAc,EACxB,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,OAAK,EAAE,QAAQ,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAC1E,KAAK,EAAE,OAAO,OAAO,EAAE,IAAI,IAAM,EAAE,IAAI,SAAS,CAAC;;;ACJpD,SAAS,KAAAA,UAAS;AAEX,IAAM,gBAAgBA,GAAE,KAAK;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,IAAM,uBAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,IAAM,sBAAsB,oBAAI,IAAqB;AAAA,EAC1D,CAAC,gBAAgB,KAAK;AAAA,EACtB,CAAC,QAAQ,IAAI;AAAA,EACb,CAAC,kBAAkB,KAAK;AAAA,EACxB,CAAC,aAAa,KAAK;AAAA,EACnB,CAAC,SAAS,IAAI;AAAA,EACd,CAAC,OAAO,IAAI;AAAA,EACZ,CAAC,eAAe,IAAI;AAAA,EACpB,CAAC,WAAW,GAAG;AAAA,EACf,CAAC,gBAAgB,KAAK;AAAA,EACtB,CAAC,QAAQ,IAAI;AAAA,EACb,CAAC,WAAW,GAAG;AAAA,EACf,CAAC,mBAAmB,IAAI;AAAA,EACxB,CAAC,WAAW,QAAQ;AAAA,EACpB,CAAC,wBAAwB,MAAM;AACjC,CAAC;AAGM,IAAM,uBAAkC,CAAC,iBAAiB,QAAQ;AAClE,IAAM,sBAAsB,oBAAI,IAAqB;AAAA,EAC1D,CAAC,iBAAiB,GAAG;AAAA,EACrB,CAAC,UAAU,GAAG;AAChB,CAAC;AAEM,IAAM,mBAAmB,OAAO;AAAA,EACrC,CAAC,GAAG,sBAAsB,GAAG,oBAAoB,EAAE,IAAI,aAAW;AAAA,IAChE,oBAAoB,IAAI,OAAO;AAAA,IAC/B;AAAA,EACF,CAAC;AACH;;;ACpEA,SAAS,oBAAoB,oBAAoB,MAAM,eAAe,mBAAmB;AAYzF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AAI7B,IAAM,SAAS,YAAY;AAAA,EAChC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,OAAO,QAAQ,OAAO,UAAU,GAAG;AAAA,EAC3D,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,yBAAyB,EAAE;AAAA,EAC/C;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,EAAE,MAAM,UAAU,KAAK,gCAAgC;AAAA,EAClE;AACF,CAAC;AAGM,IAAM,gBAAgB,YAAY;AAAA,EACvC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,OAAO,QAAQ,OAAO,UAAU,GAAG;AAAA,EAC3D,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,qCAAqC,EAAE;AAAA,EAC3D;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,EAAE,MAAM,UAAU,KAAK,qCAAqC;AAAA,EACvE;AAAA,EACA,SAAS;AACX,CAAC;AA6BM,SAAS,sBACd,SAC8C;AAC9C,QAAM,QAAQ,oBAAoB,OAAO;AACzC,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,WAAW,KAAK;AAAA,EAClB,CAAC,EAAE,OAAO,aAAa;AACzB;AAQO,SAAS,sBAAiF;AAC/F,SAAO,sBAAsB,cAAc;AAK7C;AAQO,SAAS,4BAId;AACA,SAAO,sBAAsB,gBAAgB;AAK/C;AASO,SAAS,aAAa,SAAiB,YAAsC;AAClF,QAAM,QAAQ,oBAAoB,OAAO;AACzC,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,WAAW,KAAK;AAAA,IAChB,SAAS,oBAAoB,UAAU;AAAA,EACzC,CAAC,EAAE,OAAO,aAAa;AACzB;AASO,SAAS,oBAAoB,YAAmD;AACrF,SAAO,aAAa,gBAAgB,UAAU;AAChD;AASO,SAAS,0BAA0B,YAAqD;AAC7F,SAAO,aAAa,kBAAkB,UAAU;AAClD;AAQO,SAAS,eAKd,QACsD;AACtD,SACE,OAAO,WAAW,YAAY,WAAW,QAAQ,WAAW,UAAU,eAAe;AAEzF;AAQO,SAAS,UAId,QAA2F;AAC3F,QAAM,IAAI;AACV,SACE,OAAO,WAAW,YAClB,WAAW,QACX,OAAO,EAAE,YAAY,YACrB,OAAO,EAAE,SAAS;AAAA,EAElB,OAAO,EAAE,SAAS,cAClB,OAAO,EAAE,gBAAgB,cACzB,OAAO,EAAE,kBAAkB;AAAA,EAE3B,OAAO,EAAE,oBAAoB;AAEjC;AAQO,SAAS,oBAAoB,SAAoC;AACtE,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,YAAM,IAAI,MAAM,wBAAwB,OAAO,EAAE;AAAA,EACrD;AACF;;;ACvPA;AAAA,EACE;AAAA,EAEA;AAAA,EAKA;AAAA,OACK;AACP,SAAS,cAAc;;;ACVvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAKA;AAAA,OAKK;AAMP,IAAM,iBAAiB;AAKvB,IAAM,kBAAkB;AAKxB,IAAM,gBAAgB;AAKtB,IAAM,iBAAiB;AAQhB,SAAS,sBAAsB,KAA6C;AACjF,SAAO;AAAA,IACL,MAAM,OAAO,GAAG,IAAI,OAAO,cAAc;AAAA,EAC3C;AACF;AAQO,SAAS,uBAAuB,KAA+C;AACpF,SAAO;AAAA,IACL,MAAM,QAAQ,GAAG,IAAI,QAAQ,eAAe;AAAA,EAC9C;AACF;AASO,SAAS,aACd,SACA,KACiE;AAEjE,MAAI,YAAY,iBAAiB;AAC/B,WAAO,sBAAsB,GAAG;AAAA,EAClC,WAAW,YAAY,UAAU;AAC/B,WAAO,uBAAuB,GAAG;AAAA,EACnC,OAAO;AACL,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AACF;AASO,SAAS,oBACd,SACA,KAIA;AAEA,MAAI,YAAY,iBAAiB;AAC/B,WAAO,6BAA6B,OAAO,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC;AAAA,EACjF,WAAW,YAAY,UAAU;AAC/B,WAAO,6BAA6B,QAAQ,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC;AAAA,EACnF,OAAO;AACL,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AACF;AASA,SAAS,SAAS,KAAqB;AACrC,MAAI,IAAI,WAAW,MAAM,GAAG;AAC1B,WAAO,IAAI,QAAQ,QAAQ,IAAI;AAAA,EACjC;AACA,SAAO;AACT;;;AD7FO,SAAS,yBAAyB,SAAqC;AAC5E,MAAI,CAAC,qBAAqB,KAAK,OAAK,MAAM,OAAO,GAAG;AAClD,UAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,EACvD;AACA,SAAO,aAAa,OAAkB;AACxC;AAQA,eAAsB,uBAAuB,YAA4C;AAEvF,QAAM,QAAQ,OAAO,OAAO,UAAU;AAItC,MAAI,MAAM,WAAW,IAAI;AACvB,WAAO,MAAM,6BAA6B,KAAK;AAAA,EACjD;AAEA,MAAI,MAAM,WAAW,IAAI;AACvB,WAAO,MAAM,uCAAuC,KAAK;AAAA,EAC3D;AACA,QAAM,IAAI,MAAM,0BAA0B,MAAM,MAAM,4BAA4B;AACpF;AAQO,SAASC,gBAAe,QAAwC;AACrE,SAAO,gBAAgB,MAAM;AAC/B;;;AE9CO,SAASC,uBAAsB,SAAkC;AACtE,MAAI,qBAAqB,KAAK,OAAK,MAAM,OAAO,GAAG;AACjD,WAAW,sBAAsB,OAAO;AAAA,EAC1C;AAEA,MAAI,qBAAqB,KAAK,OAAK,MAAM,OAAO,GAAG;AACjD,WAAW,yBAAyB,OAAO;AAAA,EAC7C;AAEA,QAAM,IAAI,MAAM,wBAAwB,OAAO,EAAE;AACnD;AASO,SAASC,cAAa,SAAiB,YAA2C;AAEvF,MAAI,qBAAqB,KAAK,OAAK,MAAM,OAAO,GAAG;AACjD,WAAO,QAAQ,QAAY,aAAa,SAAS,UAAiB,CAAC;AAAA,EACrE;AAGA,MAAI,qBAAqB,KAAK,OAAK,MAAM,OAAO,GAAG;AACjD,WAAW,uBAAuB,UAAoB;AAAA,EACxD;AAEA,QAAM,IAAI,MAAM,wBAAwB,OAAO,EAAE;AACnD;AAQO,SAAS,kBAAkB,QAAyC;AACzE,SAAW,eAAe,MAAuB,KAAS,UAAU,MAAuB;AAC7F;AAQO,SAAS,kBAAkB,QAAyC;AACzE,SAAWC,gBAAe,MAAuB;AACnD;AAQO,SAAS,qBAAqB,QAA8C;AACjF,SAAO,SAAS,UAAU,SAAS;AACrC;;;AC5EA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,qBAAqB;AAAA,EAChC,2BAA2B;AAAA,IACzB,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,IAChC,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,IAC9B,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,IACjC,EAAE,MAAM,cAAc,MAAM,UAAU;AAAA,IACtC,EAAE,MAAM,eAAe,MAAM,UAAU;AAAA,IACvC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,EACnC;AACF;AAEO,IAAM,2BAA2B;;;ACXxC;AAAA;AAAA;AAAA;;;ACAO,IAAM,kBAAkB;;;ACA/B,SAAS,KAAAC,UAAS;;;ACAX,IAAM,qBAAqB;AAQ3B,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AAC5C;AAQO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,MAAM,QAAQ,EAAE,SAAS,OAAO;AACrD;;;ADpBA,IAAM,oBAAoB;AAC1B,IAAM,kBAAkB;AACxB,IAAM,oBAAoB;AAC1B,IAAM,wBAAwB;AAC9B,IAAM,oBAAoB;AAEnB,IAAM,UAAU,CAAC,OAAO;AACxB,IAAM,eAAe,CAAC,CAAC;AACvB,IAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,IAAM,YAAwC,WAC5C,OAAO,UAAU,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,KAAK;AACtD,IAAM,eAAe,CAAC,cAAsB,CAAC,UAAkB,MAAM,UAAU;AAG/E,IAAM,kBAAkBC,GAAE,OAAO,EAAE,MAAM,eAAe,EAAE,GAAGA,GAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9F,IAAM,2BAA2BA,GAC9B,OAAO,EACP,MAAM,iBAAiB,EACvB,GAAGA,GAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAChC,IAAM,4BAA4BA,GAAE,OAAO;AAAA,EAChD,QAAQA,GAAE,KAAK,OAAO;AAAA,EACtB,SAAS;AAAA,EACT,mBAAmBA,GAAE,OAAO,EAAE,OAAO,SAAS;AAAA,EAC9C,UAAUA,GAAE,OAAO,EAAE,IAAI;AAAA,EACzB,aAAaA,GAAE,OAAO;AAAA,EACtB,UAAUA,GAAE,OAAO;AAAA,EACnB,cAAcA,GAAE,OAAOA,GAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACzC,OAAO;AAAA,EACP,mBAAmBA,GAAE,OAAO,EAAE,IAAI;AAAA,EAClC,OAAO;AAAA,EACP,OAAOA,GAAE,OAAOA,GAAE,IAAI,CAAC,EAAE,SAAS;AACpC,CAAC;AAIM,IAAM,qCAAqCA,GAAE,OAAO;AAAA,EACzD,MAAMA,GAAE,OAAO,EAAE,MAAM,eAAe;AAAA,EACtC,IAAIA,GAAE,OAAO,EAAE,MAAM,eAAe;AAAA,EACpC,OAAOA,GAAE,OAAO,EAAE,OAAO,SAAS,EAAE,OAAO,aAAa,iBAAiB,CAAC;AAAA,EAC1E,YAAYA,GAAE,OAAO,EAAE,OAAO,SAAS;AAAA,EACvC,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAS;AAAA,EACxC,OAAOA,GAAE,OAAO,EAAE,MAAM,qBAAqB;AAC/C,CAAC;AAGM,IAAM,wBAAwBA,GAAE,OAAO;AAAA,EAC5C,WAAWA,GAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC7C,eAAe;AACjB,CAAC;AAIM,IAAM,wBAAwBA,GAAE,OAAO;AAAA,EAC5C,aAAaA,GAAE,OAAO,EAAE,MAAM,kBAAkB;AAClD,CAAC;AAIM,IAAM,uBAAuBA,GAAE,OAAO;AAAA,EAC3C,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAO,aAAa,SAAS,GAAQ,CAAC;AAAA,EACrE,QAAQA,GAAE,KAAK,OAAO;AAAA,EACtB,SAAS;AAAA,EACT,SAASA,GAAE,MAAM,CAAC,uBAAuB,qBAAqB,CAAC;AAAA,EAC/D,qBAAqB,0BAA0B,SAAS;AAC1D,CAAC;AAOM,IAAM,qBAAqBA,GAAE,OAAO;AAAA,EACzC,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAO,aAAa,SAAS,GAAQ,CAAC;AAAA,EACrE,OAAOA,GAAE,KAAK,YAAY,EAAE,SAAS;AAAA,EACrC,SAASA,GAAE,MAAM,yBAAyB,EAAE,SAAS;AAAA,EACrD,OAAOA,GAAE,OAAO,EAAE,MAAM,iBAAiB,EAAE,SAAS;AACtD,CAAC;AAID,IAAM,kBAAkBA,GAAE,KAAK,CAAC,OAAO,QAAQ,OAAO,UAAU,SAAS,WAAW,MAAM,CAAC;AAGpF,IAAM,6BAA6BA,GAAE,OAAO;AAAA,EACjD,MAAMA,GAAE,QAAQ,MAAM;AAAA,EACtB,QAAQ;AAAA,EACR,aAAaA,GAAE,OAAOA,GAAE,OAAO,GAAGA,GAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACvD,UAAUA,GAAE,KAAK,CAAC,QAAQ,aAAa,uBAAuB,QAAQ,QAAQ,CAAC,EAAE,SAAS;AAAA,EAC1F,YAAYA,GAAE,OAAOA,GAAE,OAAO,GAAGA,GAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACnD,cAAcA,GAAE,OAAOA,GAAE,OAAO,GAAGA,GAAE,IAAI,CAAC,EAAE,SAAS;AACvD,CAAC;AAiBM,IAAM,yBAAyBA,GAAE,mBAAmB,QAAQ;AAAA,EACjE;AAAA;AAAA;AAGF,CAAC;AAQM,IAAM,2BAA2BA,GAAE,OAAO;AAAA,EAC/C,UAAUA,GAAE,OAAO;AAAA,EACnB,MAAMA,GAAE,KAAK,CAAC,MAAM,CAAC;AAAA,EACrB,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAO,aAAa,SAAS,GAAQ,CAAC;AAAA,EACrE,SAASA,GAAE,MAAM,yBAAyB;AAAA,EAC1C,aAAaA,GAAE,KAAK;AAAA,EACpB,UAAUA,GAAE,OAAOA,GAAE,IAAI,CAAC,EAAE,SAAS;AACvC,CAAC;AAIM,IAAM,sBAAsBA,GAAE,OAAO;AAAA,EAC1C,gBAAgB;AAAA,EAChB,qBAAqB;AACvB,CAAC;AAIM,IAAM,sBAAsBA,GAAE,OAAO;AAAA,EAC1C,gBAAgB;AAAA,EAChB,qBAAqB;AACvB,CAAC;AAIM,IAAM,uBAAuBA,GAAE,OAAO;AAAA,EAC3C,SAASA,GAAE,QAAQ;AAAA,EACnB,eAAeA,GAAE,KAAK,YAAY,EAAE,SAAS;AAAA,EAC7C,OAAO,gBAAgB,SAAS;AAClC,CAAC;AAIM,IAAM,uBAAuBA,GAAE,OAAO;AAAA,EAC3C,SAASA,GAAE,QAAQ;AAAA,EACnB,aAAaA,GAAE,KAAK,YAAY,EAAE,SAAS;AAAA,EAC3C,OAAO,gBAAgB,SAAS;AAAA,EAChC,aAAaA,GAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC/C,SAAS;AACX,CAAC;AAIM,IAAM,sCAAsCA,GAAE,OAAO;AAAA,EAC1D,MAAMA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,OAAOA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,QAAQA,GAAE,OAAO,EAAE,SAAS;AAC9B,CAAC;AAIM,IAAM,uCAAuCA,GAAE,OAAO;AAAA,EAC3D,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAO,aAAa,SAAS,GAAQ,CAAC;AAAA,EACrE,OAAOA,GAAE,MAAM,wBAAwB;AAAA,EACvC,YAAYA,GAAE,OAAO;AAAA,IACnB,OAAOA,GAAE,OAAO;AAAA,IAChB,QAAQA,GAAE,OAAO;AAAA,IACjB,OAAOA,GAAE,OAAO;AAAA,EAClB,CAAC;AACH,CAAC;AAIM,IAAM,6BAA6BA,GAAE,OAAO;AAAA,EACjD,aAAaA,GAAE,OAAO,EAAE,OAAO,SAAO,aAAa,SAAS,GAAQ,CAAC;AAAA,EACrE,QAAQA,GAAE,KAAK,OAAO;AAAA,EACtB,SAAS;AAAA,EACT,OAAOA,GAAE,OAAOA,GAAE,IAAI,CAAC,EAAE,SAAS;AACpC,CAAC;AAIM,IAAM,sCAAsCA,GAAE,OAAO;AAAA,EAC1D,OAAOA,GAAE,MAAM,0BAA0B;AAC3C,CAAC;;;AEhPD,SAAS,KAAAC,UAAS;;;ACOX,SAAS,WAA6B,MAAiB;AAC5D,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAQA,WAAS,QAAQ,OAAyB;AACxC,QAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACxE,aAAO,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC;AAAA,IAC1F;AAEA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,aAAO,MAAM,IAAI,OAAO;AAAA,IAC1B;AAEA,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,MAAM,SAAS;AAAA,IACxB;AACA,WAAO;AAAA,EACT;AAEA,SAAO,QAAQ,IAAI;AACrB;;;ACzBO,SAAS,aAAa,SAA0B;AACrD,MAAI,oBAAoB,IAAI,OAAO,GAAG;AACpC,WAAO,oBAAoB,IAAI,OAAO;AAAA,EACxC;AACA,MAAI,oBAAoB,IAAI,OAAO,GAAG;AACpC,WAAO,oBAAoB,IAAI,OAAO;AAAA,EACxC;AACA,QAAM,IAAI,MAAM,wBAAwB,OAAO,EAAE;AACnD;;;ACMO,SAAS,qBAAqB,QAAsC;AACzE,QAAM,mBAAmB,OAAO;AAAA,IAC9B,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM;AAAA,MAC/C;AAAA,MACA,OAAO,UAAU,YAAY,OAAO,UAAU,WACzC,EAAE,OAAO,OAAO,SAAS,eAAe,IACxC;AAAA,IACP,CAAC;AAAA,EACH;AAEA,SAAO,OAAO,QAAQ,gBAAgB,EAAE,IAAI,CAAC,CAAC,SAAS,WAAW,MAAM;AAEtE,UAAM,CAAC,MAAM,IAAI,IAAI,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,KAAK,IAAI,CAAC,KAAK,OAAO;AACjF,QAAI,CAAC,MAAM;AACT,YAAM,IAAI,MAAM,0BAA0B,OAAO,EAAE;AAAA,IACrD;AACA,WAAO;AAAA,MACL,MAAM,KAAK,YAAY;AAAA,MACvB,SAAS,IAAI;AAAA,QACX,IACE,KAEG,QAAQ,iBAAiB,MAAM,EAE/B,QAAQ,OAAO,KAAK,EACpB,QAAQ,iBAAiB,OAAO,EAChC,QAAQ,OAAO,KAAK,CACzB;AAAA,QACA;AAAA,MACF;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF,CAAC;AACH;AAUO,SAAS,kBACd,eACA,MACA,QAC0B;AAM1B,MAAI;AACJ,MAAI;AAEF,UAAM,mBAAmB,KAAK,MAAM,MAAM,EAAE,CAAC;AAI7C,UAAM,cAAc,mBAAmB,gBAAgB;AAGvD,qBAAiB,YACd,QAAQ,OAAO,GAAG,EAClB,QAAQ,QAAQ,GAAG,EACnB,QAAQ,aAAa,IAAI;AAAA,EAC9B,QAAQ;AAEN,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,cAAc,OAAO,CAAC,EAAE,SAAS,KAAK,MAAM;AACjE,UAAM,cAAc,QAAQ,KAAK,cAAc;AAC/C,UAAM,cAAc,OAAO,YAAY;AACvC,UAAM,cAAc,SAAS,OAAO,gBAAgB;AAEpD,UAAM,SAAS,eAAe;AAC9B,WAAO;AAAA,EACT,CAAC;AAED,MAAI,eAAe,WAAW,GAAG;AAC/B,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,eAAe;AAAA,IAAO,CAAC,GAAG,MAC9C,EAAE,QAAQ,OAAO,SAAS,EAAE,QAAQ,OAAO,SAAS,IAAI;AAAA,EAC1D;AAEA,SAAO;AACT;AAQO,SAAS,gBAAgB,SAAkB;AAChD,QAAM,UAAU,aAAa,OAAO;AACpC,QAAM,OAAO,2BAA2B,OAAO;AAC/C,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,kCAAkC,OAAO,EAAE;AAAA,EAC7D;AACA,SAAO;AAAA,IACL,SAAS,KAAK;AAAA,IACd,UAAU;AAAA,IACV,QAAQ;AAAA,MACN,MAAM,KAAK;AAAA,MACX,SAAS;AAAA,IACX;AAAA,EACF;AACF;AASO,SAAS,2BACd,OACA,SAGoB;AAEpB,MAAI;AACJ,MAAI;AAEJ,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU;AAE1D,UAAM,eAAe,YAAY,UAAU,KAAK;AAChD,QAAI,CAAC,aAAa,SAAS;AACzB,aAAO;AAAA,QACL,OAAO,yBAAyB,KAAK,kDAAkD,aAAa,KAAK;AAAA,MAC3G;AAAA,IACF;AACA,UAAM,kBAAkB,aAAa;AACrC,YAAQ,gBAAgB,OAAO;AAC/B,yBAAqB,kBAAkB,MAAM,MAAM,UAAU,SAAS;AAAA,EACxE,OAAO;AAEL,wBAAoB,MAAM;AAC1B,YAAQ,MAAM;AAAA,EAChB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AASO,SAAS,gCACd,qBACA,SACA;AACA,SAAO,oBAAoB;AAAA,IACzB,WAAS,MAAM,WAAW,QAAQ,UAAU,MAAM,YAAY,QAAQ;AAAA,EACxE;AACF;AAQO,SAAS,uBAAuB,QAAgB;AACrD,QAAM,UAAU,iBAAiB,MAAM;AACvC,SAAO,KAAK,MAAM,OAAO;AAM3B;;;ACjNA,IAAAC,eAAA;AAAA,SAAAA,cAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAAC;AAAA,EAAA;AAAA;;;ACCA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OAOK;AACP,SAAS,6BAA6B;AACtC,SAAS,kCAAkC;AASpC,SAAS,6BAA6B,YAA0C;AACrF,MAAI;AACF,UAAM,gBAAgB,iBAAiB;AACvC,UAAM,mBAAmB,cAAc,OAAO,WAAW,WAAW;AACpE,UAAM,qBAAqB,sBAAsB;AACjD,WAAO,mBAAmB,OAAO,gBAAgB;AAAA,EACnD,SAAS,OAAO;AACd,YAAQ,MAAM,SAAS,KAAK;AAC5B,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AACF;AASO,SAAS,6BAA6B,aAAkC;AAC7E,QAAM,WAAW,qCAAqC,EAAE;AAAA,IACtD,YAAY;AAAA,EACd;AACA,QAAM,iBAAiB,SAAS,kBAAkB,CAAC;AACnD,QAAM,eAAe,SAAS,gBAAgB,CAAC;AAE/C,aAAW,MAAM,cAAc;AAC7B,UAAM,eAAe,GAAG;AACxB,UAAM,iBAAiB,eAAe,YAAY,EAAE,SAAS;AAC7D,QACE,mBAAmB,sBAAsB,SAAS,KAClD,mBAAmB,2BAA2B,SAAS,GACvD;AACA,YAAM,iBAA2B,GAAG,kBAAkB,CAAC;AACvD,UAAI,eAAe,UAAU,GAAG;AAE9B,cAAM,aAAa,eAAe,CAAC;AACnC,cAAM,eAAe,eAAe,UAAU,EAAE,SAAS;AACzD,YAAI,aAAc,QAAO;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAUA,eAAsB,2BACpB,QACA,aACA,KACA;AAEA,QAAM,oBAAoB,MAAM,yBAAyB,CAAC,OAAO,OAAO,GAAG,WAAW;AAGtF,QAAM,2BAA2B,gCAAgC,iBAAiB;AAGlF,QAAM,mBAAmB;AAAA,IACvB,WAAW;AAAA,IACX,wBAAwB;AAAA,IACxB,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,UAAU;AAAA,IACV,mBAAmB;AAAA,IACnB,gBAAgB;AAAA,EAClB;AAEA,QAAM,iBAAiB,MAAM,IAC1B,oBAAoB,0BAA0B,gBAAgB,EAC9D,KAAK;AAER,SAAO;AACT;;;ALtGO,IAAM,2BAA2BC,GAAE,OAAO;AAAA,EAC/C,eAAeA,GAAE,OAAO;AAAA,EACxB,qBAAqB;AACvB,CAAC;AAUM,SAAS,qBAAqB,UAAkC;AACrE,SAAO,iBAAiB,KAAK,UAAU,QAAQ,CAAC;AAClD;AAQO,SAAS,yBAAyB,QAAgC;AACvE,QAAM,UAAU,iBAAiB,MAAM;AACvC,SAAO,KAAK,MAAM,OAAO;AAC3B;","names":["z","isSignerWallet","createConnectedClient","createSigner","isSignerWallet","z","z","z","svm_exports","isSignerWallet","z"]}
@@ -0,0 +1,106 @@
1
+ import {
2
+ createPaymentHeader,
3
+ createPaymentHeader2,
4
+ encodePayment,
5
+ preparePaymentHeader,
6
+ signPaymentHeader
7
+ } from "./chunk-R2NI44QI.mjs";
8
+ import {
9
+ SupportedEVMNetworks,
10
+ SupportedSVMNetworks,
11
+ getNetworkId,
12
+ isEvmSignerWallet,
13
+ isMultiNetworkSigner,
14
+ isSvmSignerWallet
15
+ } from "./chunk-XZA3USQF.mjs";
16
+ import {
17
+ getUsdcChainConfigForChain
18
+ } from "./chunk-7CWEZNFA.mjs";
19
+
20
+ // src/client/createPaymentHeader.ts
21
+ async function createPaymentHeader3(client, x402Version, paymentRequirements, config) {
22
+ if (paymentRequirements.scheme === "exact") {
23
+ if (SupportedEVMNetworks.includes(paymentRequirements.network)) {
24
+ const evmClient = isMultiNetworkSigner(client) ? client.evm : client;
25
+ if (!isEvmSignerWallet(evmClient)) {
26
+ throw new Error("Invalid evm wallet client provided");
27
+ }
28
+ return await createPaymentHeader(
29
+ evmClient,
30
+ x402Version,
31
+ paymentRequirements
32
+ );
33
+ }
34
+ if (SupportedSVMNetworks.includes(paymentRequirements.network)) {
35
+ const svmClient = isMultiNetworkSigner(client) ? client.svm : client;
36
+ if (!isSvmSignerWallet(svmClient)) {
37
+ throw new Error("Invalid svm wallet client provided");
38
+ }
39
+ return await createPaymentHeader2(
40
+ svmClient,
41
+ x402Version,
42
+ paymentRequirements,
43
+ config
44
+ );
45
+ }
46
+ throw new Error("Unsupported network");
47
+ }
48
+ throw new Error("Unsupported scheme");
49
+ }
50
+
51
+ // src/client/preparePaymentHeader.ts
52
+ function preparePaymentHeader2(from, x402Version, paymentRequirements) {
53
+ if (paymentRequirements.scheme === "exact" && SupportedEVMNetworks.includes(paymentRequirements.network)) {
54
+ return preparePaymentHeader(from, x402Version, paymentRequirements);
55
+ }
56
+ throw new Error("Unsupported scheme");
57
+ }
58
+
59
+ // src/client/selectPaymentRequirements.ts
60
+ function selectPaymentRequirements(paymentRequirements, network, scheme) {
61
+ paymentRequirements.sort((a, b) => {
62
+ if (a.network === "base" && b.network !== "base") {
63
+ return -1;
64
+ }
65
+ if (a.network !== "base" && b.network === "base") {
66
+ return 1;
67
+ }
68
+ return 0;
69
+ });
70
+ const broadlyAcceptedPaymentRequirements = paymentRequirements.filter((requirement) => {
71
+ const isExpectedScheme = !scheme || requirement.scheme === scheme;
72
+ const isExpectedChain = !network || (Array.isArray(network) ? network.includes(requirement.network) : network == requirement.network);
73
+ return isExpectedScheme && isExpectedChain;
74
+ });
75
+ const usdcRequirements = broadlyAcceptedPaymentRequirements.filter((requirement) => {
76
+ return requirement.asset === getUsdcChainConfigForChain(getNetworkId(requirement.network))?.usdcAddress;
77
+ });
78
+ if (usdcRequirements.length > 0) {
79
+ return usdcRequirements[0];
80
+ }
81
+ if (broadlyAcceptedPaymentRequirements.length > 0) {
82
+ return broadlyAcceptedPaymentRequirements[0];
83
+ }
84
+ return paymentRequirements[0];
85
+ }
86
+
87
+ // src/client/signPaymentHeader.ts
88
+ async function signPaymentHeader2(client, paymentRequirements, unsignedPaymentHeader) {
89
+ if (paymentRequirements.scheme === "exact" && SupportedEVMNetworks.includes(paymentRequirements.network)) {
90
+ const evmClient = isMultiNetworkSigner(client) ? client.evm : client;
91
+ if (!isEvmSignerWallet(evmClient)) {
92
+ throw new Error("Invalid evm wallet client provided");
93
+ }
94
+ const signedPaymentHeader = await signPaymentHeader(evmClient, paymentRequirements, unsignedPaymentHeader);
95
+ return encodePayment(signedPaymentHeader);
96
+ }
97
+ throw new Error("Unsupported scheme");
98
+ }
99
+
100
+ export {
101
+ createPaymentHeader3 as createPaymentHeader,
102
+ preparePaymentHeader2 as preparePaymentHeader,
103
+ selectPaymentRequirements,
104
+ signPaymentHeader2 as signPaymentHeader
105
+ };
106
+ //# sourceMappingURL=chunk-Z3INM7T4.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/client/createPaymentHeader.ts","../../src/client/preparePaymentHeader.ts","../../src/client/selectPaymentRequirements.ts","../../src/client/signPaymentHeader.ts"],"sourcesContent":["import { createPaymentHeader as createPaymentHeaderExactEVM } from \"../schemes/exact/evm/client\";\nimport { createPaymentHeader as createPaymentHeaderExactSVM } from \"../schemes/exact/svm/client\";\nimport { isEvmSignerWallet, isMultiNetworkSigner, isSvmSignerWallet, MultiNetworkSigner, Signer, SupportedEVMNetworks, SupportedSVMNetworks } from \"../types/shared\";\nimport { PaymentRequirements } from \"../types/verify\";\nimport { X402Config } from \"../types/config\";\n\n/**\n * Creates a payment header based on the provided client and payment requirements.\n *\n * @param client - The signer wallet instance used to create the payment header\n * @param x402Version - The version of the X402 protocol to use\n * @param paymentRequirements - The payment requirements containing scheme and network information\n * @param config - Optional configuration for X402 operations (e.g., custom RPC URLs)\n * @returns A promise that resolves to the created payment header string\n */\nexport async function createPaymentHeader(\n client: Signer | MultiNetworkSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n config?: X402Config,\n): Promise<string> {\n // exact scheme\n if (paymentRequirements.scheme === \"exact\") {\n // evm\n if (SupportedEVMNetworks.includes(paymentRequirements.network)) {\n const evmClient = isMultiNetworkSigner(client) ? client.evm : client;\n\n if (!isEvmSignerWallet(evmClient)) {\n throw new Error(\"Invalid evm wallet client provided\");\n }\n\n return await createPaymentHeaderExactEVM(\n evmClient,\n x402Version,\n paymentRequirements,\n );\n }\n // svm\n if (SupportedSVMNetworks.includes(paymentRequirements.network)) {\n const svmClient = isMultiNetworkSigner(client) ? client.svm : client;\n if (!isSvmSignerWallet(svmClient)) {\n throw new Error(\"Invalid svm wallet client provided\");\n }\n\n return await createPaymentHeaderExactSVM(\n svmClient,\n x402Version,\n paymentRequirements,\n config,\n );\n }\n throw new Error(\"Unsupported network\");\n }\n throw new Error(\"Unsupported scheme\");\n}","import { Address } from \"viem\";\nimport { preparePaymentHeader as preparePaymentHeaderExactEVM } from \"../schemes/exact/evm/client\";\nimport { SupportedEVMNetworks } from \"../types/shared\";\nimport { PaymentRequirements, UnsignedPaymentPayload } from \"../types/verify\";\n\n/**\n * Prepares a payment header with the given sender address and payment requirements.\n *\n * @param from - The sender's address from which the payment will be made\n * @param x402Version - The version of the X402 protocol to use\n * @param paymentRequirements - The payment requirements containing scheme and network information\n * @returns An unsigned payment payload that can be used to create a payment header\n */\nexport function preparePaymentHeader(\n from: Address,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n): UnsignedPaymentPayload {\n if (\n paymentRequirements.scheme === \"exact\" &&\n SupportedEVMNetworks.includes(paymentRequirements.network)\n ) {\n return preparePaymentHeaderExactEVM(from, x402Version, paymentRequirements);\n }\n\n throw new Error(\"Unsupported scheme\");\n}\n","import { Network, PaymentRequirements } from \"../types\";\nimport { getUsdcChainConfigForChain } from \"../shared/evm\";\nimport { getNetworkId } from \"../shared/network\";\n\n/**\n * Default selector for payment requirements.\n * Default behavior is to select the first payment requirement that has a USDC asset.\n * If no USDC payment requirement is found, the first payment requirement is selected.\n *\n * @param paymentRequirements - The payment requirements to select from.\n * @param network - The network to check against. If not provided, the network will not be checked.\n * @param scheme - The scheme to check against. If not provided, the scheme will not be checked.\n * @returns The payment requirement that is the most appropriate for the user.\n */\nexport function selectPaymentRequirements(paymentRequirements: PaymentRequirements[], network?: Network | Network[], scheme?: \"exact\"): PaymentRequirements {\n // Sort `base` payment requirements to the front of the list. This is to ensure that base is preferred if available.\n paymentRequirements.sort((a, b) => {\n if (a.network === \"base\" && b.network !== \"base\") {\n return -1;\n }\n if (a.network !== \"base\" && b.network === \"base\") {\n return 1;\n }\n return 0;\n });\n\n // Filter down to the scheme/network if provided\n const broadlyAcceptedPaymentRequirements = paymentRequirements.filter(requirement => {\n // If the scheme is not provided, we accept any scheme.\n const isExpectedScheme = !scheme || requirement.scheme === scheme;\n // If the chain is not provided, we accept any chain.\n const isExpectedChain = !network || (Array.isArray(network) ? network.includes(requirement.network) : network == requirement.network);\n\n return isExpectedScheme && isExpectedChain;\n });\n\n // Filter down to USDC requirements\n const usdcRequirements = broadlyAcceptedPaymentRequirements.filter(requirement => {\n // If the address is a USDC address, we return it.\n return requirement.asset === getUsdcChainConfigForChain(getNetworkId(requirement.network))?.usdcAddress;\n });\n\n // Prioritize USDC requirements if available\n if (usdcRequirements.length > 0) {\n return usdcRequirements[0];\n }\n // If no USDC requirements are found, return the first broadly accepted requirement.\n if (broadlyAcceptedPaymentRequirements.length > 0) {\n return broadlyAcceptedPaymentRequirements[0];\n }\n // If no matching requirements are found, return the first requirement.\n return paymentRequirements[0];\n}\n\n/**\n * Selector for payment requirements.\n *\n * @param paymentRequirements - The payment requirements to select from.\n * @param network - The network to check against. If not provided, the network will not be checked.\n * @param scheme - The scheme to check against. If not provided, the scheme will not be checked.\n * @returns The payment requirement that is the most appropriate for the user.\n */\nexport type PaymentRequirementsSelector = (paymentRequirements: PaymentRequirements[], network?: Network | Network[], scheme?: \"exact\") => PaymentRequirements;\n\n","import { signPaymentHeader as signPaymentHeaderExactEVM } from \"../schemes/exact/evm/client\";\nimport { encodePayment } from \"../schemes/exact/evm/utils/paymentUtils\";\nimport { isEvmSignerWallet, isMultiNetworkSigner, MultiNetworkSigner, Signer, SupportedEVMNetworks } from \"../types/shared\";\nimport { PaymentRequirements, UnsignedPaymentPayload } from \"../types/verify\";\n\n/**\n * Signs a payment header using the provided client and payment requirements.\n * \n * @param client - The signer wallet instance used to sign the payment header\n * @param paymentRequirements - The payment requirements containing scheme and network information\n * @param unsignedPaymentHeader - The unsigned payment payload to be signed\n * @returns A promise that resolves to the encoded signed payment header string\n */\nexport async function signPaymentHeader(\n client: Signer | MultiNetworkSigner,\n paymentRequirements: PaymentRequirements,\n unsignedPaymentHeader: UnsignedPaymentPayload,\n): Promise<string> {\n if (\n paymentRequirements.scheme === \"exact\" &&\n SupportedEVMNetworks.includes(paymentRequirements.network)\n ) {\n const evmClient = isMultiNetworkSigner(client) ? client.evm : client;\n\n if (!isEvmSignerWallet(evmClient)) {\n throw new Error(\"Invalid evm wallet client provided\");\n }\n const signedPaymentHeader = await signPaymentHeaderExactEVM(evmClient, paymentRequirements, unsignedPaymentHeader);\n return encodePayment(signedPaymentHeader);\n }\n\n throw new Error(\"Unsupported scheme\");\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAeA,eAAsBA,qBACpB,QACA,aACA,qBACA,QACiB;AAEjB,MAAI,oBAAoB,WAAW,SAAS;AAE1C,QAAI,qBAAqB,SAAS,oBAAoB,OAAO,GAAG;AAC9D,YAAM,YAAY,qBAAqB,MAAM,IAAI,OAAO,MAAM;AAE9D,UAAI,CAAC,kBAAkB,SAAS,GAAG;AACjC,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACtD;AAEA,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,qBAAqB,SAAS,oBAAoB,OAAO,GAAG;AAC9D,YAAM,YAAY,qBAAqB,MAAM,IAAI,OAAO,MAAM;AAC9D,UAAI,CAAC,kBAAkB,SAAS,GAAG;AACjC,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACtD;AAEA,aAAO,MAAMA;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,UAAM,IAAI,MAAM,qBAAqB;AAAA,EACvC;AACA,QAAM,IAAI,MAAM,oBAAoB;AACtC;;;ACzCO,SAASC,sBACd,MACA,aACA,qBACwB;AACxB,MACE,oBAAoB,WAAW,WAC/B,qBAAqB,SAAS,oBAAoB,OAAO,GACzD;AACA,WAAO,qBAA6B,MAAM,aAAa,mBAAmB;AAAA,EAC5E;AAEA,QAAM,IAAI,MAAM,oBAAoB;AACtC;;;ACZO,SAAS,0BAA0B,qBAA4C,SAA+B,QAAuC;AAE1J,sBAAoB,KAAK,CAAC,GAAG,MAAM;AACjC,QAAI,EAAE,YAAY,UAAU,EAAE,YAAY,QAAQ;AAChD,aAAO;AAAA,IACT;AACA,QAAI,EAAE,YAAY,UAAU,EAAE,YAAY,QAAQ;AAChD,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,CAAC;AAGD,QAAM,qCAAqC,oBAAoB,OAAO,iBAAe;AAEnF,UAAM,mBAAmB,CAAC,UAAU,YAAY,WAAW;AAE3D,UAAM,kBAAkB,CAAC,YAAY,MAAM,QAAQ,OAAO,IAAI,QAAQ,SAAS,YAAY,OAAO,IAAI,WAAW,YAAY;AAE7H,WAAO,oBAAoB;AAAA,EAC7B,CAAC;AAGD,QAAM,mBAAmB,mCAAmC,OAAO,iBAAe;AAEhF,WAAO,YAAY,UAAU,2BAA2B,aAAa,YAAY,OAAO,CAAC,GAAG;AAAA,EAC9F,CAAC;AAGD,MAAI,iBAAiB,SAAS,GAAG;AAC/B,WAAO,iBAAiB,CAAC;AAAA,EAC3B;AAEA,MAAI,mCAAmC,SAAS,GAAG;AACjD,WAAO,mCAAmC,CAAC;AAAA,EAC7C;AAEA,SAAO,oBAAoB,CAAC;AAC9B;;;ACvCA,eAAsBC,mBACpB,QACA,qBACA,uBACiB;AACjB,MACE,oBAAoB,WAAW,WAC/B,qBAAqB,SAAS,oBAAoB,OAAO,GACzD;AACA,UAAM,YAAY,qBAAqB,MAAM,IAAI,OAAO,MAAM;AAE9D,QAAI,CAAC,kBAAkB,SAAS,GAAG;AACjC,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AACA,UAAM,sBAAsB,MAAM,kBAA0B,WAAW,qBAAqB,qBAAqB;AACjH,WAAO,cAAc,mBAAmB;AAAA,EAC1C;AAEA,QAAM,IAAI,MAAM,oBAAoB;AACtC;","names":["createPaymentHeader","preparePaymentHeader","signPaymentHeader"]}
@@ -0,0 +1,64 @@
1
+ import { X as X402Config } from '../config-Dfuvno71.mjs';
2
+ import { P as PaymentRequirements, U as UnsignedPaymentPayload } from '../x402Specs-7OH8g851.mjs';
3
+ import { S as Signer, M as MultiNetworkSigner } from '../wallet-C9iHSQbd.mjs';
4
+ import { Address } from 'viem';
5
+ import { N as Network } from '../network--RYzQfBg.mjs';
6
+ import 'zod';
7
+ import '../wallet-BReyvAJs.mjs';
8
+ import 'viem/chains';
9
+ import '../wallet-BTqCm9Zp.mjs';
10
+ import '@solana/kit';
11
+
12
+ /**
13
+ * Creates a payment header based on the provided client and payment requirements.
14
+ *
15
+ * @param client - The signer wallet instance used to create the payment header
16
+ * @param x402Version - The version of the X402 protocol to use
17
+ * @param paymentRequirements - The payment requirements containing scheme and network information
18
+ * @param config - Optional configuration for X402 operations (e.g., custom RPC URLs)
19
+ * @returns A promise that resolves to the created payment header string
20
+ */
21
+ declare function createPaymentHeader(client: Signer | MultiNetworkSigner, x402Version: number, paymentRequirements: PaymentRequirements, config?: X402Config): Promise<string>;
22
+
23
+ /**
24
+ * Prepares a payment header with the given sender address and payment requirements.
25
+ *
26
+ * @param from - The sender's address from which the payment will be made
27
+ * @param x402Version - The version of the X402 protocol to use
28
+ * @param paymentRequirements - The payment requirements containing scheme and network information
29
+ * @returns An unsigned payment payload that can be used to create a payment header
30
+ */
31
+ declare function preparePaymentHeader(from: Address, x402Version: number, paymentRequirements: PaymentRequirements): UnsignedPaymentPayload;
32
+
33
+ /**
34
+ * Default selector for payment requirements.
35
+ * Default behavior is to select the first payment requirement that has a USDC asset.
36
+ * If no USDC payment requirement is found, the first payment requirement is selected.
37
+ *
38
+ * @param paymentRequirements - The payment requirements to select from.
39
+ * @param network - The network to check against. If not provided, the network will not be checked.
40
+ * @param scheme - The scheme to check against. If not provided, the scheme will not be checked.
41
+ * @returns The payment requirement that is the most appropriate for the user.
42
+ */
43
+ declare function selectPaymentRequirements(paymentRequirements: PaymentRequirements[], network?: Network | Network[], scheme?: "exact"): PaymentRequirements;
44
+ /**
45
+ * Selector for payment requirements.
46
+ *
47
+ * @param paymentRequirements - The payment requirements to select from.
48
+ * @param network - The network to check against. If not provided, the network will not be checked.
49
+ * @param scheme - The scheme to check against. If not provided, the scheme will not be checked.
50
+ * @returns The payment requirement that is the most appropriate for the user.
51
+ */
52
+ type PaymentRequirementsSelector = (paymentRequirements: PaymentRequirements[], network?: Network | Network[], scheme?: "exact") => PaymentRequirements;
53
+
54
+ /**
55
+ * Signs a payment header using the provided client and payment requirements.
56
+ *
57
+ * @param client - The signer wallet instance used to sign the payment header
58
+ * @param paymentRequirements - The payment requirements containing scheme and network information
59
+ * @param unsignedPaymentHeader - The unsigned payment payload to be signed
60
+ * @returns A promise that resolves to the encoded signed payment header string
61
+ */
62
+ declare function signPaymentHeader(client: Signer | MultiNetworkSigner, paymentRequirements: PaymentRequirements, unsignedPaymentHeader: UnsignedPaymentPayload): Promise<string>;
63
+
64
+ export { type PaymentRequirementsSelector, createPaymentHeader, preparePaymentHeader, selectPaymentRequirements, signPaymentHeader };
@@ -0,0 +1,17 @@
1
+ import {
2
+ createPaymentHeader,
3
+ preparePaymentHeader,
4
+ selectPaymentRequirements,
5
+ signPaymentHeader
6
+ } from "../chunk-Z3INM7T4.mjs";
7
+ import "../chunk-R2NI44QI.mjs";
8
+ import "../chunk-XZA3USQF.mjs";
9
+ import "../chunk-7CWEZNFA.mjs";
10
+ import "../chunk-5UPAZUO6.mjs";
11
+ export {
12
+ createPaymentHeader,
13
+ preparePaymentHeader,
14
+ selectPaymentRequirements,
15
+ signPaymentHeader
16
+ };
17
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,10 @@
1
+ import { Address } from 'viem';
2
+ import { Address as Address$1 } from '@solana/kit';
3
+
4
+ declare const config: Record<string, ChainConfig>;
5
+ type ChainConfig = {
6
+ usdcAddress: Address | Address$1;
7
+ usdcName: string;
8
+ };
9
+
10
+ export { type ChainConfig as C, config as c };
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Configuration options for Solana (SVM) RPC connections.
3
+ */
4
+ interface SvmConfig {
5
+ /**
6
+ * Custom RPC URL for Solana connections.
7
+ * If not provided, defaults to public Solana RPC endpoints based on network.
8
+ */
9
+ rpcUrl?: string;
10
+ }
11
+ /**
12
+ * Configuration options for X402 client and facilitator operations.
13
+ */
14
+ interface X402Config {
15
+ /** Configuration for Solana (SVM) operations */
16
+ svmConfig?: SvmConfig;
17
+ }
18
+
19
+ export type { SvmConfig as S, X402Config as X };
@@ -0,0 +1,42 @@
1
+ import { X as X402Config } from '../config-Dfuvno71.mjs';
2
+ import { C as ConnectedClient, S as Signer } from '../wallet-C9iHSQbd.mjs';
3
+ import { a as PaymentPayload, P as PaymentRequirements, u as VerifyResponse, S as SettleResponse } from '../x402Specs-7OH8g851.mjs';
4
+ import { Transport, Chain, Account } from 'viem';
5
+ import '../wallet-BReyvAJs.mjs';
6
+ import 'viem/chains';
7
+ import '../wallet-BTqCm9Zp.mjs';
8
+ import '@solana/kit';
9
+ import 'zod';
10
+
11
+ /**
12
+ * Verifies a payment payload against the required payment details regardless of the scheme
13
+ * this function wraps all verify functions for each specific scheme
14
+ *
15
+ * @param client - The public client used for blockchain interactions
16
+ * @param payload - The signed payment payload containing transfer parameters and signature
17
+ * @param paymentRequirements - The payment requirements that the payload must satisfy
18
+ * @param config - Optional configuration for X402 operations (e.g., custom RPC URLs)
19
+ * @returns A ValidPaymentRequest indicating if the payment is valid and any invalidation reason
20
+ */
21
+ declare function verify<transport extends Transport, chain extends Chain, account extends Account | undefined>(client: ConnectedClient | Signer, payload: PaymentPayload, paymentRequirements: PaymentRequirements, config?: X402Config): Promise<VerifyResponse>;
22
+ /**
23
+ * Settles a payment payload against the required payment details regardless of the scheme
24
+ * this function wraps all settle functions for each specific scheme
25
+ *
26
+ * @param client - The signer wallet used for blockchain interactions
27
+ * @param payload - The signed payment payload containing transfer parameters and signature
28
+ * @param paymentRequirements - The payment requirements that the payload must satisfy
29
+ * @param config - Optional configuration for X402 operations (e.g., custom RPC URLs)
30
+ * @returns A SettleResponse indicating if the payment is settled and any settlement reason
31
+ */
32
+ declare function settle<transport extends Transport, chain extends Chain>(client: Signer, payload: PaymentPayload, paymentRequirements: PaymentRequirements, config?: X402Config): Promise<SettleResponse>;
33
+ type Supported = {
34
+ x402Version: number;
35
+ kind: {
36
+ scheme: string;
37
+ networkId: string;
38
+ extra: object;
39
+ }[];
40
+ };
41
+
42
+ export { type Supported, settle, verify };
@@ -0,0 +1,14 @@
1
+ import {
2
+ settle,
3
+ verify
4
+ } from "../chunk-WS2W5DJT.mjs";
5
+ import "../chunk-MWDK4RSB.mjs";
6
+ import "../chunk-R2NI44QI.mjs";
7
+ import "../chunk-XZA3USQF.mjs";
8
+ import "../chunk-7CWEZNFA.mjs";
9
+ import "../chunk-5UPAZUO6.mjs";
10
+ export {
11
+ settle,
12
+ verify
13
+ };
14
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,16 @@
1
+ export { PaymentRequirementsSelector, createPaymentHeader, preparePaymentHeader, selectPaymentRequirements, signPaymentHeader } from './client/index.mjs';
2
+ export { Supported, settle, verify } from './facilitator/index.mjs';
3
+ import './config-Dfuvno71.mjs';
4
+ import './x402Specs-7OH8g851.mjs';
5
+ import 'zod';
6
+ import './wallet-C9iHSQbd.mjs';
7
+ import './wallet-BReyvAJs.mjs';
8
+ import 'viem';
9
+ import 'viem/chains';
10
+ import './wallet-BTqCm9Zp.mjs';
11
+ import '@solana/kit';
12
+ import './network--RYzQfBg.mjs';
13
+
14
+ declare const x402Version = 1;
15
+
16
+ export { x402Version };
@@ -0,0 +1,28 @@
1
+ import {
2
+ createPaymentHeader,
3
+ preparePaymentHeader,
4
+ selectPaymentRequirements,
5
+ signPaymentHeader
6
+ } from "./chunk-Z3INM7T4.mjs";
7
+ import {
8
+ settle,
9
+ verify
10
+ } from "./chunk-WS2W5DJT.mjs";
11
+ import "./chunk-MWDK4RSB.mjs";
12
+ import "./chunk-R2NI44QI.mjs";
13
+ import "./chunk-XZA3USQF.mjs";
14
+ import "./chunk-7CWEZNFA.mjs";
15
+ import "./chunk-5UPAZUO6.mjs";
16
+
17
+ // src/index.ts
18
+ var x402Version = 1;
19
+ export {
20
+ createPaymentHeader,
21
+ preparePaymentHeader,
22
+ selectPaymentRequirements,
23
+ settle,
24
+ signPaymentHeader,
25
+ verify,
26
+ x402Version
27
+ };
28
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/index.ts"],"sourcesContent":["export * from \"./client\";\nexport * from \"./facilitator\";\n\nexport const x402Version = 1;\n"],"mappings":";;;;;;;;;;;;;;;;;AAGO,IAAM,cAAc;","names":[]}
@@ -0,0 +1,93 @@
1
+ import { z } from 'zod';
2
+ import { N as Network } from './network--RYzQfBg.mjs';
3
+ import { E as EvmSigner } from './wallet-BReyvAJs.mjs';
4
+ import { a as PaymentPayload, P as PaymentRequirements, u as VerifyResponse, S as SettleResponse, F as SupportedPaymentKindsResponse, w as ListDiscoveryResourcesRequest, z as ListDiscoveryResourcesResponse, m as HTTPRequestStructure } from './x402Specs-7OH8g851.mjs';
5
+
6
+ declare const moneySchema: z.ZodPipeline<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodNumber]>, z.ZodNumber>;
7
+ type Money = z.input<typeof moneySchema>;
8
+
9
+ type Resource = `${string}://${string}`;
10
+
11
+ type CreateHeaders = () => Promise<{
12
+ verify: Record<string, string>;
13
+ settle: Record<string, string>;
14
+ supported: Record<string, string>;
15
+ list?: Record<string, string>;
16
+ }>;
17
+ /**
18
+ * Creates a facilitator client for interacting with the X402 payment facilitator service
19
+ *
20
+ * @param facilitator - The facilitator config to use. If not provided, the default facilitator will be used.
21
+ * @returns An object containing verify and settle functions for interacting with the facilitator
22
+ */
23
+ declare function useFacilitator(facilitator?: FacilitatorConfig): {
24
+ verify: (payload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<VerifyResponse>;
25
+ settle: (payload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<SettleResponse>;
26
+ supported: () => Promise<SupportedPaymentKindsResponse>;
27
+ list: (config?: ListDiscoveryResourcesRequest) => Promise<ListDiscoveryResourcesResponse>;
28
+ };
29
+ declare const verify: (payload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<VerifyResponse>;
30
+ declare const settle: (payload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<SettleResponse>;
31
+ declare const supported: () => Promise<SupportedPaymentKindsResponse>;
32
+ declare const list: (config?: ListDiscoveryResourcesRequest) => Promise<ListDiscoveryResourcesResponse>;
33
+
34
+ type FacilitatorConfig = {
35
+ url: Resource;
36
+ createAuthHeaders?: CreateHeaders;
37
+ };
38
+ type PaywallConfig = {
39
+ cdpClientKey?: string;
40
+ appName?: string;
41
+ appLogo?: string;
42
+ sessionTokenEndpoint?: string;
43
+ };
44
+ type PaymentMiddlewareConfig = {
45
+ description?: string;
46
+ mimeType?: string;
47
+ maxTimeoutSeconds?: number;
48
+ inputSchema?: Omit<HTTPRequestStructure, "type" | "method">;
49
+ outputSchema?: object;
50
+ discoverable?: boolean;
51
+ customPaywallHtml?: string;
52
+ resource?: Resource;
53
+ errorMessages?: {
54
+ paymentRequired?: string;
55
+ invalidPayment?: string;
56
+ noMatchingRequirements?: string;
57
+ verificationFailed?: string;
58
+ settlementFailed?: string;
59
+ };
60
+ };
61
+ interface ERC20TokenAmount {
62
+ amount: string;
63
+ asset: {
64
+ address: `0x${string}`;
65
+ decimals: number;
66
+ eip712: {
67
+ name: string;
68
+ version: string;
69
+ };
70
+ };
71
+ }
72
+ interface SPLTokenAmount {
73
+ amount: string;
74
+ asset: {
75
+ address: string;
76
+ decimals: number;
77
+ };
78
+ }
79
+ type Price = Money | ERC20TokenAmount | SPLTokenAmount;
80
+ interface RouteConfig {
81
+ price: Price;
82
+ network: Network;
83
+ config?: PaymentMiddlewareConfig;
84
+ }
85
+ type RoutesConfig = Record<string, Price | RouteConfig>;
86
+ interface RoutePattern {
87
+ verb: string;
88
+ pattern: RegExp;
89
+ config: RouteConfig;
90
+ }
91
+ type Wallet = EvmSigner;
92
+
93
+ export { type CreateHeaders as C, type ERC20TokenAmount as E, type FacilitatorConfig as F, type Money as M, type Price as P, type RoutesConfig as R, type SPLTokenAmount as S, type Wallet as W, type RoutePattern as a, type Resource as b, type PaywallConfig as c, type PaymentMiddlewareConfig as d, type RouteConfig as e, supported as f, list as l, moneySchema as m, settle as s, useFacilitator as u, verify as v };
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+
3
+ declare const NetworkSchema: z.ZodEnum<["base-sepolia", "base", "avalanche-fuji", "avalanche", "iotex", "solana-devnet", "solana", "sei", "sei-testnet", "polygon", "polygon-amoy", "peaq", "x-layer", "x-layer-testnet", "sepolia", "filecoin-calibration"]>;
4
+ type Network = z.infer<typeof NetworkSchema>;
5
+ declare const SupportedEVMNetworks: Network[];
6
+ declare const EvmNetworkToChainId: Map<"base-sepolia" | "avalanche-fuji" | "base" | "avalanche" | "sei" | "sei-testnet" | "polygon" | "polygon-amoy" | "peaq" | "iotex" | "x-layer" | "x-layer-testnet" | "solana-devnet" | "solana" | "sepolia" | "filecoin-calibration", number>;
7
+ declare const SupportedSVMNetworks: Network[];
8
+ declare const SvmNetworkToChainId: Map<"base-sepolia" | "avalanche-fuji" | "base" | "avalanche" | "sei" | "sei-testnet" | "polygon" | "polygon-amoy" | "peaq" | "iotex" | "x-layer" | "x-layer-testnet" | "solana-devnet" | "solana" | "sepolia" | "filecoin-calibration", number>;
9
+ declare const ChainIdToNetwork: Record<number, Network>;
10
+
11
+ export { ChainIdToNetwork as C, EvmNetworkToChainId as E, type Network as N, SupportedEVMNetworks as S, NetworkSchema as a, SupportedSVMNetworks as b, SvmNetworkToChainId as c };