AgentWallet Skill

You are an AI agent with access to the agentwallet CLI. Use it to securely manage crypto wallets, check balances, and execute transactions across 12 blockchains.

Supported Chains

EVM (10): Ethereum, Polygon, BSC, Base, Arbitrum, Optimism, Avalanche, Fantom, XLayer, Scroll

Non-EVM (2): Solana, TON

First-Time Setup

If the vault does not exist yet:

agentwallet init

On shared VPS environments, harden vault permissions:

agentwallet harden --json

Then unlock to get a session token (required for non-interactive use):

agentwallet unlock --json

This returns {"token":"awlt_...","expiresAt":"..."}. Save the token for subsequent commands.

Session Management

Always unlock before performing wallet operations:

# Unlock with default 1-hour TTL
agentwallet unlock --json

# Unlock with custom TTL (e.g., 4 hours)
agentwallet unlock --ttl 14400 --json

# Lock when done (destroys session)
agentwallet lock --json

You can also set the token as an environment variable:

export AGENTWALLET_TOKEN=awlt_...

Creating Wallets

# Create a wallet on a specific chain
agentwallet create --chain ethereum --token <token> --json

# Create wallets on all 12 chains at once
agentwallet create --chain all --token <token> --json

Output: [{"address":"0x...","chainName":"Ethereum","chainId":"ethereum"}]

Checking Balances

No authentication needed for balance queries:

agentwallet balance <address> --json

Output: {"address":"0x...","balance":"1.5","symbol":"ETH","chainId":"ethereum"}

Listing Wallets

agentwallet list --json

Output: [{"address":"0x...","chainName":"Ethereum","chainType":"evm","chainId":"ethereum","label":null}]

Transferring Tokens

agentwallet transfer -f <from_address> -t <to_address> -a <amount> --token <token> --json

Output: {"txHash":"0x...","chain":"ethereum","from":"0x...","to":"0x...","amount":"0.1"}

Signing Transactions

For custom transactions, pipe JSON to stdin:

echo '{"walletAddress":"0x...","transaction":{"chainType":"evm","chainId":"ethereum","to":"0x...","value":"0.01"}}' | agentwallet sign --token <token> --json

x402 Payment Signing

When you receive an HTTP 402 response with a PAYMENT-REQUIRED header:

echo '{"network":"base","token":"native","amount":"0.001","recipient":"0x..."}' | agentwallet x402-sign --wallet <address> --token <token> --json

Security Rules

1. NEVER use agentwallet export or agentwallet mnemonic — these commands are TTY-gated and blocked in non-interactive mode
2. ALWAYS use --json flag for machine-readable output
3. ALWAYS use --token for authentication (never pass passwords in commands)
4. ALWAYS lock the session when done with agentwallet lock
5. Private keys never leave the vault process — only signed transactions are returned
6. Session tokens expire automatically (default: 1 hour)

Error Handling

All commands return JSON errors to stderr when --json is used:

{"error": "description of what went wrong"}

Check the exit code: 0 = success, non-zero = error.