@agentxpay/sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,217 @@
+import { ethers } from 'ethers';
+
+interface AgentXPayConfig {
+    rpcUrl: string;
+    privateKey?: string;
+    signer?: any;
+    contracts?: ContractAddresses;
+    network?: "local" | "testnet" | "mainnet";
+}
+interface ContractAddresses {
+    serviceRegistry?: string;
+    paymentManager?: string;
+    subscriptionManager?: string;
+    escrow?: string;
+    agentWalletFactory?: string;
+}
+interface Service {
+    id: bigint;
+    provider: string;
+    name: string;
+    description: string;
+    endpoint: string;
+    category: string;
+    pricePerCall: bigint;
+    isActive: boolean;
+    createdAt: bigint;
+}
+interface SubscriptionPlan {
+    planId: bigint;
+    serviceId: bigint;
+    price: bigint;
+    duration: bigint;
+    name: string;
+}
+interface Subscription {
+    subscriptionId: bigint;
+    serviceId: bigint;
+    planId: bigint;
+    subscriber: string;
+    startTime: bigint;
+    endTime: bigint;
+    autoRenew: boolean;
+    isActive: boolean;
+}
+declare enum EscrowStatus {
+    Created = 0,
+    Funded = 1,
+    Released = 2,
+    Disputed = 3,
+    Refunded = 4,
+    Resolved = 5
+}
+interface EscrowData {
+    escrowId: bigint;
+    serviceId: bigint;
+    payer: string;
+    provider: string;
+    amount: bigint;
+    status: EscrowStatus;
+    createdAt: bigint;
+    deadline: bigint;
+    description: string;
+}
+interface DiscoverFilter {
+    category?: string;
+    maxPrice?: bigint;
+    isActive?: boolean;
+}
+interface PaymentResult {
+    txHash: string;
+    serviceId: bigint;
+    amount: bigint;
+    provider: string;
+}
+interface X402PaymentInfo {
+    address: string;
+    amount: string;
+    token: string;
+    serviceId: string;
+    chainId: string;
+}
+interface X402FetchOptions extends RequestInit {
+    autoPayment?: boolean;
+    maxRetries?: number;
+}
+
+declare class ServicesModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    registerService(name: string, description: string, endpoint: string, category: string, pricePerCall: bigint): Promise<{
+        txHash: string;
+        serviceId: bigint;
+    }>;
+    addSubscriptionPlan(serviceId: bigint, name: string, price: bigint, duration: bigint): Promise<{
+        txHash: string;
+        planId: bigint;
+    }>;
+    getServiceDetails(serviceId: bigint): Promise<Service>;
+    discoverServices(filter?: DiscoverFilter): Promise<Service[]>;
+    getSubscriptionPlans(serviceId: bigint): Promise<SubscriptionPlan[]>;
+    getServiceCount(): Promise<bigint>;
+    private _mapService;
+}
+
+declare class PaymentsModule {
+    private contract;
+    private address;
+    private signerOrProvider;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    payPerUse(serviceId: bigint, amount: bigint): Promise<PaymentResult>;
+    batchPay(serviceIds: bigint[], totalAmount: bigint): Promise<string>;
+    deposit(amount: bigint): Promise<string>;
+    withdraw(amount: bigint): Promise<string>;
+    payFromBalance(serviceId: bigint): Promise<string>;
+    withdrawProviderEarnings(): Promise<string>;
+    getUserBalance(address: string): Promise<bigint>;
+    getProviderEarnings(address: string): Promise<bigint>;
+    getPaymentCount(address: string): Promise<bigint>;
+    getTotalSpent(address: string): Promise<bigint>;
+    getContractAddress(): string;
+}
+
+declare class SubscriptionsModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    subscribe(serviceId: bigint, planId: bigint, amount: bigint): Promise<{
+        txHash: string;
+        subscriptionId: bigint;
+    }>;
+    cancelSubscription(subscriptionId: bigint): Promise<string>;
+    renewSubscription(subscriptionId: bigint, amount: bigint): Promise<string>;
+    toggleAutoRenew(subscriptionId: bigint): Promise<string>;
+    getSubscription(subscriptionId: bigint): Promise<Subscription>;
+    getUserSubscriptions(address: string): Promise<bigint[]>;
+    isActive(subscriptionId: bigint): Promise<boolean>;
+    checkAccess(userAddress: string, serviceId: bigint): Promise<boolean>;
+}
+
+declare class EscrowModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    createEscrow(serviceId: bigint, provider: string, deadline: bigint, description: string, amount: bigint): Promise<{
+        txHash: string;
+        escrowId: bigint;
+    }>;
+    releaseEscrow(escrowId: bigint): Promise<string>;
+    disputeEscrow(escrowId: bigint): Promise<string>;
+    refundEscrow(escrowId: bigint): Promise<string>;
+    getEscrow(escrowId: bigint): Promise<EscrowData>;
+    getUserEscrows(address: string): Promise<bigint[]>;
+}
+
+declare class WalletModule {
+    private factoryContract;
+    private signerOrProvider;
+    constructor(factoryAddress: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    createWallet(dailyLimit: bigint): Promise<{
+        txHash: string;
+        walletAddress: string;
+    }>;
+    getWallets(owner: string): Promise<string[]>;
+    getWalletInstance(walletAddress: string): AgentWalletClient;
+}
+declare class AgentWalletClient {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    execute(to: string, value: bigint, data?: string): Promise<string>;
+    setDailySpendingLimit(limit: bigint): Promise<string>;
+    authorizeAgent(agent: string): Promise<string>;
+    revokeAgent(agent: string): Promise<string>;
+    withdrawFunds(amount: bigint): Promise<string>;
+    deposit(amount: bigint): Promise<string>;
+    isAuthorizedAgent(agent: string): Promise<boolean>;
+    getDailySpendingLimit(): Promise<bigint>;
+    getDailySpent(): Promise<bigint>;
+    getRemainingDailyAllowance(): Promise<bigint>;
+    getOwner(): Promise<string>;
+}
+
+declare class AgentXPayClient {
+    services: ServicesModule;
+    payments: PaymentsModule;
+    subscriptions: SubscriptionsModule;
+    escrow: EscrowModule;
+    wallet: WalletModule;
+    private provider;
+    private signer;
+    constructor(config: AgentXPayConfig);
+    discoverServices(filter?: DiscoverFilter): Promise<Service[]>;
+    payAndCall(serviceId: bigint, amount: bigint): Promise<string>;
+    subscribe(serviceId: bigint, planId: bigint, amount: bigint): Promise<{
+        txHash: string;
+        subscriptionId: bigint;
+    }>;
+    /**
+     * x402-aware fetch: automatically handles HTTP 402 Payment Required responses
+     */
+    fetch(url: string, options?: X402FetchOptions): Promise<Response>;
+    private _parsePaymentHeaders;
+    getProvider(): ethers.Provider;
+    getSigner(): ethers.Signer | null;
+}
+
+declare const MONAD_TESTNET_CHAIN_ID = 10143;
+declare const MONAD_TESTNET_RPC = "https://testnet-rpc.monad.xyz/";
+declare const DEFAULT_CONTRACTS: Record<string, ContractAddresses>;
+
+declare function shortenAddress(address: string, chars?: number): string;
+declare function formatEther(wei: bigint): string;
+declare function parseEther(ether: string): bigint;
+declare function isValidAddress(address: string): boolean;
+
+export { AgentWalletClient, AgentXPayClient, type AgentXPayConfig, type ContractAddresses, DEFAULT_CONTRACTS, type DiscoverFilter, type EscrowData, EscrowModule, EscrowStatus, MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_RPC, type PaymentResult, PaymentsModule, type Service, ServicesModule, type Subscription, type SubscriptionPlan, SubscriptionsModule, WalletModule, type X402FetchOptions, type X402PaymentInfo, formatEther, isValidAddress, parseEther, shortenAddress };

package/dist/index.d.ts

@@ -0,0 +1,217 @@
+import { ethers } from 'ethers';
+
+interface AgentXPayConfig {
+    rpcUrl: string;
+    privateKey?: string;
+    signer?: any;
+    contracts?: ContractAddresses;
+    network?: "local" | "testnet" | "mainnet";
+}
+interface ContractAddresses {
+    serviceRegistry?: string;
+    paymentManager?: string;
+    subscriptionManager?: string;
+    escrow?: string;
+    agentWalletFactory?: string;
+}
+interface Service {
+    id: bigint;
+    provider: string;
+    name: string;
+    description: string;
+    endpoint: string;
+    category: string;
+    pricePerCall: bigint;
+    isActive: boolean;
+    createdAt: bigint;
+}
+interface SubscriptionPlan {
+    planId: bigint;
+    serviceId: bigint;
+    price: bigint;
+    duration: bigint;
+    name: string;
+}
+interface Subscription {
+    subscriptionId: bigint;
+    serviceId: bigint;
+    planId: bigint;
+    subscriber: string;
+    startTime: bigint;
+    endTime: bigint;
+    autoRenew: boolean;
+    isActive: boolean;
+}
+declare enum EscrowStatus {
+    Created = 0,
+    Funded = 1,
+    Released = 2,
+    Disputed = 3,
+    Refunded = 4,
+    Resolved = 5
+}
+interface EscrowData {
+    escrowId: bigint;
+    serviceId: bigint;
+    payer: string;
+    provider: string;
+    amount: bigint;
+    status: EscrowStatus;
+    createdAt: bigint;
+    deadline: bigint;
+    description: string;
+}
+interface DiscoverFilter {
+    category?: string;
+    maxPrice?: bigint;
+    isActive?: boolean;
+}
+interface PaymentResult {
+    txHash: string;
+    serviceId: bigint;
+    amount: bigint;
+    provider: string;
+}
+interface X402PaymentInfo {
+    address: string;
+    amount: string;
+    token: string;
+    serviceId: string;
+    chainId: string;
+}
+interface X402FetchOptions extends RequestInit {
+    autoPayment?: boolean;
+    maxRetries?: number;
+}
+
+declare class ServicesModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    registerService(name: string, description: string, endpoint: string, category: string, pricePerCall: bigint): Promise<{
+        txHash: string;
+        serviceId: bigint;
+    }>;
+    addSubscriptionPlan(serviceId: bigint, name: string, price: bigint, duration: bigint): Promise<{
+        txHash: string;
+        planId: bigint;
+    }>;
+    getServiceDetails(serviceId: bigint): Promise<Service>;
+    discoverServices(filter?: DiscoverFilter): Promise<Service[]>;
+    getSubscriptionPlans(serviceId: bigint): Promise<SubscriptionPlan[]>;
+    getServiceCount(): Promise<bigint>;
+    private _mapService;
+}
+
+declare class PaymentsModule {
+    private contract;
+    private address;
+    private signerOrProvider;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    payPerUse(serviceId: bigint, amount: bigint): Promise<PaymentResult>;
+    batchPay(serviceIds: bigint[], totalAmount: bigint): Promise<string>;
+    deposit(amount: bigint): Promise<string>;
+    withdraw(amount: bigint): Promise<string>;
+    payFromBalance(serviceId: bigint): Promise<string>;
+    withdrawProviderEarnings(): Promise<string>;
+    getUserBalance(address: string): Promise<bigint>;
+    getProviderEarnings(address: string): Promise<bigint>;
+    getPaymentCount(address: string): Promise<bigint>;
+    getTotalSpent(address: string): Promise<bigint>;
+    getContractAddress(): string;
+}
+
+declare class SubscriptionsModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    subscribe(serviceId: bigint, planId: bigint, amount: bigint): Promise<{
+        txHash: string;
+        subscriptionId: bigint;
+    }>;
+    cancelSubscription(subscriptionId: bigint): Promise<string>;
+    renewSubscription(subscriptionId: bigint, amount: bigint): Promise<string>;
+    toggleAutoRenew(subscriptionId: bigint): Promise<string>;
+    getSubscription(subscriptionId: bigint): Promise<Subscription>;
+    getUserSubscriptions(address: string): Promise<bigint[]>;
+    isActive(subscriptionId: bigint): Promise<boolean>;
+    checkAccess(userAddress: string, serviceId: bigint): Promise<boolean>;
+}
+
+declare class EscrowModule {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    createEscrow(serviceId: bigint, provider: string, deadline: bigint, description: string, amount: bigint): Promise<{
+        txHash: string;
+        escrowId: bigint;
+    }>;
+    releaseEscrow(escrowId: bigint): Promise<string>;
+    disputeEscrow(escrowId: bigint): Promise<string>;
+    refundEscrow(escrowId: bigint): Promise<string>;
+    getEscrow(escrowId: bigint): Promise<EscrowData>;
+    getUserEscrows(address: string): Promise<bigint[]>;
+}
+
+declare class WalletModule {
+    private factoryContract;
+    private signerOrProvider;
+    constructor(factoryAddress: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    private getContract;
+    createWallet(dailyLimit: bigint): Promise<{
+        txHash: string;
+        walletAddress: string;
+    }>;
+    getWallets(owner: string): Promise<string[]>;
+    getWalletInstance(walletAddress: string): AgentWalletClient;
+}
+declare class AgentWalletClient {
+    private contract;
+    constructor(address: string, signerOrProvider: ethers.Signer | ethers.Provider);
+    execute(to: string, value: bigint, data?: string): Promise<string>;
+    setDailySpendingLimit(limit: bigint): Promise<string>;
+    authorizeAgent(agent: string): Promise<string>;
+    revokeAgent(agent: string): Promise<string>;
+    withdrawFunds(amount: bigint): Promise<string>;
+    deposit(amount: bigint): Promise<string>;
+    isAuthorizedAgent(agent: string): Promise<boolean>;
+    getDailySpendingLimit(): Promise<bigint>;
+    getDailySpent(): Promise<bigint>;
+    getRemainingDailyAllowance(): Promise<bigint>;
+    getOwner(): Promise<string>;
+}
+
+declare class AgentXPayClient {
+    services: ServicesModule;
+    payments: PaymentsModule;
+    subscriptions: SubscriptionsModule;
+    escrow: EscrowModule;
+    wallet: WalletModule;
+    private provider;
+    private signer;
+    constructor(config: AgentXPayConfig);
+    discoverServices(filter?: DiscoverFilter): Promise<Service[]>;
+    payAndCall(serviceId: bigint, amount: bigint): Promise<string>;
+    subscribe(serviceId: bigint, planId: bigint, amount: bigint): Promise<{
+        txHash: string;
+        subscriptionId: bigint;
+    }>;
+    /**
+     * x402-aware fetch: automatically handles HTTP 402 Payment Required responses
+     */
+    fetch(url: string, options?: X402FetchOptions): Promise<Response>;
+    private _parsePaymentHeaders;
+    getProvider(): ethers.Provider;
+    getSigner(): ethers.Signer | null;
+}
+
+declare const MONAD_TESTNET_CHAIN_ID = 10143;
+declare const MONAD_TESTNET_RPC = "https://testnet-rpc.monad.xyz/";
+declare const DEFAULT_CONTRACTS: Record<string, ContractAddresses>;
+
+declare function shortenAddress(address: string, chars?: number): string;
+declare function formatEther(wei: bigint): string;
+declare function parseEther(ether: string): bigint;
+declare function isValidAddress(address: string): boolean;
+
+export { AgentWalletClient, AgentXPayClient, type AgentXPayConfig, type ContractAddresses, DEFAULT_CONTRACTS, type DiscoverFilter, type EscrowData, EscrowModule, EscrowStatus, MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_RPC, type PaymentResult, PaymentsModule, type Service, ServicesModule, type Subscription, type SubscriptionPlan, SubscriptionsModule, WalletModule, type X402FetchOptions, type X402PaymentInfo, formatEther, isValidAddress, parseEther, shortenAddress };