relayer-cli

CLI for relayer account onboarding and transaction flows.

Account Create

Create a new account (interactive password prompt):

relayer account create

Create a named profile in local dev:

relayer account create --env dev --name alice

Keystore layout (new profiles):

~/.config/towns/relayer-cli/profiles/<env>/<profile>/default.keystore.json
~/.config/towns/relayer-cli/profiles/<env>/<profile>/sessions/default.json

Resume a previously created profile:

relayer account create --resume --env dev --name alice

Non-interactive mode (stdin password + JSON output):

echo "my-password" | relayer account create --password-stdin --json

Use an explicit keystore path:

relayer account create --keystore-path ~/.config/towns/relayer-cli/profiles/dev/team/default.keystore.json --env dev

Account Export

Export metadata only (safe default):

relayer account export --env dev --name alice

Export metadata in JSON:

relayer account export --env dev --name alice --json

Export decrypted private keys (interactive confirmation required):

relayer account export --env dev --name alice --show-private

Account Address

Print the main/root account address:

relayer account address --env dev --name alice

Account Balance

Check USDC balance for the main/root account on Base (default):

relayer account balance --env dev --name alice

Check USDC balance on Polygon:

relayer account balance --env prod --name alice --chain polygon

For local dev (--env dev), default chain is Anvil (http://127.0.0.1:8545). You can override with --chain.

Account Send

Send USDC to an address:

relayer account send 1 0x1111111111111111111111111111111111111111

Send USDC to ENS on Base:

relayer account send 2.5 vitalik.eth --chain base

Send USDC on Polygon with JSON output:

relayer account send 10 0x1111111111111111111111111111111111111111 --chain polygon --env prod --json

Local dev defaults to Anvil:

relayer account send 1 0x1111111111111111111111111111111111111111 --env dev

Account Status

Show compact readiness status (doctor + status):

relayer account status --env dev --name alice

Show detailed diagnostics, including session permission diff:

relayer account status --env dev --name alice --verbose

JSON output for automation:

relayer account status --env prod --name alice --chain polygon --json

Note: session permission mismatches are reported as warnings in this version and do not flip readiness by themselves.

Troubleshooting:

# If root keystore exists but session file is missing/corrupt, restore or recreate:
rm ~/.config/towns/relayer-cli/profiles/dev/alice/default.keystore.json
rm -rf ~/.config/towns/relayer-cli/profiles/dev/alice/sessions
relayer account create --env dev --name alice