@dcentralab/d402-client 0.3.0 → 0.3.3

package/dist/index.d.mts

@@ -166,6 +166,26 @@ declare function createPaymentSelector(defaultOptions: PaymentSelectorOptions):
  * @returns Sorted list (preferred first)
  */
 declare function sortPaymentRequirements(requirements: PaymentRequirement[], preferredNetwork?: string): PaymentRequirement[];
+/**
+ * Find matching payment requirement from a list.
+ *
+ * Simple helper to find a requirement matching scheme and network.
+ * For more complex selection logic, use selectPaymentRequirement() instead.
+ *
+ * @param requirements - List of payment requirements
+ * @param scheme - Desired payment scheme (default: "exact")
+ * @param network - Desired network (optional)
+ * @returns Matching payment requirement or undefined
+ *
+ * @example
+ * ```ts
+ * const match = findMatchingPaymentRequirement(requirements, 'exact', 'sepolia')
+ * if (match) {
+ *   console.log('Found exact payment on Sepolia')
+ * }
+ * ```
+ */
+declare function findMatchingPaymentRequirement(requirements: PaymentRequirement[], scheme?: string, network?: string): PaymentRequirement | undefined;
 
 /**
  * D402 Client - Main client class for handling HTTP 402 payments
@@ -495,6 +515,34 @@ declare function encodePayment(payment: SignedPayment): string;
  * ```
  */
 declare function decodePayment(encodedPayment: string): SignedPayment;
+/**
+ * Decode X-PAYMENT-RESPONSE header from server.
+ *
+ * After a successful payment, servers may return payment confirmation
+ * in the X-PAYMENT-RESPONSE header. This function decodes it.
+ *
+ * @param header - Base64 encoded payment response header
+ * @returns Decoded payment response object
+ *
+ * @example
+ * ```ts
+ * const response = await fetch(url, { headers: { 'X-Payment': payment } })
+ * const responseHeader = response.headers.get('X-Payment-Response')
+ *
+ * if (responseHeader) {
+ *   const paymentResponse = decodePaymentResponse(responseHeader)
+ *   console.log('Success:', paymentResponse.success)
+ *   console.log('Transaction:', paymentResponse.transaction)
+ * }
+ * ```
+ */
+declare function decodePaymentResponse(header: string): {
+    success: boolean;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+    message?: string;
+};
 
 /**
  * Type definitions for wallet module
@@ -561,45 +609,6 @@ declare function createIATPWallet(params: {
     network?: 'sepolia';
     rpcUrl?: string;
 }): Promise<WalletCreationResult>;
-/**
- * Get all IATPWallet addresses owned by a user.
- *
- * Queries the IATPWalletFactory contract to retrieve all wallets
- * where the specified address is the owner.
- *
- * Use this to check if a user already has a wallet before calling createIATPWallet().
- *
- * @param params - Query parameters
- * @param params.ownerAddress - User's wallet address (from MetaMask)
- * @param params.network - Network to query (default: "sepolia")
- * @param params.rpcUrl - Custom RPC URL (optional)
- * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
- *
- * @example
- * ```ts
- * import { getWalletsByOwner } from '@dcentralab/d402-client'
- * import { useAccount } from 'wagmi'
- *
- * const { address } = useAccount()
- *
- * // Check if user has any wallets
- * const wallets = await getWalletsByOwner({
- *   ownerAddress: address,
- *   network: 'sepolia'
- * })
- *
- * if (wallets.length === 0) {
- *   // Show "Create Wallet" button
- * } else {
- *   // Use existing wallet: wallets[0]
- * }
- * ```
- */
-declare function getWalletsByOwner(params: {
-    ownerAddress: Address;
-    network?: 'sepolia';
-    rpcUrl?: string;
-}): Promise<Address[]>;
 
 /**
  * IATPWallet query functions
@@ -640,6 +649,45 @@ declare function getAvailableBalance(params: {
     tokenAddress: Address;
     network?: 'sepolia';
 }): Promise<bigint>;
+/**
+ * Get all IATPWallet addresses owned by a user.
+ *
+ * Queries the IATPWalletFactory contract to retrieve all wallets
+ * where the specified address is the owner.
+ *
+ * Use this to check if a user already has a wallet before calling createIATPWallet().
+ *
+ * @param params - Query parameters
+ * @param params.ownerAddress - User's wallet address (from MetaMask)
+ * @param params.network - Network to query (default: "sepolia")
+ * @param params.rpcUrl - Custom RPC URL (optional)
+ * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
+ *
+ * @example
+ * ```ts
+ * import { getWalletsByOwner } from '@dcentralab/d402-client'
+ * import { useAccount } from 'wagmi'
+ *
+ * const { address } = useAccount()
+ *
+ * // Check if user has any wallets
+ * const wallets = await getWalletsByOwner({
+ *   ownerAddress: address,
+ *   network: 'sepolia'
+ * })
+ *
+ * if (wallets.length === 0) {
+ *   // Show "Create Wallet" button
+ * } else {
+ *   // Use existing wallet: wallets[0]
+ * }
+ * ```
+ */
+declare function getWalletsByOwner(params: {
+    ownerAddress: Address;
+    network?: 'sepolia';
+    rpcUrl?: string;
+}): Promise<Address[]>;
 
 /**
  * IATPWallet withdrawal functions
@@ -1011,15 +1059,6 @@ declare function getUsdcAddress(network: SupportedNetwork): `0x${string}`;
  * ```
  */
 declare function getChainId(network: string): number;
-/**
- * Find matching payment requirement from a list
- *
- * @param requirements - List of payment requirements
- * @param scheme - Desired payment scheme (default: "exact")
- * @param network - Desired network (optional)
- * @returns Matching payment requirement or undefined
- */
-declare function findMatchingPaymentRequirement(requirements: PaymentRequirement[], scheme?: string, network?: string): PaymentRequirement | undefined;
 /**
  * Convert USD amount to USDC atomic units
  *
@@ -1059,23 +1098,6 @@ declare function isValidAddress(address: string): boolean;
  * @returns Normalized address
  */
 declare function normalizeAddress(address: string): `0x${string}`;
-/**
- * Decode X-PAYMENT-RESPONSE header from server
- *
- * @param header - Base64 encoded payment response
- * @returns Decoded payment response
- *
- * @example
- * const response = decodePaymentResponse(responseHeader)
- * console.log(response.success, response.transaction)
- */
-declare function decodePaymentResponse(header: string): {
-    success: boolean;
-    transaction?: string;
-    network?: string;
-    payer?: string;
-    message?: string;
-};
 
 /**
  * Error classes for D402 payment protocol

package/dist/index.d.ts

@@ -166,6 +166,26 @@ declare function createPaymentSelector(defaultOptions: PaymentSelectorOptions):
  * @returns Sorted list (preferred first)
  */
 declare function sortPaymentRequirements(requirements: PaymentRequirement[], preferredNetwork?: string): PaymentRequirement[];
+/**
+ * Find matching payment requirement from a list.
+ *
+ * Simple helper to find a requirement matching scheme and network.
+ * For more complex selection logic, use selectPaymentRequirement() instead.
+ *
+ * @param requirements - List of payment requirements
+ * @param scheme - Desired payment scheme (default: "exact")
+ * @param network - Desired network (optional)
+ * @returns Matching payment requirement or undefined
+ *
+ * @example
+ * ```ts
+ * const match = findMatchingPaymentRequirement(requirements, 'exact', 'sepolia')
+ * if (match) {
+ *   console.log('Found exact payment on Sepolia')
+ * }
+ * ```
+ */
+declare function findMatchingPaymentRequirement(requirements: PaymentRequirement[], scheme?: string, network?: string): PaymentRequirement | undefined;
 
 /**
  * D402 Client - Main client class for handling HTTP 402 payments
@@ -495,6 +515,34 @@ declare function encodePayment(payment: SignedPayment): string;
  * ```
  */
 declare function decodePayment(encodedPayment: string): SignedPayment;
+/**
+ * Decode X-PAYMENT-RESPONSE header from server.
+ *
+ * After a successful payment, servers may return payment confirmation
+ * in the X-PAYMENT-RESPONSE header. This function decodes it.
+ *
+ * @param header - Base64 encoded payment response header
+ * @returns Decoded payment response object
+ *
+ * @example
+ * ```ts
+ * const response = await fetch(url, { headers: { 'X-Payment': payment } })
+ * const responseHeader = response.headers.get('X-Payment-Response')
+ *
+ * if (responseHeader) {
+ *   const paymentResponse = decodePaymentResponse(responseHeader)
+ *   console.log('Success:', paymentResponse.success)
+ *   console.log('Transaction:', paymentResponse.transaction)
+ * }
+ * ```
+ */
+declare function decodePaymentResponse(header: string): {
+    success: boolean;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+    message?: string;
+};
 
 /**
  * Type definitions for wallet module
@@ -561,45 +609,6 @@ declare function createIATPWallet(params: {
     network?: 'sepolia';
     rpcUrl?: string;
 }): Promise<WalletCreationResult>;
-/**
- * Get all IATPWallet addresses owned by a user.
- *
- * Queries the IATPWalletFactory contract to retrieve all wallets
- * where the specified address is the owner.
- *
- * Use this to check if a user already has a wallet before calling createIATPWallet().
- *
- * @param params - Query parameters
- * @param params.ownerAddress - User's wallet address (from MetaMask)
- * @param params.network - Network to query (default: "sepolia")
- * @param params.rpcUrl - Custom RPC URL (optional)
- * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
- *
- * @example
- * ```ts
- * import { getWalletsByOwner } from '@dcentralab/d402-client'
- * import { useAccount } from 'wagmi'
- *
- * const { address } = useAccount()
- *
- * // Check if user has any wallets
- * const wallets = await getWalletsByOwner({
- *   ownerAddress: address,
- *   network: 'sepolia'
- * })
- *
- * if (wallets.length === 0) {
- *   // Show "Create Wallet" button
- * } else {
- *   // Use existing wallet: wallets[0]
- * }
- * ```
- */
-declare function getWalletsByOwner(params: {
-    ownerAddress: Address;
-    network?: 'sepolia';
-    rpcUrl?: string;
-}): Promise<Address[]>;
 
 /**
  * IATPWallet query functions
@@ -640,6 +649,45 @@ declare function getAvailableBalance(params: {
     tokenAddress: Address;
     network?: 'sepolia';
 }): Promise<bigint>;
+/**
+ * Get all IATPWallet addresses owned by a user.
+ *
+ * Queries the IATPWalletFactory contract to retrieve all wallets
+ * where the specified address is the owner.
+ *
+ * Use this to check if a user already has a wallet before calling createIATPWallet().
+ *
+ * @param params - Query parameters
+ * @param params.ownerAddress - User's wallet address (from MetaMask)
+ * @param params.network - Network to query (default: "sepolia")
+ * @param params.rpcUrl - Custom RPC URL (optional)
+ * @returns Array of IATPWallet contract addresses (empty if user has no wallets)
+ *
+ * @example
+ * ```ts
+ * import { getWalletsByOwner } from '@dcentralab/d402-client'
+ * import { useAccount } from 'wagmi'
+ *
+ * const { address } = useAccount()
+ *
+ * // Check if user has any wallets
+ * const wallets = await getWalletsByOwner({
+ *   ownerAddress: address,
+ *   network: 'sepolia'
+ * })
+ *
+ * if (wallets.length === 0) {
+ *   // Show "Create Wallet" button
+ * } else {
+ *   // Use existing wallet: wallets[0]
+ * }
+ * ```
+ */
+declare function getWalletsByOwner(params: {
+    ownerAddress: Address;
+    network?: 'sepolia';
+    rpcUrl?: string;
+}): Promise<Address[]>;
 
 /**
  * IATPWallet withdrawal functions
@@ -1011,15 +1059,6 @@ declare function getUsdcAddress(network: SupportedNetwork): `0x${string}`;
  * ```
  */
 declare function getChainId(network: string): number;
-/**
- * Find matching payment requirement from a list
- *
- * @param requirements - List of payment requirements
- * @param scheme - Desired payment scheme (default: "exact")
- * @param network - Desired network (optional)
- * @returns Matching payment requirement or undefined
- */
-declare function findMatchingPaymentRequirement(requirements: PaymentRequirement[], scheme?: string, network?: string): PaymentRequirement | undefined;
 /**
  * Convert USD amount to USDC atomic units
  *
@@ -1059,23 +1098,6 @@ declare function isValidAddress(address: string): boolean;
  * @returns Normalized address
  */
 declare function normalizeAddress(address: string): `0x${string}`;
-/**
- * Decode X-PAYMENT-RESPONSE header from server
- *
- * @param header - Base64 encoded payment response
- * @returns Decoded payment response
- *
- * @example
- * const response = decodePaymentResponse(responseHeader)
- * console.log(response.success, response.transaction)
- */
-declare function decodePaymentResponse(header: string): {
-    success: boolean;
-    transaction?: string;
-    network?: string;
-    payer?: string;
-    message?: string;
-};
 
 /**
  * Error classes for D402 payment protocol

package/dist/index.js

@@ -267,13 +267,6 @@ function getChainId(network) {
   }
   return chainId;
 }
-function findMatchingPaymentRequirement(requirements, scheme = "exact", network) {
-  return requirements.find((req) => {
-    const schemeMatches = req.scheme === scheme;
-    const networkMatches = !network || req.network === network;
-    return schemeMatches && networkMatches;
-  });
-}
 function usdToUsdc(usdAmount, decimals = 6) {
   return parseMoney(usdAmount, decimals);
 }
@@ -291,16 +284,6 @@ function isValidAddress(address) {
 function normalizeAddress(address) {
   return address.toLowerCase();
 }
-function decodePaymentResponse(header) {
-  try {
-    const binString = atob(header);
-    const bytes = Uint8Array.from(binString, (m) => m.codePointAt(0));
-    const decoded = new TextDecoder().decode(bytes);
-    return JSON.parse(decoded);
-  } catch (error) {
-    throw new Error(`Failed to decode payment response: ${error}`);
-  }
-}
 var init_utils = __esm({
   "src/core/utils.ts"() {
     init_constants();
@@ -389,6 +372,7 @@ var init_signer = __esm({
 var encoder_exports = {};
 __export(encoder_exports, {
   decodePayment: () => decodePayment,
+  decodePaymentResponse: () => decodePaymentResponse,
   encodePayment: () => encodePayment,
   safeBase64Decode: () => safeBase64Decode,
   safeBase64Encode: () => safeBase64Encode
@@ -411,6 +395,14 @@ function decodePayment(encodedPayment) {
   const jsonString = safeBase64Decode(encodedPayment);
   return JSON.parse(jsonString);
 }
+function decodePaymentResponse(header) {
+  try {
+    const jsonString = safeBase64Decode(header);
+    return JSON.parse(jsonString);
+  } catch (error) {
+    throw new Error(`Failed to decode payment response: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
 var init_encoder = __esm({
   "src/payment/encoder.ts"() {
   }
@@ -498,6 +490,13 @@ function sortPaymentRequirements(requirements, preferredNetwork) {
     return 0;
   });
 }
+function findMatchingPaymentRequirement(requirements, scheme = "exact", network) {
+  return requirements.find((req) => {
+    const schemeMatches = req.scheme === scheme;
+    const networkMatches = !network || req.network === network;
+    return schemeMatches && networkMatches;
+  });
+}
 
 // src/contracts/abis/sepolia.json
 var sepolia_default = {
@@ -5108,6 +5107,20 @@ async function createIATPWallet(params) {
     chainId: chain.id
   };
 }
+async function getAvailableBalance(params) {
+  const { publicClient, walletAddress, tokenAddress, network = "sepolia" } = params;
+  const walletConfig = getContractConfig("IATPWallet" /* IATP_WALLET */, network);
+  if (!walletConfig) {
+    throw new Error(`IATPWallet contract not found for network: ${network}`);
+  }
+  const balance = await publicClient.readContract({
+    address: walletAddress,
+    abi: walletConfig.abi,
+    functionName: "getAvailableBalance",
+    args: [tokenAddress]
+  });
+  return balance;
+}
 async function getWalletsByOwner(params) {
   const { ownerAddress, network = "sepolia", rpcUrl } = params;
   const factoryConfig = getContractConfig("IATPWalletFactory" /* IATP_WALLET_FACTORY */, network);
@@ -5129,22 +5142,6 @@ async function getWalletsByOwner(params) {
   return wallets;
 }
 
-// src/wallet/queries.ts
-async function getAvailableBalance(params) {
-  const { publicClient, walletAddress, tokenAddress, network = "sepolia" } = params;
-  const walletConfig = getContractConfig("IATPWallet" /* IATP_WALLET */, network);
-  if (!walletConfig) {
-    throw new Error(`IATPWallet contract not found for network: ${network}`);
-  }
-  const balance = await publicClient.readContract({
-    address: walletAddress,
-    abi: walletConfig.abi,
-    functionName: "getAvailableBalance",
-    args: [tokenAddress]
-  });
-  return balance;
-}
-
 // src/wallet/withdrawals.ts
 async function getWithdrawalRequest(params) {
   const { publicClient, walletAddress, tokenAddress, network = "sepolia" } = params;