aether-agent-sdk 3.1.2 → 3.2.0

package/README.md

@@ -46,6 +46,7 @@ Aether is a production-ready SDK for building autonomous agent-to-agent systems
 ### Agent Framework
 
 - **SettlementAgent**: Executes x402 payments and settlement on-chain
+- **PayGateClient**: Client for purchasing x402-protected content from PayGate
 - **x402 Facilitator**: Payment verification and USDC transfers
 - **Protocol Support**: A2A and AP2 protocol implementations
 

package/dist/src/index.d.ts

@@ -8,6 +8,7 @@
 export * from './agents';
 export * from './facilitator';
 export * from './marketplace';
+export * from './paygate';
 export * from './utils';
 /**
  * SDK Version

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,cAAc,UAAU,CAAA;AAGxB,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,SAAS,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,OAAO,QAAc,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,cAAc,UAAU,CAAA;AAGxB,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,WAAW,CAAA;AAGzB,cAAc,SAAS,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,OAAO,QAAc,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAW,CAAA"}

package/dist/src/index.js

@@ -43,6 +43,8 @@ __exportStar(require("./agents"), exports);
 __exportStar(require("./facilitator"), exports);
 // Marketplace
 __exportStar(require("./marketplace"), exports);
+// PayGate
+__exportStar(require("./paygate"), exports);
 // Utils
 __exportStar(require("./utils"), exports);
 /**

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;AAEH,gDAAuB;AAEvB,SAAS,sBAAsB;IAC7B,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAc,EAAE,OAAO,EAAE,GAAG,CAAC,OAAiB,EAAE,CAAA;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IACzD,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAA;AAEpC,SAAS;AACT,2CAAwB;AAExB,cAAc;AACd,gDAA6B;AAE7B,cAAc;AACd,gDAA6B;AAE7B,QAAQ;AACR,0CAAuB;AAEvB;;GAEG;AACU,QAAA,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;AAElC;;GAEG;AACU,QAAA,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;AAEH,gDAAuB;AAEvB,SAAS,sBAAsB;IAC7B,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAc,EAAE,OAAO,EAAE,GAAG,CAAC,OAAiB,EAAE,CAAA;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IACzD,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAA;AAEpC,SAAS;AACT,2CAAwB;AAExB,cAAc;AACd,gDAA6B;AAE7B,cAAc;AACd,gDAA6B;AAE7B,UAAU;AACV,4CAAyB;AAEzB,QAAQ;AACR,0CAAuB;AAEvB;;GAEG;AACU,QAAA,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;AAElC;;GAEG;AACU,QAAA,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAA"}

package/dist/src/paygate/PayGateClient.d.ts

@@ -0,0 +1,92 @@
+/**
+ * PayGate Client
+ * Client for interacting with PayGate x402 payment protocol
+ */
+import { Keypair } from '@solana/web3.js';
+import { PayGateClientConfig, PaymentCurrency, Product, PaymentRequirements, PricingResponse, VerifyResponse, PurchaseOptions, PurchaseResult, ContentResult, PurchaseHistoryResponse } from './types';
+/**
+ * Error class for PayGate-specific errors
+ */
+export declare class PayGateError extends Error {
+    readonly statusCode: number | undefined;
+    readonly code: string | undefined;
+    constructor(message: string, statusCode?: number, code?: string);
+}
+/**
+ * PayGate client for purchasing and retrieving x402-protected content
+ */
+export declare class PayGateClient {
+    private baseUrl;
+    private wallet;
+    private defaultCurrency;
+    private timeout;
+    private http;
+    private settlementAgent;
+    private logger;
+    constructor(config: PayGateClientConfig);
+    /**
+     * Initialize the client with a wallet for signing payments
+     * @param wallet Optional wallet keypair (loads from env if not provided)
+     */
+    init(wallet?: Keypair): Promise<void>;
+    /**
+     * Fetch product information
+     * @param productId The product ID
+     * @returns Product information
+     */
+    fetchProduct(productId: string): Promise<Product>;
+    /**
+     * Get full payment requirements from x402 402 response
+     * @param productId The product ID
+     * @returns Payment requirements
+     */
+    getPaymentRequirements(productId: string): Promise<PaymentRequirements>;
+    /**
+     * Get pricing options for a product (USDC/ATHR)
+     * @param productId The product ID
+     * @returns Pricing options
+     */
+    getPricing(productId: string): Promise<PricingResponse>;
+    /**
+     * Verify payment details before purchase
+     * @param productId The product ID
+     * @param amount The payment amount
+     * @param currency The payment currency
+     * @returns Verification result
+     */
+    verify(productId: string, amount: string, currency?: PaymentCurrency): Promise<VerifyResponse>;
+    /**
+     * Purchase a product using the x402 flow
+     * @param productId The product ID
+     * @param options Purchase options
+     * @returns Purchase result with transaction hash and delivery URL
+     */
+    purchase(productId: string, options?: PurchaseOptions): Promise<PurchaseResult>;
+    /**
+     * Get content for a purchased product
+     * @param productId The product ID
+     * @returns Content delivery result
+     */
+    getContent(productId: string): Promise<ContentResult>;
+    /**
+     * Get purchase history for the current wallet
+     * @returns Purchase history
+     */
+    getPurchaseHistory(): Promise<PurchaseHistoryResponse>;
+    /**
+     * Check if the current wallet has already purchased a product
+     * @param productId The product ID
+     * @returns True if already purchased
+     */
+    hasPurchased(productId: string): Promise<boolean>;
+    /**
+     * Get the current wallet public key
+     * @returns Wallet public key as base58 string, or undefined if not initialized
+     */
+    getWalletAddress(): string | undefined;
+    /**
+     * Handle and log errors consistently
+     */
+    private handleError;
+}
+//# sourceMappingURL=PayGateClient.d.ts.map

package/dist/src/paygate/PayGateClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayGateClient.d.ts","sourceRoot":"","sources":["../../../src/paygate/PayGateClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAKzC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,OAAO,EACP,mBAAmB,EAEnB,eAAe,EACf,cAAc,EAEd,eAAe,EACf,cAAc,EACd,aAAa,EAEb,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,SAAgB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;gBAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAMhE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,EAAE,mBAAmB;IAiBvC;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3C;;;;OAIG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCvD;;;;OAIG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8B7E;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAc7D;;;;;;OAMG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,eAAsC,GAC/C,OAAO,CAAC,cAAc,CAAC;IA6B1B;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA6EzF;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6B3D;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAmB5D;;;;OAIG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBvD;;;OAGG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACH,OAAO,CAAC,WAAW;CAepB"}

package/dist/src/paygate/PayGateClient.js

@@ -0,0 +1,396 @@
+"use strict";
+/**
+ * PayGate Client
+ * Client for interacting with PayGate x402 payment protocol
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayGateClient = exports.PayGateError = void 0;
+const axios_1 = __importStar(require("axios"));
+const SettlementAgent_1 = require("../agents/SettlementAgent");
+const wallet_1 = require("../utils/wallet");
+const logger_1 = require("../utils/logger");
+/**
+ * Error class for PayGate-specific errors
+ */
+class PayGateError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode, code) {
+        super(message);
+        this.name = 'PayGateError';
+        this.statusCode = statusCode;
+        this.code = code;
+    }
+}
+exports.PayGateError = PayGateError;
+/**
+ * PayGate client for purchasing and retrieving x402-protected content
+ */
+class PayGateClient {
+    baseUrl;
+    wallet;
+    defaultCurrency;
+    timeout;
+    http;
+    settlementAgent;
+    logger = (0, logger_1.createLogger)('PayGateClient');
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.wallet = config.wallet;
+        this.defaultCurrency = config.defaultCurrency || 'USDC';
+        this.timeout = config.timeout || 30000;
+        this.http = axios_1.default.create({
+            baseURL: this.baseUrl,
+            timeout: this.timeout,
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        this.logger.info(`PayGateClient initialized for ${this.baseUrl}`);
+    }
+    /**
+     * Initialize the client with a wallet for signing payments
+     * @param wallet Optional wallet keypair (loads from env if not provided)
+     */
+    async init(wallet) {
+        try {
+            if (wallet) {
+                this.wallet = wallet;
+                this.logger.info(`Initialized with provided wallet: ${wallet.publicKey.toBase58()}`);
+            }
+            else if (!this.wallet) {
+                const { keypair } = (0, wallet_1.loadKeypairFromEnv)();
+                if (keypair) {
+                    this.wallet = keypair;
+                    this.logger.info(`Initialized with wallet from env: ${keypair.publicKey.toBase58()}`);
+                }
+                else {
+                    this.logger.warn('No wallet configured. Purchase functionality will be unavailable.');
+                }
+            }
+            if (this.wallet) {
+                this.settlementAgent = new SettlementAgent_1.SettlementAgent();
+                await this.settlementAgent.init(this.wallet);
+                this.logger.info('SettlementAgent initialized');
+            }
+            this.logger.info('PayGateClient ready');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize PayGateClient', error);
+            throw new PayGateError(`Initialization failed: ${error.message}`);
+        }
+    }
+    /**
+     * Fetch product information
+     * @param productId The product ID
+     * @returns Product information
+     */
+    async fetchProduct(productId) {
+        try {
+            this.logger.info(`Fetching product: ${productId}`);
+            const response = await this.http.get(`/pay/${productId}`, {
+                validateStatus: (status) => status === 200 || status === 402
+            });
+            if (response.status === 402) {
+                const data = response.data;
+                if (data.accepts && data.accepts.length > 0) {
+                    const req = data.accepts[0];
+                    if (req) {
+                        return {
+                            id: req.productId || productId,
+                            title: req.description || productId,
+                            description: req.description || '',
+                            type: 'content_link',
+                            price: req.amount,
+                            currency: req.currency,
+                            network: req.network,
+                            status: 'active'
+                        };
+                    }
+                }
+            }
+            return response.data;
+        }
+        catch (error) {
+            this.handleError('fetchProduct', error);
+            throw error;
+        }
+    }
+    /**
+     * Get full payment requirements from x402 402 response
+     * @param productId The product ID
+     * @returns Payment requirements
+     */
+    async getPaymentRequirements(productId) {
+        try {
+            this.logger.info(`Getting payment requirements for: ${productId}`);
+            const response = await this.http.get(`/pay/${productId}`, {
+                validateStatus: (status) => status === 402
+            });
+            if (response.status !== 402) {
+                throw new PayGateError('Expected 402 Payment Required response', response.status);
+            }
+            const data = response.data;
+            if (!data.accepts || data.accepts.length === 0) {
+                throw new PayGateError('No payment requirements in response');
+            }
+            const requirements = data.accepts[0];
+            if (!requirements) {
+                throw new PayGateError('No payment requirements in response');
+            }
+            this.logger.info(`Payment requirements received for ${productId}`);
+            return requirements;
+        }
+        catch (error) {
+            this.handleError('getPaymentRequirements', error);
+            throw error;
+        }
+    }
+    /**
+     * Get pricing options for a product (USDC/ATHR)
+     * @param productId The product ID
+     * @returns Pricing options
+     */
+    async getPricing(productId) {
+        try {
+            this.logger.info(`Getting pricing for: ${productId}`);
+            const response = await this.http.get(`/x402/pricing/${productId}`);
+            this.logger.info(`Pricing received for ${productId}`);
+            return response.data;
+        }
+        catch (error) {
+            this.handleError('getPricing', error);
+            throw error;
+        }
+    }
+    /**
+     * Verify payment details before purchase
+     * @param productId The product ID
+     * @param amount The payment amount
+     * @param currency The payment currency
+     * @returns Verification result
+     */
+    async verify(productId, amount, currency = this.defaultCurrency) {
+        try {
+            if (!this.wallet) {
+                throw new PayGateError('Wallet not initialized. Call init() first.');
+            }
+            this.logger.info(`Verifying payment: ${amount} ${currency} for ${productId}`);
+            const response = await this.http.post('/x402/verify', {
+                productId,
+                amount,
+                currency,
+                payerWallet: this.wallet.publicKey.toBase58()
+            });
+            const result = response.data;
+            if (result.isValid) {
+                this.logger.info('Payment verification successful');
+            }
+            else {
+                this.logger.warn(`Payment verification failed: ${result.invalidReason}`);
+            }
+            return result;
+        }
+        catch (error) {
+            this.handleError('verify', error);
+            throw error;
+        }
+    }
+    /**
+     * Purchase a product using the x402 flow
+     * @param productId The product ID
+     * @param options Purchase options
+     * @returns Purchase result with transaction hash and delivery URL
+     */
+    async purchase(productId, options = {}) {
+        try {
+            if (!this.wallet) {
+                throw new PayGateError('Wallet not initialized. Call init() first.');
+            }
+            if (!this.settlementAgent) {
+                throw new PayGateError('SettlementAgent not initialized. Call init() first.');
+            }
+            const currency = options.currency || this.defaultCurrency;
+            this.logger.info(`Starting purchase flow for ${productId} with ${currency}`);
+            // Step 1: Get payment requirements
+            this.logger.info('Step 1: Getting payment requirements');
+            const requirements = await this.getPaymentRequirements(productId);
+            // Get pricing for selected currency if different from requirements
+            let amount = requirements.amount;
+            let tokenMint = requirements.tokenMint;
+            if (currency !== requirements.currency) {
+                const pricing = await this.getPricing(productId);
+                const option = pricing.options.find((o) => o.currency === currency);
+                if (option) {
+                    amount = option.amount;
+                    tokenMint = option.tokenMint;
+                }
+            }
+            if (options.amount !== undefined) {
+                amount = (options.amount * 1_000_000).toString();
+            }
+            // Step 2: Verify payment
+            this.logger.info('Step 2: Verifying payment');
+            const verification = await this.verify(productId, amount, currency);
+            if (!verification.isValid) {
+                throw new PayGateError(`Payment verification failed: ${verification.invalidReason}`);
+            }
+            // Step 3: Create signed payment via SettlementAgent
+            this.logger.info('Step 3: Creating signed payment');
+            const paymentToken = currency.toLowerCase();
+            const amountDecimal = Number(amount) / 1_000_000;
+            const paymentHeader = await this.settlementAgent.createSignedPayment(requirements.recipient, amountDecimal, { token: paymentToken });
+            // Step 4: Settle payment
+            this.logger.info('Step 4: Settling payment');
+            const settleResponse = await this.http.post('/x402/settle', {
+                paymentHeader,
+                productId
+            });
+            const settle = settleResponse.data;
+            if (!settle.success) {
+                throw new PayGateError(`Settlement failed: ${settle.error}`);
+            }
+            this.logger.info(`Purchase successful! TX: ${settle.txHash}`);
+            return {
+                transactionHash: settle.txHash,
+                productId,
+                amount,
+                currency,
+                deliveryUrl: settle.deliveryUrl
+            };
+        }
+        catch (error) {
+            this.handleError('purchase', error);
+            throw error;
+        }
+    }
+    /**
+     * Get content for a purchased product
+     * @param productId The product ID
+     * @returns Content delivery result
+     */
+    async getContent(productId) {
+        try {
+            if (!this.wallet) {
+                throw new PayGateError('Wallet not initialized. Call init() first.');
+            }
+            this.logger.info(`Getting content for: ${productId}`);
+            const response = await this.http.get(`/deliver/${productId}`, {
+                headers: {
+                    'X-Wallet-Address': this.wallet.publicKey.toBase58()
+                }
+            });
+            const delivery = response.data;
+            this.logger.info(`Content retrieved for ${productId}`);
+            return {
+                product: delivery.product,
+                downloadUrl: delivery.downloadUrl,
+                accessToken: delivery.accessToken,
+                purchaseDate: delivery.purchaseDate
+            };
+        }
+        catch (error) {
+            this.handleError('getContent', error);
+            throw error;
+        }
+    }
+    /**
+     * Get purchase history for the current wallet
+     * @returns Purchase history
+     */
+    async getPurchaseHistory() {
+        try {
+            if (!this.wallet) {
+                throw new PayGateError('Wallet not initialized. Call init() first.');
+            }
+            const walletAddress = this.wallet.publicKey.toBase58();
+            this.logger.info(`Getting purchase history for: ${walletAddress}`);
+            const response = await this.http.get(`/deliver/wallet/${walletAddress}`);
+            this.logger.info('Purchase history retrieved');
+            return response.data;
+        }
+        catch (error) {
+            this.handleError('getPurchaseHistory', error);
+            throw error;
+        }
+    }
+    /**
+     * Check if the current wallet has already purchased a product
+     * @param productId The product ID
+     * @returns True if already purchased
+     */
+    async hasPurchased(productId) {
+        try {
+            if (!this.wallet) {
+                return false;
+            }
+            this.logger.info(`Checking purchase status for: ${productId}`);
+            const history = await this.getPurchaseHistory();
+            const purchased = history.purchases.some((p) => p.productId === productId && p.status === 'completed');
+            this.logger.info(`Product ${productId} purchased: ${purchased}`);
+            return purchased;
+        }
+        catch (error) {
+            this.logger.warn('Error checking purchase status', error);
+            return false;
+        }
+    }
+    /**
+     * Get the current wallet public key
+     * @returns Wallet public key as base58 string, or undefined if not initialized
+     */
+    getWalletAddress() {
+        return this.wallet?.publicKey.toBase58();
+    }
+    /**
+     * Handle and log errors consistently
+     */
+    handleError(method, error) {
+        if (error instanceof PayGateError) {
+            this.logger.error(`${method} failed: ${error.message}`);
+            return;
+        }
+        if (error instanceof axios_1.AxiosError) {
+            const status = error.response?.status;
+            const message = error.response?.data?.error || error.message;
+            this.logger.error(`${method} failed: HTTP ${status} - ${message}`);
+            throw new PayGateError(message, status);
+        }
+        this.logger.error(`${method} failed: ${error.message}`);
+    }
+}
+exports.PayGateClient = PayGateClient;
+//# sourceMappingURL=PayGateClient.js.map

package/dist/src/paygate/PayGateClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayGateClient.js","sourceRoot":"","sources":["../../../src/paygate/PayGateClient.ts"],"names":[],"mappings":"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"}

package/dist/src/paygate/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PayGate Module
+ * Client for interacting with PayGate x402 payment protocol
+ */
+export { PayGateClient, PayGateError } from './PayGateClient';
+export type { PayGateClientConfig, PaymentCurrency, ProductType, Product, PaymentRequirements, X402Response, PricingOption, PricingResponse, VerifyRequest, VerifyResponse, SettleRequest, SettleResponse, PurchaseOptions, PurchaseResult, ContentResult, DeliveryResponse, PurchaseHistoryEntry, PurchaseHistoryResponse } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/paygate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/paygate/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE7D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,OAAO,EACP,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,SAAS,CAAA"}

package/dist/src/paygate/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * PayGate Module
+ * Client for interacting with PayGate x402 payment protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayGateError = exports.PayGateClient = void 0;
+var PayGateClient_1 = require("./PayGateClient");
+Object.defineProperty(exports, "PayGateClient", { enumerable: true, get: function () { return PayGateClient_1.PayGateClient; } });
+Object.defineProperty(exports, "PayGateError", { enumerable: true, get: function () { return PayGateClient_1.PayGateError; } });
+//# sourceMappingURL=index.js.map

package/dist/src/paygate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/paygate/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAA6D;AAApD,8GAAA,aAAa,OAAA;AAAE,6GAAA,YAAY,OAAA"}

package/dist/src/paygate/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * PayGate Client Types
+ * Type definitions for the PayGate x402 payment client
+ */
+import { Keypair } from '@solana/web3.js';
+/**
+ * Supported payment currencies
+ */
+export type PaymentCurrency = 'USDC' | 'ATHR';
+/**
+ * Product types available on PayGate
+ */
+export type ProductType = 'content_link' | 'api_proxy' | 'feature_unlock' | 'iot_endpoint';
+/**
+ * PayGate client configuration
+ */
+export interface PayGateClientConfig {
+    /** Base URL of the PayGate server */
+    baseUrl: string;
+    /** Optional wallet keypair for signing payments */
+    wallet?: Keypair;
+    /** Default currency for purchases (defaults to USDC) */
+    defaultCurrency?: PaymentCurrency;
+    /** Request timeout in milliseconds (defaults to 30000) */
+    timeout?: number;
+}
+/**
+ * Product information returned from PayGate
+ */
+export interface Product {
+    id: string;
+    title: string;
+    description: string;
+    type: ProductType;
+    price: string;
+    currency: string;
+    network: string;
+    status: string;
+}
+/**
+ * Payment requirements from x402 402 response
+ */
+export interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    recipient: string;
+    amount: string;
+    currency: string;
+    tokenMint: string;
+    productId: string;
+    maxTimeoutSeconds?: number;
+    resource?: string;
+    description?: string;
+}
+/**
+ * Full x402 payment response (402 status)
+ */
+export interface X402Response {
+    status: 402;
+    accepts: PaymentRequirements[];
+    error?: string;
+}
+/**
+ * Pricing option for a product
+ */
+export interface PricingOption {
+    currency: PaymentCurrency;
+    amount: string;
+    tokenMint: string;
+    discount?: number;
+}
+/**
+ * Pricing response from PayGate
+ */
+export interface PricingResponse {
+    productId: string;
+    options: PricingOption[];
+}
+/**
+ * Verification request payload
+ */
+export interface VerifyRequest {
+    productId: string;
+    amount: string;
+    currency: PaymentCurrency;
+    payerWallet: string;
+}
+/**
+ * Verification response from PayGate
+ */
+export interface VerifyResponse {
+    isValid: boolean;
+    invalidReason?: string;
+    requirements?: PaymentRequirements;
+}
+/**
+ * Settlement request payload
+ */
+export interface SettleRequest {
+    paymentHeader: string;
+    productId: string;
+}
+/**
+ * Settlement response from PayGate
+ */
+export interface SettleResponse {
+    success: boolean;
+    txHash?: string;
+    deliveryUrl?: string;
+    error?: string;
+}
+/**
+ * Purchase options
+ */
+export interface PurchaseOptions {
+    /** Currency to use for payment */
+    currency?: PaymentCurrency;
+    /** Custom amount (overrides product price) */
+    amount?: number;
+}
+/**
+ * Result of a successful purchase
+ */
+export interface PurchaseResult {
+    transactionHash: string;
+    productId: string;
+    amount: string;
+    currency: string;
+    deliveryUrl: string;
+}
+/**
+ * Content delivery result
+ */
+export interface ContentResult {
+    product: {
+        id: string;
+        title: string;
+        type: ProductType;
+    };
+    downloadUrl: string | null;
+    accessToken: string | undefined;
+    purchaseDate: string;
+}
+/**
+ * Delivery response from PayGate
+ */
+export interface DeliveryResponse {
+    productId: string;
+    product: {
+        id: string;
+        title: string;
+        type: ProductType;
+    };
+    downloadUrl: string | null;
+    accessToken?: string;
+    purchaseDate: string;
+    expiresAt?: string;
+}
+/**
+ * Purchase history entry
+ */
+export interface PurchaseHistoryEntry {
+    productId: string;
+    title: string;
+    type: ProductType;
+    amount: string;
+    currency: string;
+    transactionHash: string;
+    purchaseDate: string;
+    status: 'completed' | 'pending' | 'failed';
+}
+/**
+ * Purchase history response
+ */
+export interface PurchaseHistoryResponse {
+    wallet: string;
+    purchases: PurchaseHistoryEntry[];
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/paygate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/paygate/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAA;AAE1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wDAAwD;IACxD,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,GAAG,CAAA;IACX,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,eAAe,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,WAAW,CAAA;KAClB,CAAA;IACD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,WAAW,CAAA;KAClB,CAAA;IACD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,oBAAoB,EAAE,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/src/paygate/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * PayGate Client Types
+ * Type definitions for the PayGate x402 payment client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/paygate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/paygate/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-agent-sdk",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "description": "Autonomous Agent Ecosystem SDK for Solana - A2A Protocol, x402 Payment Standard, and Agent-to-Agent Communication",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
@@ -29,6 +29,11 @@
       "import": "./dist/src/marketplace/index.js",
       "require": "./dist/src/marketplace/index.js",
       "types": "./dist/src/marketplace/index.d.ts"
+    },
+    "./paygate": {
+      "import": "./dist/src/paygate/index.js",
+      "require": "./dist/src/paygate/index.js",
+      "types": "./dist/src/paygate/index.d.ts"
     }
   },
   "files": [