agentwallet

EVM wallet with accountability for autonomous agents. Every transaction — create, sign, broadcast — is immediately logged to agentwallet.json. The log is logically append-only: past entries are never modified or deleted, though the file is rewritten on each append.

⚠️ High-impact tool. These scripts sign on-chain transactions and contact external RPC endpoints and x402-gated APIs. Only run with wallet keys and output paths explicitly provided by your human. Always confirm --max-amount is set for x402 flows.

Install

This skill is distributed via ClawHub. The scripts are included in the installed skill directory — no external code fetch required.

Dependencies (install once if not present):
CODEBLOCK0

Usage

Arbitrary contract call (e.g. bridge, custom protocol):

python3 agentwallet/scripts/log_transaction.py 0.004 ETH Linea 0xBridgeContract "bridge to Base" \
    --wallet-key ~/.secrets/eth_wallet.json \
    --rpc https://rpc.linea.build \
    --calldata 0x1234abcd... \
    --output ~/website/treasury.json

Signs and broadcasts a raw contract call with custom calldata. Logs the transaction automatically.

x402 payment to a gated API (e.g. Actors.dev email, GateSkip):

python3 agentwallet/scripts/x402_request.py \
    --url https://actors.dev/emails \
    --wallet-key ~/.secrets/eth_wallet.json \
    --rpc https://mainnet.base.org \
    --output ~/website/treasury.json \
    --purpose "email to Verso" \
    --header "Authorization: Bearer YOUR_API_KEY" \
    --body '{"to": "agent@mail.actors.dev", "subject": "Hi", "body": "Hello!"}' \
    --max-amount 0.02 \
    --pay-to 0x3604712bd95ba2ff36b624f3ffeb6b73b34604ea

Handles full 402→sign EIP-712→retry flow. Logs USDC spend automatically.
Always set --max-amount. Use --pay-to only when the facilitator address is stable — some providers (e.g. Actors.dev via Stripe) rotate it per request by design, so --pay-to would always abort.

Uniswap V3 swap (e.g. ETH → USDC on Base):

python3 agentwallet/scripts/log_transaction.py 0.0012 ETH Base - "swap ETH to USDC" \
    --wallet-key ~/.secrets/eth_wallet.json \
    --rpc https://mainnet.base.org \
    --swap-to 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
    --asset-out USDC --decimals-out 6

Logs two entries automatically: ETH out + USDC in.

CODEBLOCK4

Send ETH:
CODEBLOCK5

Send ERC20 (e.g. USDC on Base, 6 decimals):
CODEBLOCK6

Log only (no broadcast):
CODEBLOCK7

Options

Option	Description
INLINECODE5	JSON file with "private_key" field. Required for broadcasting.
INLINECODE7

EVM-compatible RPC endpoint. Required for broadcasting. | | --contract <addr> | ERC20 contract address. Omit for native ETH. | | --decimals <int> | Token decimals. Default: 18. USDC = 6. | | --output <path> | Path to agentwallet.json. Required — ask your human if unsure. | | --tx-hash <hash> | Skip broadcast, log an existing hash only. | | --direction <sent\|received> | Direction of the transaction. Default: sent. Use received to log incoming transactions (requires --tx-hash). | | --calldata <hex> | Raw calldata hex (with or without 0x prefix) — triggers arbitrary contract call instead of transfer. | | --swap-to <contract> | Output token contract address — triggers Uniswap V3 swap instead of transfer. | | --asset-out <symbol> | Output asset symbol for the log (default: TOKEN). | | --decimals-out <int> | Output token decimals (default: 6). | | --fee <int> | Uniswap V3 pool fee tier in bps (default: 500 = 0.05%). | | --min-out <amount> | Minimum output amount in human units (e.g. 2.4). Enables slippage protection — swap reverts if output is below this. Recommended for larger swaps. |

Wallet JSON format

CODEBLOCK8

Keep at chmod 600. Never commit to git.

Log format

CODEBLOCK9

Rules

• - Log before or immediately after every transaction — never batch or defer
• Use "pending" for tx hash if not yet confirmed
• Never modify or delete past log entries — the log is a permanent audit trail
• If --wallet-key or --output are not known, ask your human before proceeding
• For x402 flows, always confirm --max-amount is set to prevent signing unexpected amounts

Docs

Full documentation: https://cdnsoft.github.io/agentwallet