@dcentralab/d402-client 0.3.14 → 0.3.16

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Account } from 'viem/accounts';
-import { WalletClient, PublicClient, Hash, Address } from 'viem';
+import { WalletClient, PublicClient, Hash, Address, Hex } from 'viem';
 import { Chain } from 'viem/chains';
 
 /**
@@ -56,8 +56,6 @@ interface PaymentAuthorization {
     validBefore: string;
     /** Unique nonce */
     nonce: `0x${string}`;
-    /** Request path/resource */
-    requestPath: string;
 }
 /**
  * Signed payment ready to send
@@ -448,7 +446,6 @@ declare class D402Client {
  * @param params.walletClient - Optional wallet client for signing (wagmi). If provided, uses walletClient.signTypedData
  * @param params.paymentRequirement - Payment requirements from 402 response
  * @param params.iatpWalletAddress - IATPWallet contract address (optional)
- * @param params.requestPath - API request path (optional, uses payment_requirements.resource if not provided)
  * @returns Signed payment ready to encode and send
  *
  * @example
@@ -473,7 +470,6 @@ declare function signD402Payment(params: {
     walletClient?: WalletClient;
     paymentRequirement: PaymentRequirement;
     iatpWalletAddress: `0x${string}`;
-    requestPath?: string;
     d402Version?: number;
 }): Promise<SignedPayment>;
 
@@ -802,6 +798,33 @@ declare function getWalletEIP712Domain(params: {
     chainId: bigint;
     verifyingContract: Address;
 }>;
+/**
+ * Validate a consumer payment signature on-chain.
+ *
+ * Calls the IATPWallet's validateConsumerSignature view function to verify
+ * that a payment signature is valid for the given parameters.
+ *
+ * @param params - Query parameters
+ * @param params.publicClient - Viem PublicClient
+ * @param params.walletAddress - IATPWallet contract address
+ * @param params.tokenAddress - Token contract address (e.g., USDC)
+ * @param params.amount - Payment amount in token's base units
+ * @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")
+ * @returns true if the signature is valid, false otherwise
+ */
+declare function validateConsumerSignature(params: {
+    publicClient: PublicClient;
+    walletAddress: Address;
+    tokenAddress: Address;
+    amount: bigint;
+    providerAddress: Address;
+    deadline: bigint;
+    signature: Hex;
+    network?: SupportedNetwork;
+}): Promise<boolean>;
 
 /**
  * IATPWallet withdrawal functions
@@ -1413,4 +1436,4 @@ declare class UnsupportedNetworkError extends PaymentError {
     constructor(network: string);
 }
 
-export { ContractName, D402Client, type D402ClientConfig, type D402Response, type EIP712Domain, Invalid402ResponseError, type JsonRpcPayload, type McpToolResult, MissingRequestConfigError, type ParsedMcpResponse, PaymentAlreadyAttemptedError, PaymentAmountExceededError, type PaymentAuthorization, PaymentError, type PaymentRequirement, type PaymentSelector, type PaymentSelectorOptions, PaymentVerificationError, type SignedPayment, type SupportedNetwork, UnsupportedNetworkError, UnsupportedSchemeError, type WalletCreationResult, type WithdrawalRequest, buildMcpHeaders, buildToolCallPayload, createIATPWallet, createPaymentSelector, decodePayment, decodePaymentResponse, encodePayment, executeWithdrawal, extractToolResult, findMatchingPaymentRequirement, formatMoney, generateNonce, getAvailableBalance, getChain, getChainId, getContractAbi, getContractAddress, getContractConfig, getCurrentTimestamp, getLockedBalanceForProvider, getUnlockedBalanceForProvider, getUsdcAddress, getWalletEIP712Domain, getWalletInfo, getWalletsByOwner, getWithdrawalRequest, initMcpSession, isValidAddress, normalizeAddress, parseAllPaymentRequirements, parseMcpResponse, parseMoney, parsePaymentRequirement, requestWithdrawal, selectPaymentRequirement, signD402Payment, sortPaymentRequirements, usdToUsdc, withdrawAllAvailableEpochs, withdrawAllFromSettlement };
+export { ContractName, D402Client, type D402ClientConfig, type D402Response, type EIP712Domain, Invalid402ResponseError, type JsonRpcPayload, type McpToolResult, MissingRequestConfigError, type ParsedMcpResponse, PaymentAlreadyAttemptedError, PaymentAmountExceededError, type PaymentAuthorization, PaymentError, type PaymentRequirement, type PaymentSelector, type PaymentSelectorOptions, PaymentVerificationError, type SignedPayment, type SupportedNetwork, UnsupportedNetworkError, UnsupportedSchemeError, type WalletCreationResult, type WithdrawalRequest, buildMcpHeaders, buildToolCallPayload, createIATPWallet, createPaymentSelector, decodePayment, decodePaymentResponse, encodePayment, executeWithdrawal, extractToolResult, findMatchingPaymentRequirement, formatMoney, generateNonce, getAvailableBalance, getChain, getChainId, getContractAbi, getContractAddress, getContractConfig, getCurrentTimestamp, getLockedBalanceForProvider, getUnlockedBalanceForProvider, getUsdcAddress, getWalletEIP712Domain, getWalletInfo, getWalletsByOwner, getWithdrawalRequest, initMcpSession, isValidAddress, normalizeAddress, parseAllPaymentRequirements, parseMcpResponse, parseMoney, parsePaymentRequirement, requestWithdrawal, selectPaymentRequirement, signD402Payment, sortPaymentRequirements, usdToUsdc, validateConsumerSignature, withdrawAllAvailableEpochs, withdrawAllFromSettlement };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Account } from 'viem/accounts';
-import { WalletClient, PublicClient, Hash, Address } from 'viem';
+import { WalletClient, PublicClient, Hash, Address, Hex } from 'viem';
 import { Chain } from 'viem/chains';
 
 /**
@@ -56,8 +56,6 @@ interface PaymentAuthorization {
     validBefore: string;
     /** Unique nonce */
     nonce: `0x${string}`;
-    /** Request path/resource */
-    requestPath: string;
 }
 /**
  * Signed payment ready to send
@@ -448,7 +446,6 @@ declare class D402Client {
  * @param params.walletClient - Optional wallet client for signing (wagmi). If provided, uses walletClient.signTypedData
  * @param params.paymentRequirement - Payment requirements from 402 response
  * @param params.iatpWalletAddress - IATPWallet contract address (optional)
- * @param params.requestPath - API request path (optional, uses payment_requirements.resource if not provided)
  * @returns Signed payment ready to encode and send
  *
  * @example
@@ -473,7 +470,6 @@ declare function signD402Payment(params: {
     walletClient?: WalletClient;
     paymentRequirement: PaymentRequirement;
     iatpWalletAddress: `0x${string}`;
-    requestPath?: string;
     d402Version?: number;
 }): Promise<SignedPayment>;
 
@@ -802,6 +798,33 @@ declare function getWalletEIP712Domain(params: {
     chainId: bigint;
     verifyingContract: Address;
 }>;
+/**
+ * Validate a consumer payment signature on-chain.
+ *
+ * Calls the IATPWallet's validateConsumerSignature view function to verify
+ * that a payment signature is valid for the given parameters.
+ *
+ * @param params - Query parameters
+ * @param params.publicClient - Viem PublicClient
+ * @param params.walletAddress - IATPWallet contract address
+ * @param params.tokenAddress - Token contract address (e.g., USDC)
+ * @param params.amount - Payment amount in token's base units
+ * @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")
+ * @returns true if the signature is valid, false otherwise
+ */
+declare function validateConsumerSignature(params: {
+    publicClient: PublicClient;
+    walletAddress: Address;
+    tokenAddress: Address;
+    amount: bigint;
+    providerAddress: Address;
+    deadline: bigint;
+    signature: Hex;
+    network?: SupportedNetwork;
+}): Promise<boolean>;
 
 /**
  * IATPWallet withdrawal functions
@@ -1413,4 +1436,4 @@ declare class UnsupportedNetworkError extends PaymentError {
     constructor(network: string);
 }
 
-export { ContractName, D402Client, type D402ClientConfig, type D402Response, type EIP712Domain, Invalid402ResponseError, type JsonRpcPayload, type McpToolResult, MissingRequestConfigError, type ParsedMcpResponse, PaymentAlreadyAttemptedError, PaymentAmountExceededError, type PaymentAuthorization, PaymentError, type PaymentRequirement, type PaymentSelector, type PaymentSelectorOptions, PaymentVerificationError, type SignedPayment, type SupportedNetwork, UnsupportedNetworkError, UnsupportedSchemeError, type WalletCreationResult, type WithdrawalRequest, buildMcpHeaders, buildToolCallPayload, createIATPWallet, createPaymentSelector, decodePayment, decodePaymentResponse, encodePayment, executeWithdrawal, extractToolResult, findMatchingPaymentRequirement, formatMoney, generateNonce, getAvailableBalance, getChain, getChainId, getContractAbi, getContractAddress, getContractConfig, getCurrentTimestamp, getLockedBalanceForProvider, getUnlockedBalanceForProvider, getUsdcAddress, getWalletEIP712Domain, getWalletInfo, getWalletsByOwner, getWithdrawalRequest, initMcpSession, isValidAddress, normalizeAddress, parseAllPaymentRequirements, parseMcpResponse, parseMoney, parsePaymentRequirement, requestWithdrawal, selectPaymentRequirement, signD402Payment, sortPaymentRequirements, usdToUsdc, withdrawAllAvailableEpochs, withdrawAllFromSettlement };
+export { ContractName, D402Client, type D402ClientConfig, type D402Response, type EIP712Domain, Invalid402ResponseError, type JsonRpcPayload, type McpToolResult, MissingRequestConfigError, type ParsedMcpResponse, PaymentAlreadyAttemptedError, PaymentAmountExceededError, type PaymentAuthorization, PaymentError, type PaymentRequirement, type PaymentSelector, type PaymentSelectorOptions, PaymentVerificationError, type SignedPayment, type SupportedNetwork, UnsupportedNetworkError, UnsupportedSchemeError, type WalletCreationResult, type WithdrawalRequest, buildMcpHeaders, buildToolCallPayload, createIATPWallet, createPaymentSelector, decodePayment, decodePaymentResponse, encodePayment, executeWithdrawal, extractToolResult, findMatchingPaymentRequirement, formatMoney, generateNonce, getAvailableBalance, getChain, getChainId, getContractAbi, getContractAddress, getContractConfig, getCurrentTimestamp, getLockedBalanceForProvider, getUnlockedBalanceForProvider, getUsdcAddress, getWalletEIP712Domain, getWalletInfo, getWalletsByOwner, getWithdrawalRequest, initMcpSession, isValidAddress, normalizeAddress, parseAllPaymentRequirements, parseMcpResponse, parseMoney, parsePaymentRequirement, requestWithdrawal, selectPaymentRequirement, signD402Payment, sortPaymentRequirements, usdToUsdc, validateConsumerSignature, withdrawAllAvailableEpochs, withdrawAllFromSettlement };

package/dist/index.js

@@ -97,8 +97,7 @@ var init_constants = __esm({
         { name: "provider", type: "address" },
         { name: "token", type: "address" },
         { name: "amount", type: "uint256" },
-        { name: "deadline", type: "uint256" },
-        { name: "requestPath", type: "string" }
+        { name: "deadline", type: "uint256" }
       ]
     };
   }
@@ -301,13 +300,8 @@ async function signD402Payment(params) {
     walletClient,
     paymentRequirement,
     iatpWalletAddress,
-    requestPath,
     d402Version = 1
   } = params;
-  let finalRequestPath = requestPath || paymentRequirement.resource || "/mcp";
-  if (!finalRequestPath || finalRequestPath.trim() === "") {
-    finalRequestPath = "/mcp";
-  }
   const nonce = generateNonce();
   const now = getCurrentTimestamp();
   const validAfter = (now - 60).toString();
@@ -327,8 +321,7 @@ async function signD402Payment(params) {
     provider: paymentRequirement.payTo,
     token: paymentRequirement.asset,
     amount: BigInt(paymentRequirement.maxAmountRequired),
-    deadline: BigInt(validBefore),
-    requestPath: finalRequestPath
+    deadline: BigInt(validBefore)
   };
   let signature;
   if (walletClient) {
@@ -365,8 +358,7 @@ async function signD402Payment(params) {
         value: paymentRequirement.maxAmountRequired,
         validAfter,
         validBefore,
-        nonce,
-        requestPath: finalRequestPath
+        nonce
       }
     }
   };
@@ -1191,19 +1183,6 @@ var sepolia_default = {
         stateMutability: "view",
         type: "function"
       },
-      {
-        inputs: [],
-        name: "MAX_REQUEST_PATH_LENGTH",
-        outputs: [
-          {
-            internalType: "uint256",
-            name: "",
-            type: "uint256"
-          }
-        ],
-        stateMutability: "view",
-        type: "function"
-      },
       {
         inputs: [],
         name: "PROVIDER_ATTESTATION_TYPEHASH",
@@ -1516,11 +1495,6 @@ var sepolia_default = {
             name: "deadline",
             type: "uint256"
           },
-          {
-            internalType: "string",
-            name: "requestPath",
-            type: "string"
-          },
           {
             internalType: "bytes",
             name: "signature",
@@ -1612,11 +1586,6 @@ var sepolia_default = {
             name: "deadline",
             type: "uint256"
           },
-          {
-            internalType: "string",
-            name: "requestPath",
-            type: "string"
-          },
           {
             internalType: "bytes",
             name: "signature",
@@ -1761,11 +1730,6 @@ var sepolia_default = {
             name: "deadline",
             type: "uint256"
           },
-          {
-            internalType: "string",
-            name: "requestPath",
-            type: "string"
-          },
           {
             internalType: "bytes",
             name: "signature",
@@ -1786,14 +1750,14 @@ var sepolia_default = {
       {
         inputs: [
           {
-            internalType: "bytes",
-            name: "consumerSignature",
-            type: "bytes"
+            internalType: "bytes32",
+            name: "consumerSignatureHash",
+            type: "bytes32"
           },
           {
-            internalType: "bytes",
+            internalType: "bytes32",
             name: "outputHash",
-            type: "bytes"
+            type: "bytes32"
           },
           {
             internalType: "uint256",
@@ -1852,24 +1816,6 @@ var sepolia_default = {
         stateMutability: "nonpayable",
         type: "function"
       },
-      {
-        inputs: [
-          {
-            internalType: "uint256",
-            name: "epoch",
-            type: "uint256"
-          },
-          {
-            internalType: "address",
-            name: "token",
-            type: "address"
-          }
-        ],
-        name: "withdrawEpochFromSettlement",
-        outputs: [],
-        stateMutability: "nonpayable",
-        type: "function"
-      },
       {
         inputs: [],
         name: "withdrawalLockupPeriod",
@@ -10685,6 +10631,20 @@ async function getWalletEIP712Domain(params) {
     };
   }
 }
+async function validateConsumerSignature(params) {
+  const { publicClient, walletAddress, tokenAddress, amount, providerAddress, deadline, signature, network = "sepolia" } = params;
+  const walletAbi = getContractAbi("IATPWallet" /* IATP_WALLET */, network);
+  if (!walletAbi) {
+    throw new Error(`IATPWallet ABI not found for network: ${network}`);
+  }
+  const isValid = await publicClient.readContract({
+    address: walletAddress,
+    abi: walletAbi,
+    functionName: "validateConsumerSignature",
+    args: [tokenAddress, amount, providerAddress, deadline, signature]
+  });
+  return isValid;
+}
 
 // src/wallet/withdrawals.ts
 async function getWithdrawalRequest(params) {
@@ -11194,6 +11154,7 @@ exports.selectPaymentRequirement = selectPaymentRequirement;
 exports.signD402Payment = signD402Payment;
 exports.sortPaymentRequirements = sortPaymentRequirements;
 exports.usdToUsdc = usdToUsdc;
+exports.validateConsumerSignature = validateConsumerSignature;
 exports.withdrawAllAvailableEpochs = withdrawAllAvailableEpochs;
 exports.withdrawAllFromSettlement = withdrawAllFromSettlement;
 //# sourceMappingURL=index.js.map