Create2 Deployment

Predict Address

Calculate the address without deploying. This is a pure local computation — no transaction, no gas:

var create2Service = web3.Eth.Create2DeterministicDeploymentProxyService;
var salt = "0x0000000000000000000000000000000000000000000000000000000000000001";

var predictedAddress = create2Service
    .CalculateCreate2Address<MyContractDeployment>(
        new MyContractDeployment { /* constructor args */ },
        proxyAddress,
        salt);

Check If Already Deployed

Before deploying, verify the contract doesn't already exist at the predicted address. This avoids wasting gas on a transaction that will fail:

var alreadyDeployed = await create2Service
    .HasContractAlreadyDeployedAsync(predictedAddress);

Deploy via CREATE2 Proxy

The deployment goes through a deterministic proxy contract. The proxy forwards the bytecode + salt to the CREATE2 opcode:

var salt = "0x0000000000000000000000000000000000000000000000000000000000000001";

var result = await create2Service
    .DeployContractRequestAndWaitForReceiptAsync<MyContractDeployment>(
        new MyContractDeployment { /* constructor args */ },
        proxyAddress,
        salt);

Console.WriteLine($"Deployed to: {result.ContractAddress}");

The result's ContractAddress will match the predicted address exactly.

Deploy the Proxy

If the deterministic deployment proxy isn't deployed on your chain yet (common on private/app chains), deploy it first:

var proxyAddress = await create2Service
    .DeployProxyAndGetContractAddressAsync();

On public networks (Mainnet, Sepolia, Polygon, etc.), the standard proxy is usually already deployed.

Check Proxy Exists

var proxyDeployed = await create2Service
    .HasProxyBeenDeployedAsync(proxyAddress);

EIP-155 Chain-Specific Deployment

For deployments that include the chain ID (producing a different proxy address per chain, but deterministic on each):

var deployment = await create2Service
    .GenerateEIP155DeterministicDeploymentAsync();

Common Patterns

For full documentation, see: https://docs.nethereum.com/docs/smart-contracts/guide-create2-deployment