web3.js
introduction
web3.js is a JavaScript library that allows developers to interact with EVM-compatible blockchain networks like Klaytn. With Klaytn supporting features for Ethereum Equivalence, Ethereum tools such as web3.js can be used on Klaytn without any significant modifications.
Thus, developers can leverage this compatibility and use the web3.js library to interact with a Klaytn node.
In this guide, you'll learn how to use the web3.js library to send a transaction, read data from the blockchain and interact with an existing contract on the Klaytn Network.
Prerequisites
Code-Editor: a source-code editor such as VS-Code.
Metamask: used to deploy the contracts, sign transactions and interact with the contracts.
RPC Endpoint: you can get this from one of the supported Endpoint Providers.
Test KLAY from Faucet: fund your account with sufficient KLAY.
Setup Project
To get started, you need to create a project directory to house the files to be created in this guide.
Install web3.js
To install web3.js run the following command in your terminal:
Initialize web3.js
In this tutorial, we would be creating a bunch of scripts file to send transactions, read data from the blockchain, and also interact with existing smart contract. To get started, you need to know how to initialize web3.js for each of your script files.
Import web3
into your script file.
After successfully importing web3, you need to connect to Klaytn by instantiating a new web3.js object with an RPC URL of the Klaytn network. Add the code below to the existing code:
Further, you need to add your private key to sign transactions. Add the code below to the existing code:
Reading data from the blockchain
To read data from the blockchain, create a new read.js
file in your project folder by running this command:
After creating this file, initialize web3
as done in the initialize
section. In this section, you'll learn how to read data from the blockchain (e.g., blockNumber, KLAY balance).
To see this in action, paste the following code in your read.js
.
Output
To run the script and read data from the blockchain, you can run the following command in your terminal:
If the transaction was succesful, you'll see the block number and user’s KLAY balance been logged in your terminal.
Sending transaction to the blockchain
To send transaction to the blockchain, create a new send.js
file in your project folder by running this command:
After creating this file, initialize web3
as done in the initialize
section. In this section, you ll learn how to send transaction to the blockchain e.g send KLAY to an address.
To see this in action, paste the following code in your send.js
.
Output
To run the script and send data to the blockchain, you can run the following command in your terminal:
If the transaction was succesful, you'll see the transaction receipt been logged in your terminal.
Interact with smart contracts
To interact with an existing smart contract on Klaytn, create a new interact.js
file in your project folder by running this command:
After creating this file, initialize web3
as done in the initialize
section. In this section, you will use web3.js to interact with a smart contract on Klaytn by instantiating a Contract
object using the ABI and address of a deployed contract.
For the purpose of this guide, a simple_storage contract was compiled and deployed on Remix IDE. We will be sending a transaction to the contract by calling the store
function and also reading from it by calling the retrieve
function.
To see this in action, paste the following code in your interact.js
.
Output
To run the script and interact with smart contracts, you can run the following command in your terminal:
If the transaction was succesful, in your terminal you'll see the transaction hash and the value stored.
For more in-depth guide on web3.js, please refer to web3.js docs. Also, you can find the full implementation of the code for this guide on GitHub
Last updated