Practical overview
When it fits
Use Create2Crunch during preparation of a CREATE2 deployment when you have the relevant factory, caller and initialization-code hash and want to search and review candidate addresses before using a salt.
Who it is for
- Ethereum developers preparing CREATE2 contract deployments who want to search for efficient addresses.
- Developers who need to explore salts against a specific factory, caller and initialization-code hash.
- Users with an OpenCL device who want to try the repository’s experimental GPU search option.
Documented uses
- Search CREATE2 salts using deployment-specific inputs.
- Record candidate salts, resultant addresses and approximate rarity values for review.
- Monitor search output with the included Python script.
- Filter OpenCL search results by leading or total zero-byte thresholds.
Requirements & limits
The project is provided as a public GitHub repository under the MIT license.
- The search depends on supplying the factory address, caller address and keccak-256 initialization-code hash.
- A candidate salt should be checked against the intended address, ideally through a factory view method where available.
- Existing output should be cleared before changing the factory address or initialization code to keep search results from becoming commingled.
- The OpenCL option is experimental and depends on an available OpenCL device.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run a standard CREATE2 salt search
Search salts using a factory, caller and initialization-code hash, then review the resulting address records.
Before you start
- A factory address or contract that will call CREATE2
- A caller address
- The keccak-256 hash of the contract initialization code
- Rust and Cargo for the documented command-line workflow
Steps
Clone the create2crunch repository and change into its directory.
Set the FACTORY, CALLER and INIT_CODE_HASH environment variables to the values for the intended deployment.
Run cargo run --release with those three values as arguments.
Review efficient_addresses.txt for salts, resultant addresses and approximate rarity values.
Expected outcome
The tool records efficient salts, their resultant addresses and approximate rarity values in efficient_addresses.txt.
Guide limitations
- Verify that a candidate salt yields the intended address, ideally with a factory view method when available.
- Clear existing output before changing the factory address or initialization code, to avoid mixing salt types.
Try an experimental OpenCL search
Run a GPU-backed search with optional filters for leading and total zero bytes.
Before you start
- The standard search inputs: factory address, caller address and initialization-code hash
- An available OpenCL device and its device identifier
Steps
Add the OpenCL device identifier as the fourth search argument.
Optionally add fifth and sixth arguments for the leading-zero-byte and total-zero-byte thresholds.
Run the search using the documented Cargo command.
Expected outcome
The search uses the selected OpenCL device and can filter returned results by the specified zero-byte thresholds.
Guide limitations
- The repository describes OpenCL support as experimental.
- GPU searching depends on the available OpenCL device.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- 0age/create2crunch · Official homepage title · retained in its source language
Related options
Pr000xy Create2Factory — The README says Create2Crunch was originally built for use with Pr000xy, including its Create2Factory contract.