Overview
The evm-address toolkit allows for the offline, deterministic generation of EVM deposit addresses. It supports two primary modes:
- XPUB (BIP-44): Generates EOA addresses using an extended public key.
- Factory (CREATE2): Generates contract addresses for EIP-1167 minimal proxies.
Installation
SDK
npm install @evm-address/sdk
CLI
npm install -g @evm-address/cli
Quick Start (SDK)
import { createXpubGenerator } from "@evm-address/sdk";
const generator = createXpubGenerator({ xpub: "xpub..." });
const address = generator.generate(0);
Detailed Documentation
- SDK Guide: Full API for programatic address generation.
- CLI Guide: Usage patterns for the command-line tool.
- Smart Contract Deployment: How to deploy and verify the required contracts.
- Contract Source Code: Solidity source code for Factory, Delegate, and Permit contracts.
Strategies Support
| Strategy | Logic |
|---|---|
| BIP-44 | Traditional EOA derivation (m/44'/60'/0'/0/i) |
| CREATE2 | Counterfactual contracts via WalletFactory |
| EIP-7702 | Delegation to SweeperDelegate |
| Permit/Auth | Batch sweeping via PermitSweeper |
Security Note
This tool is designed for offline use and never requires your private keys. It only uses public information (XPUB or contract addresses) to derive deterministic deposit locations.