ethereum-wallet-toolkit-guide

Ethereum Wallet Toolkit Guide

Python toolkit for Ethereum wallets: CLI tools + MCP servers for wallet generation, BIP39/BIP44 HD wallets, keystores, and typed data signing. Designed for offline use.

Core Features

Feature	Description	Offline
Wallet Generation	Create new Ethereum wallets	✅
BIP39 Mnemonics	12/24-word seed phrases	✅
BIP44 HD Wallets	Derive multiple addresses from one seed	✅
Keystores	Web3 Secret Storage V3 encryption	✅
EIP-712 Signing	Typed structured data signing	✅
Vanity Addresses	Custom-prefix wallet addresses	✅
MCP Server	AI agent interface for all features	✅

Quick Start

pip install ethereum-wallet-toolkit

Wallet Generation

Create a New Wallet

ethereum-wallet create
# Output:
# Address: 0x742d35Cc6634C0532925a3b844Bc...
# Private Key: 0x4c0883a69102937d62...
# Mnemonic: abandon ability able about above...

From Mnemonic (BIP39)

from ethereum_wallet_toolkit import Wallet

wallet = Wallet.from_mnemonic(
    "abandon ability able about above absent absorb abstract absurd abuse access accident"
)
print(wallet.address)  # 0x...
print(wallet.private_key)  # 0x...

HD Wallet Derivation (BIP44)

from ethereum_wallet_toolkit import HDWallet

hd = HDWallet.from_mnemonic("your 12 words here")

# Derive multiple addresses
for i in range(5):
    child = hd.derive(f"m/44'/60'/0'/0/{i}")
    print(f"Address {i}: {child.address}")

Standard Ethereum derivation path: m/44'/60'/0'/0/index

Keystores (Web3 Secret Storage V3)

Create Keystore

from ethereum_wallet_toolkit import Keystore

# Encrypt private key with password
keystore = Keystore.encrypt(
    private_key="0x4c0883a69102937d...",
    password="my-strong-password"
)

# Save to file
keystore.save("./my-keystore.json")

Decrypt Keystore

wallet = Keystore.decrypt("./my-keystore.json", "my-strong-password")
print(wallet.private_key)