agentwallet-elizaos

Standalone ElizaOS plugin for AgentWallet SDK v5. Gives your ElizaOS agent a non-custodial smart wallet with on-chain spend limits and automatic x402 payment handling.

Install

npm install agentwallet-elizaos agentwallet-sdk viem @elizaos/core

Usage

Add the plugin to your ElizaOS character config:

import { AgentWalletPlugin } from 'agentwallet-elizaos';

export const character = {
  name: 'MyAgent',
  plugins: [AgentWalletPlugin],
  settings: {
    secrets: {
      AGENT_WALLET_PRIVATE_KEY: process.env.AGENT_PRIVATE_KEY,
      AGENT_WALLET_ACCOUNT_ADDRESS: process.env.AGENT_ACCOUNT_ADDRESS,
    },
  },
};

What's Included in v5

• Non-custodial wallet — agent holds its own keys, owner sets spend limits on-chain
• Budget enforcement — per-transaction and per-period spend caps via smart contract
• x402 payments — automatic HTTP 402 invoice detection and payment
• ERC-20 transfers — send USDC and other tokens within budget constraints
• Multi-chain — Base, Arbitrum, Optimism support

API

• AgentWalletPlugin — ElizaOS plugin instance (default export)
• getAgentWallet(runtime) — get the configured wallet from ElizaOS runtime
• createAgentFetch(runtime) — get an x402-enabled fetch function

License

MIT