Awp Wallet

AWP Wallet

EVM wallet for AI agents. All output is JSON. No passwords, no session tokens needed.

Setup

awp-wallet setup

Creates wallet if needed. Returns { "status": "ready", "address": "0x..." }.

If awp-wallet is not installed

git clone https://github.com/awp-core/awp-wallet.git ~/awp-wallet && cd ~/awp-wallet && bash install.sh

If command not found after install: export PATH="$HOME/.local/bin:$PATH"

Commands

No --token needed. Just run the command directly.

Balance / Portfolio

awp-wallet balance --chain ethereum
awp-wallet balance --chain base --asset usdc
awp-wallet portfolio

Send

Confirm with user first:

[TX] about to send:
     to:      0xBob...1234
     amount:  50 USDC
     chain:   Base
     proceed? (y/n)

awp-wallet send --to 0xAddr --amount 0.1 --chain ethereum
awp-wallet send --to 0xAddr --amount 100 --asset usdc --chain base

Receive

awp-wallet receive

Approve / Revoke

awp-wallet approve --asset usdc --spender 0xRouter --amount 1000 --chain base
awp-wallet revoke --asset usdc --spender 0xRouter --chain base

Sign

awp-wallet sign-message --message "Hello World"
awp-wallet sign-typed-data --data '{"types":{...},...}'

Gas Estimate

awp-wallet estimate --to 0xAddr --amount 0.1 --chain ethereum

Transaction Status

awp-wallet tx-status --hash 0xHash --chain ethereum

History

awp-wallet history --chain ethereum --limit 20

Batch Send

awp-wallet batch --chain base \
  --ops '[{"to":"0xA","amount":"10","asset":"usdc"},{"to":"0xB","amount":"20","asset":"usdc"}]'

Raw Transaction (call any contract without touching private key)

# Sign only (returns signed hex, caller broadcasts)
awp-wallet sign-tx --to 0xContract --data 0xabcdef... --chain base
awp-wallet sign-tx --to 0xContract --data 0xabcdef... --value 1000000000000000 --chain base

# Sign + broadcast (awp-wallet handles everything)
awp-wallet send-tx --to 0xContract --data 0xabcdef... --chain base
awp-wallet send-tx --to 0xContract --data 0xabcdef... --gas 200000 --chain base

Use sign-tx / send-tx when you need to call arbitrary contract methods (DeFi, NFT, staking, etc.). Build your calldata externally, pass it via --data.

Export (for wallet migration)

awp-wallet export                  # mnemonic
awp-wallet export-private-key      # private key

Chains

--chain name or ID. Default: ethereum.

16 built-in: ethereum base bsc arbitrum optimism polygon avalanche fantom zksync linea scroll mantle blast celo sepolia base-sepolia

Custom: --chain 99999 --rpc-url https://custom.rpc.com

"on Base" → --chain base. "on BSC" / "BNB Chain" → --chain bsc. No chain mentioned → ethereum.

Assets

--asset symbol or 0x... address. Omit for native (ETH, BNB, etc.).

Built-in: usdc usdt awp weth wbnb dai

Output Tags

Error Recovery

Advanced

awp-wallet chains                                       # list all chains
awp-wallet chain-info --chain zksync                    # chain details
awp-wallet wallets                                      # list wallet profiles
awp-wallet wallet-id                                    # current profile ID
awp-wallet status                                       # wallet address
awp-wallet allowances --asset usdc --spender 0xRouter --chain base
awp-wallet verify-log                                   # audit log integrity
awp-wallet upgrade-7702 --chain ethereum                # EIP-7702 upgrade
awp-wallet revoke-7702 --chain ethereum                 # revoke EIP-7702
awp-wallet deploy-4337 --chain ethereum                 # smart account status

Environment Variables (all optional)

Gasless auto-activates when no native gas and PIMLICO_API_KEY is set. Force: --mode gasless.