agentwallet-sdk 5.1.1 → 5.2.0

package/dist/swap/types.js

@@ -1,3 +1,4 @@
+// ─── Token Addresses ───
 /** Well-known Base Mainnet token addresses */
 export const BASE_TOKENS = {
     USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
@@ -5,7 +6,61 @@ export const BASE_TOKENS = {
     cbETH: '0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22',
     WNATIVE: '0x4200000000000000000000000000000000000006',
 };
-/** Uniswap V3 contract addresses on Base Mainnet (chain 8453) */
+/** Well-known Arbitrum token addresses */
+export const ARBITRUM_TOKENS = {
+    USDC: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    WETH: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+    WNATIVE: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+};
+/** Well-known Optimism token addresses */
+export const OPTIMISM_TOKENS = {
+    USDC: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    WETH: '0x4200000000000000000000000000000000000006',
+    OP: '0x4200000000000000000000000000000000000042',
+    WNATIVE: '0x4200000000000000000000000000000000000006',
+};
+/** Well-known Polygon token addresses */
+export const POLYGON_TOKENS = {
+    USDC: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    WETH: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619',
+    WMATIC: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
+    WNATIVE: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
+};
+// ─── Uniswap V3 Contract Addresses ───
+/**
+ * Uniswap V3 router and quoter addresses.
+ *
+ * Base has a different router (SwapRouter02 deployed at a unique address due to BASE chain launch).
+ * Arbitrum, Optimism, and Polygon use the same universal SwapRouter02 address.
+ *
+ * Sources:
+ *   - Base: https://docs.uniswap.org/contracts/v3/reference/deployments/base-deployments
+ *   - Arbitrum: https://docs.uniswap.org/contracts/v3/reference/deployments/arbitrum-deployments
+ *   - Optimism: https://docs.uniswap.org/contracts/v3/reference/deployments/optimism-deployments
+ *   - Polygon: https://docs.uniswap.org/contracts/v3/reference/deployments/polygon-deployments
+ */
+export const UNISWAP_V3_ADDRESSES = {
+    base: {
+        ROUTER: '0x2626664c2603336E57B271c5C0b26F421741e481',
+        QUOTER_V2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+    },
+    arbitrum: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+    optimism: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+    polygon: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+};
+/**
+ * @deprecated Use UNISWAP_V3_ADDRESSES.base instead.
+ * Kept for backwards compatibility.
+ */
 export const UNISWAP_V3_BASE = {
     ROUTER: '0x2626664c2603336E57B271c5C0b26F421741e481',
     QUOTER_V2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',

package/dist/swap/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAwCA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,4CAAqD;IAC3D,IAAI,EAAE,4CAAqD;IAC3D,KAAK,EAAE,4CAAqD;IAC5D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,4CAAqD;IAC7D,SAAS,EAAE,4CAAqD;CACjE,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AA2DA,0BAA0B;AAE1B,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,KAAK,EAAI,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,EAAE,EAAO,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,MAAM,EAAG,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,wCAAwC;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+D;IAC9F,IAAI,EAAE;QACJ,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,QAAQ,EAAE;QACR,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,QAAQ,EAAE;QACR,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,OAAO,EAAE;QACP,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAK,4CAAqD;IAChE,SAAS,EAAE,4CAAqD;CACjE,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,14 @@
+/**
+ * @module types
+ * Core type definitions for the AgentWallet SDK.
+ *
+ * Contains shared interfaces, constants, and type utilities used across all
+ * SDK modules: spending policies, wallet config, chain identifiers, and
+ * value-add diagnostic types (BudgetForecast, WalletHealth, ActivityEntry).
+ *
+ * Supported chains: Base, Ethereum, Arbitrum, Polygon, Optimism, Avalanche,
+ * Unichain, Linea, Sonic, Worldchain, and Base Sepolia (testnet).
+ */
 import type { Address, Hash, Hex } from 'viem';
 /** Spend policy for a single token */
 export interface SpendPolicy {
@@ -38,7 +49,7 @@ export interface ExecuteResult {
 /** Config for creating an AgentWallet client */
 export interface AgentWalletConfig {
     accountAddress: Address;
-    chain: 'base' | 'base-sepolia' | 'ethereum' | 'arbitrum' | 'polygon';
+    chain: 'base' | 'base-sepolia' | 'ethereum' | 'arbitrum' | 'polygon' | 'optimism' | 'avalanche' | 'unichain' | 'linea' | 'sonic' | 'worldchain';
     rpcUrl?: string;
 }
 /** Event emitted when a transaction exceeds spend limits */
@@ -106,5 +117,13 @@ export declare const CHAIN_IDS: {
     readonly ethereum: 1;
     readonly arbitrum: 42161;
     readonly polygon: 137;
+    readonly optimism: 10;
+    readonly avalanche: 43114;
+    readonly unichain: 130;
+    readonly linea: 59144;
+    readonly sonic: 146;
+    readonly worldchain: 480;
 };
+/** Supported chain name type */
+export type SupportedChain = keyof typeof CHAIN_IDS;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -5,5 +5,11 @@ export const CHAIN_IDS = {
     'ethereum': 1,
     'arbitrum': 42161,
     'polygon': 137,
+    'optimism': 10,
+    'avalanche': 43114,
+    'unichain': 130,
+    'linea': 59144,
+    'sonic': 146,
+    'worldchain': 480,
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgHA,0BAA0B;AAC1B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,GAAG;CACN,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2HA,0BAA0B;AAC1B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAS,IAAI;IACnB,cAAc,EAAE,KAAK;IACrB,UAAU,EAAK,CAAC;IAChB,UAAU,EAAK,KAAK;IACpB,SAAS,EAAM,GAAG;IAClB,UAAU,EAAK,EAAE;IACjB,WAAW,EAAI,KAAK;IACpB,UAAU,EAAK,GAAG;IAClB,OAAO,EAAQ,KAAK;IACpB,OAAO,EAAQ,GAAG;IAClB,YAAY,EAAG,GAAG;CACV,CAAC"}

package/dist/x402/__tests__/client.test.js

@@ -1,6 +1,7 @@
 // [MAX-ADDED] Tests for x402 Client — protocol parsing and payment selection
 import { describe, it, expect } from 'vitest';
 import { X402Client } from '../client.js';
+import { USDC_ADDRESSES } from '../types.js';
 // Mock wallet (we test protocol logic, not on-chain execution)
 const mockWallet = {};
 describe('X402Client', () => {
@@ -67,8 +68,8 @@ describe('X402Client', () => {
         });
     });
     describe('selectPaymentOption', () => {
-        it('selects Base USDC exact scheme', () => {
-            const client = new X402Client(mockWallet);
+        it('selects Base USDC exact scheme when base is in supported networks', () => {
+            const client = new X402Client(mockWallet, { supportedNetworks: ['base:8453'] });
             const accepts = [
                 { scheme: 'exact', network: 'ethereum:1', asset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
                 { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
@@ -77,8 +78,47 @@ describe('X402Client', () => {
             expect(selected).not.toBeNull();
             expect(selected.network).toBe('base:8453');
         });
+        it('selects Arbitrum USDC when configured for arbitrum', () => {
+            const client = new X402Client(mockWallet, { supportedNetworks: ['arbitrum:42161'] });
+            const accepts = [
+                { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+                { scheme: 'exact', network: 'arbitrum:42161', asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected).not.toBeNull();
+            expect(selected.network).toBe('arbitrum:42161');
+        });
+        it('selects Optimism USDC when configured for optimism', () => {
+            const client = new X402Client(mockWallet, { supportedNetworks: ['optimism:10'] });
+            const accepts = [
+                { scheme: 'exact', network: 'optimism:10', asset: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', amount: '2000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected).not.toBeNull();
+            expect(selected.network).toBe('optimism:10');
+        });
+        it('selects Polygon USDC when configured for polygon', () => {
+            const client = new X402Client(mockWallet, { supportedNetworks: ['polygon:137'] });
+            const accepts = [
+                { scheme: 'exact', network: 'polygon:137', asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', amount: '500000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected).not.toBeNull();
+            expect(selected.network).toBe('polygon:137');
+        });
+        it('selects any supported network when multi-chain configured', () => {
+            const client = new X402Client(mockWallet, {
+                supportedNetworks: ['base:8453', 'ethereum:1', 'arbitrum:42161'],
+            });
+            const accepts = [
+                { scheme: 'exact', network: 'arbitrum:42161', asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected).not.toBeNull();
+            expect(selected.network).toBe('arbitrum:42161');
+        });
         it('prefers lowest amount among compatible options', () => {
-            const client = new X402Client(mockWallet);
+            const client = new X402Client(mockWallet, { supportedNetworks: ['base:8453'] });
             const accepts = [
                 { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '5000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
                 { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
@@ -87,14 +127,22 @@ describe('X402Client', () => {
             expect(selected.amount).toBe('1000000');
         });
         it('returns null when no compatible option exists', () => {
-            const client = new X402Client(mockWallet);
+            const client = new X402Client(mockWallet, { supportedNetworks: ['base:8453'] });
             const accepts = [
                 { scheme: 'exact', network: 'solana:mainnet', asset: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', amount: '1000000', payTo: 'sol_addr', maxTimeoutSeconds: 30, extra: {} },
             ];
             expect(client.selectPaymentOption(accepts)).toBeNull();
         });
+        it('returns null when network matches but asset is not supported USDC', () => {
+            const client = new X402Client(mockWallet, { supportedNetworks: ['base:8453'] });
+            const accepts = [
+                { scheme: 'exact', network: 'base:8453', asset: '0xDeAdBeEfDeAdBeEfDeAdBeEfDeAdBeEfDeAdBeEf', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            // Asset is not the known USDC address — should be rejected
+            expect(client.selectPaymentOption(accepts)).toBeNull();
+        });
         it('prefers exact scheme over others', () => {
-            const client = new X402Client(mockWallet);
+            const client = new X402Client(mockWallet, { supportedNetworks: ['base:8453'] });
             const accepts = [
                 { scheme: 'upto', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '500000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
                 { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
@@ -104,4 +152,28 @@ describe('X402Client', () => {
         });
     });
 });
+// ─── USDC_ADDRESSES coverage tests ───
+describe('USDC_ADDRESSES multi-chain coverage', () => {
+    it('covers all 10 mainnet chains', () => {
+        const mainnetChains = [
+            'base:8453',
+            'ethereum:1',
+            'arbitrum:42161',
+            'polygon:137',
+            'optimism:10',
+            'avalanche:43114',
+            'unichain:130',
+            'linea:59144',
+            'sonic:146',
+            'worldchain:480',
+        ];
+        for (const chain of mainnetChains) {
+            expect(USDC_ADDRESSES[chain]).toBeDefined();
+            expect(USDC_ADDRESSES[chain]).toMatch(/^0x[0-9a-fA-F]{40}$/);
+        }
+    });
+    it('includes base-sepolia testnet', () => {
+        expect(USDC_ADDRESSES['base-sepolia:84532']).toBe('0x036CbD53842c5426634e7929541eC2318f3dCF7e');
+    });
+});
 //# sourceMappingURL=client.test.js.map

package/dist/x402/__tests__/client.test.js.map

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

package/dist/x402/chains/stellar/index.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Stellar x402 Payment Adapter
+ *
+ * Implements x402 payment protocol on Stellar network.
+ * Stellar x402 support went live March 11, 2026.
+ *
+ * Chain identifiers:
+ *   - Stellar Mainnet: "stellar:pubnet"
+ *   - Stellar Testnet: "stellar:testnet"
+ *
+ * Key differences from EVM chains:
+ * - Uses Ed25519 keypairs (not secp256k1)
+ * - Transaction format: Stellar XDR (not EVM tx)
+ * - Settlement: ~5 seconds (1 ledger close)
+ * - Fees: ~0.00001 XLM per operation (effectively free at scale)
+ * - USDC: Circle-issued USDC on Stellar
+ */
+export declare const STELLAR_NETWORK: {
+    readonly pubnet: {
+        readonly horizonUrl: "https://horizon.stellar.org";
+        readonly networkPassphrase: "Public Global Stellar Network ; September 2015";
+        readonly chainId: "stellar:pubnet";
+    };
+    readonly testnet: {
+        readonly horizonUrl: "https://horizon-testnet.stellar.org";
+        readonly networkPassphrase: "Test SDF Network ; September 2015";
+        readonly chainId: "stellar:testnet";
+    };
+};
+/**
+ * Circle USDC on Stellar (Mainnet)
+ * Asset code: USDC
+ * Issuer: GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
+ */
+export declare const STELLAR_USDC: {
+    readonly pubnet: {
+        readonly code: "USDC";
+        readonly issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN";
+    };
+    readonly testnet: {
+        readonly code: "USDC";
+        readonly issuer: "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5";
+    };
+};
+export type StellarNetwork = 'pubnet' | 'testnet';
+export interface StellarPaymentConfig {
+    /** Which Stellar network to use */
+    network?: StellarNetwork;
+    /** x402 resource identifier (for memo) */
+    resource?: string;
+    /** Custom Horizon URL (overrides default) */
+    horizonUrl?: string;
+}
+export interface StellarPaymentRequest {
+    /** Destination Stellar account (G... address) */
+    destination: string;
+    /** Amount in USDC (decimal string, e.g. "0.50") */
+    amount: string;
+    /** Source Stellar account public key */
+    sourcePublicKey: string;
+    /** x402 resource path for memo */
+    resource?: string;
+    /** Network to use */
+    network?: StellarNetwork;
+}
+export interface StellarPaymentResult {
+    /** Stellar transaction hash */
+    hash: string;
+    /** Ledger number the transaction landed in */
+    ledger: number;
+    /** Successful */
+    successful: boolean;
+    /** Network used */
+    network: StellarNetwork;
+}
+/**
+ * StellarX402Adapter
+ *
+ * Handles x402 payment flow for Stellar network.
+ *
+ * Usage (with stellar-sdk):
+ * ```typescript
+ * import { StellarX402Adapter } from 'agentwallet-sdk/x402/stellar';
+ * import { Keypair, Networks } from '@stellar/stellar-sdk';
+ *
+ * const adapter = new StellarX402Adapter({ network: 'pubnet' });
+ * const result = await adapter.pay({
+ *   destination: 'GDESTWVX3VMLQCXPHPVLS3FMNMG2X7L5IGGQT7BQMIZXZZ4V7KBQVS',
+ *   amount: '0.50',
+ *   sourcePublicKey: keypair.publicKey(),
+ *   resource: '/api/data-endpoint',
+ * }, keypair.secret());
+ * ```
+ *
+ * Note: stellar-sdk must be installed separately:
+ * npm install @stellar/stellar-sdk
+ */
+export declare class StellarX402Adapter {
+    private network;
+    private horizonUrl;
+    constructor(config?: StellarPaymentConfig);
+    /**
+     * Parse an x402 402 response and extract Stellar payment details.
+     * The 402 response should include X-Payment-Chains: stellar:pubnet
+     * and X-Payment-Amount, X-Payment-Destination headers.
+     */
+    parseX402Response(headers: Record<string, string>): {
+        supported: boolean;
+        destination?: string;
+        amount?: string;
+        resource?: string;
+    };
+    /**
+     * Build a Stellar USDC payment transaction.
+     *
+     * Requires @stellar/stellar-sdk to be installed:
+     * npm install @stellar/stellar-sdk
+     *
+     * Returns the XDR-encoded transaction envelope for signing and submission.
+     */
+    buildPaymentTransaction(request: StellarPaymentRequest): Promise<string>;
+    /**
+     * Submit a signed Stellar transaction to Horizon.
+     */
+    submitTransaction(signedXdr: string): Promise<StellarPaymentResult>;
+    private _loadAccount;
+    /** Chain ID for this adapter (e.g. "stellar:pubnet") */
+    get chainId(): string;
+}
+/**
+ * Full x402 payment flow for Stellar.
+ * 1. Detects 402 response from API
+ * 2. Parses Stellar payment details from headers
+ * 3. Builds, signs, and submits Stellar USDC payment
+ * 4. Retries the original request with payment proof
+ *
+ * Requires stellar-sdk: npm install @stellar/stellar-sdk
+ */
+export declare function stellarX402Pay(params: {
+    /** The 402 response headers */
+    responseHeaders: Record<string, string>;
+    /** Source account public key */
+    sourcePublicKey: string;
+    /** Signer function that takes XDR and returns signed XDR */
+    sign: (xdr: string) => Promise<string>;
+    /** Network to use */
+    network?: StellarNetwork;
+}): Promise<StellarPaymentResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/x402/chains/stellar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/x402/chains/stellar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,eAAe;;;;;;;;;;;CAWlB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAIX,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAK7C;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAClD,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAgBD;;;;;;;OAOG;IACG,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6C9E;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YA6B3D,YAAY;IAe1B,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAID;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,qBAAqB;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC"}

package/dist/x402/chains/stellar/index.js

@@ -0,0 +1,197 @@
+/**
+ * Stellar x402 Payment Adapter
+ *
+ * Implements x402 payment protocol on Stellar network.
+ * Stellar x402 support went live March 11, 2026.
+ *
+ * Chain identifiers:
+ *   - Stellar Mainnet: "stellar:pubnet"
+ *   - Stellar Testnet: "stellar:testnet"
+ *
+ * Key differences from EVM chains:
+ * - Uses Ed25519 keypairs (not secp256k1)
+ * - Transaction format: Stellar XDR (not EVM tx)
+ * - Settlement: ~5 seconds (1 ledger close)
+ * - Fees: ~0.00001 XLM per operation (effectively free at scale)
+ * - USDC: Circle-issued USDC on Stellar
+ */
+// ─── Stellar Chain Constants ─────────────────────────────────────────────────
+export const STELLAR_NETWORK = {
+    pubnet: {
+        horizonUrl: 'https://horizon.stellar.org',
+        networkPassphrase: 'Public Global Stellar Network ; September 2015',
+        chainId: 'stellar:pubnet',
+    },
+    testnet: {
+        horizonUrl: 'https://horizon-testnet.stellar.org',
+        networkPassphrase: 'Test SDF Network ; September 2015',
+        chainId: 'stellar:testnet',
+    },
+};
+/**
+ * Circle USDC on Stellar (Mainnet)
+ * Asset code: USDC
+ * Issuer: GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
+ */
+export const STELLAR_USDC = {
+    pubnet: {
+        code: 'USDC',
+        issuer: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
+    },
+    testnet: {
+        code: 'USDC',
+        issuer: 'GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
+    },
+};
+// ─── Stellar x402 Payment Adapter ────────────────────────────────────────────
+/**
+ * StellarX402Adapter
+ *
+ * Handles x402 payment flow for Stellar network.
+ *
+ * Usage (with stellar-sdk):
+ * ```typescript
+ * import { StellarX402Adapter } from 'agentwallet-sdk/x402/stellar';
+ * import { Keypair, Networks } from '@stellar/stellar-sdk';
+ *
+ * const adapter = new StellarX402Adapter({ network: 'pubnet' });
+ * const result = await adapter.pay({
+ *   destination: 'GDESTWVX3VMLQCXPHPVLS3FMNMG2X7L5IGGQT7BQMIZXZZ4V7KBQVS',
+ *   amount: '0.50',
+ *   sourcePublicKey: keypair.publicKey(),
+ *   resource: '/api/data-endpoint',
+ * }, keypair.secret());
+ * ```
+ *
+ * Note: stellar-sdk must be installed separately:
+ * npm install @stellar/stellar-sdk
+ */
+export class StellarX402Adapter {
+    constructor(config = {}) {
+        this.network = config.network ?? 'pubnet';
+        this.horizonUrl = config.horizonUrl ?? STELLAR_NETWORK[this.network].horizonUrl;
+    }
+    /**
+     * Parse an x402 402 response and extract Stellar payment details.
+     * The 402 response should include X-Payment-Chains: stellar:pubnet
+     * and X-Payment-Amount, X-Payment-Destination headers.
+     */
+    parseX402Response(headers) {
+        const chains = headers['x-payment-chains'] ?? headers['X-Payment-Chains'] ?? '';
+        const chainId = STELLAR_NETWORK[this.network].chainId;
+        if (!chains.includes(chainId) && !chains.includes('stellar')) {
+            return { supported: false };
+        }
+        return {
+            supported: true,
+            destination: headers['x-payment-destination'] ?? headers['X-Payment-Destination'],
+            amount: headers['x-payment-amount'] ?? headers['X-Payment-Amount'],
+            resource: headers['x-payment-resource'] ?? headers['X-Payment-Resource'],
+        };
+    }
+    /**
+     * Build a Stellar USDC payment transaction.
+     *
+     * Requires @stellar/stellar-sdk to be installed:
+     * npm install @stellar/stellar-sdk
+     *
+     * Returns the XDR-encoded transaction envelope for signing and submission.
+     */
+    async buildPaymentTransaction(request) {
+        let StellarSdk;
+        try {
+            StellarSdk = await import('@stellar/stellar-sdk');
+        }
+        catch {
+            throw new Error('Stellar support requires @stellar/stellar-sdk: npm install @stellar/stellar-sdk');
+        }
+        const networkConfig = STELLAR_NETWORK[request.network ?? this.network];
+        const usdcAsset = STELLAR_USDC[request.network ?? this.network];
+        // Load source account sequence number from Horizon
+        const account = await this._loadAccount(request.sourcePublicKey, networkConfig.horizonUrl);
+        const stellarAccount = new StellarSdk.Account(request.sourcePublicKey, account.sequence);
+        const asset = new StellarSdk.Asset(usdcAsset.code, usdcAsset.issuer);
+        const memoText = request.resource
+            ? request.resource.slice(0, 28) // Stellar memo max 28 bytes
+            : 'x402-payment';
+        const transaction = new StellarSdk.TransactionBuilder(stellarAccount, {
+            fee: StellarSdk.BASE_FEE,
+            networkPassphrase: networkConfig.networkPassphrase,
+        })
+            .addOperation(StellarSdk.Operation.payment({
+            destination: request.destination,
+            asset,
+            amount: request.amount,
+        }))
+            .addMemo(StellarSdk.Memo.text(memoText))
+            .setTimeout(300) // 5 minute window
+            .build();
+        return transaction.toXDR();
+    }
+    /**
+     * Submit a signed Stellar transaction to Horizon.
+     */
+    async submitTransaction(signedXdr) {
+        const networkConfig = STELLAR_NETWORK[this.network];
+        const body = new URLSearchParams({ tx: signedXdr }).toString();
+        const resp = await fetch(`${networkConfig.horizonUrl}/transactions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body,
+        });
+        if (!resp.ok) {
+            const err = await resp.text();
+            throw new Error(`Stellar transaction failed: ${resp.status} ${err.slice(0, 200)}`);
+        }
+        const result = await resp.json();
+        return {
+            hash: result.hash,
+            ledger: result.ledger,
+            successful: result.successful ?? true,
+            network: this.network,
+        };
+    }
+    async _loadAccount(publicKey, horizonUrl) {
+        const resp = await fetch(`${horizonUrl}/accounts/${publicKey}`);
+        if (!resp.ok) {
+            throw new Error(`Cannot load Stellar account ${publicKey}: ${resp.status}. ` +
+                `Ensure the account exists and has a USDC trustline established.`);
+        }
+        const data = await resp.json();
+        return { sequence: data.sequence };
+    }
+    /** Chain ID for this adapter (e.g. "stellar:pubnet") */
+    get chainId() {
+        return STELLAR_NETWORK[this.network].chainId;
+    }
+}
+// ─── x402 Auto-Pay Helper ────────────────────────────────────────────────────
+/**
+ * Full x402 payment flow for Stellar.
+ * 1. Detects 402 response from API
+ * 2. Parses Stellar payment details from headers
+ * 3. Builds, signs, and submits Stellar USDC payment
+ * 4. Retries the original request with payment proof
+ *
+ * Requires stellar-sdk: npm install @stellar/stellar-sdk
+ */
+export async function stellarX402Pay(params) {
+    const adapter = new StellarX402Adapter({ network: params.network ?? 'pubnet' });
+    const details = adapter.parseX402Response(params.responseHeaders);
+    if (!details.supported) {
+        throw new Error('This endpoint does not support Stellar x402 payments');
+    }
+    if (!details.destination || !details.amount) {
+        throw new Error('x402 response missing destination or amount headers');
+    }
+    const xdr = await adapter.buildPaymentTransaction({
+        destination: details.destination,
+        amount: details.amount,
+        sourcePublicKey: params.sourcePublicKey,
+        resource: details.resource,
+        network: params.network ?? 'pubnet',
+    });
+    const signedXdr = await params.sign(xdr);
+    return adapter.submitTransaction(signedXdr);
+}
+//# sourceMappingURL=index.js.map