@dcentralab/d402-client 0.2.2 → 0.2.4

package/dist/index.js

@@ -511,139 +511,6 @@ function sortPaymentRequirements(requirements, preferredNetwork) {
   });
 }
 
-// src/client.ts
-var D402Client = class {
-  /**
-   * Create a new D402 Client.
-   * 
-   * @param config - Client configuration
-   * 
-   * @example
-   * ```ts
-   * const client = new D402Client({
-   *   operatorAccount: walletClient.account,  // User's wallet from wagmi
-   *   iatpWalletAddress: userWallet,          // From createIATPWallet() or getWalletsByOwner()
-   *   maxValue: 1000000n                       // Safety limit: 1 USDC max
-   * })
-   * ```
-   */
-  constructor(config) {
-    this.operatorAccount = config.operatorAccount;
-    this.iatpWalletAddress = config.iatpWalletAddress || config.operatorAccount.address;
-    this.maxValue = config.maxValue;
-    this.networkFilter = config.networkFilter;
-    this.schemeFilter = config.schemeFilter || "exact";
-    this.paymentRequirementsSelector = config.paymentRequirementsSelector || selectPaymentRequirement;
-  }
-  /**
-   * Select payment requirement from list of options.
-   * 
-   * Applies configured filters (network, scheme, maxValue) to choose
-   * the appropriate payment option from the server's requirements list.
-   * 
-   * @param requirements - List of payment requirements from 402 response
-   * @returns Selected payment requirement
-   */
-  selectPaymentRequirement(requirements) {
-    return this.paymentRequirementsSelector(requirements, {
-      network: this.networkFilter,
-      scheme: this.schemeFilter,
-      maxAmount: this.maxValue
-    });
-  }
-  /**
-   * Get the IATP wallet address used for payments.
-   * 
-   * @returns IATPWallet contract address, or user's EOA address if no wallet configured
-   */
-  getIATPWalletAddress() {
-    return this.iatpWalletAddress;
-  }
-  /**
-   * Get the user's account used for signing payments.
-   * 
-   * @returns User's wallet account
-   */
-  getOperatorAccount() {
-    return this.operatorAccount;
-  }
-  /**
-   * Get the maximum payment value limit.
-   * 
-   * @returns Maximum value in base units, or undefined if no limit
-   */
-  getMaxValue() {
-    return this.maxValue;
-  }
-  /**
-   * Fetch with automatic 402 payment handling.
-   * 
-   * 
-   * Flow:
-   * 1. Make request without payment
-   * 2. If 402 response, parse payment requirements
-   * 3. Select appropriate payment option
-   * 4. Sign payment with EIP-712
-   * 5. Retry request with X-Payment header
-   * 6. Return final response
-   * 
-   * @param url - URL to fetch
-   * @param init - Fetch options (method, headers, body, etc.)
-   * @returns Response object (after payment if 402)
-   * 
-   * @example
-   * ```ts
-   * const client = new D402Client({ operatorAccount, iatpWalletAddress })
-   * 
-   * const response = await client.fetch('http://api.example.com/analyze', {
-   *   method: 'POST',
-   *   headers: { 'Content-Type': 'application/json' },
-   *   body: JSON.stringify({ text: 'Analyze this' })
-   * })
-   * 
-   * const data = await response.json()
-   * ```
-   */
-  async fetch(url, init) {
-    const { parseAllPaymentRequirements: parseAllPaymentRequirements2 } = await Promise.resolve().then(() => (init_parser(), parser_exports));
-    const { signD402Payment: signD402Payment2 } = await Promise.resolve().then(() => (init_signer(), signer_exports));
-    const { encodePayment: encodePayment2 } = await Promise.resolve().then(() => (init_encoder(), encoder_exports));
-    let response = await fetch(url, init);
-    if (response.status !== 402) {
-      return response;
-    }
-    try {
-      const requirements = await parseAllPaymentRequirements2(response);
-      const selectedRequirement = this.selectPaymentRequirement(requirements);
-      const signedPayment = await signD402Payment2({
-        operatorAccount: this.operatorAccount,
-        paymentRequirement: selectedRequirement,
-        iatpWalletAddress: this.iatpWalletAddress
-      });
-      const paymentHeader = encodePayment2(signedPayment);
-      response = await fetch(url, {
-        ...init,
-        headers: {
-          ...init?.headers,
-          "X-Payment": paymentHeader,
-          "Access-Control-Expose-Headers": "X-Payment-Response"
-        }
-      });
-      return response;
-    } catch (error) {
-      throw error;
-    }
-  }
-};
-
-// src/index.ts
-init_signer();
-init_parser();
-init_encoder();
-init_utils();
-init_errors();
-init_constants();
-
 // src/contracts/abis/sepolia.json
 var sepolia_default = {
   sepolia: {
@@ -1213,6 +1080,25 @@ var sepolia_default = {
         stateMutability: "nonpayable",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "address",
+            name: "token",
+            type: "address"
+          }
+        ],
+        name: "getAvailableBalance",
+        outputs: [
+          {
+            internalType: "uint256",
+            name: "",
+            type: "uint256"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [
           {
@@ -1325,6 +1211,50 @@ var sepolia_default = {
         stateMutability: "view",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "address",
+            name: "token",
+            type: "address"
+          },
+          {
+            internalType: "uint256",
+            name: "amount",
+            type: "uint256"
+          },
+          {
+            internalType: "address",
+            name: "provider",
+            type: "address"
+          },
+          {
+            internalType: "uint256",
+            name: "deadline",
+            type: "uint256"
+          },
+          {
+            internalType: "string",
+            name: "requestPath",
+            type: "string"
+          },
+          {
+            internalType: "bytes",
+            name: "signature",
+            type: "bytes"
+          }
+        ],
+        name: "isValidSettlementRequest",
+        outputs: [
+          {
+            internalType: "bool",
+            name: "",
+            type: "bool"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [],
         name: "operatorAddress",
@@ -1565,6 +1495,11 @@ var sepolia_default = {
             internalType: "address",
             name: "token",
             type: "address"
+          },
+          {
+            internalType: "bool",
+            name: "sendToOwner",
+            type: "bool"
           }
         ],
         name: "withdrawAllFromSettlement",
@@ -2554,6 +2489,31 @@ var sepolia_default = {
         name: "EpochReleased",
         type: "event"
       },
+      {
+        anonymous: false,
+        inputs: [
+          {
+            indexed: true,
+            internalType: "address",
+            name: "facilitator",
+            type: "address"
+          },
+          {
+            indexed: true,
+            internalType: "address",
+            name: "token",
+            type: "address"
+          },
+          {
+            indexed: false,
+            internalType: "uint256",
+            name: "amount",
+            type: "uint256"
+          }
+        ],
+        name: "FacilitatorEarningsWithdrawn",
+        type: "event"
+      },
       {
         anonymous: false,
         inputs: [
@@ -2972,6 +2932,11 @@ var sepolia_default = {
             internalType: "struct IIATPSettlementLayer.SettlementRequest",
             name: "req",
             type: "tuple"
+          },
+          {
+            internalType: "address",
+            name: "facilitator",
+            type: "address"
           }
         ],
         name: "_settleRequest",
@@ -3184,6 +3149,30 @@ var sepolia_default = {
         stateMutability: "view",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "address",
+            name: "",
+            type: "address"
+          },
+          {
+            internalType: "address",
+            name: "",
+            type: "address"
+          }
+        ],
+        name: "facilitatorFeeBalances",
+        outputs: [
+          {
+            internalType: "uint256",
+            name: "",
+            type: "uint256"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [
           {
@@ -3304,6 +3293,30 @@ var sepolia_default = {
         stateMutability: "view",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "address",
+            name: "facilitator",
+            type: "address"
+          },
+          {
+            internalType: "address",
+            name: "token",
+            type: "address"
+          }
+        ],
+        name: "getFacilitatorEarnings",
+        outputs: [
+          {
+            internalType: "uint256",
+            name: "",
+            type: "uint256"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [
           {
@@ -4012,6 +4025,30 @@ var sepolia_default = {
         stateMutability: "view",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "uint256",
+            name: "amount",
+            type: "uint256"
+          },
+          {
+            internalType: "uint256",
+            name: "facilitatorFeePercent",
+            type: "uint256"
+          }
+        ],
+        name: "validatePaymentAmount",
+        outputs: [
+          {
+            internalType: "bool",
+            name: "isValid",
+            type: "bool"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [
           {
@@ -4042,6 +4079,19 @@ var sepolia_default = {
         outputs: [],
         stateMutability: "nonpayable",
         type: "function"
+      },
+      {
+        inputs: [
+          {
+            internalType: "address[]",
+            name: "tokens",
+            type: "address[]"
+          }
+        ],
+        name: "withdrawFacilitatorEarnings",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function"
       }
     ],
     IATPWalletFactory: [
@@ -4751,9 +4801,9 @@ var implementations_default = {
   sepolia: {
     Congress: "0x94Fc9eddBd1779542b78eb92F0569762603876e2",
     TraiaCongressMembersRegistry: "0x3B685403b195f16D103b42FCf56F848A278d6049",
-    IATPWalletImplementation: "0xab2Ea0765B9dBCf997Fe7ad2fE826D0dA51cfB69",
+    IATPWalletImplementation: "0xfE32B4ae6606F70342749AD0C62E1C7e5F84E1B4",
     RoleManagerImplementation: "0x585AD85FCFBec3B1503E50b46407bF65d4006560",
-    IATPSettlementLayerImplementation: "0x88Ff3cdb3c8F7cd480DC48E849D5550F9cAeCBb7",
+    IATPSettlementLayerImplementation: "0x0fDd39d323EE3538c800d4A13730eecE3F0bA975",
     IATPWalletFactoryImplementation: "0xA1E5a53cE5b4e78801d9394EC60D0B53390CA240"
   }
 };
@@ -4802,6 +4852,8 @@ function isContractDeployed(contractName, network) {
   const abi = getContractAbi(contractName, network);
   return address !== null && abi !== null;
 }
+
+// src/wallet.ts
 async function createIATPWallet(params) {
   const { ownerAccount, network = "sepolia", rpcUrl } = params;
   const factoryConfig = getContractConfig("IATPWalletFactory" /* IATP_WALLET_FACTORY */, network);
@@ -4889,6 +4941,326 @@ async function getWalletsByOwner(params) {
   });
   return wallets;
 }
+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 getWithdrawalRequest(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 result = await publicClient.readContract({
+    address: walletAddress,
+    abi: walletConfig.abi,
+    functionName: "getWithdrawalRequest",
+    args: [tokenAddress]
+  });
+  if (result[0] === 0n) {
+    return null;
+  }
+  return result;
+}
+async function requestWithdrawal(params) {
+  const { walletClient, publicClient, walletAddress, tokenAddress, amount, account, network = "sepolia" } = params;
+  const walletConfig = getContractConfig("IATPWallet" /* IATP_WALLET */, network);
+  if (!walletConfig) {
+    throw new Error(`IATPWallet contract not found for network: ${network}`);
+  }
+  const data = viem.encodeFunctionData({
+    abi: walletConfig.abi,
+    functionName: "requestWithdrawal",
+    args: [tokenAddress, amount]
+  });
+  const estimatedGas = await publicClient.estimateGas({
+    account: account.address,
+    to: walletAddress,
+    data
+  });
+  const gasLimit = estimatedGas + estimatedGas * BigInt(20) / BigInt(100);
+  const { request } = await publicClient.simulateContract({
+    account,
+    address: walletAddress,
+    abi: walletConfig.abi,
+    functionName: "requestWithdrawal",
+    args: [tokenAddress, amount]
+  });
+  const hash = await walletClient.writeContract({
+    ...request,
+    gas: gasLimit
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
+async function executeWithdrawal(params) {
+  const { walletClient, publicClient, walletAddress, tokenAddress, account, network = "sepolia" } = params;
+  const walletConfig = getContractConfig("IATPWallet" /* IATP_WALLET */, network);
+  if (!walletConfig) {
+    throw new Error(`IATPWallet contract not found for network: ${network}`);
+  }
+  const data = viem.encodeFunctionData({
+    abi: walletConfig.abi,
+    functionName: "executeWithdrawal",
+    args: [tokenAddress]
+  });
+  const estimatedGas = await publicClient.estimateGas({
+    account: account.address,
+    to: walletAddress,
+    data
+  });
+  const gasLimit = estimatedGas + estimatedGas * BigInt(20) / BigInt(100);
+  const { request } = await publicClient.simulateContract({
+    account,
+    address: walletAddress,
+    abi: walletConfig.abi,
+    functionName: "executeWithdrawal",
+    args: [tokenAddress]
+  });
+  const hash = await walletClient.writeContract({
+    ...request,
+    gas: gasLimit
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
+
+// src/client.ts
+var D402Client = class {
+  /**
+   * Create a new D402 Client.
+   * 
+   * @param config - Client configuration
+   * 
+   * @example
+   * ```ts
+   * const client = new D402Client({
+   *   operatorAccount: walletClient.account,  // User's wallet from wagmi
+   *   iatpWalletAddress: userWallet,          // From createIATPWallet() or getWalletsByOwner()
+   *   maxValue: 1000000n                       // Safety limit: 1 USDC max
+   * })
+   * ```
+   */
+  constructor(config) {
+    this.operatorAccount = config.operatorAccount;
+    this.iatpWalletAddress = config.iatpWalletAddress;
+    this.maxValue = config.maxValue;
+    this.networkFilter = config.networkFilter;
+    this.schemeFilter = config.schemeFilter || "exact";
+    this.paymentRequirementsSelector = config.paymentRequirementsSelector || selectPaymentRequirement;
+  }
+  /**
+   * Select payment requirement from list of options.
+   * 
+   * Applies configured filters (network, scheme, maxValue) to choose
+   * the appropriate payment option from the server's requirements list.
+   * 
+   * @param requirements - List of payment requirements from 402 response
+   * @returns Selected payment requirement
+   */
+  selectPaymentRequirement(requirements) {
+    return this.paymentRequirementsSelector(requirements, {
+      network: this.networkFilter,
+      scheme: this.schemeFilter,
+      maxAmount: this.maxValue
+    });
+  }
+  /**
+   * Get the IATP wallet address used for payments.
+   * 
+   * @returns IATPWallet contract address, or user's EOA address if no wallet configured
+   */
+  getIATPWalletAddress() {
+    return this.iatpWalletAddress;
+  }
+  /**
+   * Get the user's account used for signing payments.
+   * 
+   * @returns User's wallet account
+   */
+  getOperatorAccount() {
+    return this.operatorAccount;
+  }
+  /**
+   * Get the maximum payment value limit.
+   * 
+   * @returns Maximum value in base units, or undefined if no limit
+   */
+  getMaxValue() {
+    return this.maxValue;
+  }
+  /**
+   * Get available balance for a token in the IATP wallet.
+   * 
+   * @param publicClient - Viem PublicClient (from wagmi usePublicClient)
+   * @param tokenAddress - Token contract address
+   * @returns Available balance in token's base units (wei)
+   */
+  async getAvailableBalance(publicClient, tokenAddress) {
+    return getAvailableBalance({
+      publicClient,
+      walletAddress: this.iatpWalletAddress,
+      tokenAddress
+    });
+  }
+  /**
+   * Get withdrawal request for a token.
+   * 
+   * @param publicClient - Viem PublicClient
+   * @param tokenAddress - Token contract address
+   * @returns Withdrawal request: [amount, unlockTimestamp] or null if no request exists
+   */
+  async getWithdrawalRequest(publicClient, tokenAddress) {
+    return getWithdrawalRequest({
+      publicClient,
+      walletAddress: this.iatpWalletAddress,
+      tokenAddress
+    });
+  }
+  /**
+   * Request a withdrawal from the IATP wallet.
+   * 
+   * @param walletClient - Viem WalletClient (from wagmi useWalletClient)
+   * @param publicClient - Viem PublicClient (from wagmi usePublicClient)
+   * @param tokenAddress - Token contract address
+   * @param amount - Amount in token's base units (wei)
+   * @returns Transaction hash
+   */
+  async requestWithdrawal(walletClient, publicClient, tokenAddress, amount) {
+    return requestWithdrawal({
+      walletClient,
+      publicClient,
+      walletAddress: this.iatpWalletAddress,
+      tokenAddress,
+      amount,
+      account: this.operatorAccount
+    });
+  }
+  /**
+   * Execute a withdrawal for a token (after unlock period).
+   * 
+   * @param walletClient - Viem WalletClient
+   * @param publicClient - Viem PublicClient
+   * @param tokenAddress - Token contract address
+   * @returns Transaction hash
+   */
+  async executeWithdrawal(walletClient, publicClient, tokenAddress) {
+    return executeWithdrawal({
+      walletClient,
+      publicClient,
+      walletAddress: this.iatpWalletAddress,
+      tokenAddress,
+      account: this.operatorAccount
+    });
+  }
+  /**
+   * Fetch with automatic 402 payment handling.
+   * 
+   * 
+   * Flow:
+   * 1. Make request without payment
+   * 2. If 402 response, parse payment requirements
+   * 3. Select appropriate payment option
+   * 4. Sign payment with EIP-712
+   * 5. Retry request with X-Payment header
+   * 6. Return final response
+   * 
+   * @param url - URL to fetch
+   * @param init - Fetch options (method, headers, body, etc.)
+   * @returns Response object (after payment if 402)
+   * 
+   * @example
+   * ```ts
+   * const client = new D402Client({ operatorAccount, iatpWalletAddress })
+   * 
+   * const response = await client.fetch('http://api.example.com/analyze', {
+   *   method: 'POST',
+   *   headers: { 'Content-Type': 'application/json' },
+   *   body: JSON.stringify({ text: 'Analyze this' })
+   * })
+   * 
+   * const data = await response.json()
+   * ```
+   */
+  async fetch(url, init) {
+    const { parseAllPaymentRequirements: parseAllPaymentRequirements2 } = await Promise.resolve().then(() => (init_parser(), parser_exports));
+    const { signD402Payment: signD402Payment2 } = await Promise.resolve().then(() => (init_signer(), signer_exports));
+    const { encodePayment: encodePayment2 } = await Promise.resolve().then(() => (init_encoder(), encoder_exports));
+    let response = await fetch(url, init);
+    if (response.status !== 402) {
+      return response;
+    }
+    try {
+      const requirements = await parseAllPaymentRequirements2(response);
+      const selectedRequirement = this.selectPaymentRequirement(requirements);
+      const signedPayment = await signD402Payment2({
+        operatorAccount: this.operatorAccount,
+        paymentRequirement: selectedRequirement,
+        iatpWalletAddress: this.iatpWalletAddress
+      });
+      const paymentHeader = encodePayment2(signedPayment);
+      response = await fetch(url, {
+        ...init,
+        headers: {
+          ...init?.headers,
+          "X-Payment": paymentHeader,
+          "Access-Control-Expose-Headers": "X-Payment-Response"
+        }
+      });
+      return response;
+    } catch (error) {
+      throw error;
+    }
+  }
+};
+
+// src/index.ts
+init_signer();
+init_parser();
+init_encoder();
+init_utils();
+init_errors();
+init_constants();
+
+// src/settlement.ts
+async function getLockedBalanceForProvider(params) {
+  const { publicClient, settlementLayerAddress, providerAddress, tokenAddress, network = "sepolia" } = params;
+  const settlementConfig = getContractConfig("IATPSettlementLayer" /* IATP_SETTLEMENT_LAYER */, network);
+  if (!settlementConfig) {
+    throw new Error(`IATPSettlementLayer contract not found for network: ${network}`);
+  }
+  const balance = await publicClient.readContract({
+    address: settlementLayerAddress,
+    abi: settlementConfig.abi,
+    functionName: "getLockedBalanceForProvider",
+    args: [providerAddress, tokenAddress]
+  });
+  return balance;
+}
+async function getUnlockedBalanceForProvider(params) {
+  const { publicClient, settlementLayerAddress, providerAddress, tokenAddress, network = "sepolia" } = params;
+  const settlementConfig = getContractConfig("IATPSettlementLayer" /* IATP_SETTLEMENT_LAYER */, network);
+  if (!settlementConfig) {
+    throw new Error(`IATPSettlementLayer contract not found for network: ${network}`);
+  }
+  const balance = await publicClient.readContract({
+    address: settlementLayerAddress,
+    abi: settlementConfig.abi,
+    functionName: "getUnlockedBalanceForProvider",
+    args: [providerAddress, tokenAddress]
+  });
+  return balance;
+}
 
 exports.ContractName = ContractName;
 exports.D402Client = D402Client;
@@ -4901,11 +5273,14 @@ exports.findMatchingPaymentRequirement = findMatchingPaymentRequirement;
 exports.formatMoney = formatMoney;
 exports.generateNonce = generateNonce;
 exports.getAllContractAddresses = getAllContractAddresses;
+exports.getAvailableBalance = getAvailableBalance;
 exports.getChainId = getChainId;
 exports.getContractAbi = getContractAbi;
 exports.getContractAddress = getContractAddress;
 exports.getContractConfig = getContractConfig;
 exports.getCurrentTimestamp = getCurrentTimestamp;
+exports.getLockedBalanceForProvider = getLockedBalanceForProvider;
+exports.getUnlockedBalanceForProvider = getUnlockedBalanceForProvider;
 exports.getUsdcAddress = getUsdcAddress;
 exports.getWalletsByOwner = getWalletsByOwner;
 exports.isContractDeployed = isContractDeployed;