EVM Address Generator

Overview

The evm-address toolkit allows for the offline, deterministic generation of EVM deposit addresses. It supports two primary modes:

1. XPUB (BIP-44): Generates EOA addresses using an extended public key.
2. 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.