@dcentralab/d402-client 0.1.0 → 0.1.2

package/README.md

@@ -1,4 +1,4 @@
-# @iatp/d402-client
+# @dcentralab/d402-client
 
 **D402 Payment Protocol Client** for TypeScript/JavaScript
 
@@ -9,11 +9,14 @@ Port of Python IATP package to TypeScript with 1:1 API compatibility.
 ## 🚀 Installation
 
 ```bash
-npm install @iatp/d402-client viem wagmi
+npm install @dcentralab/d402-client viem wagmi
+
 # or
-pnpm add @iatp/d402-client viem wagmi
+pnpm add @dcentralab/d402-client viem wagmi
+
 # or
-yarn add @iatp/d402-client viem wagmi
+yarn add @dcentralab/d402-client viem wagmi
+
 ```
 
 **Requirements:**
@@ -24,46 +27,14 @@ yarn add @iatp/d402-client viem wagmi
 
 ## 📖 Quick Start (React/Next.js)
 
-### Step 1: Configure Next.js Polyfills
-
-**File:** `next.config.js`
-
-```javascript
-module.exports = {
-  webpack: (config, { isServer }) => {
-    if (!isServer) {
-      config.resolve.fallback = {
-        ...config.resolve.fallback,
-        buffer: require.resolve('buffer/'),
-        crypto: require.resolve('crypto-browserify'),
-        stream: require.resolve('stream-browserify'),
-        process: require.resolve('process/browser')
-      }
-
-      const webpack = require('webpack')
-      config.plugins.push(
-        new webpack.ProvidePlugin({
-          Buffer: ['buffer', 'Buffer'],
-          process: 'process/browser'
-        })
-      )
-    }
-    return config
-  }
-}
-```
-
-**Install polyfills:**
-```bash
-pnpm add buffer process crypto-browserify stream-browserify
-```
+### Usage in React Component
 
-### Step 2: Use in React Component
+**No special configuration needed!** ✨ Uses native browser APIs (TextEncoder, TextDecoder, Web Crypto).
 
 ```typescript
 'use client'
 
-import { D402Client } from '@iatp/d402-client'
+import { D402Client } from '@dcentralab/d402-client'
 import { useWalletClient } from 'wagmi'
 import { useState } from 'react'
 
@@ -84,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
       })
 
@@ -125,7 +96,7 @@ export default function AnalyzeButton() {
 6. API returns data
 7. User sees result
 
-**All in browser!** No backend needed.
+**All in browser!** No backend or polyfills needed.
 
 ## 🏗️ Features
 
@@ -134,7 +105,7 @@ export default function AnalyzeButton() {
 Create on-chain wallet with owner/operator separation:
 
 ```typescript
-import { createIATPWallet } from '@iatp/d402-client'
+import { createIATPWallet } from '@dcentralab/d402-client'
 import { privateKeyToAccount } from 'viem/accounts'
 
 // Owner creates wallet (one-time setup)
@@ -146,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
@@ -160,11 +131,11 @@ console.log('Operator key:', result.operatorPrivateKey) // Store securely!
 ### 2. Automatic 402 Payment Handling
 
 ```typescript
-import { D402Client } from '@iatp/d402-client'
+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
@@ -185,7 +156,7 @@ import {
   parsePaymentRequirement,
   signD402Payment,
   encodePayment
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 
 // 1. Make request
 const response = await fetch('https://api.example.com')
@@ -198,7 +169,7 @@ if (response.status === 402) {
   const signedPayment = await signD402Payment({
     operatorAccount,
     paymentRequirement: requirement,
-    walletAddress: '0xYourWallet...'
+    iatpWalletAddress: '0xYourWallet...'
   })
   
   // 4. Encode for header
@@ -228,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") |
@@ -337,7 +308,7 @@ Get chain ID for network name.
 ```typescript
 'use client'
 
-import { D402Client } from '@iatp/d402-client'
+import { D402Client } from '@dcentralab/d402-client'
 import { useWalletClient } from 'wagmi'
 
 export default function PaymentComponent() {
@@ -349,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
     })
 
@@ -373,7 +344,6 @@ export default function PaymentComponent() {
 
 **Cons:**
 - ⚠️ Requires wallet connection
-- ⚠️ Needs Next.js polyfill config
 - ⚠️ User approves each payment
 
 ### Pattern 2: Backend Proxy (Alternative)
@@ -382,7 +352,7 @@ export default function PaymentComponent() {
 
 **Backend (Node.js):**
 ```typescript
-import { D402Client } from '@iatp/d402-client'
+import { D402Client } from '@dcentralab/d402-client'
 import { privateKeyToAccount } from 'viem/accounts'
 
 const operatorAccount = privateKeyToAccount(process.env.OPERATOR_KEY!)
@@ -390,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
   })
   
@@ -416,7 +386,6 @@ const response = await fetch('/api/analyze', {
 
 **Pros:**
 - ✅ Simpler frontend (no wallet needed)
-- ✅ No polyfills needed in frontend
 - ✅ Smooth UX (no wallet popups)
 
 **Cons:**
@@ -439,10 +408,10 @@ const response = await fetch('/api/analyze', {
 
 ```typescript
 // Main client
-export { D402Client } from '@iatp/d402-client'
+export { D402Client } from '@dcentralab/d402-client'
 
 // Wallet management
-export { createIATPWallet } from '@iatp/d402-client'
+export { createIATPWallet } from '@dcentralab/d402-client'
 
 // Payment functions
 export {
@@ -451,7 +420,7 @@ export {
   signD402Payment,
   encodePayment,
   decodePayment
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 
 // Contract access
 export {
@@ -459,7 +428,7 @@ export {
   getContractAddress,
   getContractAbi,
   getContractConfig
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 
 // Utilities
 export {
@@ -467,7 +436,7 @@ export {
   usdToUsdc,
   generateNonce,
   getChainId
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 
 // Error classes
 export {
@@ -475,7 +444,7 @@ export {
   PaymentAmountExceededError,
   UnsupportedSchemeError,
   Invalid402ResponseError
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 
 // Types
 export type {
@@ -483,7 +452,7 @@ export type {
   PaymentRequirement,
   SignedPayment,
   WalletCreationResult
-} from '@iatp/d402-client'
+} from '@dcentralab/d402-client'
 ```
 
 ## 🧪 Testing
@@ -569,9 +538,9 @@ pnpm typecheck
 ## 📝 Related Packages
 
 Part of the IATP-JS monorepo:
-- `@iatp/d402-client` - D402 payment protocol (this package)
-- `@iatp/mcp-client` - MCP integration (planned)
-- `@iatp/a2a-client` - A2A protocol (planned)
+- `@dcentralab/d402-client` - D402 payment protocol (this package)
+- `@dcentralab/mcp-client` - MCP integration (planned)
+- `@dcentralab/a2a-client` - A2A protocol (planned)
 
 ## 🔗 Related Projects
 
@@ -585,10 +554,10 @@ MIT
 
 ## 💬 Support
 
-- GitHub Issues: [iatp-js/issues](https://github.com/Traia-IO/iatp-js/issues)
-- Email: support@traia.io
+- GitHub Issues: [iatp-js/issues](https://github.com/DcentraLab/iatp-js/issues)
+- Email: dev.support@d402.net
 
 ---
 
-**Made with ❤️ by the Traia Team**
+**Made with ❤️ by the DcentraLab Team**
 

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.
      *
@@ -238,14 +238,14 @@ interface D402ClientConfig {
  *
  * @example
  * ```ts
- * import { D402Client } from '@iatp/d402-client'
+ * import { D402Client } from '@dcentralab/d402-client'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
  * const operatorAccount = privateKeyToAccount('0x...')
  *
  * 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>;
@@ -835,7 +835,7 @@ interface WalletCreationResult {
  *
  * @example
  * ```ts
- * import { createIATPWallet } from '@iatp/d402-client'
+ * import { createIATPWallet } from '@dcentralab/d402-client'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
  * const ownerAccount = privateKeyToAccount('0x...')

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.
      *
@@ -238,14 +238,14 @@ interface D402ClientConfig {
  *
  * @example
  * ```ts
- * import { D402Client } from '@iatp/d402-client'
+ * import { D402Client } from '@dcentralab/d402-client'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
  * const operatorAccount = privateKeyToAccount('0x...')
  *
  * 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>;
@@ -835,7 +835,7 @@ interface WalletCreationResult {
  *
  * @example
  * ```ts
- * import { createIATPWallet } from '@iatp/d402-client'
+ * import { createIATPWallet } from '@dcentralab/d402-client'
  * import { privateKeyToAccount } from 'viem/accounts'
  *
  * const ownerAccount = privateKeyToAccount('0x...')

package/dist/index.js

@@ -327,7 +327,9 @@ function normalizeAddress(address) {
 }
 function decodePaymentResponse(header) {
   try {
-    const decoded = Buffer.from(header, "base64").toString("utf-8");
+    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}`);
@@ -349,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";
@@ -427,11 +429,14 @@ __export(encoder_exports, {
   safeBase64Encode: () => safeBase64Encode
 });
 function safeBase64Encode(data) {
-  const buffer = typeof data === "string" ? Buffer.from(data, "utf-8") : data;
-  return buffer.toString("base64");
+  const bytes = new TextEncoder().encode(data);
+  const binString = Array.from(bytes, (byte) => String.fromCodePoint(byte)).join("");
+  return btoa(binString);
 }
 function safeBase64Decode(data) {
-  return Buffer.from(data, "base64").toString("utf-8");
+  const binString = atob(data);
+  const bytes = Uint8Array.from(binString, (m) => m.codePointAt(0));
+  return new TextDecoder().decode(bytes);
 }
 function encodePayment(payment) {
   const jsonString = JSON.stringify(payment);
@@ -540,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";
@@ -562,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.
@@ -604,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',
@@ -629,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, {