Package Exports

elizaos-plugin-agentwallet
elizaos-plugin-agentwallet/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (elizaos-plugin-agentwallet) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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