zkSync Era tooling

Get started with a reliable zkSync Era RPC endpoint to use the tools below.

Interaction tools

MetaMask

On node access details, click Connect wallet.

Development tools

ZKsync Era runs standard EVM bytecode through its EVM Bytecode Interpreter, so for most new projects you can use standard Ethereum tooling — Hardhat, Foundry, ethers, or viem — pointed at your Chainstack ZKsync Era endpoint, exactly like any other EVM chain. The EraVM-native workflow below (the hardhat-zksync plugin suite with the zksolc compiler) remains for contracts that target EraVM directly.

zksync-ethers SDK

See zksync-ethers.

Hardhat (EraVM-native)

To compile and deploy contracts that target EraVM natively, configure the hardhat-zksync plugin suite to build and interact through your zkSync Era nodes. For standard EVM contracts, use a normal Hardhat setup pointed at your Chainstack endpoint instead (see the note above).

Install Hardhat and create a project.

yarn add -D typescript ts-node ethers@^5.7.2 zksync-web3 hardhat @matterlabs/hardhat-zksync-solc @matterlabs/hardhat-zksync-deploy @matterlabs/zksync-contracts @openzeppelin/contracts @matterlabs/hardhat-zksync-verify @nomicfoundation/hardhat-verify dotenv

Install the dotenv package to securely load your sensitive variables from a .env file
Create a new environment in hardhat.config.ts:

import { HardhatUserConfig } from "hardhat/config";
require("dotenv").config();

import "@matterlabs/hardhat-zksync-deploy";
import "@matterlabs/hardhat-zksync-solc";
import "@matterlabs/hardhat-zksync-verify";

const config: HardhatUserConfig = {
  zksolc: {
    version: "1.3.13", // Use latest available
    compilerSource: "binary",
    settings: {},
  },
  defaultNetwork: "zkSyncTestnet",
  networks: {
    hardhat: {
      zksync: true,
    },
    zkSyncTestnet: {
      url: process.env.ZKSYNC_TESTNET_CHAINSTACK,
      ethNetwork: "sepolia",
      zksync: true,
      verifyURL:
        "https://explorer.sepolia.era.zksync.dev/contract_verification",
    },
  },
  solidity: {
    version: "0.8.17",
  },
};

export default config;

Follow the tutorial for a better understanding: zkSync Era∎: Develop a custom paymaster contract

web3.py

Build DApps using web3.py and zkSync Era nodes deployed with Chainstack.

Install web3.py.
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)

from web3 import Web3

web3 = Web3(Web3.HTTPProvider('https://%s:%s@%s'% ("USERNAME", "PASSWORD", "HOSTNAME")))
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)

WSS

Use the WebsocketProvider object to connect to your node WSS endpoint and get the latest block number.

from web3 import Web3

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

from web3 import Web3

web3 = Web3(Web3.WebsocketProvider('wss://%s:%s@%s'% ("USERNAME", "PASSWORD", "HOSTNAME")))
print(web3.eth.block_number)

where

YOUR_CHAINSTACK_ENDPOINT — your node WSS endpoint protected either with the key or password
HOSTNAME — your node WSS 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 zkSync Era nodes deployed with Chainstack.

Install ethers.js.
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 — zkSync Era network ID:
- Mainnet: 324
- Sepolia Testnet:300

WebSocket

Use the WebSocketProvider object to connect to your node WSS endpoint and get the latest block number:

const ethers = require('ethers');
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT";
const provider = new ethers.WebSocketProvider(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 WSS endpoint protected either with the key or password
NETWORK_ID — zkSync Era network ID:
- Mainnet: 324
- Sepolia Testnet:300

Remix IDE

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

Get MetaMask and set it to interact through a Chainstack node. See Interacting through MetaMask.
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.

Platform

Pricing

Core

Add-ons

Security

Migrate to Chainstack

Web3 [de]coded

MCP servers

Marketplace

Chainstack Compare

Chainstack ChatGPT plugin

Chainstack DLP browser extension

Protocols

Advanced APIs

Tooling

Interaction tools

MetaMask

Development tools

zksync-ethers SDK

Hardhat (EraVM-native)

web3.py

HTTPS

WSS

node.js

ethers.js

HTTPS

WebSocket

Remix IDE

​Interaction tools

​MetaMask

​Development tools

​zksync-ethers SDK

​Hardhat (EraVM-native)

​web3.py

​HTTPS

​WSS

​node.js

​ethers.js

​HTTPS

​WebSocket

​Remix IDE

Interaction tools

MetaMask

Development tools

zksync-ethers SDK

Hardhat (EraVM-native)

web3.py

HTTPS

WSS

node.js

ethers.js

HTTPS

WebSocket

Remix IDE