A command-line interface wallet for the Sepolia Testnet, built with TypeScript and Viem. It features secure encrypted storage for managing multiple wallets and accounts.

• 🔒 Encrypted Storage: Your keys are AES-256 encrypted using your password. No more plain text .env storage!
• 🔑 Wallet Management:
  • HD Wallets: Generate BIP-39 seed phrases and derived accounts.
  • Import: Import existing Seed Phrases, Private Keys, or Keystore Files.
  • Switching: Easily toggle between different wallets and accounts.
• 🌐 Network Management:
  • Custom Networks: Add any EVM-compatible chain (RPC, ChainID).
  • Switching: Toggle between Sepolia, Anvil, or your custom networks.
  • Persistence: Remembers your active network.
• 🪙 Token Management:
  • Multi-Token Support: Manage list of ERC20 tokens per network.
  • Unified Balance: See ETH and all tracked token balances in one view.
  • Easy Transfers: Select tokens directly from your list.
• 🗑️ Deletion: Safely remove unused wallets, accounts, or networks.
• 💰 Assets: Check ETH balances and transfer ERC-20 tokens.
• 💨 EIP-1559: Supports modern gas fee transactions.
• 🦊 MetaMask Compatible: Seamlessly import/export accounts between CEW and MetaMask.
• 🧰 Standalone Executable: Build a binary that runs without Node.js.

CEW is designed to be fully compatible with MetaMask, giving you the flexibility of a CLI with the interoperability of a browser wallet:

• Same Mnemonic: Generate a wallet in CEW and import the same 12-word seed phrase into MetaMask (or vice versa) to access the exact same accounts.
• Standard Derivation: Uses the standard BIP-44 path m/44'/60'/0'/0/x just like MetaMask, so your addresses always match.
• Portable: Export your private keys from CEW and drop them into MetaMask for browser usage anytime.

• Node.js (v18 or higher)
• npm or pnpm

1. Navigate to the project directory:

   cd cew

2. Install dependencies:

   pnpm install

Simply run the start command to enter the interactive menu:

pnpm start

On first run, you will be prompted to create a password to secure your wallet storage.

Main Menu Options:

• Wallet And Account: Manage your identities.
  • Generate New Wallet: Create a new HD Wallet (batch generates first 10 accounts).
  • Import: Bring in existing keys/seeds.
  • Switch: Change active wallet/account.
  • Delete: Remove unwanted wallets or accounts.
  • Export: View seed phrases or private keys (requires password).
• Check Balance: View native ETH and managed Token balances.
• Transfer ETH: Send native currency.
• Transfer ERC20: Send tokens (select from managed list or enter custom address).
• Manage Tokens: Add/Remove tokens for the current network.
• Network Settings: Switch networks, add custom RPCs, or remove networks.

You can compile the wallet into a single executable file (binary) for easy distribution or running on systems without Node.js.

1. Build the package:

   pnpm package

2. Run the executable:

   ./cew

• ~/.cew/data/wallets.json: Stores your encrypted wallet data globally. Do not delete this if you want to keep your accounts.
• Password: The encryption key is derived from your password. If you lose your password, you lose access to your local data.

To compile the TypeScript code manually:

pnpm build

The output will be in the dist folder.