# minimal-create2
-This is the minimal amount of code required to mine a smart contract address using [`CREATE2`](https://eips.ethereum.org/EIPS/eip-1014).
+This is a minimal web app to mine a specific smart contract address using [`CREATE2`](https://eips.ethereum.org/EIPS/eip-1014).
-## Create the `CREATE2` deployment factory
+To reproduce the mining manually, see [manual.md](/manual.md).
-The `CREATE2` opcode can only be called by a smart contract. So to use `CREATE2`, you must first deploy a minimal smart contract that calls this opcode.
+## Local development
-Here's the code to create a new smart contract that calls `CREATE2`. Paste this code into DevTools (assuming MetaMask is installed):
+The project must be hosted in a [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts) for [`SharedArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer) to work. Use [`local-web-server`](https://www.npmjs.com/package/local-web-server) to set the appropriate headers:
-```javascript
-await ethereum.request({
- method: 'eth_sendTransaction',
- params: [{
- from: (await ethereum.request({ method: 'eth_requestAccounts' }))[0], // Your currently active MetaMask address
- data: '0x6d365f5f375f516020360360205ff55f52600e6012f3' // create2-deployment.evm, compiled
- }]
-});
```
-
-`create2-deployment.evm` contains bytecode that deploys `create2.evm`. `create2.evm` is a minimal smart contract written in EVM assembly which expects a 32-byte salt and arbitrary bytecode in the calldata passed to it and deploys the bytecode using the `CREATE2` opcode.
-
-**Important**: If you want the same `CREATE2` contract address *across chains*, you should use a fresh EOA with no prior transactions to create this deployment factory. Otherwise, the deployment factories will have different addresses and will output different `CREATE2` addresses.
-
-## Mine the desired `CREATE2` address
-
-Here's a basic example of predicting the `CREATE2` address:
-
-```javascript
-const ethers = await import('https://cdn.jsdelivr.net/npm/ethers@6.6.2/+esm');
-
-// The smart contract you deployed in "Create the CREATE2 deployment factory"
-const factory = '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A';
-
-// Salt must be hex and exactly 32 bytes
-const salt = '0x0000000000000000000000000000000000000000000000000000000000000123';
-
-// Must be the entire creation bytecode, including constructor arguments
-const bytecode = '0x385f818153f3'; // minimal-contract-deployment.evm, compiled
-
-ethers.getCreate2Address(factory, salt, ethers.keccak256(bytecode));
-// 0xD7ada5e4De61a3c14994046d349d90F7ae693433
+ws --cors.opener-policy same-origin --cors.embedder-policy require-corp
```
-And here's how to mine a specific smart contract address by testing different `salt` values:
-
-```javascript
-const ethers = await import('https://cdn.jsdelivr.net/npm/ethers@6.6.2/+esm');
-
-// The smart contract you deployed in "Create the CREATE2 deployment factory"
-const factory = '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A';
-
-// Must be the entire creation bytecode for the smart contract you want to deploy, including constructor arguments
-const bytecode = '0x385f818153f3'; // minimal-contract-deployment.evm, compiled
-const hashedBytecode = ethers.keccak256(bytecode); // Hash it once and save for efficiency
-
-// Simple regex to match the desired CREATE2 address
-const requirement = /^0xbeef/;
-
-// WARNING: this loop may take a long time to complete depending on the complexity of the requirement
-let salt = 1;
-while (true) {
- const paddedSalt = `0x${salt.toString(16).padStart(64, '0')}`;
- const addr = ethers.getCreate2Address(factory, paddedSalt, hashedBytecode);
- if (requirement.test(addr)) {
- console.log({factory, paddedSalt, bytecode, addr});
- break;
- }
- salt++;
-}
-// {factory: '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A', paddedSalt: '0x000000000000000000000000000000000000000000000000000000000005c342', bytecode: '0x385f818153f3', addr: '0xbeef7906063D950306868AF5af36955015110f84'}
-```
-
-## Using the mined `salt`
-
-Once a desired `CREATE2` address has been mined, you can deploy it by sending the mined `salt` parameter to the smart contract deployed in "Create the `CREATE2` deployment factory".
-
-```javascript
-// Same parameters from "Mine the desired CREATE2 address"
-const factory = '8137a81A74E2a9d510898B2e3E307e7C33eBad8A'; // Drop "0x" prefix
-const salt = '000000000000000000000000000000000000000000000000000000000005c342'; // Drop "0x" prefix
-const bytecode = '385f818153f3'; // Drop "0x" prefix
-
-await ethereum.request({
- method: 'eth_sendTransaction',
- params: [{
- from: (await ethereum.request({ method: 'eth_requestAccounts' }))[0], // Your currently active MetaMask address
- to: `0x${factory}`,
- data: `0x${salt}${bytecode}`
- }]
-});
-// Smart contract is deployed as 0xbeef7906063D950306868AF5af36955015110f84, as predicted
-```
-
-Block explorers such as Etherscan may interpret this payload as a call to a Solidity function with the ABI selector `0x00000000`. As of July 2023, Etherscan's database has the `0x00000000` selector mapped to a function called `fulfillBasicOrder_efficient_6GL6yc(tuple parameters)`.
-
-Since the `CREATE2` factory smart contract was written directly in EVM assembly and not Solidity, the factory has no conception of ABI. To have block explorers display a different function in their UI, you can set the first 4 bytes of the salt to some hardcoded value while using the last 28 bytes to mine the desired address.
-
## Similar projects
- [Seaport (OpenSea)'s CREATE2 Factory](https://github.com/ProjectOpenSea/seaport/blob/main/docs/Deployment.md)
--- /dev/null
+# Manually mine a `CREATE2` smart contract address
+
+These are the steps to manually mine a specific smart contract address using the `CREATE2` opcode.
+
+## Create the `CREATE2` deployment factory
+
+The `CREATE2` opcode can only be called by a smart contract. So to use `CREATE2`, you must first deploy a minimal smart contract that calls this opcode.
+
+Here's the code to create a new smart contract that calls `CREATE2`. Paste this code into DevTools (assuming MetaMask is installed):
+
+```javascript
+await ethereum.request({
+ method: 'eth_sendTransaction',
+ params: [{
+ from: (await ethereum.request({ method: 'eth_requestAccounts' }))[0], // Your currently active MetaMask address
+ data: '0x6d365f5f375f516020360360205ff55f52600e6012f3' // create2-deployment.evm, compiled
+ }]
+});
+```
+
+`create2-deployment.evm` contains bytecode that deploys `create2.evm`. `create2.evm` is a minimal smart contract written in EVM assembly which expects a 32-byte salt and arbitrary bytecode in the calldata passed to it and deploys the bytecode using the `CREATE2` opcode.
+
+**Important**: If you want the same `CREATE2` contract address *across chains*, you should use a fresh EOA with no prior transactions to create this deployment factory. Otherwise, the deployment factories will have different addresses and will output different `CREATE2` addresses.
+
+## Mine the desired `CREATE2` address
+
+Here's a basic example of predicting the `CREATE2` address:
+
+```javascript
+const ethers = await import('https://cdn.jsdelivr.net/npm/ethers@6.6.2/+esm');
+
+// The smart contract you deployed in "Create the CREATE2 deployment factory"
+const factory = '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A';
+
+// Salt must be hex and exactly 32 bytes
+const salt = '0x0000000000000000000000000000000000000000000000000000000000000123';
+
+// Must be the entire creation bytecode, including constructor arguments
+const bytecode = '0x385f818153f3'; // minimal-contract-deployment.evm, compiled
+
+ethers.getCreate2Address(factory, salt, ethers.keccak256(bytecode));
+// 0xD7ada5e4De61a3c14994046d349d90F7ae693433
+```
+
+And here's how to mine a specific smart contract address by testing different `salt` values:
+
+```javascript
+const ethers = await import('https://cdn.jsdelivr.net/npm/ethers@6.6.2/+esm');
+
+// The smart contract you deployed in "Create the CREATE2 deployment factory"
+const factory = '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A';
+
+// Must be the entire creation bytecode for the smart contract you want to deploy, including constructor arguments
+const bytecode = '0x385f818153f3'; // minimal-contract-deployment.evm, compiled
+const hashedBytecode = ethers.keccak256(bytecode); // Hash it once and save for efficiency
+
+// Simple regex to match the desired CREATE2 address
+const requirement = /^0xbeef/;
+
+// WARNING: this loop may take a long time to complete depending on the complexity of the requirement
+let salt = 1;
+while (true) {
+ const paddedSalt = `0x${salt.toString(16).padStart(64, '0')}`;
+ const addr = ethers.getCreate2Address(factory, paddedSalt, hashedBytecode);
+ if (requirement.test(addr)) {
+ console.log({factory, paddedSalt, bytecode, addr});
+ break;
+ }
+ salt++;
+}
+// {factory: '0x8137a81A74E2a9d510898B2e3E307e7C33eBad8A', paddedSalt: '0x000000000000000000000000000000000000000000000000000000000005c342', bytecode: '0x385f818153f3', addr: '0xbeef7906063D950306868AF5af36955015110f84'}
+```
+
+## Using the mined `salt`
+
+Once a desired `CREATE2` address has been mined, you can deploy it by sending the mined `salt` parameter to the smart contract deployed in "Create the `CREATE2` deployment factory".
+
+```javascript
+// Same parameters from "Mine the desired CREATE2 address"
+const factory = '8137a81A74E2a9d510898B2e3E307e7C33eBad8A'; // Drop "0x" prefix
+const salt = '000000000000000000000000000000000000000000000000000000000005c342'; // Drop "0x" prefix
+const bytecode = '385f818153f3'; // Drop "0x" prefix
+
+await ethereum.request({
+ method: 'eth_sendTransaction',
+ params: [{
+ from: (await ethereum.request({ method: 'eth_requestAccounts' }))[0], // Your currently active MetaMask address
+ to: `0x${factory}`,
+ data: `0x${salt}${bytecode}`
+ }]
+});
+// Smart contract is deployed as 0xbeef7906063D950306868AF5af36955015110f84, as predicted
+```
+
+Block explorers such as Etherscan may interpret this payload as a call to a Solidity function with the ABI selector `0x00000000`. As of July 2023, Etherscan's database has the `0x00000000` selector mapped to a function called `fulfillBasicOrder_efficient_6GL6yc(tuple parameters)`.
+
+Since the `CREATE2` factory smart contract was written directly in EVM assembly and not Solidity, the factory has no conception of ABI. To have block explorers display a different function in their UI, you can set the first 4 bytes of the salt to some hardcoded value while using the last 28 bytes to mine the desired address.
git.ardis.lu / minimal-create2 / commitdiff