Deploy a smart contract using Hardhat

Overview

This tutorial describes how to deploy a sample smart contract on the Saigon testnet and interact with it using the Ronin app. Additionally, the tutorial describes how to verify a smart contract using the Ronin Sourcify service.

Prerequisites

A Hardhat project. If you are not familiar with Hardhat, follow the official Hardhat tutorial.
npm or yarn for package installation. This tutorial uses yarn.
A Ronin Wallet browser extension.

Step 1. Install hardhat-deploy

The hardhat-deploy is a Hardhat plugin used for deploying smart contracts on any network.

In your Hardhat project, install hardhat-deploy:
```
yarn add --dev hardhat-deploy
```
To enable hardhat-deploy, add the following line to your hardhat.config.js file:
```
require('hardhat-deploy')
```

Step 2. Set up the environment

To deploy your contract onto the Saigon testnet and then the Ronin mainnet, provide the network information to Hardhat.

In the hardhat.config.js file, add a networks object with the following code:

hardhat.config.js
module.exports = {
  solidity: "0.8.24",
  networks: {
    ronin: {
      chainId: 2020,
      url: 'https://api.roninchain.com/rpc',
    },
    saigon: {
      chainId: 2021,
      url: 'https://saigon-testnet.roninchain.com/rpc',
    },
  }
};

Step 3. Set up a deployer account

To deploy the smart contract, you need a deployer account with some RON to cover transaction gas fees.

In the hardhat.config.js file, add a namedAccounts object with the following code:

hardhat.config.js
module.exports = {
  solidity: "0.8.24",
  namedAccounts: {
    deployer: 'privatekey://<your deployer private key>',
  },
  networks: {
    ronin: {
      chainId: 2020,
      url: 'https://api.roninchain.com/rpc',
    },
    saigon: {
      chainId: 2021,
      url: 'https://saigon-testnet.roninchain.com/rpc',
    },
  }
};

Retrieve the private key in your Ronin Wallet browser extension:
1. Open the extension, and at the top right corner, click the profile icon.
2. Click Manage. You'll see a list of your accounts.
3. Select the account from which you wish to deploy the contract, then click View private key, and then enter your password.
Copy your private key and paste it in the namedAccounts object.
Top up your Saigon testnet deployer account with RON to cover the gas fees using the Ronin Faucet.

info

By default, the Saigon testnet network doesn't appear in Ronin Wallet. To make it visible, you need to enable it in the Ronin Wallet extension. Follow the steps in the Accessing Saigon Testnet guide.

Step 4. Write a deployment script

In your project's root directory, create a sub-directory for a deployment script:
```
mkdir deploy
```

Create a file called 1_deploy_token.js and paste the following code:

1_deploy_token.js
const func = async function (hre) {
  const { deployments, getNamedAccounts } = hre;
  const { deploy } = deployments;

  const { deployer } = await getNamedAccounts();

  await deploy('Token', {
    from: deployer,
    args: [],
    log: true,
  });
};
module.exports = func;
func.tags = ['Token'];

Step 5. Deploy the contract on the Saigon testnet

Now that you are ready to deploy, run the following command to deploy your smart contract:

yarn hardhat deploy --network saigon

You should see output with the deployed address similar to this:

deploying "Token" (tx: 0x6a3ecf86a07cbde9505bdfc233b9949a276ee54c04bc52269c161e9aad128d8b)...: deployed at 0x2D7b763d4A86dd105d8878f31993c7995e9261A1 with 686956 gas
✨  Done in 16.14s.

Copy the contract address. In the preceding example, our contract address is 0x2D7b763d4A86dd105d8878f31993c7995e9261A1.
Open the Saigon testnet explorer and paste your contract address in the search field.
To view your contract, select it in the list.

Step 6. Verify the contract using Ronin Sourcify

Although this step is optional, verifying your smart contract and publishing its source code can build trust for your app. The Ronin network uses Sourcify to make this task easier.

To publish the source code of your contract to Sourcify, run the following command:

yarn hardhat --network saigon sourcify --endpoint https://sourcify.roninchain.com/server

In the Saigon testnet explorer, search for your contract, then select the Contracts tab, and then notice the green checkmark. Your contract is successfully verified.

Overview​

Prerequisites​

Step 1. Install hardhat-deploy​

Step 2. Set up the environment​

Step 3. Set up a deployer account​

Step 4. Write a deployment script​

Step 5. Deploy the contract on the Saigon testnet​

Step 6. Verify the contract using Ronin Sourcify​

See also​