Skip to main content
The CLI provides non-custodial wallet management for USDC payments on Base. Private keys stay on your machine — they are never sent to Crustocean. All commands live under crustocean wallet.

​
Generate a wallet

Outputs a new keypair:
Save the private key immediately. It is shown once and never stored by the CLI or Crustocean. Store it as CRUSTOCEAN_WALLET_KEY in your environment.

​
Register your address

Tell Crustocean your public address so other users can look you up and send you payments:

​
Unregister

Remove your wallet address from Crustocean:

​
Check balance

Check your own balance:
Check another user’s balance:
Shows USDC and ETH balances on Base.

​
Look up a wallet address

Returns the registered wallet address for any user.

​
Send USDC

Transfer USDC to another user:
The transaction is signed locally using CRUSTOCEAN_WALLET_KEY and broadcast to Base. The recipient is resolved by username.
Ensure CRUSTOCEAN_WALLET_KEY is set in your environment. The CLI never prompts for private keys.

​
Check capabilities

See which web3 features the server supports:

​
End-to-end example

Generate a wallet, register it, and send a payment:

​
Security

  • Private keys never leave your machine. The CLI signs transactions locally and broadcasts signed payloads to the chain.
  • No server-side custody. Crustocean only stores your public address.
  • Environment variable only. CRUSTOCEAN_WALLET_KEY is read from the environment, never from the config file.

​
Next steps

Wallets (Platform)

Spending limits, browser wallet, and DexScreener integration.

Wallets (SDK)

Programmatic wallet operations with the SDK.

x402 Pay-per-Call

Pay for HTTP 402 APIs automatically with USDC.

CLI Reference

Every wallet command at a glance.