AWP Wallet

EVM wallet for AI agents. All commands output JSON. No password needed — encryption is auto-managed.

Step 1 — Ensure Installed

awp-wallet --version 2>/dev/null || {
  git clone https://github.com/awp-core/awp-wallet.git /tmp/awp-wallet &&
  cd /tmp/awp-wallet && bash install.sh
}

If awp-wallet: command not found persists after install, run:

export PATH="$HOME/.local/bin:$PATH"

Step 2 — Ensure Wallet Exists

awp-wallet receive 2>/dev/null || awp-wallet init

When creating a new wallet, tell the user: [WALLET] created new wallet: 0x...

Step 3 — Unlock Session

Every operation that reads or writes on-chain needs a session token.

TOKEN=$(awp-wallet unlock --duration 3600 | jq -r '.sessionToken')

If you get Invalid or expired session, re-run this step.

Step 4 — Execute the User's Request

Pick the right command based on what the user asked. $T = the session token from Step 3.

"Check my balance" / "How much do I have"

awp-wallet balance --token $T --chain ethereum
awp-wallet balance --token $T --chain base --asset usdc
awp-wallet portfolio --token $T                          # all chains overview

"Send X to 0x..."

Before sending, confirm with the user:

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

Then:

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

"What's my address" / "Where do I receive"

awp-wallet receive

No session token needed.

"Approve spending" / "Revoke approval"

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

"Sign this message"

awp-wallet sign-message --token $T --message "Hello World"
awp-wallet sign-typed-data --token $T --data '{"types":{...},"primaryType":"...","domain":{...},"message":{...}}'

"Estimate gas"

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

"Check transaction status"

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

"Show history"

awp-wallet history --token $T --chain ethereum --limit 20

"Send to multiple addresses"

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

Step 5 — Lock When Done

awp-wallet lock

Choosing a Chain

--chain accepts a name or numeric ID. Default: ethereum.

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

Any EVM chain: --chain 99999 --rpc-url https://custom.rpc.com

If the user says "on Base" → --chain base. If they say "on BSC" or "BNB Chain" → --chain bsc. If no chain is mentioned, use ethereum.

Choosing an Asset

--asset accepts a symbol or contract address. Omit for native currency (ETH, BNB, etc.).

Built-in: usdc usdt awp weth wbnb dai

Any token: --asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Output Tags

Use these tags when presenting results to the user:

Error Recovery

Advanced (rarely needed)

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 --token $T                            # session info
awp-wallet allowances --token $T --asset usdc --spender 0xRouter --chain base
awp-wallet verify-log                                   # audit log integrity
awp-wallet upgrade-7702 --token $T --chain ethereum     # EIP-7702 upgrade
awp-wallet revoke-7702 --token $T --chain ethereum      # revoke EIP-7702
awp-wallet deploy-4337 --token $T --chain ethereum      # smart account status

Environment Variables (all optional)

Gasless mode auto-activates when the wallet has no native gas and PIMLICO_API_KEY is set. Force with --mode gasless.