The quickest way to start building on Immutable zkEVM with Quicknode is by sending a JSON-RPC request to your endpoint. In this guide, you’ll create an endpoint, copy its provider URL, and make your first request. Code samples are available in cURL as well as popular SDKs and programming languages.

Get Your Immutable zkEVM Endpoint

1

Créer un Quicknode

Inscrivez-vous ici si ce n'est pas déjà fait.

2

Accédez à votre tableau de bord

Ouvrez le tableau de bord « Endpoints » dans le menu de la barre latérale gauche pour gérer tous vos points de terminaison blockchain.

3

Créer un nouveau endpoint

Click Create an Endpoint in the top-right corner, select Immutable zkEVM as your blockchain, then select your preferred network

4

Copiez les URL de vos fournisseurs

Gardez l'URL HTTP à portée de main. Vous en aurez besoin dans les requêtes ci-dessous.

En savoir plus sur le tableau de bord

Pour découvrir en détail le Quicknode , consultez notre guide

Envoyez votre première demande

Your endpoint is ready. Now, let's make your first call to Immutable zkEVM. We’ll use the eth_blockNumber method, which returns the latest block number. Select your preferred language or tool and follow the steps to send your request.

cURL

1

Vérifier l'installation de cURL

La plupart des systèmes basés sur *nix prennent en charge cURL dès leur installation. Ouvrez votre terminal et vérifiez la version de cURL en exécutant la commande ci-dessous :

curl --version

2

Envoyer une requête JSON-RPC

In your terminal, copy and paste the following cURL command to retrieve the latest block number:

curl -X POST YOUR_QUICKNODE_ENDPOINT_URL/ \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

3

Exemple de réponse

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1234567"
}

SDK

1

Configurez votre projet

First, verify Node.js is installed with node --version. If not installed, download it from https://nodejs.org. Then create a new directory and initialize a Node.js project:

mkdir immutable_zkevm-api-quickstart
cd immutable_zkevm-api-quickstart
npm init -y

2

Installez le SDK

Install the SDK package:

npm install @quicknode/sdk

3

Create your main file

Create an index.js file for your code:

touch index.js

4

Add this code to your index.js file

Copy and paste this code into your index.js file:

const { Core } = require('@quicknode/sdk');

const main = async () => {
  const core = new Core({
    endpointUrl: 'YOUR_QUICKNODE_ENDPOINT_URL/',
  });

  const blockNumber = await core.client.request({
    method: 'eth_blockNumber',
  });

  console.log('Block number:', parseInt(blockNumber, 16));
};

main();

5

Run your project

Execute your script to see the latest block number:

node index.js

Python

1

Configurez votre projet

Créez un nouveau répertoire pour votre projet Python :

mkdir immutable_zkevm-python-quickstart
cd immutable_zkevm-python-quickstart

2

Créer et activer un environnement virtuel

Créer un environnement virtuel pour gérer les dépendances :

python3 -m venv venv
source venv/bin/activate

3

Demandes d'installation

Installez la bibliothèque « requests » pour effectuer des requêtes HTTP :

pip installer requests

4

Créez un script Python (app.py)

Créez un fichier Python contenant le code suivant :

import requests
import json

# Your Quicknode endpoint URL
endpoint_url = "YOUR_QUICKNODE_ENDPOINT_URL/"

# JSON-RPC request payload
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_blockNumber",
    "params": []
}

# Make the request
response = requests.post(endpoint_url, json=payload)
result = response.json()

print("Latest block number (hex):", result["result"])
print("Latest block number (decimal):", int(result["result"], 16))

5

Exécutez le script

Exécutez votre script Python :

python app.py

JavaScript

1

Configurez votre projet

Créez un nouveau répertoire et lancez un projet Node.js :

mkdir immutable_zkevm-js-quickstart
cd immutable_zkevm-js-quickstart
npm init -y

2

Créez un fichier JavaScript (app.js)

Create an app.js file with the following code (using native fetch available in Node.js 18+):

const url = 'YOUR_QUICKNODE_ENDPOINT_URL/';
const options = {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_blockNumber',
    params: [],
    id: 1
  })
};

async function main() {
  try {
    const response = await fetch(url, options);
    const data = await response.json();
    console.log('Block Number (hex):', data.result);
    console.log('Block Number (decimal):', parseInt(data.result, 16));
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

3

Exécutez le script

Exécutez votre script JavaScript :

node app.js

Ruby

1

Configurez votre projet

Créez un nouveau répertoire pour votre projet Ruby :

mkdir immutable_zkevm-ruby-quickstart
cd immutable_zkevm-ruby-quickstart

2

Vérifier l'installation de Ruby

Vérifiez que Ruby est bien installé sur votre système. Si ce n'est pas le cas, installez-le à partir du site https://ruby-lang.org :

ruby --version

3

Créer un script Ruby (main.rb)

Créez un fichier main.rb contenant le code suivant :

require "uri"
require "json"
require "net/http"

url = URI("YOUR_QUICKNODE_ENDPOINT_URL/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "eth_blockNumber",
  "params": [],
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
result = JSON.parse(response.read_body)
hex_result = result["result"]
decimal_result = hex_result.to_i(16)
puts "Block number (hex): #{hex_result}"
puts "Block number (decimal): #{decimal_result}"

4

Exécutez le script

Execute your Ruby script to see the latest block number:

ruby main.rb

Aller

1

Configurez votre projet

Create a new directory for your Go project:

mkdir immutable_zkevm-go-quickstart
cd immutable_zkevm-go-quickstart

2

Check Go installation

Verify Go is installed on your system. If not, install it from https://golang.org:

go version

3

Create a Go script (main.go)

Create a main.go file with the following code:

package main

import (
  « encoding/json »
  « fmt »
  "strings"
  "net/http"
  "io/ioutil"
  "strconv"
)

type Response struct {
  Result string `json:"result"`
}

func main() {
  url := "YOUR_QUICKNODE_ENDPOINT_URL/"
  method := "POST"

  payload := strings.NewReader(`{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}`)

  client := &http.Client{}
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    retour
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    retour
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    retour
  }

  var response Response
  err = json.Unmarshal(body, &response)
  if err != nil {
    fmt.Println("Error parsing JSON:", err)
    retour
  }

  // Convert hex to decimal
  blockNumber, err := strconv.ParseInt(response.Result, 0, 64)
  if err != nil {
    fmt.Println("Error converting hex to decimal:", err)
    retour
  }

  fmt.Printf("Block number (hex): %s\n", response.Result)
  fmt.Printf("Block number (decimal): %d\n", blockNumber)
}

4

Exécutez le script

Execute your Go script to see the latest block number:

go run main.go

Ethers.js

1

Configurez votre projet

Create a new directory and initialize a Node.js project (assumes Node.js is already installed):

mkdir immutable_zkevm-ethers-quickstart
cd immutable_zkevm-ethers-quickstart
npm init -y
npm pkg set type=module

2

Install ethers.js

Install the ethers.js library for Ethereum interaction:

npm install ethers

3

Create your main file (index.js)

Create an index.js file with the following code:

import { ethers } from "ethers";

(async () => {
  const provider = new ethers.JsonRpcProvider("YOUR_QUICKNODE_ENDPOINT_URL/");
  const blockNum = await provider.getBlockNumber();
  console.log('Current block number (decimal):', blockNum);
  console.log('Block number (hex):', '0x' + blockNum.toString(16));
})();

4

Run your project

Execute your script to see the latest block number:

node index.js

Web3.py

1

Configurez votre projet

Create a new directory for your web3.py project:

mkdir immutable_zkevm-web3py-quickstart
cd immutable_zkevm-web3py-quickstart

2

Install web3.py (if not already installed)

Check if web3.py is installed with `pip list | grep web3`. If not found, install it:

pip install web3

3

Create a Python script (main.py)

Create a main.py file with the following code:

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("YOUR_QUICKNODE_ENDPOINT_URL/"))

try:
  latest_block_number = w3.eth.block_number
  print(f"Latest Block Number: {latest_block_number}")
  print(f"Block number (hex): {hex(latest_block_number)}")
except Exception as e:
  print(f"Error: {e}")

Eth.rb

1

Configurez votre projet

Create a new directory for your eth.rb project:

mkdir immutable_zkevm-ethrb-quickstart
cd immutable_zkevm-ethrb-quickstart

2

Install eth.rb (if not already installed)

Check if eth.rb is installed with `gem list eth`. If not found, install it:

gem install eth

3

Créer un script Ruby (main.rb)

Créez un fichier main.rb contenant le code suivant :

require 'eth'

client = Eth::Client.create "YOUR_QUICKNODE_ENDPOINT_URL/"

begin
  block_number = client.eth_block_number
  hex_result = block_number["result"]
  decimal_result = hex_result.to_i(16)
  puts "Block number (hex): #{hex_result}"
  puts "Block number (decimal): #{decimal_result}"
rescue => e
  puts "Error: #{e.message}"
fin

4

Exécutez le script

Execute your Ruby script to see the latest block number:

ruby main.rb

Ethgo

1

Configurez votre projet

Create a new directory for your Ethgo project:

mkdir immutable_zkevm-ethgo-quickstart
cd immutable_zkevm-ethgo-quickstart

2

Initialize Go module and install ethgo

Initialize a go.mod file to track dependencies, then install the ethgo SDK:

go mod init immutable_zkevm-ethgo-quickstart
go get github.com/umbracle/ethgo
go mod tidy

3

Create a Go script (main.go)

Create a main.go file with the following code:

package main

import (
  « fmt »
  « journal »
  "github.com/umbracle/ethgo/jsonrpc"
)

func main() {
  client, err := jsonrpc.NewClient("YOUR_QUICKNODE_ENDPOINT_URL/")
  if err != nil {
    log.Fatalf("Failed to connect to Ethereum: %v", err)
  }

  blockNumber, err := client.Eth().BlockNumber()
  if err != nil {
    log.Fatalf("Failed to get latest block number: %v", err)
  }

  fmt.Printf("Latest block number (decimal): %d\n", blockNumber)
  fmt.Printf("Latest block number (hex): 0x%x\n", blockNumber)
}

4

Exécutez le script

Execute your Go script to see the latest block number:

go run main.go

If you want to continue learning about making API requests, check out our guides and sample apps.

Présentation de l'API

Discover Supported Immutable zkEVM APIs, Networks, Chain Configurations, and compatible Quicknode Products

Points de terminaison des fournisseurs

Learn how to set up and configure your Immutable zkEVM RPC endpoints for development and production use

Endpoint

Sécurisez vos terminaux grâce à l'authentification par jeton, la limitation de débit, les listes blanches, les jetons JWT et les meilleures pratiques en matière de sécurité

Error Reference

Reference document for common Immutable zkEVM RPC error codes and troubleshooting tips

Modules complémentaires

Discover endpoint add-ons that extend your Immutable zkEVM development workflow