agentwallet-sdk 6.0.4 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentwallet-sdk",
-  "version": "6.0.4",
+  "version": "6.1.0",
   "description": "Non-custodial AI agent wallet SDK. ERC-8004 identity & reputation registries, mutual stake escrow, x402 payments, 17-chain CCTP bridging, ERC-6551 TBA, SpendingPolicy guardrails, Uniswap V3 swap. The agent holds the keys.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,8 @@
     "clean": "rm -rf dist",
     "test": "vitest run",
     "deploy": "wrangler deploy",
-    "preview": "wrangler dev"
+    "preview": "wrangler dev",
+    "lint": "eslint src/"
   },
   "keywords": [
     "agent-wallet",
@@ -39,7 +40,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/agentnexus/agent-wallet-sdk"
+    "url": "git+https://github.com/up2itnow0822/agent-wallet-sdk.git"
   },
   "author": "AgentNexus",
   "dependencies": {
@@ -56,8 +57,16 @@
   "devDependencies": {
     "@elizaos/core": "^1.5.4",
     "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "globals": "^16.5.0",
     "typescript": "5.3.3",
     "vitest": "4.0.18",
     "wrangler": "^4.72.0"
+  },
+  "homepage": "https://github.com/up2itnow0822/agent-wallet-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/up2itnow0822/agent-wallet-sdk/issues"
   }
 }

package/dist/plugins/elizaos.d.ts

@@ -1,52 +0,0 @@
-/**
- * @elizaos/plugin-agentwallet
- *
- * ElizaOS plugin for agentwallet-sdk — non-custodial AI agent wallet with
- * x402 payment support, CCTP V2 cross-chain transfers, and on-chain spend limits.
- *
- * Your agent holds its own private key. No custodian. No KYC.
- */
-import type { Plugin } from '@elizaos/core';
-import { createWallet } from '../index.js';
-type AgentWallet = ReturnType<typeof createWallet>;
-export interface AgentWalletPluginConfig {
-    /** Agent private key — stays in your environment, never transmitted */
-    privateKey: `0x${string}`;
-    /** Deployed AgentAccountV2 contract address */
-    accountAddress: `0x${string}`;
-    /** Chain to connect to (default: 'base') */
-    chain?: 'base' | 'base-sepolia' | 'ethereum' | 'arbitrum' | 'polygon' | 'etherlink';
-    /** Optional custom RPC URL */
-    rpcUrl?: string;
-    /** Optional daily x402 spend limit in USDC base units (default: 50 USDC = 50_000_000n) */
-    x402DailyLimit?: bigint;
-}
-/**
- * Get or create the agent wallet singleton.
- */
-export declare function getAgentWallet(config: AgentWalletPluginConfig): AgentWallet;
-/**
- * Create an x402-enabled fetch function for the agent to pay APIs automatically.
- */
-export declare function createAgentFetch(config: AgentWalletPluginConfig): typeof fetch;
-/**
- * ElizaOS Plugin definition for agentwallet-sdk.
- *
- * Usage in your Eliza character config:
- *
- * ```json
- * {
- *   "plugins": ["@elizaos/plugin-agentwallet"],
- *   "settings": {
- *     "AGENT_PRIVATE_KEY": "0x...",
- *     "AGENT_ACCOUNT_ADDRESS": "0x...",
- *     "AGENT_CHAIN": "base",
- *     "X402_DAILY_LIMIT": "50000000"
- *   }
- * }
- * ```
- */
-declare const AgentWalletPlugin: Plugin;
-export default AgentWalletPlugin;
-export { AgentWalletPlugin };
-//# sourceMappingURL=elizaos.d.ts.map

package/dist/plugins/elizaos.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elizaos.d.ts","sourceRoot":"","sources":["../../src/plugins/elizaos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,YAAY,EAGb,MAAM,aAAa,CAAC;AAGrB,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAInD,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,cAAc,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IACpF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW,CAuB3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,gBAK/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,iBAAiB,EAAE,MAiCxB,CAAC;AAEF,eAAe,iBAAiB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/plugins/elizaos.js

@@ -1,89 +0,0 @@
-import { createWallet, createX402Fetch, } from '../index.js';
-import { createWalletClient, http } from 'viem';
-import { privateKeyToAccount } from 'viem/accounts';
-let walletInstance = null;
-/**
- * Get or create the agent wallet singleton.
- */
-export function getAgentWallet(config) {
-    if (!walletInstance) {
-        const account = privateKeyToAccount(config.privateKey);
-        const rpcUrls = {
-            base: 'https://mainnet.base.org',
-            'base-sepolia': 'https://sepolia.base.org',
-            ethereum: 'https://eth.llamarpc.com',
-            arbitrum: 'https://arb1.arbitrum.io/rpc',
-            polygon: 'https://polygon-rpc.com',
-            etherlink: 'https://node.mainnet.etherlink.com',
-        };
-        const chain = config.chain ?? 'base';
-        const walletClient = createWalletClient({
-            account,
-            transport: http(config.rpcUrl ?? rpcUrls[chain] ?? rpcUrls.base),
-        });
-        walletInstance = createWallet({
-            accountAddress: config.accountAddress,
-            chain,
-            walletClient,
-        });
-    }
-    return walletInstance;
-}
-/**
- * Create an x402-enabled fetch function for the agent to pay APIs automatically.
- */
-export function createAgentFetch(config) {
-    const wallet = getAgentWallet(config);
-    return createX402Fetch(wallet, {
-        globalDailyLimit: config.x402DailyLimit ?? 50000000n, // 50 USDC default
-    });
-}
-/**
- * ElizaOS Plugin definition for agentwallet-sdk.
- *
- * Usage in your Eliza character config:
- *
- * ```json
- * {
- *   "plugins": ["@elizaos/plugin-agentwallet"],
- *   "settings": {
- *     "AGENT_PRIVATE_KEY": "0x...",
- *     "AGENT_ACCOUNT_ADDRESS": "0x...",
- *     "AGENT_CHAIN": "base",
- *     "X402_DAILY_LIMIT": "50000000"
- *   }
- * }
- * ```
- */
-const AgentWalletPlugin = {
-    name: '@elizaos/plugin-agentwallet',
-    description: 'Non-custodial agent wallet for ElizaOS — x402 payments, CCTP cross-chain, on-chain spend limits. Agent holds its own keys.',
-    actions: [],
-    providers: [
-        {
-            name: 'agentWallet',
-            description: 'Provides agent wallet and x402 fetch capability to the runtime',
-            async get(runtime) {
-                const privateKey = runtime.getSetting('AGENT_PRIVATE_KEY');
-                const accountAddress = runtime.getSetting('AGENT_ACCOUNT_ADDRESS');
-                const chain = (runtime.getSetting('AGENT_CHAIN') ?? 'base');
-                const dailyLimitStr = runtime.getSetting('X402_DAILY_LIMIT');
-                const x402DailyLimit = dailyLimitStr ? BigInt(dailyLimitStr) : 50000000n;
-                if (!privateKey || !accountAddress) {
-                    return 'AgentWallet not configured: AGENT_PRIVATE_KEY and AGENT_ACCOUNT_ADDRESS required.';
-                }
-                const config = { privateKey, accountAddress, chain, x402DailyLimit };
-                const wallet = getAgentWallet(config);
-                const x402Fetch = createAgentFetch(config);
-                // Expose on runtime for actions to use
-                runtime.agentWallet = wallet;
-                runtime.x402Fetch = x402Fetch;
-                return `AgentWallet ready — non-custodial, keys stay local. Chain: ${chain}. x402 daily limit: ${x402DailyLimit / 1000000n} USDC.`;
-            },
-        },
-    ],
-    evaluators: [],
-};
-export default AgentWalletPlugin;
-export { AgentWalletPlugin };
-//# sourceMappingURL=elizaos.js.map

package/dist/plugins/elizaos.js.map

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

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

@@ -1,149 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,197 +0,0 @@
-/**
- * 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

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

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