Familiarity with Linux/Javascript is essential.
Overview
Similar to Web3.js, the Ethers.js library offers a comprehensive suite of tools for interacting with Ethereum nodes using JavaScript. In addition, Darwinia provides an Ethereum-compatible API that supports JSON RPC invocations, making it fully compatible with the Ethers.js library. This compatibility enables developers to utilize the Ethers.js library to interact with a Darwinia node in a manner similar to interacting with an Ethereum node. This allows developers to leverage their existing knowledge and tools to build applications on the Darwinia network seamlessly.
Prerequisites
Install Solidity Compiler
The solc compiler is a JavaScript library used to retrieve the code and ABI metadata of a Solidity smart contract by compiling it. This allows developers to access the necessary information for interacting with the smart contract programmatically. Run the following command to install:
shellnpm install -g solc
Check the installed result by:
shellsolc --version
The output:
shellsolc, the solidity compiler commandline interface Version: 0.8.17+commit.8df45f5f.Linux.g++
Install Ethers.js
In this tutorial, we will explore the usage of Ethers.js by deploying a contract and performing various contract functionalities. The tutorial involves multiple script files, so let's create a new JavaScript project called
example-with-ethersjs
to organize and manage the code effectively. This project will serve as a workaround for implementing the Ethers.js functionality.shellmkdir example-with-ethersjs && cd example-with-ethersjs && npm init --y
Install the Web3.js by runing the following command:
shellnpm install ethers@5.7.2
Contract Interaction
The network provider used in this tutorial is the Pangolin Testnet. However, the concepts and techniques covered in this tutorial are applicable to other Darwinia networks as well.
Prepare Contract
Create a smart contract file by running this command:
shelltouch storage.sol
To showcase the interaction with the smart contract, we have prepared a simple Solidity smart contract. You can find the contract code pasted into the
storage.sol
file. This contract will serve as the basis for demonstrating how to interact with it using ethers.js.solidity// SPDX-License-Identifier: GPL-3.0 pragma solidity >=0.8.2 <0.9.0; contract Storage { uint256 number; /** * @dev Store value in variable * @param num value to store */ function store(uint256 num) public { number = num; } /** * @dev Return value * @return value of 'number' */ function retrieve() public view returns (uint256){ return number; } }
This contract is straightforward and easy to understand. It consists of two functionalities: storing a number and retrieving the updated number. Let's proceed to learn how to interact with this contract using ethers.js.
Generate Contract Metadata
When interacting with a contract using Ethers.js, it is essential to have the contract metadata. The toolchain relies on this metadata information to properly interact with the contract. To generate the metadata and store it in a
metadata.json
file, you can run the following command:shellsolc storage.sol --combined-json abi,bin,hashes --pretty-json > metadata.json
The output of
cat metadata.json
:json{ "contracts": { "storage.sol:Storage": { "abi": [ { "inputs": [], "name": "retrieve", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "num", "type": "uint256" } ], "name": "store", "outputs": [], "stateMutability": "nonpayable", "type": "function" } ], "bin": "608060405234801561001057600080fd5b50610150806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80632e64cec11461003b5780636057361d14610059575b600080fd5b610043610075565b60405161005091906100a1565b60405180910390f35b610073600480360381019061006e91906100ed565b61007e565b005b60008054905090565b8060008190555050565b6000819050919050565b61009b81610088565b82525050565b60006020820190506100b66000830184610092565b92915050565b600080fd5b6100ca81610088565b81146100d557600080fd5b50565b6000813590506100e7816100c1565b92915050565b600060208284031215610103576101026100bc565b5b6000610111848285016100d8565b9150509291505056fea264697066735822122084d3253ae949e222c0defd4cd0cd1238db9d84a3fee248e7cd91529d9a759ad164736f6c63430008110033", "hashes": { "retrieve()": "2e64cec1", "store(uint256)": "6057361d" } } }, "version": "0.8.17+commit.8df45f5f.Linux.g++" }
Deploy Storage Contract
Create a deploy script by running this command:
shellnode deploy.js
And paste the following content into it:
javascriptconst ethers = require("ethers"); const contractMetadata = require("../example-with-ethersjs/metadata.json"); // The test account const accountFrom = { address: "0x6Bc9543094D17f52CF6b419FB692797E48d275d0", privateKey: "0xd5cef12c5641455ad949c3ce8f9056478eeda53dcbade335b06467e8d6b2accc", } const provider = new ethers.providers.JsonRpcProvider('https://pangolin-rpc.darwinia.network'); const wallet = new ethers.Wallet(accountFrom.privateKey, provider); const abi = contractMetadata.contracts["storage.sol:Storage"].abi; const bin = contractMetadata.contracts["storage.sol:Storage"].bin; const deploy = async () => { console.log(`Attempting to deploy from account ${accountFrom.address}`); // Construct the contract instance const contract = new ethers.ContractFactory(abi, bin, wallet); let storage = await contract.deploy(); console.log(`Contract deployed at address: ${storage.address}`); }; deploy();
Start the deployment by running the command:
shellnode deploy.js
The output like this:
shellAttempting to deploy from account 0x6Bc9543094D17f52CF6b419FB692797E48d275d0 Contract deployed at address: 0xE175242B7509e32a18973Ab622Ea3349a6C47429
0xE175242B7509e32a18973Ab622Ea3349a6C47429
is the address of the deployed storage contract, as a unique identifier for that contract. It will be used later to store and retrieve the number.Store Number
Create a store script by running this command:
shelltouch store.js
Please paste the following content into the
store.js
file, ensuring that you have updated the contractAddress
in the script with the address of the contract you deployed.javascriptconst ethers = require("ethers"); const contractMetadata = require("../example-with-ethersjs/metadata.json"); // The test account const accountFrom = { address: "0x6Bc9543094D17f52CF6b419FB692797E48d275d0", privateKey: "0xd5cef12c5641455ad949c3ce8f9056478eeda53dcbade335b06467e8d6b2accc", } const provider = new ethers.providers.JsonRpcProvider('https://pangolin-rpc.darwinia.network'); const wallet = new ethers.Wallet(accountFrom.privateKey, provider); const abi = contractMetadata.contracts["storage.sol:Storage"].abi; // The contract address deployed in last step const contractAddress = '0xE175242B7509e32a18973Ab622Ea3349a6C47429'; const store = async () => { // Construct the contract instance= let storageContract = new ethers.Contract(contractAddress, abi, wallet); // Call store to update the number to 3 let transaction = await storageContract.store(3); let receipt = await transaction.wait(); console.log(`Tx successful with hash: ${receipt.transactionHash}`); }; store();
Run the script by the command:
shellnode store.js
The output:
shellTx successful with hash: 0x524f2647157635978feff15754400f36d93d2e4bc5f0b0119da0a671b666cd74
Retrieve Number
Create a retrieve script by running this command:
shelltouch retrieve.js
Please paste the following content into the
retrieve.js
file, ensuring that you have updated the contractAddress
in the script with the address of the contract you deployed.javascriptconst ethers = require("ethers"); const contractMetadata = require("../example-with-ethersjs/metadata.json"); const provider = new ethers.providers.JsonRpcProvider('https://pangolin-rpc.darwinia.network'); const abi = contractMetadata.contracts["storage.sol:Storage"].abi; // The contract address deployed in last step const contractAddress = '0xE175242B7509e32a18973Ab622Ea3349a6C47429'; const retrieve = async () => { // Construct the contract instance let storageContract = new ethers.Contract(contractAddress, abi, provider); // Call retrieve let number = await storageContract.retrieve(); console.log(`The current number stored is: ${number}`); }; retrieve();
Run the script by the command:
shellnode retrieve.js
The output:
shellThe current number stored is: 3