evm-address

使用@evm-address/sdk和CLI离线生成确定性EVM存款地址的指南。支持BIP-44（XPUB）和CREATE2（Factory）策略，且不会暴露私钥。在实现存款系统、批量扫币或离线地址生成时使用。

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.