@agentxpay/sdk 0.1.0

package/src/AgentXPayClient.ts

@@ -0,0 +1,135 @@
+import { ethers } from "ethers";
+import { AgentXPayConfig, DiscoverFilter, Service, X402FetchOptions, X402PaymentInfo } from "./types";
+import { ServicesModule } from "./modules/services";
+import { PaymentsModule } from "./modules/payments";
+import { SubscriptionsModule } from "./modules/subscriptions";
+import { EscrowModule } from "./modules/escrow";
+import { WalletModule } from "./modules/wallet";
+import { DEFAULT_CONTRACTS, MONAD_TESTNET_RPC } from "./utils/constants";
+
+export class AgentXPayClient {
+  public services: ServicesModule;
+  public payments: PaymentsModule;
+  public subscriptions: SubscriptionsModule;
+  public escrow: EscrowModule;
+  public wallet: WalletModule;
+
+  private provider: ethers.Provider;
+  private signer: ethers.Signer | null = null;
+
+  constructor(config: AgentXPayConfig) {
+    const rpcUrl = config.rpcUrl || MONAD_TESTNET_RPC;
+    this.provider = new ethers.JsonRpcProvider(rpcUrl);
+
+    if (config.signer) {
+      this.signer = config.signer;
+    } else if (config.privateKey) {
+      this.signer = new ethers.Wallet(config.privateKey, this.provider);
+    }
+
+    const signerOrProvider = this.signer || this.provider;
+    const network = config.network || "testnet";
+    const defaultContracts = DEFAULT_CONTRACTS[network] || {};
+    const contracts = {
+      serviceRegistry: config.contracts?.serviceRegistry || defaultContracts.serviceRegistry || "",
+      paymentManager: config.contracts?.paymentManager || defaultContracts.paymentManager || "",
+      subscriptionManager: config.contracts?.subscriptionManager || defaultContracts.subscriptionManager || "",
+      escrow: config.contracts?.escrow || defaultContracts.escrow || "",
+      agentWalletFactory: config.contracts?.agentWalletFactory || defaultContracts.agentWalletFactory || "",
+    };
+
+    // Validate required contract addresses
+    if (!contracts.serviceRegistry) {
+      throw new Error("ServiceRegistry address is required");
+    }
+
+    this.services = new ServicesModule(
+      contracts.serviceRegistry,
+      signerOrProvider
+    );
+    this.payments = new PaymentsModule(
+      contracts.paymentManager,
+      signerOrProvider
+    );
+    this.subscriptions = new SubscriptionsModule(
+      contracts.subscriptionManager,
+      signerOrProvider
+    );
+    this.escrow = new EscrowModule(
+      contracts.escrow,
+      signerOrProvider
+    );
+    this.wallet = new WalletModule(
+      contracts.agentWalletFactory,
+      signerOrProvider
+    );
+  }
+
+  async discoverServices(filter?: DiscoverFilter): Promise<Service[]> {
+    return this.services.discoverServices(filter);
+  }
+
+  async payAndCall(serviceId: bigint, amount: bigint): Promise<string> {
+    const result = await this.payments.payPerUse(serviceId, amount);
+    return result.txHash;
+  }
+
+  async subscribe(serviceId: bigint, planId: bigint, amount: bigint) {
+    return this.subscriptions.subscribe(serviceId, planId, amount);
+  }
+
+  /**
+   * x402-aware fetch: automatically handles HTTP 402 Payment Required responses
+   */
+  async fetch(url: string, options?: X402FetchOptions): Promise<Response> {
+    const autoPayment = options?.autoPayment ?? true;
+    const maxRetries = options?.maxRetries ?? 1;
+
+    let response = await globalThis.fetch(url, options);
+
+    if (response.status === 402 && autoPayment) {
+      for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const paymentInfo = this._parsePaymentHeaders(response);
+        if (!paymentInfo) throw new Error("Invalid 402 response: missing payment headers");
+
+        const result = await this.payments.payPerUse(
+          BigInt(paymentInfo.serviceId),
+          BigInt(paymentInfo.amount)
+        );
+
+        const retryHeaders = new Headers(options?.headers);
+        retryHeaders.set("X-Payment-TxHash", result.txHash);
+        retryHeaders.set("X-Payment-ChainId", paymentInfo.chainId);
+
+        response = await globalThis.fetch(url, {
+          ...options,
+          headers: retryHeaders,
+        });
+
+        if (response.status !== 402) break;
+      }
+    }
+
+    return response;
+  }
+
+  private _parsePaymentHeaders(response: Response): X402PaymentInfo | null {
+    const address = response.headers.get("X-Payment-Address");
+    const amount = response.headers.get("X-Payment-Amount");
+    const token = response.headers.get("X-Payment-Token") || "native";
+    const serviceId = response.headers.get("X-Payment-ServiceId");
+    const chainId = response.headers.get("X-Payment-ChainId") || "10143";
+
+    if (!address || !amount || !serviceId) return null;
+
+    return { address, amount, token, serviceId, chainId };
+  }
+
+  getProvider(): ethers.Provider {
+    return this.provider;
+  }
+
+  getSigner(): ethers.Signer | null {
+    return this.signer;
+  }
+}

package/src/abi/AgentWallet.json

@@ -0,0 +1,360 @@
+[
+  {
+    "type": "constructor",
+    "inputs": [
+      {
+        "name": "owner_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "dailyLimit",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "receive",
+    "stateMutability": "payable"
+  },
+  {
+    "type": "function",
+    "name": "authorizeAgent",
+    "inputs": [
+      {
+        "name": "agent",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "execute",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "value",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "data",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "getDailySpendingLimit",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getDailySpent",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getOwner",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getRemainingDailyAllowance",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "isAuthorizedAgent",
+    "inputs": [
+      {
+        "name": "agent",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "revokeAgent",
+    "inputs": [
+      {
+        "name": "agent",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "setDailySpendingLimit",
+    "inputs": [
+      {
+        "name": "limit",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "withdrawFunds",
+    "inputs": [
+      {
+        "name": "amount",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "event",
+    "name": "AgentAuthorized",
+    "inputs": [
+      {
+        "name": "agent",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "AgentRevoked",
+    "inputs": [
+      {
+        "name": "agent",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Deposited",
+    "inputs": [
+      {
+        "name": "from",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Executed",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "value",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "data",
+        "type": "bytes",
+        "indexed": false,
+        "internalType": "bytes"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "SpendingLimitSet",
+    "inputs": [
+      {
+        "name": "dailyLimit",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Withdrawn",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "error",
+    "name": "ExceedsDailyLimit",
+    "inputs": [
+      {
+        "name": "requested",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "remaining",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "ExecutionFailed",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "data",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InsufficientFunds",
+    "inputs": [
+      {
+        "name": "required",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "available",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "NotAuthorized",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "NotOwner",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "ReentrancyGuardReentrantCall",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "TransferFailed",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "ZeroAmount",
+    "inputs": []
+  }
+]

package/src/abi/AgentWalletFactory.json

@@ -0,0 +1,84 @@
+[
+  {
+    "type": "function",
+    "name": "createWallet",
+    "inputs": [
+      {
+        "name": "dailyLimit",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "wallet",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "getWalletCount",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getWallets",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address[]",
+        "internalType": "address[]"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "event",
+    "name": "WalletCreated",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "wallet",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "dailyLimit",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  }
+]