ethers.js

ethers.js is a JavaScript library that allows developers to interact with EVM-compatible blockchain networks.

You can use ethers.js to interact with smart contracts deployed on the RACE™ network.

---

Install​

To install ethers.js run the following command:

npm install --save ethers

Setup​

Before you can start using ethers.js, you need to import it into your project.

Add the following line of code to the top of your file to import ethers.js:

const ethers = require('ethers');

Connecting to RACE™​

You can connect to RACE™ by instantiating a new ethers.js JsonRpcProvider object with a RPC URL of the RACE™ network:

const ethers = require('ethers');

const url = 'https://racetestnet.io/';
const provider = new ethers.providers.JsonRpcProvider(url);

Reading data from the blockchain​

Once you have created a provider, you can use it to read data from the RACE™ network.

For example, you can use the getBlockNumber method to get the latest block:

async function getLatestBlock() {
  const latestBlock = await provider.getBlockNumber();
  console.log(latestBlock);
}

Writing data to the blockchain​

To write data to the RACE™ network, you need to create a Signer.

You can create a Signer by instantiating a new ethers.js Wallet object, providing it with a private key and Provider.

const privateKey = 'PRIVATE_KEY';
const signer = new ethers.Wallet(privateKey, provider);

INFO

PRIVATE_KEY is the private key of the wallet to use when creating the signer.

Interacting with smart contracts​

You can use ethers.js to interact with a smart contract on RACE™ by instantiating a Contract object using the ABI and address of a deployed contract:

const abi = [
… // ABI of deployed contract
];

const contractAddress = "CONTRACT_ADDRESS"

// read-only
const contract = new ethers.Contract(contractAddress, abi, provider);

For write-only contracts, provide a Signer object instead of a Provider object:

// write only
const contract = new ethers.Contract(contractAddress, abi, signer);

INFO

CONTRACT_ADDRESS is the address of the deployed contract.

Once you have created a Contract object, you can use it to call desired methods on the smart contract:

async function setValue(value) {
  const tx = await contract.set(value);
  console.log(tx.hash);
}

async function getValue() {
  const value = await contract.get();
  console.log(value.toString());
}