Prerequisites

This guide provides clear instructions for developers on the supported Solidity versions and the necessary configurations needed to ensure your smart contracts are deployed on the Rootstock network. See the developer tools section for a list of tools to build on Rootstock.

Hackathon Info

Participating in a Rootstock hackathon or Workshop? View the Hackathon Resources section.

Solidity Version

• Supported solc version: 0.8.19

Node RPC

• Interact with Rootstock using the RPC API

Get an API Key

See how to setup the RPC API and get an API Key.

Connecting to a Wallet

Fill these values to connect to the Rootstock Mainnet or Testnet in MetaMask.

• See Configure MetaMask Wallet for Rootstock

Contract Addresses

• See the List of Contract Addresses on Rootstock

Derivation path

When using BIP-44-compatible wallet software, you will need to specify a derivation path.

Mainnet: m/44'/137'/0'/0/N
Testnet: m/44'/37310'/0'/0/N

Info

See Account based addresses section for more information or how to verify address ownership.

Install Hardhat

npm install --save-dev hardhat

Recommended

• Install hh autocomplete to use hh shorthand globally.

npm i -g hardhat-shorthand

• Use the Hardhat Starter Kit

• Learn how to write, interact, deploy, and test smart contracts on Rootstock using Hardhat or Foundry.

Install Foundry

Development Environments

You don't need to use both development environments (Hardhat and Foundry) together, you can use your favorite one.

To install Foundry in your system, run the following command:

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

This will install Foundryup. Simply follow the on-screen instructions, and the foundryup command will become available in your CLI.

Running foundryup will automatically install the latest (nightly) versions of the precompiled binaries: forge, cast, anvil, and chisel. For additional options, such as installing a specific version or commit, run foundryup --help.

Windows Users

If you’re using Windows, you’ll need to install and use Git BASH or WSL as your terminal, since Foundryup currently doesn’t support Powershell or Command Prompt (Cmd).

Command Line Tools

POSIX Compliant Shell

Windows

Standard terminals like cmd or PowerShell may not support some commands. We recommended installing Git for Windows for Git Bash, which provides a more UNIX-like experience. Here's a tutorial on Git Bash.

MacOS/Linux

Standard terminal.

Installing Node.js and NPM

NVM

• Node v18 or later.
  • For installation, use NVM install script.

Windows

1. Download the Node.js Installer from Node.js Downloads.
2. Run the installer and follow the on-screen instructions.
3. Open Command Prompt or PowerShell and check versions with node -v and npm -v.
   • See Posix Compliant Shell.

MacOS

1. Install Homebrew (if not installed):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)
2. Install Node.js and npm with brew install node
3. Check versions in Terminal with node -v and npm -v

Linux

1. Open a terminal.
2. Update package manager with sudo apt update
3. Install Node.js and npm with sudo apt install nodejs npm
4. Check versions in the terminal with node -v and npm -v

Optional Setup

• Foundry
• Remix