agentwallet-sdk 5.0.4 → 5.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 up2itnow0822
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # AgentWallet SDK
 
+> **📦 CANONICAL PACKAGE:** This is the actively maintained source for the `agentwallet-sdk` npm package (v5+). The old `agentwallet-sdk` GitHub repo is deprecated — use this repo.
+
+
 Non-custodial AI agent wallet with ERC-8004 on-chain identity, ERC-6551 token-bound accounts, x402 payments, mutual stake escrow, and programmable spending guardrails.
 
 Agent Wallet gives AI agents autonomous spending power with hard on-chain limits. No more choosing between "agent can drain everything" and "every transaction needs manual approval."
@@ -231,6 +234,22 @@ Testnet: Base Sepolia, Arbitrum Sepolia, and corresponding testnets.
 - [GitHub](https://github.com/agentnexus/agent-wallet-sdk)
 - [npm](https://www.npmjs.com/package/agentwallet-sdk)
 
+
+## Why agent-wallet-sdk vs. Polygon Agent CLI
+
+| Feature | agent-wallet-sdk | Polygon Agent CLI |
+|---|---|---|
+| Wallet model | Non-custodial, agent holds keys | CLI-based, operator-managed |
+| x402 support | Native, automatic negotiation | Not supported |
+| Spend limits | Programmable (daily, per-tx, per-agent) | Manual configuration |
+| Multi-chain | Ethereum, Base, Etherlink, Polygon, 10+ chains | Polygon-only |
+| Integration | npm package, works in any JS/TS runtime | CLI tool, requires shell access |
+| Agent frameworks | Any (LangChain, CrewAI, Cursor, NemoClaw) | Polygon ecosystem only |
+| Audit trail | Built-in transaction logging | External tooling required |
+| Use case | Autonomous agent payments at scale | Polygon-specific agent ops |
+
+agent-wallet-sdk is chain-agnostic, framework-agnostic, and built for autonomous agents that need to pay for things without human approval. Polygon Agent CLI is a solid tool if you are all-in on Polygon infrastructure - but if your agents need to operate across chains or use x402 payment headers, agent-wallet-sdk is the better fit.
+
 ## License
 
 MIT

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

@@ -0,0 +1,136 @@
+/**
+ * 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
+ *
+ * Requires optional peer dependency: npm install @stellar/stellar-sdk
+ */
+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.
+ *
+ * Requires optional peer dependency: npm install @stellar/stellar-sdk
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new StellarX402Adapter({ network: 'pubnet' });
+ * const xdr = await adapter.buildPaymentTransaction({
+ *   destination: 'GDES...',
+ *   amount: '0.50',
+ *   sourcePublicKey: keypair.publicKey(),
+ *   resource: '/api/data-endpoint',
+ * });
+ * // sign xdr with your keypair, then:
+ * const result = await adapter.submitTransaction(signedXdr);
+ * ```
+ */
+export declare class StellarX402Adapter {
+    private network;
+    private horizonUrl;
+    constructor(config?: StellarPaymentConfig);
+    /**
+     * Parse an x402 402 response and extract Stellar payment details.
+     */
+    parseX402Response(headers: Record<string, string>): {
+        supported: boolean;
+        destination?: string;
+        amount?: string;
+        resource?: string;
+    };
+    /**
+     * Build a Stellar USDC payment transaction XDR.
+     *
+     * Requires @stellar/stellar-sdk installed as a peer dependency.
+     * The returned XDR string must be signed before submission.
+     */
+    buildPaymentTransaction(request: StellarPaymentRequest): Promise<string>;
+    /**
+     * Submit a signed Stellar transaction XDR 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.
+ * Requires @stellar/stellar-sdk installed as peer dependency.
+ */
+export declare function stellarX402Pay(params: {
+    responseHeaders: Record<string, string>;
+    sourcePublicKey: string;
+    sign: (xdr: string) => Promise<string>;
+    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;;;;;;;;;;;;;;;;;;GAkBG;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;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAK7C;;OAEG;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;;;;;OAKG;IACG,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgD9E;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAyB3D,YAAY;IAc1B,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC"}

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

@@ -0,0 +1,190 @@
+/**
+ * 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
+ *
+ * Requires optional peer dependency: npm install @stellar/stellar-sdk
+ */
+// ─── 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.
+ *
+ * Requires optional peer dependency: npm install @stellar/stellar-sdk
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new StellarX402Adapter({ network: 'pubnet' });
+ * const xdr = await adapter.buildPaymentTransaction({
+ *   destination: 'GDES...',
+ *   amount: '0.50',
+ *   sourcePublicKey: keypair.publicKey(),
+ *   resource: '/api/data-endpoint',
+ * });
+ * // sign xdr with your keypair, then:
+ * const result = await adapter.submitTransaction(signedXdr);
+ * ```
+ */
+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.
+     */
+    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 XDR.
+     *
+     * Requires @stellar/stellar-sdk installed as a peer dependency.
+     * The returned XDR string must be signed before submission.
+     */
+    async buildPaymentTransaction(request) {
+        // Dynamic import to avoid hard dependency on @stellar/stellar-sdk
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let StellarSdk;
+        try {
+            StellarSdk = await import(
+            /* webpackIgnore: true */
+            '@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];
+        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)
+            : '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)
+            .build();
+        return transaction.toXDR();
+    }
+    /**
+     * Submit a signed Stellar transaction XDR 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.`);
+        }
+        return await resp.json();
+    }
+    /** 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.
+ * Requires @stellar/stellar-sdk installed as peer dependency.
+ */
+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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentwallet-sdk",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "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",

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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"}