Deploy Contract

Then create a Web3 instance with your account and deploy. The handler encodes the constructor args into the bytecode, estimates gas, and waits for the receipt:

var account = new Account("0xYOUR_PRIVATE_KEY");
var web3 = new Web3(account, "https://your-rpc-url");

var handler = web3.Eth.GetContractDeploymentHandler<StandardTokenDeployment>();
var receipt = await handler.SendRequestAndWaitForReceiptAsync(
    new StandardTokenDeployment { TotalSupply = Web3.Convert.ToWei(1000000) });

Console.WriteLine($"Deployed at: {receipt.ContractAddress}");

Gas estimation, nonce, and EIP-1559 fees are all automatic.

Estimate Gas Before Deploying

If you want to check the cost before committing, call EstimateGasAsync. This simulates the deployment without sending a transaction:

var deployment = new StandardTokenDeployment { TotalSupply = Web3.Convert.ToWei(1000000) };
var estimatedGas = await handler.EstimateGasAsync(deployment);
Console.WriteLine($"Estimated gas: {estimatedGas.Value}");

Note: SendRequestAndWaitForReceiptAsync estimates gas automatically if you don't set Gas on the message — this step is only needed when you want to display costs to a user.

Deploy Without Code-Generated Classes

For quick prototyping when you have raw ABI and bytecode strings. Less safe — constructor argument types aren't checked at compile time:

var receipt = await web3.Eth.DeployContract.SendRequestAndWaitForReceiptAsync(
    abi, bytecode, account.Address,
    new Nethereum.Hex.HexTypes.HexBigInteger(3000000),
    null, null, constructorArg1, constructorArg2);

Multiple Constructor Parameters

Contracts often take multiple constructor arguments. Each maps to a property on the deployment class:

public class MyNFTDeployment : ContractDeploymentMessage
{
    public static string BYTECODE = "0x...";
    public MyNFTDeployment() : base(BYTECODE) { }

    [Parameter("string", "name", 1)]
    public string Name { get; set; }

    [Parameter("string", "symbol", 2)]
    public string Symbol { get; set; }

    [Parameter("uint256", "maxSupply", 3)]
    public BigInteger MaxSupply { get; set; }
}

var receipt = await handler.SendRequestAndWaitForReceiptAsync(
    new MyNFTDeployment { Name = "My NFT", Symbol = "MNFT", MaxSupply = 10000 });

Check Deployment Status

The receipt's Status tells you if the deployment succeeded. A status of 1 means success; 0 means the constructor reverted (often a require failure):

if (receipt.Status.Value == 1)
{
    Console.WriteLine($"Deployed at block {receipt.BlockNumber.Value}");
    Console.WriteLine($"Gas used: {receipt.GasUsed.Value}");
    Console.WriteLine($"Contract address: {receipt.ContractAddress}");
}

When to Use Which Approach

For full documentation, see: https://docs.nethereum.com/docs/smart-contracts/deploy-a-contract