@elizaos/plugin-wallet

Non-custodial wallet for elizaOS agents. Replaces the legacy fan-out across plugin-evm, plugin-solana, plugin-raydium, plugin-orca, plugin-meteora, plugin-jupiter, plugin-lp-manager, plugin-clanker, and the former elizaos-plugin-agentwallet stub with one canonical action+provider surface governed by docs/architecture/wallet-and-trading.md.

Surface

The plugin exposes 10 canonical planner-visible actions:

Action	Purpose
`TRADE`	Open positions, swap, bridge. Discriminated by `kind`: `perp` (Hyperliquid), `prediction` (Polymarket), `spot` / `swap` (Li.Fi on EVM, Jupiter on Solana), `bridge` (Li.Fi / CCTP).
`MANAGE_POSITION`	Close, modify, cancel orders.
`QUERY_MARKET`	Read-only price / depth / funding / chart / news / sentiment. No wallet required.
`QUERY_PORTFOLIO`	Balances, positions, P&L, history.
`LEND`	Supply / borrow / repay / withdraw on Aave or Morpho.
`MANAGE_LP`	Open / close / collect / rebalance LP positions. EVM (Uniswap V3, Aerodrome) + Solana (Raydium, Orca Whirlpools, Meteora DLMM) behind one surface.
`TRANSFER`	Move value to an arbitrary external address. EVM + Solana. Always policy-checked.
`SET_AUTOMATION`	DCA, threshold triggers, P&L exits.
`MANAGE_AUTOMATION`	List / pause / resume / delete automations.
`MINT`	Token launches via Clanker on Base.

These dispatch into typed providers (one per venue / data source). Adding a new venue means adding a provider, not a new planner verb.

Wallet abstraction

Two backends behind WalletBackend:

LocalEoaBackend — desktop default. EOA private keys hydrated from the OS keychain. Optional ERC-6551 token-bound account mode (via the bundled SDK at ./sdk) for on-chain spend policy enforcement.
StewardBackend — cloud + mobile default. Multi-tenant Steward service is the only custody primitive in cloud. No fallback to local.

See src/wallet/ for interface and impls. ELIZA_WALLET_BACKEND=local|steward|auto selects at runtime.

Layout

src/
  index.ts                  # Plugin export
  plugin.ts                 # Plugin object: actions + providers + services
  sdk/                      # Lifted from agent-wallet-sdk (ERC-6551, x402, CCTP, swap, escrow, identity, multi-token, payment router)
  wallet/                   # WalletBackend interface + LocalEoa + Steward
  policy/                   # PolicyModule (local + steward bridge)
  providers/                # Canonical providers (one per venue / data source)
  actions/                  # Canonical actions (TRADE, MANAGE_POSITION, ...)
  audit/                    # Append-only hash-chained audit log

The sdk/ subtree carries forward primitives from agent-wallet-sdk (MIT). See SDK-LICENSE. The wallet/policy/providers/actions/audit subtrees implement the canonical architecture in the spec.

Migration status

This plugin is being built incrementally. Tracked phases:

Phase 0 — interfaces (WalletBackend, CanonicalProvider, CanonicalAction, PolicyModule, audit log schema, failure-code unions).
Phase 1 — backend impls + @elizaos/plugin-wallet composes legacy plugin-evm + plugin-solana; migrate call sites to consume WalletBackend only.
Phase 2 — provider lifts (13+ providers).
Phase 3 — canonical action implementations.
Phase 4 — approval-queue surface (SSE + decision endpoint + tray + Capacitor bridge).
Phase 5 — EVM + Solana chain implementations live under src/chains/; migrate remaining callsites to WalletBackend only; expand test coverage.

See docs/architecture/wallet-and-trading.md §I for the dependency graph.

License

MIT. Source code under src/sdk/ originates from agent-wallet-sdk (MIT, attribution preserved in SDK-LICENSE).