CLI wallet for managing encrypted ERC-7984 tokens using Zama's FHE technology
npm install fhevm-walletA CLI wallet for managing encrypted ERC-7984 tokens using Zama's Fully Homomorphic Encryption (FHE) technology.
- Interactive Mode - Menu-driven terminal interface with keyboard navigation
- Wallet Management - Create new wallets or import existing ones via mnemonic phrase or private key
- Confidential Token Tracking - Add and manage ERC-7984 compliant tokens
- Encrypted Balance Viewing - Decrypt and view your confidential token balances
- Confidential Transfers - Send tokens with end-to-end encryption
- Address Book - Save frequently used addresses with friendly names
- Multi-Network Support - Works on Ethereum Sepolia testnet and Mainnet
Requires Node.js >= 22.
``bashnpm
npm install -g fhevm-wallet
Usage
Run
fhevm-wallet or the shorter alias fhew to start the interactive mode:`bash
fhew
`$3
`bash
Create a new wallet
fhew wallet create my-walletImport wallet from mnemonic
fhew wallet import my-wallet --mnemonicImport wallet from private key
fhew wallet import my-wallet --keyList all wallets
fhew wallet listSet default wallet
fhew wallet set-default my-wallet
`$3
`bash
Add a token to track
fhew token add 0x...List tracked tokens
fhew token listRemove a tracked token
fhew token remove 0x...
`$3
`bash
View balances for all tracked tokens
fhew balanceView balance on specific network
fhew balance --network mainnetSend tokens (interactive prompts)
fhew sendSend tokens with arguments
fhew send 0x... 100 --token 0x...
`$3
`bash
View current configuration
fhew config --showSet default network
fhew config --network sepoliaSet RPC endpoints
fhew config --rpc-mainnet https://mainnet.infura.io/v3/YOUR_KEY
fhew config --rpc-sepolia https://sepolia.infura.io/v3/YOUR_KEYSet API keys
fhew config --etherscan-key YOUR_ETHERSCAN_KEY
fhew config --zama-key YOUR_ZAMA_KEY
`$3
`bash
Use specific network for any command
fhew balance --network mainnet
fhew send 0x... 100 -n sepolia
`Data Storage
All data is stored in
~/.fhevm-wallet/:`
~/.fhevm-wallet/
├── wallets/ # Encrypted keystore files
├── config.json # CLI configuration
├── tokens.json # Tracked tokens
├── addressbook.json # Saved contacts
└── balance-cache.json # Cached balances
``- Wallet Guide - Detailed wallet, token, and balance documentation
- Development - Local development setup
- Docker - Docker setup
- Contributing - Contribution guidelines
- Wallets are encrypted locally using standard Ethereum keystore format with scrypt
- Your password never leaves your machine
- Write down your recovery phrase - anyone with it can access your funds
- Start with testnet (Sepolia) before using mainnet
MIT