Deploy smart contract on Ronin

This guide covers adding the network to a browser wallet, then deploying a simple contract using Foundry and Hardhat — pick whichever you prefer.

Ronin is EVM-compatible, so contracts deploy with standard Ethereum tooling such as Foundry, Hardhat, and Remix. This guide covers adding Ronin to a wallet and deploying a first contract with Foundry and Hardhat through a GetBlock endpoint. Ronin verifies contracts through Sourcify rather than an Etherscan-style explorer.

Prerequisites

• A wallet holding RON for gas (see Add Network to Your Wallet below)

• A GetBlock access token from the GetBlock dashboard, used as <ACCESS-TOKEN> in the endpoint https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

• Node.js version 20 or later, for Hardhat

• A funded deployer address, on Saigon Testnet for testing (see Testnet Faucets)

Network Details

Property	Ronin Mainnet	Saigon Testnet
Chain ID	2020 (0x7e4)	202601 (0x31769)
RPC URL	https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/	https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
Currency Symbol	RON	RON
Block Explorer	app.roninchain.com/explorer	saigon-app.roninchain.com/explorer

Ronin is not pre-configured in MetaMask by default, and is best used with the Ronin Wallet browser extension. To use MetaMask, add Ronin manually or through an add-network button before it appears in the wallet.

Every command below defaults to Mainnet — replace environment variable values with testnet ones for a dry run before touching real funds.

Never commit a real private key. Use environment variables and prefer a throwaway deployer key for testing. Private keys committed to a public repo are drained within seconds by automated bots.

Add Network to Your Wallet

1

Open your wallet

Open the Ronin Wallet extension, or MetaMask.

2

Open the network menu

Click the network dropdown at the top of the wallet.

3

Add a network manually

Click Add network, then Add a network manually.

4

Enter the network details

Enter the network details from the Prerequisites section above.

5

Save and switch networks

Save and switch to the newly added network.

Deploy with Foundry

1

Install Foundry

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

2

Create a project

mkdir ronin-deploy && cd ronin-deploy
forge init

3

Create a contract

Create src/HelloRonin.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

contract HelloRonin {
    function hello() external pure returns (string memory) {
        return "Hello from Ronin";
    }
}

4

Deploy

export PRIVATE_KEY=<your-deployer-private-key>
export RONIN_RPC_URL=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

forge create src/HelloRonin.sol:HelloRonin \
  --rpc-url $RONIN_RPC_URL \
  --private-key $PRIVATE_KEY \
  --broadcast

5

Verify with Sourcify

Ronin uses Sourcify for contract verification, not an Etherscan-style API. Verify against Ronin's Sourcify server:

forge verify-contract <contract_address> \
  src/HelloRonin.sol:HelloRonin \
  --chain-id 2020 \
  --verifier sourcify \
  --verifier-url https://sourcify.roninchain.com/server

Then open the contract in the Ronin explorer and confirm the Contracts tab shows a verified checkmark.

Deploy with Hardhat

1

Create a project

mkdir ronin-deploy && cd ronin-deploy
npm init -y
npm install --save-dev hardhat
npx hardhat init

Select a JavaScript project when prompted.

2

Configure networks

hardhat.config.js

require('@nomicfoundation/hardhat-toolbox');

const PRIVATE_KEY = process.env.PRIVATE_KEY;

module.exports = {
  solidity: '0.8.28',
  networks: {
    ronin: {
      url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
      chainId: 2020,
      accounts: [PRIVATE_KEY]
    },
    saigon: {
      url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
      chainId: 202601,
      accounts: [PRIVATE_KEY]
    }
  }
};

3

Create a contract

Create contracts/HelloRonin.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

contract HelloRonin {
    function hello() external pure returns (string memory) {
        return "Hello from Ronin";
    }
}

4

Compile and deploy

Create scripts/deploy.js:

scripts/deploy.js

const hre = require('hardhat');

async function main() {
  const contract = await hre.ethers.deployContract('HelloRonin');
  await contract.waitForDeployment();
  console.log('HelloRonin deployed to:', await contract.getAddress());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Then compile and deploy:

npx hardhat compile
npx hardhat run scripts/deploy.js --network ronin

5

Verify with Sourcify

Publish the source to Ronin's Sourcify server:

npx hardhat --network ronin sourcify \
  --endpoint https://sourcify.roninchain.com/server

In the Ronin explorer, search for the contract, open the Contracts tab, and confirm the green verified checkmark.

Testnet Faucets

Saigon Testnet

• Ronin Faucet — dispenses Saigon test RON to a connected wallet, roughly 0.01 RON per day (verify)