hodl

Light crypto wallet. TUI. Rust + ratatui.

Status

Working multi-chain wallet. Send / receive / balance across all listed chains. Roadmap tracked in GitHub issues.

Goals

• Light wallet — no full-node sync, talk to public/self-hosted endpoints.
• Terminal UI via ratatui.
• Multi-chain: Bitcoin (+ testnet), Litecoin, Dogecoin, Bitcoin Cash, NavCoin, Ethereum, BNB Smart Chain, Monero. BIP-39 seed, BIP-32/44/49/84/86 derivation.
• Local-only key storage, ChaCha20-Poly1305 vault under Argon2id. Never phones home.
• Cross-platform: Linux, macOS, Windows.

Layout

hodl/
├── apps/
│   └── hodl/                  # main binary
├── crates/
│   ├── hodl-core/             # shared types, errors, traits
│   ├── hodl-config/           # config + known_hosts loading (TOML)
│   ├── hodl-wallet/           # vault, BIP-39, BIP-32 derivation, signing
│   ├── hodl-chain-bitcoin/    # BTC + LTC + DOGE + BCH + NAV (Electrum)
│   ├── hodl-chain-ethereum/   # ETH + BSC (JSON-RPC, EIP-1559)
│   ├── hodl-chain-monero/     # XMR (LWS)
│   └── hodl-tui/              # ratatui screens, input, layout
└── Cargo.toml                 # workspace root

Install

macOS (Homebrew)

brew install kryptic-sh/tap/hodl

Arch Linux (AUR)

paru -S hodl-bin

Alpine Linux (once available in the apk repo)

apk add hodl

Until the package lands in a public Alpine repo, install the .apk asset from the GitHub Release directly:

apk add --allow-untrusted hodl-*.apk

Pre-built binaries

Download the tarball for your platform from the Releases page and extract the hodl binary onto your $PATH.

Build

cargo build --release
cargo run -p hodl

Contributing

See CONTRIBUTING.md (if exists) or open an issue / PR.

License

MIT. See LICENSE.