Open-source wallet for the terminal

Your crypto. Your command.

A fast CLI wallet with an interactive TUI, encrypted local vaults, and predictable JSON output.

$npm i -g hodl-wallet && hodl

npm package ↗ View on GitHub ↗

HODL Wallet terminal showing a network, balances, and transfer controls

Local by designEncrypted profiles on your machine

Interactive or scriptedTUI for people, JSON for agents

Open to inspectionMIT licensed source on GitHub

Use the TUI. Automate the same wallet.

Running hodl opens the interface above. Subcommands skip prompts and return one predictable JSON object.

Read a balance without exposing the password

Pipe the password through standard input. The command returns a single JSON envelope that scripts can parse.

printf '%s' '{"password":"vault-password"}' |
  hodl balance --wallet treasury --network eth

→ {"version":1,"ok":true,"command":"balance","data":{...}}

Security is a workflow

Keep the vault close

Create wallets offline, protect local profiles with a password, and export encrypted HODL files for deliberate backup.

Offline creationGenerate a wallet without handing keys to a hosted service.

Two-part recoveryAn exported HODL file requires both the file and its password.

Explicit transfersJSON sends require confirmation and a unique request ID.

Inspectable codeRead the implementation, dependencies, and network adapters.

Across Bitcoin and EVM networks

Work with native assets and configured tokens through one consistent interface.

Bitcoin Ethereum BNB Chain Polygon Optimism Arbitrum One Fantom Avalanche C-Chain Hyperliquid

Dry-run before sending

Prepare and inspect a transfer before explicitly authorizing a real transaction.

Retry without duplicating

A reused request ID returns the previously prepared signed transaction instead of creating another payment.

Take it to the terminal

Install globally, run hodl, and inspect the source before trusting it with real assets.

Install from npm ↗ View on GitHub ↗

HODL Wallet is a personal open-source project and may contain security flaws. Use it at your own risk, test with small amounts, verify addresses, and keep independent backups.