minimal-create2

Important

EIP-7997 (targeting Glamsterdam in November 2026) will enshrine the 0x4e59b44847b379578588920cA78FbF26c0B4956C factory into the protocol. Meaning, you can just use 0x4e59b44847b379578588920cA78FbF26c0B4956C to deploy your contracts instead of making your own factory.

This is a minimal web app to mine a specific smart contract address using CREATE2.

To reproduce the mining manually, see manual.md.

Code repository mirrors: GitHub, Codeberg, git.ardis.lu

Local development

The project must be hosted in a secure context for SharedArrayBuffer to work. Use local-web-server to set the appropriate headers:

ws --cors.opener-policy same-origin --cors.embedder-policy require-corp

Similar projects

Seaport (OpenSea)'s CREATE2 Factory
Zoltu's deterministic-deployment-proxy
Arachnid's deterministic-deployment-proxy
create2deployer
- This smart contract (with minor modifications) is a predeploy at 0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2 on OP Stack blockchains as of the Canyon hardfork (November 2023).
CreateX

description	The minimal amount of code required to mine a smart contract address using CREATE2.
last change	Fri, 16 Oct 2026 06:55:38 +0000 (23:55 -0700)
URL	https://git.ardis.lu/minimal-create2.git
	ssh://git@git.ardis.lu/~/minimal-create2.git
	git@git.ardis.lu:minimal-create2.git

2 days ago	Ardis Lu	Upgrade styling main	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
3 days ago	Ardis Lu	Upgrade noble-hashes to 2.4.0	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-08-19	Ardis Lu	Add note about EIP-7997	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-08-19	Ardis Lu	Remove unnecessary <br>	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-07-14	Ardis Lu	Optimize gas usage	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-07-14	Ardis Lu	Update remaining `.evm` extension usage	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-07-13	Ardis Lu	Add code repository mirrors	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-07-12	Ardis Lu	Add comments to note stack state	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-07-11	Ardis Lu	Change EVM assembly extension to `.eas`	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2026-04-02	Ardis Lu	Add MIT license	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2024-11-15	Ardis Lu	Add link to example of deterministic deployment	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2024-04-02	Ardis Lu	Upgrade noble-hashes to 1.4.0	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2024-02-26	Ardis Lu	Add note about OP Stack predeploy	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2023-12-12	Ardis Lu	Upgrade noble-hashes to 1.3.3	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2023-12-09	Ardis Lu	Add CreateX to similar projects	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
2023-12-07	Ardis Lu	Update note for clarity	commit \| commitdiff \| tree \| snapshot (zip tar.gz)
...