Polygon zkEVM tooling

​

Interaction tools

​

MetaMask

On node access details, click Add to MetaMask.

​

Development tools

​

Hardhat

Configure Hardhat to deploy contracts and interact through your Polygon zkEVM nodes.

1. Install Hardhat and create a project.

2. Install the dotenv package to securely load your sensitive variables from a .env file

3. Create a new environment in hardhat.config.js:

   Copy

   require("@nomicfoundation/hardhat-toolbox");
   require('dotenv').config();
   
   module.exports = {
     solidity: "0.8.18",
     defaultNetwork: "zkEVM_testnet",
     networks: {
       zkEVM_testnet: {
           url: `${process.env.YOUR_CHAINSTACK_ENDPOINT}`,
           accounts: [process.env.YOUR_PRIVATE_KEY]
       },
   },
   };
   

​

web3.js

Build DApps using web3.js and Polygon zkEVM nodes deployed with Chainstack.

1. Install web3.js.
2. Connect over HTTP or WebSocket.

​

HTTPS

Use the HttpProvider object to connect to your node HTTPS endpoint and get the latest block number:

const Web3 = require('web3');

const web3 = new Web3(new Web3.providers.HttpProvider('YOUR_CHAINSTACK_ENDPOINT'));

web3.eth.getBlockNumber().then(console.log);

where YOUR_CHAINSTACK_ENDPOINT is your node HTTPS endpoint protected either with the key or password.

​

web3.py

Build DApps using web3.py and Polygon zkEVM nodes deployed with Chainstack.

1. Install web3.py.
2. Connect over HTTP or WebSocket. See also EVM node connection: HTTP vs WebSocket.

​

HTTPS

Use HTTPProvider to connect to your node endpoint and get the latest block number.

from web3 import Web3

web3 = Web3(Web3.HTTPProvider('YOUR_CHAINSTACK_ENDPOINT'))
print(web3.eth.block_number)

where

• YOUR_CHAINSTACK_ENDPOINT — your node HTTPS endpoint protected either with the key or password
• HOSTNAME — your node HTTPS endpoint hostname
• USERNAME — your node access username (for password-protected endpoints)
• PASSWORD — your node access password (for password-protected endpoints)

​

node.js

You can build a web app to query data using node.js and axios:

const axios = require("axios");

const payload = {
    jsonrpc: "2.0",
    id: 0,
    method: "eth_blockNumber",
    params: []

};

(async () => {
    const response = await axios.post(`YOUR_CHAINSTACK_ENDPOINT`, payload)
    console.log(response.data)
})();

• YOUR_CHAINSTACK_ENDPOINT — your Chainstack node endpoint protected either with the key or password. See node access details.
• query — your JSON-RPC query. In this case, to get the latest block number.

​

ethers.js

Build DApps using ethers.js and Polygon zkEVM nodes deployed with Chainstack.

1. Install ethers.js.
2. Connect over HTTPS or WebSocket. See also EVM node connection: HTTP vs WebSocket.

​

HTTPS

Use the JsonRpcProvider object to connect to your node endpoint and get the balance of any address:

const ethers = require('ethers');
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT ";
const provider = new ethers.JsonRpcProvider(NODE_URL, NETWORK_ID);
const eth_getBalance = async () => {
    const balance = await provider.getBalance("0x439356Ad40D2f2961c99FFED4453f482AEC453Af");
    console.log(balance);
  };
eth_getBalance()

where

• YOUR_CHAINSTACK_ENDPOINT — your node HTTPS endpoint protected either with the key or password

• NETWORK_ID — Polygon zkEVM network ID:

  • Mainnet: 1101
  • Testnet:1442

​

Brownie

1. Install Brownie.

2. Use the brownie networks add command with the node endpoint:

   Copy

   brownie networks add zkEVM ID name="NETWORK_NAME" host=YOUR_CHAINSTACK_ENDPOINT chainid=NETWORK_ID
   

   where

   • ID — any name that you will use as the network tag to run a deployment. For example, chainstack-testnet.
   • NETWORK_NAME — any name that you want to identify the network by in the list of networks. For example, zkEVM.
   • YOUR_CHAINSTACK_ENDPOINT — your node HTTPS or WSS endpoint protected either with the key or password
   • NETWORK_ID — Polygon zkEVM network ID:
     • Mainnet: 1101
     • Testnet: 1442

Example to run the deployment script:

brownie run deploy.py --network chainstack-testnet

​

Remix IDE

To make Remix IDE interact with the network through a zkEVM node deployed with Chainstack:

1. Get MetaMask and set it to interact through a Chainstack node. See Interacting through MetaMask.
2. In Remix IDE, navigate to the Deploy tab. Select Injected Provider - MetaMask in Environment.

This will engage MetaMask and make Remix IDE interact with the network through a Chainstack node.