The quickest way to start building on GIWA with Quicknode is to send a JSON-RPC request to your endpoint. This guide creates an endpoint and requests the latest GIWA Sepolia block number. Code samples are available in cURL and popular Ethereum libraries.

Get Your GIWA Endpoint

1

Criar uma Quicknode

Inscreve-te aqui, se ainda não o fizeste.

2

Aceda ao seu painel de controlo

Open the Endpoints dashboard from the left sidebar menu to manage all your blockchain endpoints

3

Criar um novo endpoint

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

4

Copie os URLs do seu fornecedor

Tenha a URL HTTP à mão. Vai precisar dela nas solicitações que se seguem.

Saiba mais sobre o painel de controlo

Para um guia detalhado do Quicknode do Quicknode , consulte o nosso guia

Envie o seu primeiro pedido

Your endpoint is ready. Use eth_blockNumber to return the latest block number. Select a language or SDK and send the request below.

cURL

1

Verificar a instalação do cURL

Most *nix based systems have cURL support out of the box. Open your terminal and check the cURL version by running the command below:

curl --versão

2

Send a JSON-RPC request

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

Sample Response

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

SDK

1

Configure o seu projeto

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 giwa-api-quickstart
cd giwa-api-quickstart
npm init -y

2

Instale o 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

Configure o seu projeto

Crie um novo diretório para o seu projeto em Python:

mkdir giwa-python-quickstart
cd giwa-python-quickstart

2

Criar e ativar um ambiente virtual

Criar um ambiente virtual para gerir dependências:

python3 -m venv venv
source venv/bin/activate

3

Pedidos de instalação

Instale a biblioteca `requests` para efetuar pedidos HTTP:

pip instalar requests

4

Crie um script em Python (app.py)

Create a Python file with the following code:

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

Executar o script

Execute your Python script:

python app.py

JavaScript

1

Configure o seu projeto

Create a new directory and initialize a Node.js project:

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

2

Create a JavaScript file (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

Executar o script

Execute your JavaScript script:

node app.js

Ruby

1

Configure o seu projeto

Crie um novo diretório para o seu projeto Ruby:

mkdir giwa-ruby-quickstart
cd giwa-ruby-quickstart

2

Verificar a instalação do Ruby

Verifique se o Ruby está instalado no seu sistema. Caso contrário, instale-o a partir de https://ruby-lang.org:

ruby --versão

3

Create a Ruby script (main.rb)

Create a main.rb file with the following code:

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

Executar o script

Execute your Ruby script to see the latest block number:

ruby main.rb

Vai

1

Configure o seu projeto

Create a new directory for your Go project:

mkdir giwa-go-quickstart
cd giwa-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)
    return
  }
  req.Header.Add("Content-Type", "application/json")

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

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

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

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

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

4

Executar o script

Execute your Go script to see the latest block number:

executa o ficheiro main.go

Ethers.js

1

Configure o seu projeto

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

mkdir giwa-ethers-quickstart
cd giwa-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

Configure o seu projeto

Create a new directory for your web3.py project:

mkdir giwa-web3py-quickstart
cd giwa-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

Configure o seu projeto

Create a new directory for your eth.rb project:

mkdir giwa-ethrb-quickstart
cd giwa-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

Create a Ruby script (main.rb)

Create a main.rb file with the following code:

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}"
fim

4

Executar o script

Execute your Ruby script to see the latest block number:

ruby main.rb

Ethgo

1

Configure o seu projeto

Create a new directory for your Ethgo project:

mkdir giwa-ethgo-quickstart
cd giwa-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 giwa-ethgo-quickstart
go get github.com/umbracle/ethgo
executar o comando «mod tidy»

3

Create a Go script (main.go)

Create a main.go file with the following code:

package main

import (
  "fmt"
  "registo"
  "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

Executar o script

Execute your Go script to see the latest block number:

executa o ficheiro main.go

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

Visão geral da API

Discover Supported GIWA APIs, Networks, Chain Configurations, and compatible Quicknode Products

Pontos de acesso do prestador

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

Endpoint

Proteja os seus terminais com autenticação por token, limitação de taxa, lista de permissões, JWT e as melhores práticas de segurança

Error Reference

Reference document for common GIWA RPC error codes and troubleshooting tips

Complementos

Discover endpoint add-ons that extend your GIWA development workflow

Guias

Explore comprehensive GIWA development guides and best practices to accelerate your blockchain application development