autogen-ext-agentwallet

Non-custodial wallet extension for AutoGen agents.

Give your AutoGen agents a real wallet: check balances, send tokens, bridge across 17 chains via CCTP, handle HTTP 402 micropayments, and enforce on-chain spend limits — all without ever handing over custody of your keys.

Features

• EVM balance checks — native ETH and any ERC-20 token
• Token transfers — sign and broadcast transactions directly from the agent
• 17-chain CCTP bridge — USDC bridging via Circle's Cross-Chain Transfer Protocol (Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, and more)
• x402 payments — automatic handling of HTTP 402 Payment Required flows
• On-chain spend limits — query AgentAccountV2 contract limits before spending

Installation

pip install autogen-ext-agentwallet

Configuration

Set these environment variables (or pass directly to the toolkit):

WALLET_ADDRESS=0xYourAgentWalletAddress
PRIVATE_KEY=0xYourPrivateKey
RPC_URL=https://mainnet.base.org
CHAIN_ID=8453

Security: Never hardcode your private key. Use .env files or a secrets manager.

Quick Start

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_ext_agentwallet import AgentWalletToolkit

# Initialize the toolkit
toolkit = AgentWalletToolkit(
    wallet_address="0xYourAgentWalletAddress",
    private_key="0xYourPrivateKey",
    chain_id=8453,          # Base mainnet
    rpc_url="https://mainnet.base.org",
)

tools = toolkit.get_tools()

# Create an AutoGen agent with wallet capabilities
agent = AssistantAgent(
    name="wallet_agent",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
    system_message=(
        "You are an autonomous agent with a non-custodial wallet. "
        "You can check balances, send tokens, bridge assets, and pay for services."
    ),
)

async def main():
    result = await agent.run(task="Check my ETH balance on Base")
    print(result)

asyncio.run(main())

Available Tools

WalletBalanceTool

Check native or ERC-20 token balance.

from autogen_ext_agentwallet import WalletBalanceTool

tool = WalletBalanceTool(rpc_url="https://mainnet.base.org", wallet_address="0x...")
# Used automatically by the agent, or call directly:
# result = await tool.run(BalanceInput(address="0x...", token="0xUSDC..."))

WalletTransferTool

Sign and send ETH or ERC-20 tokens.

The agent will construct a transaction, sign it locally (non-custodial), and broadcast it.

WalletBridgeTool

Bridge USDC across chains using Circle's CCTP.

Supported chains: Ethereum (1), Base (8453), Arbitrum (42161),
Optimism (10), Polygon (137), Avalanche (43114), and more.

X402PaymentTool

Handle HTTP 402 payment flows automatically. The agent will:

1. Detect the 402 response
2. Parse payment requirements from headers
3. Sign a micropayment (if within max_amount_usd)
4. Retry the request with the payment header

GetSpendLimitsTool

Query on-chain spend limits from an AgentAccountV2 contract.

Using Individual Tools

from autogen_ext_agentwallet import WalletBalanceTool, WalletTransferTool, GetSpendLimitsTool

balance_tool = WalletBalanceTool(
    rpc_url="https://mainnet.base.org",
    wallet_address="0x...",
)

transfer_tool = WalletTransferTool(
    rpc_url="https://mainnet.base.org",
    wallet_address="0x...",
    private_key="0x...",
    chain_id=8453,
)

spend_tool = GetSpendLimitsTool(rpc_url="https://mainnet.base.org")

Supported Chains

License

MIT — see LICENSE

Links

• agentwallet-sdk on npm
• AI Agent Economy
• GitHub