agentwallet-a0

AgentWallet SDK plugin for Agent Zero. Bridges Python-based Agent Zero tools to the Node.js AgentWallet SDK via subprocess.

Install

npm install -g agentwallet-sdk agentwallet-a0
pip install # no Python deps beyond stdlib

Setup

Set environment variables:

export AGENT_PRIVATE_KEY=0x...        # Agent's private key
export AGENT_ACCOUNT_ADDRESS=0x...    # Smart account address
export AGENT_CHAIN=base               # base | arbitrum | optimism
export AGENT_RPC_URL=https://mainnet.base.org

Usage with Agent Zero

Copy the plugin files into your Agent Zero instruments directory:

from tool_wallet import AgentWalletTool

tool = AgentWalletTool()

# Check budget
result = tool.execute('balance')
print(result)  # {'remainingInPeriod': '1000000', 'perTxLimit': '500000'}

# Transfer USDC
result = tool.execute('transfer', {
    'token': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
    'to': '0xRecipient...',
    'amount': '1000000'  # 1 USDC
})
print(result)  # {'executed': True, 'txHash': '0x...'}

How It Works

Agent Zero runs Python. This plugin uses a Node.js bridge script (wallet_bridge.mjs) that the Python tool calls via subprocess. The bridge imports agentwallet-sdk and executes wallet operations, returning JSON results.

License

MIT