@dcentralab/d402-client 0.1.1 → 0.1.3

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/README.md

@@ -55,7 +55,7 @@ export default function AnalyzeButton() {
       // Create D402 client with user's wallet
       const client = new D402Client({
         operatorAccount: walletClient.account,
-        walletAddress: '0xUserIATPWallet...', // User's IATPWallet
+        iatpWalletAddress: '0xUserIATPWallet...', // User's IATPWallet
         maxValue: 1000000n  // 1 USDC max
       })
 
@@ -117,12 +117,12 @@ const result = await createIATPWallet({
   rpcUrl: 'https://ethereum-sepolia-rpc.publicnode.com'
 })
 
-console.log('Wallet:', result.walletAddress)
+console.log('Wallet:', result.iatpWalletAddress)
 console.log('Operator key:', result.operatorPrivateKey) // Store securely!
 ```
 
 **Returns:**
-- `walletAddress` - IATPWallet contract address
+- `iatpWalletAddress` - IATPWallet contract address
 - `operatorAddress` - Operator's address
 - `operatorPrivateKey` - Operator's private key (store securely!)
 - `transactionHash` - Creation transaction
@@ -135,7 +135,7 @@ import { D402Client } from '@dcentralab/d402-client'
 
 const client = new D402Client({
   operatorAccount,
-  walletAddress: '0xYourWallet...',
+  iatpWalletAddress: '0xYourWallet...',
   maxValue: 1000000n,
   networkFilter: 'base-mainnet',  // Only Base network
   schemeFilter: 'exact'           // Only exact payments
@@ -169,7 +169,7 @@ if (response.status === 402) {
   const signedPayment = await signD402Payment({
     operatorAccount,
     paymentRequirement: requirement,
-    walletAddress: '0xYourWallet...'
+    iatpWalletAddress: '0xYourWallet...'
   })
   
   // 4. Encode for header
@@ -199,7 +199,7 @@ new D402Client(config: D402ClientConfig)
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
 | `operatorAccount` | `Account` | ✅ | Viem account for signing payments (EOA) |
-| `walletAddress` | `0x${string}` | ❌ | IATPWallet contract address (uses operator address if not provided) |
+| `iatpWalletAddress` | `0x${string}` | ❌ | IATPWallet contract address (uses operator address if not provided) |
 | `maxValue` | `bigint` | ❌ | Max payment in base units (wei). Safety limit to prevent overpaying. |
 | `networkFilter` | `string` | ❌ | Only select requirements matching this network |
 | `schemeFilter` | `string` | ❌ | Payment scheme filter (default: "exact") |
@@ -320,7 +320,7 @@ export default function PaymentComponent() {
     // User's wallet signs payments
     const client = new D402Client({
       operatorAccount: walletClient.account,
-      walletAddress: '0xUserIATPWallet...',
+      iatpWalletAddress: '0xUserIATPWallet...',
       maxValue: 1000000n
     })
 
@@ -360,7 +360,7 @@ const operatorAccount = privateKeyToAccount(process.env.OPERATOR_KEY!)
 app.post('/api/analyze', async (req, res) => {
   const client = new D402Client({
     operatorAccount,
-    walletAddress: req.user.iatpWallet,
+    iatpWalletAddress: req.user.iatpWallet,
     maxValue: 1000000n
   })
   

package/dist/index.d.mts

@@ -189,10 +189,10 @@ interface D402ClientConfig {
     /** Operator account with private key for signing payments (EOA) */
     operatorAccount: Account;
     /**
-     * Consumer's IATPWallet contract address.
-     * If not provided, uses operator_account.address for testing.
+     * IATPWallet contract address.
+     * If not provided, uses operatorAccount.address for testing.
      */
-    walletAddress?: `0x${string}`;
+    iatpWalletAddress?: `0x${string}`;
     /**
      * Optional safety limit for maximum payment amount per request in base units.
      *
@@ -245,7 +245,7 @@ interface D402ClientConfig {
  *
  * const client = new D402Client({
  *   operatorAccount,
- *   walletAddress: '0xUserIATPWallet...',
+   *   iatpWalletAddress: '0xUserIATPWallet...',
  *   maxValue: 1000000n  // 1 USDC max
  * })
  *
@@ -259,7 +259,7 @@ interface D402ClientConfig {
  */
 declare class D402Client {
     private readonly operatorAccount;
-    private readonly walletAddress;
+    private readonly iatpWalletAddress;
     private readonly maxValue?;
     private readonly paymentRequirementsSelector;
     private readonly networkFilter?;
@@ -282,11 +282,11 @@ declare class D402Client {
      */
     selectPaymentRequirement(requirements: PaymentRequirement[]): PaymentRequirement;
     /**
-     * Get the wallet address used for payments.
+     * Get the IATP wallet address used for payments.
      *
      * @returns IATPWallet contract address or operator EOA address
      */
-    getWalletAddress(): `0x${string}`;
+    getIATPWalletAddress(): `0x${string}`;
     /**
      * Get the operator account used for signing.
      *
@@ -318,7 +318,7 @@ declare class D402Client {
      *
      * @example
      * ```ts
-     * const client = new D402Client({ operatorAccount, walletAddress })
+     * const client = new D402Client({ operatorAccount, iatpWalletAddress })
      *
      * const response = await client.fetch('http://api.example.com/analyze', {
      *   method: 'POST',
@@ -349,7 +349,7 @@ declare class D402Client {
  * @param params - Signing parameters
  * @param params.operatorAccount - Operator account with private key for signing (EOA)
  * @param params.paymentRequirement - Payment requirements from 402 response
- * @param params.walletAddress - Consumer's IATPWallet contract address (optional, uses operator address if not provided)
+ * @param params.iatpWalletAddress - IATPWallet contract address (optional, uses operator address if not provided)
  * @param params.requestPath - API request path (optional, uses payment_requirements.resource if not provided)
  * @returns Signed payment ready to encode and send
  *
@@ -359,7 +359,7 @@ declare class D402Client {
  * const signedPayment = await signD402Payment({
  *   operatorAccount: account,
  *   paymentRequirement: requirement,
- *   walletAddress: '0xUserWallet...'
+ *   iatpWalletAddress: '0xUserWallet...'
  * })
  * const encoded = encodePayment(signedPayment)
  * ```
@@ -367,7 +367,7 @@ declare class D402Client {
 declare function signD402Payment(params: {
     operatorAccount: Account;
     paymentRequirement: PaymentRequirement;
-    walletAddress?: `0x${string}`;
+    iatpWalletAddress?: `0x${string}`;
     requestPath?: string;
     d402Version?: number;
 }): Promise<SignedPayment>;

package/dist/index.d.ts

@@ -189,10 +189,10 @@ interface D402ClientConfig {
     /** Operator account with private key for signing payments (EOA) */
     operatorAccount: Account;
     /**
-     * Consumer's IATPWallet contract address.
-     * If not provided, uses operator_account.address for testing.
+     * IATPWallet contract address.
+     * If not provided, uses operatorAccount.address for testing.
      */
-    walletAddress?: `0x${string}`;
+    iatpWalletAddress?: `0x${string}`;
     /**
      * Optional safety limit for maximum payment amount per request in base units.
      *
@@ -245,7 +245,7 @@ interface D402ClientConfig {
  *
  * const client = new D402Client({
  *   operatorAccount,
- *   walletAddress: '0xUserIATPWallet...',
+   *   iatpWalletAddress: '0xUserIATPWallet...',
  *   maxValue: 1000000n  // 1 USDC max
  * })
  *
@@ -259,7 +259,7 @@ interface D402ClientConfig {
  */
 declare class D402Client {
     private readonly operatorAccount;
-    private readonly walletAddress;
+    private readonly iatpWalletAddress;
     private readonly maxValue?;
     private readonly paymentRequirementsSelector;
     private readonly networkFilter?;
@@ -282,11 +282,11 @@ declare class D402Client {
      */
     selectPaymentRequirement(requirements: PaymentRequirement[]): PaymentRequirement;
     /**
-     * Get the wallet address used for payments.
+     * Get the IATP wallet address used for payments.
      *
      * @returns IATPWallet contract address or operator EOA address
      */
-    getWalletAddress(): `0x${string}`;
+    getIATPWalletAddress(): `0x${string}`;
     /**
      * Get the operator account used for signing.
      *
@@ -318,7 +318,7 @@ declare class D402Client {
      *
      * @example
      * ```ts
-     * const client = new D402Client({ operatorAccount, walletAddress })
+     * const client = new D402Client({ operatorAccount, iatpWalletAddress })
      *
      * const response = await client.fetch('http://api.example.com/analyze', {
      *   method: 'POST',
@@ -349,7 +349,7 @@ declare class D402Client {
  * @param params - Signing parameters
  * @param params.operatorAccount - Operator account with private key for signing (EOA)
  * @param params.paymentRequirement - Payment requirements from 402 response
- * @param params.walletAddress - Consumer's IATPWallet contract address (optional, uses operator address if not provided)
+ * @param params.iatpWalletAddress - IATPWallet contract address (optional, uses operator address if not provided)
  * @param params.requestPath - API request path (optional, uses payment_requirements.resource if not provided)
  * @returns Signed payment ready to encode and send
  *
@@ -359,7 +359,7 @@ declare class D402Client {
  * const signedPayment = await signD402Payment({
  *   operatorAccount: account,
  *   paymentRequirement: requirement,
- *   walletAddress: '0xUserWallet...'
+ *   iatpWalletAddress: '0xUserWallet...'
  * })
  * const encoded = encodePayment(signedPayment)
  * ```
@@ -367,7 +367,7 @@ declare class D402Client {
 declare function signD402Payment(params: {
     operatorAccount: Account;
     paymentRequirement: PaymentRequirement;
-    walletAddress?: `0x${string}`;
+    iatpWalletAddress?: `0x${string}`;
     requestPath?: string;
     d402Version?: number;
 }): Promise<SignedPayment>;

package/dist/index.js

@@ -351,11 +351,11 @@ async function signD402Payment(params) {
   const {
     operatorAccount,
     paymentRequirement,
-    walletAddress,
+    iatpWalletAddress,
     requestPath,
     d402Version = 1
   } = params;
-  const consumerWallet = walletAddress || operatorAccount.address;
+  const consumerWallet = iatpWalletAddress || operatorAccount.address;
   let finalRequestPath = requestPath || paymentRequirement.resource || "/mcp";
   if (!finalRequestPath || finalRequestPath.trim() === "") {
     finalRequestPath = "/mcp";
@@ -545,7 +545,7 @@ var D402Client = class {
    */
   constructor(config) {
     this.operatorAccount = config.operatorAccount;
-    this.walletAddress = config.walletAddress || config.operatorAccount.address;
+    this.iatpWalletAddress = config.iatpWalletAddress || config.operatorAccount.address;
     this.maxValue = config.maxValue;
     this.networkFilter = config.networkFilter;
     this.schemeFilter = config.schemeFilter || "exact";
@@ -567,12 +567,12 @@ var D402Client = class {
     });
   }
   /**
-   * Get the wallet address used for payments.
+   * Get the IATP wallet address used for payments.
    * 
    * @returns IATPWallet contract address or operator EOA address
    */
-  getWalletAddress() {
-    return this.walletAddress;
+  getIATPWalletAddress() {
+    return this.iatpWalletAddress;
   }
   /**
    * Get the operator account used for signing.
@@ -609,7 +609,7 @@ var D402Client = class {
    * 
    * @example
    * ```ts
-   * const client = new D402Client({ operatorAccount, walletAddress })
+   * const client = new D402Client({ operatorAccount, iatpWalletAddress })
    * 
    * const response = await client.fetch('http://api.example.com/analyze', {
    *   method: 'POST',
@@ -634,7 +634,7 @@ var D402Client = class {
       const signedPayment = await signD402Payment2({
         operatorAccount: this.operatorAccount,
         paymentRequirement: selectedRequirement,
-        walletAddress: this.walletAddress
+        iatpWalletAddress: this.iatpWalletAddress
       });
       const paymentHeader = encodePayment2(signedPayment);
       response = await fetch(url, {