agentwallet-sdk 3.4.2 → 3.5.0

package/README.md

@@ -286,6 +286,40 @@ const client = createX402Client(wallet, {
 });
 ```text
 
+### Etherlink x402 - Non-Custodial ERC-20 Payments via Permit2
+
+Etherlink (Tezos L2) launched x402 support in March 2026 with a Permit2 proxy that lets agents pay in ERC-20 tokens without pre-approvals. `agentwallet-sdk` supports this directly:
+
+```typescript
+import { createWallet, createX402Client } from 'agentwallet-sdk';
+import { createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+
+const walletClient = createWalletClient({
+  account: privateKeyToAccount(process.env.AGENT_KEY!),
+  transport: http('https://node.mainnet.etherlink.com'),
+});
+
+const wallet = createWallet({
+  accountAddress: '0xYOUR_AGENT_CONTRACT',
+  chain: 'etherlink',
+  walletClient,
+});
+
+// x402 client on Etherlink -- same API, different chain
+const client = createX402Client(wallet, {
+  preferredChain: 'etherlink',   // near-zero fees on Tezos L2
+  globalDailyLimit: 100_000_000n, // 100 USDC/day
+  globalPerRequestMax: 2_000_000n, // 2 USDC max per request
+});
+
+// Fetch x402-gated resources -- 402 payment handled automatically
+const response = await client.fetch('https://api.example.com/agent-data');
+// The client: parsed the 402, checked budget, signed via Permit2, retried with proof
+```
+
+Unlike custodial x402 implementations (Coinbase, OKX OnchainOS), the key never leaves your environment. The Permit2 proxy handles the ERC-20 approval flow, but authorization is still signed locally.
+
 ### How x402 Works
 
 ```text
@@ -310,15 +344,18 @@ Every major AI company launched an agent wallet in early 2026. Coinbase Agentic
 
 Here's the direct comparison:
 
-| | Coinbase Agentic Wallets | MoonPay Agents | agent-wallet-sdk |
-|---|---|---|---|
-| **Key custody** | Coinbase servers | MoonPay servers | Your environment only |
-| **Spend limits** | Session caps (off-chain API) | None | Per-tx + daily, on-chain contract |
-| **x402 support** | Yes (Base/USDC) | No | Yes (Base/USDC, full spec) |
-| **Cross-chain** | Base only | Limited | 5 chains via CCTP |
-| **Freeze risk** | Yes (KYC, compliance) | Yes | None -- contract on-chain |
-| **Audit trail** | API logs (centralized) | API logs | On-chain events, self-queryable |
-| **Open source** | No | No | Yes (MIT) |
+| | Coinbase AgentKit | MoonPay Agents | Circuit & Chisel ATXP | agent-wallet-sdk |
+|---|---|---|---|---|
+| **Key custody** | Coinbase servers | MoonPay servers | Enterprise custodian | Your environment only |
+| **Spend limits** | Session caps (off-chain API) | None | Nested policy layer | Per-tx + daily, on-chain contract |
+| **x402 support** | Yes (Base/USDC) | No | Partial | Yes (Base, Etherlink, full spec) |
+| **Cross-chain** | Base only | Limited | EVM-only | 5 chains via CCTP V2 |
+| **Freeze risk** | Yes (KYC, compliance) | Yes | Yes (enterprise terms) | None -- contract on-chain |
+| **Audit trail** | API logs (centralized) | API logs | Enterprise dashboard | On-chain events, self-queryable |
+| **Open source** | No | No | No | Yes (MIT) |
+| **KYC required** | Yes | Yes | Yes | No |
+| **Micropayments** | Limited | No | Yes (nested) | Yes (x402 + sub-cent via L2) |
+| **Agent-sovereign** | No | No | No | Yes |
 
 **The three questions that matter:**
 

package/dist/plugins/elizaos.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 { type AgentWallet } from 'agentwallet-sdk';
+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): any;
+/**
+ * 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

@@ -0,0 +1 @@
+{"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,EAIL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAIzB,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,OAK/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

@@ -0,0 +1,89 @@
+import { createWallet, createX402Fetch, } from 'agentwallet-sdk';
+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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentwallet-sdk",
-  "version": "3.4.2",
-  "description": "Non-custodial TypeScript SDK for AI agent wallets — x402 payments (Solana, Base, Abstract, Polygon), CCTP cross-chain, token swaps. Private keys never leave your environment.",
+  "version": "3.5.0",
+  "description": "Non-custodial TypeScript SDK for AI agent wallets \u2014 x402 payments (Solana, Base, Abstract, Polygon), CCTP cross-chain, token swaps. Private keys never leave your environment.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -42,4 +42,4 @@
     "typescript": "5.3.3",
     "vitest": "4.0.18"
   }
-}
+}