awal

Coinbase Wallet CLI for payments and crypto.

Installation

npx awal status

Or install globally:

npm install -g awal
awal status

Quick Start

# Check status (will install server on first run)
awal status

# Sign in with email
awal auth login [email protected]
awal auth verify <flow-id> <6-digit-code>

# Check your balance (all chains)
awal balance

# Check balance on a specific chain
awal balance --chain polygon

# Get your wallet address
awal address

# Send USDC
awal send $1.00 0x...recipient...
awal send $1.00 0x...recipient... --chain polygon

# Swap tokens
awal trade $1 usdc eth
awal trade $1 usdc pol --chain polygon

Commands

Wallet

• awal status - Check server and auth status
• awal balance - Get wallet balances across all chains (Base: USDC/ETH, Polygon: USDC/POL, Solana: USDC/SOL)
• awal address - Get wallet address
• awal show - Open wallet UI

Authentication

• awal auth login <email> - Start email OTP sign-in
• awal auth verify <flowId> <code> - Complete sign-in with 6-digit code

Transactions

• awal send <amount> <recipient> - Send USDC to address or ENS
• awal revoke <tokenAddress> <spenderAddress> - Revoke an ERC-20 approval (sets the spender's allowance to 0). Useful for cleaning up Permit2 / DEX router allowances.
• awal trade <amount> <from> <to> - Swap tokens

X402 Payments

• awal bazaar list - List X402 payment services
• awal bazaar search <query> - Search bazaar resources by keyword
  • --network <network> - Filter by chain (base, base-sepolia, polygon, solana, solana-devnet)
  • --scheme <scheme> - Filter by payment scheme: exact or upto
  • --max-price <usd> - Maximum price in USD (e.g. 0.01)
  • --asset <address> - Filter by payment asset address
  • --pay-to <address> - Filter by recipient wallet address
  • --extensions <type> - Filter by extension type (e.g. outputSchema, bazaar)
  • -k, --top <n> - Max results, 1–20 (default: 20)
• awal bazaar details <url> - Get service details
• awal pay <baseURL> <path> - Make X402 payment request
• awal discover <baseURL> <path> - Discover payment requirements

Options

Most commands support:

• --json - Output as JSON
• --chain <chain> - Specify blockchain: base, base-sepolia, polygon, solana, solana-devnet (default: base)

Architecture

The CLI communicates with an Electron-based wallet server via file-based IPC. On first run, the server bundle and Electron runtime are installed to ~/.local/share/awal/.

Requirements

• Node.js 18+
• macOS, Linux, or Windows

License

Apache-2.0