@dcentralab/d402-client 0.3.18 → 0.4.2

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Traia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/index.d.mts

@@ -56,6 +56,8 @@ interface PaymentAuthorization {
     validBefore: string;
     /** Unique nonce */
     nonce: `0x${string}`;
+    /** Request path (resource being paid for) */
+    requestPath?: string;
 }
 /**
  * Signed payment ready to send
@@ -593,7 +595,7 @@ declare function decodePaymentResponse(header: string): {
 /**
  * Supported blockchain networks (where IATP contracts are deployed)
  */
-type SupportedNetwork = 'sepolia' | 'arbitrum';
+type SupportedNetwork = 'sepolia' | 'arbitrum_one';
 /**
  * EIP-712 domain for signature verification
  */
@@ -655,7 +657,7 @@ interface WithdrawalRequest {
  *
  * @param params - Creation parameters
  * @param params.ownerAccount - Owner's account (will own the wallet)
- * @param params.network - Network to deploy on: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to deploy on: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @param params.rpcUrl - Custom RPC URL (optional)
  * @returns Wallet creation result with addresses and keys
  *
@@ -695,7 +697,7 @@ declare function createIATPWallet(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address (e.g., USDC)
- * @param params.network - Network to query: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to query: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Available balance in token's base units (wei)
  *
  * @example
@@ -730,7 +732,7 @@ declare function getAvailableBalance(params: {
  *
  * @param params - Query parameters
  * @param params.ownerAddress - User's wallet address (from MetaMask)
- * @param params.network - Network to query: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to query: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @param params.rpcUrl - Custom RPC URL (optional)
  * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
  *
@@ -812,7 +814,7 @@ declare function getWalletEIP712Domain(params: {
  * @param params.providerAddress - Provider's address
  * @param params.deadline - Signature deadline (unix timestamp)
  * @param params.signature - The signed payment signature bytes
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns true if the signature is valid, false otherwise
  */
 declare function validateConsumerSignature(params: {
@@ -840,7 +842,7 @@ declare function validateConsumerSignature(params: {
  * @param params.publicClient - Viem PublicClient
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Withdrawal request details or null if no request exists
  *
  * @example
@@ -887,7 +889,7 @@ declare function getWithdrawalRequest(params: {
  * @param params.tokenAddress - Token contract address
  * @param params.amount - Amount in token's base units (wei)
  * @param params.account - Account to sign transaction (operator)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -926,7 +928,7 @@ declare function requestWithdrawal(params: {
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address
  * @param params.account - Account to sign transaction (operator)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -962,7 +964,7 @@ declare function executeWithdrawal(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.tokenAddress - Token contract address to withdraw
  * @param params.sendToOwner - If true, sends funds to owner; if false, keeps in wallet (default: true)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -1105,7 +1107,7 @@ declare function extractToolResult(response: ParsedMcpResponse): unknown;
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Locked balance in base units (wei)
  *
  * @example
@@ -1138,7 +1140,7 @@ declare function getLockedBalanceForProvider(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Unlocked balance in base units (wei)
  *
  * @example
@@ -1168,7 +1170,7 @@ declare function getUnlockedBalanceForProvider(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Total dispute amount in progress in base units (wei)
  */
 declare function getProviderTotalDisputeInProgress(params: {
@@ -1195,7 +1197,7 @@ declare function getProviderTotalDisputeInProgress(params: {
  * @param params.walletClient - Viem WalletClient (from wagmi useWalletClient)
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.tokenAddress - Token contract address to withdraw
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -1239,7 +1241,7 @@ declare enum ContractName {
  * Get contract address for a given network.
  *
  * @param contractName - Name of the contract (use ContractName enum)
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Contract address as hex string, or null if not found
  *
  * @example
@@ -1253,7 +1255,7 @@ declare function getContractAddress(contractName: string | ContractName, network
  * Get contract ABI for a given network.
  *
  * @param contractName - Name of the contract (use ContractName enum)
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Contract ABI as array of objects, or null if not found
  *
  * @example
@@ -1267,7 +1269,7 @@ declare function getContractAbi(contractName: string | ContractName, network?: S
  * Get contract configuration (address and ABI) for a network.
  *
  * @param contractName - Name of the contract
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Object with address and abi, or null if not found
  *
  * @example
@@ -1296,7 +1298,7 @@ declare function getContractConfig(contractName: string | ContractName, network?
  *
  * @example
  * ```ts
- * const chain = getChain('arbitrum')
+ * const chain = getChain('arbitrum_one')
  * console.log(chain.id) // 42161
  * ```
  */
@@ -1340,7 +1342,7 @@ declare function getUsdcAddress(network: SupportedNetwork): `0x${string}`;
  * from external APIs. It supports many networks that may appear in 402 responses,
  * even if IATP contracts are not deployed on those networks.
  *
- * Note: IATP contracts are deployed on Sepolia and Arbitrum. This function can also
+ * Note: IATP contracts are deployed on Sepolia and Arbitrum One. This function can also
  * handle 402 responses from APIs that might reference other networks by chain ID.
  *
  * @param network - Network name or chain ID as string

package/dist/index.d.ts

@@ -56,6 +56,8 @@ interface PaymentAuthorization {
     validBefore: string;
     /** Unique nonce */
     nonce: `0x${string}`;
+    /** Request path (resource being paid for) */
+    requestPath?: string;
 }
 /**
  * Signed payment ready to send
@@ -593,7 +595,7 @@ declare function decodePaymentResponse(header: string): {
 /**
  * Supported blockchain networks (where IATP contracts are deployed)
  */
-type SupportedNetwork = 'sepolia' | 'arbitrum';
+type SupportedNetwork = 'sepolia' | 'arbitrum_one';
 /**
  * EIP-712 domain for signature verification
  */
@@ -655,7 +657,7 @@ interface WithdrawalRequest {
  *
  * @param params - Creation parameters
  * @param params.ownerAccount - Owner's account (will own the wallet)
- * @param params.network - Network to deploy on: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to deploy on: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @param params.rpcUrl - Custom RPC URL (optional)
  * @returns Wallet creation result with addresses and keys
  *
@@ -695,7 +697,7 @@ declare function createIATPWallet(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address (e.g., USDC)
- * @param params.network - Network to query: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to query: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Available balance in token's base units (wei)
  *
  * @example
@@ -730,7 +732,7 @@ declare function getAvailableBalance(params: {
  *
  * @param params - Query parameters
  * @param params.ownerAddress - User's wallet address (from MetaMask)
- * @param params.network - Network to query: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network to query: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @param params.rpcUrl - Custom RPC URL (optional)
  * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
  *
@@ -812,7 +814,7 @@ declare function getWalletEIP712Domain(params: {
  * @param params.providerAddress - Provider's address
  * @param params.deadline - Signature deadline (unix timestamp)
  * @param params.signature - The signed payment signature bytes
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns true if the signature is valid, false otherwise
  */
 declare function validateConsumerSignature(params: {
@@ -840,7 +842,7 @@ declare function validateConsumerSignature(params: {
  * @param params.publicClient - Viem PublicClient
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Withdrawal request details or null if no request exists
  *
  * @example
@@ -887,7 +889,7 @@ declare function getWithdrawalRequest(params: {
  * @param params.tokenAddress - Token contract address
  * @param params.amount - Amount in token's base units (wei)
  * @param params.account - Account to sign transaction (operator)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -926,7 +928,7 @@ declare function requestWithdrawal(params: {
  * @param params.walletAddress - IATPWallet contract address
  * @param params.tokenAddress - Token contract address
  * @param params.account - Account to sign transaction (operator)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -962,7 +964,7 @@ declare function executeWithdrawal(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.tokenAddress - Token contract address to withdraw
  * @param params.sendToOwner - If true, sends funds to owner; if false, keeps in wallet (default: true)
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -1105,7 +1107,7 @@ declare function extractToolResult(response: ParsedMcpResponse): unknown;
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Locked balance in base units (wei)
  *
  * @example
@@ -1138,7 +1140,7 @@ declare function getLockedBalanceForProvider(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Unlocked balance in base units (wei)
  *
  * @example
@@ -1168,7 +1170,7 @@ declare function getUnlockedBalanceForProvider(params: {
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.providerAddress - Provider (utility agent) IATPWallet address
  * @param params.tokenAddress - Token contract address
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Total dispute amount in progress in base units (wei)
  */
 declare function getProviderTotalDisputeInProgress(params: {
@@ -1195,7 +1197,7 @@ declare function getProviderTotalDisputeInProgress(params: {
  * @param params.walletClient - Viem WalletClient (from wagmi useWalletClient)
  * @param params.publicClient - Viem PublicClient (from wagmi usePublicClient)
  * @param params.tokenAddress - Token contract address to withdraw
- * @param params.network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param params.network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Transaction hash
  *
  * @example
@@ -1239,7 +1241,7 @@ declare enum ContractName {
  * Get contract address for a given network.
  *
  * @param contractName - Name of the contract (use ContractName enum)
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Contract address as hex string, or null if not found
  *
  * @example
@@ -1253,7 +1255,7 @@ declare function getContractAddress(contractName: string | ContractName, network
  * Get contract ABI for a given network.
  *
  * @param contractName - Name of the contract (use ContractName enum)
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Contract ABI as array of objects, or null if not found
  *
  * @example
@@ -1267,7 +1269,7 @@ declare function getContractAbi(contractName: string | ContractName, network?: S
  * Get contract configuration (address and ABI) for a network.
  *
  * @param contractName - Name of the contract
- * @param network - Network: "sepolia" | "arbitrum" (default: "sepolia")
+ * @param network - Network: "sepolia" | "arbitrum_one" (default: "sepolia")
  * @returns Object with address and abi, or null if not found
  *
  * @example
@@ -1296,7 +1298,7 @@ declare function getContractConfig(contractName: string | ContractName, network?
  *
  * @example
  * ```ts
- * const chain = getChain('arbitrum')
+ * const chain = getChain('arbitrum_one')
  * console.log(chain.id) // 42161
  * ```
  */
@@ -1340,7 +1342,7 @@ declare function getUsdcAddress(network: SupportedNetwork): `0x${string}`;
  * from external APIs. It supports many networks that may appear in 402 responses,
  * even if IATP contracts are not deployed on those networks.
  *
- * Note: IATP contracts are deployed on Sepolia and Arbitrum. This function can also
+ * Note: IATP contracts are deployed on Sepolia and Arbitrum One. This function can also
  * handle 402 responses from APIs that might reference other networks by chain ID.
  *
  * @param network - Network name or chain ID as string

package/dist/index.js

@@ -89,7 +89,7 @@ var init_constants = __esm({
   "src/core/constants.ts"() {
     TOKEN_ADDRESSES = {
       sepolia: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
-      arbitrum: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
+      arbitrum_one: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
     };
     EIP712_TYPES = {
       PullFundsForSettlement: [
@@ -141,7 +141,7 @@ function getChainId(network) {
   }
   const networkMap = {
     "sepolia": 11155111,
-    "arbitrum": 42161
+    "arbitrum_one": 42161
   };
   const chainId = networkMap[network];
   if (!chainId) {
@@ -173,7 +173,7 @@ var init_utils = __esm({
     init_errors();
     CHAIN_MAP = {
       sepolia: chains.sepolia,
-      arbitrum: chains.arbitrum
+      arbitrum_one: chains.arbitrum
     };
   }
 });
@@ -358,7 +358,8 @@ async function signD402Payment(params) {
         value: paymentRequirement.maxAmountRequired,
         validAfter,
         validBefore,
-        nonce
+        nonce,
+        requestPath: paymentRequirement.resource || "/mcp"
       }
     }
   };
@@ -5527,9 +5528,9 @@ var sepolia_default = {
   }
 };
 
-// src/contracts/abis/arbitrum.json
-var arbitrum_default = {
-  arbitrum: {
+// src/contracts/abis/arbitrum_one.json
+var arbitrum_one_default = {
+  arbitrum_one: {
     IATPWallet: [
       {
         inputs: [],
@@ -10435,7 +10436,7 @@ var proxies_default = {
     IATPSettlementLayer: "0xB82816BA396fB06aF7076202cb5d7D9e4dACBb15",
     IATPWalletFactory: "0x2A95caE178142EC53864b42891828455f45a9E01"
   },
-  arbitrum: {
+  arbitrum_one: {
     RoleManager: "0x36db583518A2C92D371f075Ac39162bf4825Cbd0",
     IATPSettlementLayer: "0x677028749258c728a8ECb2C7EeA29030e045E7A5",
     IATPWalletFactory: "0x2887f721a7484d4b044410aEE3C73246Ac2062Df"
@@ -10452,7 +10453,7 @@ var ContractName = /* @__PURE__ */ ((ContractName2) => {
 })(ContractName || {});
 var ABIS = {
   sepolia: sepolia_default.sepolia || {},
-  arbitrum: arbitrum_default.arbitrum || {}
+  arbitrum_one: arbitrum_one_default.arbitrum_one || {}
 };
 var PROXY_ADDRESSES = proxies_default;
 function getContractAddress(contractName, network = "sepolia") {