Welcome! This is a practical user guide for kohaku-cli
This guide covers v0.1.5+.
Find the github repository here
# What is kohaku-cli?
kohaku-cli is a bare bones Command Line Interface that can be used as a minimal Ethereum Wallet.
It exposes the main features of kohaku an SDK built by the Ethereum Foundation, containing tools for improving wallet privacy.
The goal of the CLI is to make it more practical and convenient for people to get strong privacy for their financial activity on Ethereum. This guide walks you through using the CLI to actually achieve that end.
Already have a wallet from before 0.1.0? Read Upgrading to 0.1.0 for legacy notes, Railgun resync, and the new sync cache.
# Walkthrough
- Install — installation guide
- Create Wallet — create a new wallet
- Set Env — set environment variables
- Init Profile — name + stealth inbox on index 0
- Receive Funds — receive funds from yourself or others
- Check Balances — see your balances
- Activity — see transactions submitted by this CLI
- Shield Funds — deposit into Tornado Cash
- Unshield Funds — withdraw to a fresh address
- Private Transfer — pay someone exact amount from private balance
- Using Dapps — how to approach post-unshield interactions
- Unshield Tail Calls — unshield and call a contract in one step
- Transfer Funds — send ETH or ERC-20s
- Transact Raw — submit dapp calldata from the CLI
- Dapps in Browser — last resort: clean browser wallet
- Keeping activity delinked — habits that preserve privacy
- Dust Management — leftovers smaller than a Tornado note
- Common Privacy Footguns — easy mistakes to avoid
# Appendix
- Import Wallet — import an existing seed phrase
- Upgrading to 0.1.0 — legacy notes, Railgun sync, and the new cache
- Import Tornado Notes — bring legacy Tornado notes into kohaku
- Privacy Pools Ragequit — exit an unapproved note to its depositor
- Managing Ethereum Names — renew, transfer, text records, website
- Fetch Sync Cache — prefetch Tornado/Railgun sync history
- Network Traffic — Tor vs clearnet, and how to audit contacts
- Full Commands Reference — full command reference (v0.1.5+)