EVM Address Generator

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.