elizaos-plugin-agentwallet

Non-custodial wallet plugin for ElizaOS agents. EVM + Solana, x402 micropayments, CCTP cross-chain bridge, Jupiter and Uniswap swaps — and your agent holds its own private key the entire time.

Why non-custodial matters

Most agent wallet setups proxy through a vendor. Your agent calls Coinbase's API. Privy holds the key. The agent is asking permission to spend its own money.

This plugin skips all that. The key lives in the agent's settings. Every transaction gets signed locally. There's no CDP API key, no Privy account, no custody layer between your agent and its funds.

Install

npm install elizaos-plugin-agentwallet agentwallet-sdk

Quick start

import { createAgent } from '@elizaos/core';
import agentWalletPlugin from 'elizaos-plugin-agentwallet';

const agent = await createAgent({
  plugins: [agentWalletPlugin],
  settings: {
    // EVM setup (Base mainnet)
    AGENTWALLET_PRIVATE_KEY: process.env.AGENT_PRIVATE_KEY,
    AGENTWALLET_CHAIN: 'evm',
    AGENTWALLET_EVM_NETWORK: 'base',
    AGENTWALLET_SPEND_LIMIT_USD: '50', // won't sign any tx over $50

    // Swap to Solana setup instead:
    // AGENTWALLET_CHAIN: 'solana',
    // AGENTWALLET_SOLANA_NETWORK: 'mainnet-beta',
  },
});

Now your agent can respond to:

• "What's my wallet balance?" → checks all token balances
• "Send 10 USDC to 0x..." → signs and submits the transfer
• "Swap 0.5 SOL to USDC" → Jupiter route, best price
• "Bridge 100 USDC from base to arbitrum" → CCTP V2, ~3 min
• "Pay x402 endpoint https://api.example.com max 0.001 USDC" → micropayment, instant

Available actions

Action	Trigger examples	Chains
WALLET_BALANCE	"check balance", "how much do I have"	EVM + Solana
WALLET_TRANSFER	"send 10 USDC to 0x...", "pay 0.1 SOL to..."	EVM + Solana
WALLET_SWAP	"swap 0.5 ETH to USDC", "swap 1 SOL for USDT"	EVM (Uniswap V3) + Solana (Jupiter)
WALLET_BRIDGE	"bridge 100 USDC from base to solana"	17 chains via CCTP V2
X402_PAY	"pay x402 endpoint https://..."	Solana (sub-cent) + EVM

Wallet provider

The plugin automatically injects wallet state into the agent's context before each response:

## Agent Wallet
Address: 0xYourAgentAddress
Chain: evm (base)
Balances:
  ETH: 0.5 ($1,200.00)
  USDC: 250.00 ($250.00)
Spend limit: $50 per transaction

This lets the agent reason about its own funds before deciding to spend. It won't try to send $500 when it only has $250.

Settings reference

Setting	Required	Default	Description
AGENTWALLET_PRIVATE_KEY	✅	—	Private key. Hex for EVM, base58 for Solana
AGENTWALLET_CHAIN	✅	—	evm or solana
AGENTWALLET_EVM_NETWORK	—	base	base, arbitrum, optimism, ethereum
AGENTWALLET_SOLANA_NETWORK	—	mainnet-beta	mainnet-beta or devnet
AGENTWALLET_SPEND_LIMIT_USD	—	50	Max USD per transaction
AGENTWALLET_RPC_URL	—	public	Custom RPC endpoint (use your own for production)

How it compares to plugin-evm

ElizaOS's built-in plugin-evm is great for getting started but has some gaps:

• No x402 micropayment support
• No spend limits (agent can drain itself)
• No CCTP cross-chain bridge
• No Jupiter swaps on Solana
• Routes through LiFi (adds a dependency)

This plugin is a drop-in addition for teams that need the full financial stack.

Security

• The private key never leaves your infrastructure. It's passed as a runtime setting and used locally to sign transactions.
• Spend limits are enforced before every transaction. Set them low.
• For production deployments, use a dedicated agent keypair with a small funded balance — don't point this at your main treasury.

License

MIT — agentwallet-sdk | ai-agent-economy.com