Deploy a Smart Contract

This guide will walk you through the process of deploying a smart contract on the Unichain network.

Requirements

ETH on Unichain is required, see Funding a Wallet

1. The guide uses foundry

   for deployments. Install it by running:

   curl -L https://foundry.paradigm.xyz | bash

   To verify the installation:

   forge --version

2. Add Unichain to your foundry.toml

   [rpc_endpoints]
   unichain = "https://sepolia.unichain.org"

Steps to Deploy

Due to the EVM-equivalence of Unichain, foundry commands should work as expected. The major difference is the network URL. In most cases, using --rpc-url unichain is sufficient

1. Navigate to your smart contract project

   cd path/to/your/project

2. Deploying a smart contract

   Your private key should have ETH on the Unichain network. A transaction will be created, and requires a gas fee.

   forge create src/{YourContract}.sol:{ContractName} --rpc-url unichain --private-key {YourPrivateKey}

3. Contract Verification

   Obtain an API key from https://sepolia.uniscan.xyz

   There are two options to verify your contract:

   • During deployment
   • After deployment

   During deployment provide additional flags:

   --etherscan-api-key {API_KEY} --verify

   After deployment:

   forge verify-contract \
       --chain-id 1301 \
       --num-of-optimizations 200 \
       --watch \
       --constructor-args $(cast abi-encode "constructor(string,string,uint256,uint256)" "ForgeUSD" "FUSD" 18 1000000000000000000000) \
       --etherscan-api-key {your_etherscan_api_key} \
       --compiler-version {v0.8.20+commit.a1b79de}
       {the_contract_address} \
       src/{YourContract}.sol:{ContractName}

   forge verify-contract

Additional information here

or other deployment options

Example Deployment

See deploying an ERC-20 contract

Best Practices

• Verification

  Verifying during deployment is recommended, as compilation parameters are known during execution

• Scripting

  For complex deployments, such as deploying multiple related contracts, complex constructor arguments, or create & call patterns, it is recommended to use foundry's solidity scripting