/create2-salt-miner

An extremely fast CREATE2 salt miner for creating efficient Ethereum addresses.

Primary LanguageC

⛏️ Salty – CREATE2 Salt Miner

Nickname: salty

An extremely fast miner for finding salts that create gas-efficient and vanity Ethereum addresses via CREATE2.

Salty only searches for results better than what is already found. For example, if a salt is found that results in an address with 3 leading zero bytes, the next salt will only be displayed if it results in an address with 4 leading zero bytes. This improves performance by reducing the number of times the kernel needs to communicate with the host.

Salty can run for a really long time and will keep finding better salts. It is recommended to leave it running for a few hours if you're looking to find a salt that results in an efficient address.

Salty is written in Rust, uses Alloy for Ethereum primitives and uses OpenCL as the processing backend.

Salty always uses OpenCL, which means it can utilize a wide variety of systems including CPUs, GPUs and supported accelerators. It is highly recommended to use GPUs for mining as they are significantly faster than CPUs. If you'd like to use CPUs, you'll need to install the OpenCL Driver for your platform. Typically, for all x86-64 systems, Intel's OpenCL Driver works best.

Using OpenCL Platform as the backend also means you can run it across multiple GPUs as long as they are grouped in the same OpenCL Platform. By default, if your GPUs are from the same vendor, the drivers will automatically group them. Additional configuration may be required if you have GPUs from different vendors.

Usage

Salty is currently tested on Linux, macOS and Windows. It works with CPUs, GPUs and Accelerators.

You'll need Rust and OpenCL SDK installed and available in PATH. Start by cloning the repository.

git clone git@github.com:akshatmittal/create2-salt-miner.git

You can then run it with cargo by providing each option as an argument.

cargo run --release -- mine --factory 0x0000000000FFe8B47B3e2130213B802212439497                            \
                            --caller 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045                             \
                            --codehash 0x64e604787cbf194841e7b68d7cd28786f6c9a0a3ab9f8b0a0e87cb4387ab0107

Alternatively, you can create a file named salty.toml in root with the same parameter names and simply run the miner. A sample file is included in this repo. CLI arguments take precedence so any arguments you provide via the CLI will override the arguments provided via the config file.

cargo run --release -- mine

Additionally, Salty includes a list command to display all available OpenCL platforms on the device.

cargo run --release -- list

Features

  • Multiple Config Sources (CLI, Config File)
  • OpenCL Backend (CPU, GPU, Accelerators)
  • Ranking Mode (Zero Bytes)
  • Ranking Mode (Any Bytes)
  • Pattern Matching Mode
  • CREATE2 Support
  • Hardhat Plugin
  • Foundry Plugin
  • CREATE3 Support
  • WASM Build (is that even possible?)

Parameters

The following parameters are available when using the mine command.

Option Description Default
factory Factory address that will be used to deploy the contract via CREATE2 0x0000000000FFe8B47B3e2130213B802212439497
caller Caller for the deployment (required parameter)
codehash Keccak-256 hash of the contract initialization code (required parameter)
worksize Work size per batch 0x4400000
zeros Minimum zero bytes to look for in the created contract (no stop) 1

Performance Benchmarks

Platform Platform Type Speed
Nvidia RTX 3070 GPU (CUDA) 1,250
Apple M1 Pro Hybrid (Metal) 40
AMD Ryzen 5 3600 CPU (PoCL) TODO
AMD Ryzen 9 5900X CPU (PoCL) TODO

Speed is measured in million attempts per second.

Acknowledgements

This project is heavily inspired by 0age's create2crunch. The code for the OpenCL Kernel is taken from there and modified to work in this context.