The quickest way to start building on Xai with Quicknode is by sending a JSON-RPC request to your endpoint. In this quickstart, you’ll create an endpoint, copy its provider URL, and make your first request. Code samples below use cURL and common languages.

Get Your Xai Endpoint

1

Ein Quicknode-Konto erstellen

Melde dich hier an, falls du das noch nicht getan hast.

2

Gehen Sie zu Ihrem Dashboard

Öffnen Sie das Endpunkte-Dashboard über das Menü in der linken Seitenleiste, um alle Ihre Blockchain-Endpunkte zu verwalten

3

Neuen Endpunkt erstellen

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

4

Kopieren Sie die URLs Ihres Anbieters

Halten Sie die HTTP-URL griffbereit. Sie werden sie in den folgenden Anfragen verwenden.

Erfahren Sie mehr über das Dashboard

Eine ausführliche Anleitung zur Nutzung des Quicknode-Dashboards finden Sie in unserem Leitfaden

Senden Sie Ihre erste Anfrage

Your endpoint is ready. Now, let's make your first call to the Xai network. We’ll use the eth_blockNumber Methode, die die aktuelle Blocknummer zurückgibt. Select your preferred language or SDK and follow the steps below to send your first request.

cURL

1

cURL-Installation überprüfen

Die meisten *nix-basierten Systeme unterstützen cURL standardmäßig. Öffnen Sie Ihr Terminal und überprüfen Sie die cURL-Version, indem Sie den folgenden Befehl ausführen:

curl --version

2

Eine JSON-RPC-Anfrage senden

Kopieren Sie den folgenden cURL-Befehl in Ihr Terminal und fügen Sie ihn ein, um die aktuelle Blocknummer abzurufen:

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

3

Beispielantwort

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

Quicknode-SDK

1

Richten Sie Ihr Projekt ein

Überprüfen Sie zunächst mit dem Befehl „node --version“, ob Node.js installiert ist. Falls nicht, laden Sie es unter https://nodejs.org herunter. Erstellen Sie anschließend ein neues Verzeichnis und initialisieren Sie ein Node.js-Projekt:

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

2

Installieren Sie das Quicknode-SDK

Installieren Sie das Quicknode-SDK-Paket:

npm install @quicknode/sdk

3

Erstellen Sie Ihre Hauptdatei

Erstellen Sie eine Datei „index.js“ für Ihren Code:

touch index.js

4

Füge diesen Code in deine Datei „index.js“ ein

Kopieren Sie diesen Code und fügen Sie ihn in Ihre Datei „index.js“ ein:

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

Führen Sie Ihr Projekt aus

Führen Sie Ihr Skript aus, um die aktuelle Blocknummer anzuzeigen:

node index.js

Python

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr Python-Projekt:

mkdir xai-python-quickstart
cd xai-python-quickstart

2

Eine virtuelle Umgebung erstellen und aktivieren

Erstellen Sie eine virtuelle Umgebung zur Verwaltung von Abhängigkeiten:

python3 -m venv venv
source venv/bin/activate

3

Installationsanfragen

Installieren Sie die Bibliothek „requests“ zum Absenden von HTTP-Anfragen:

pip install Requests

4

Erstellen Sie ein Python-Skript (app.py)

Erstellen Sie eine Python-Datei mit dem folgenden 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

Führen Sie das Skript aus

Führen Sie Ihr Python-Skript aus:

python app.py

JavaScript

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis und initialisieren Sie ein Node.js-Projekt:

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

2

Erstellen Sie eine JavaScript-Datei (app.js)

Erstellen Sie eine Datei „app.js“ mit dem folgenden Code (unter Verwendung der nativen „fetch“-Funktion, die ab Node.js 18 verfügbar ist):

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

Führen Sie das Skript aus

Führen Sie Ihr JavaScript-Skript aus:

Knoten app.js

Ruby

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr Ruby-Projekt:

mkdir xai-ruby-quickstart
cd xai-ruby-quickstart

2

Ruby-Installation überprüfen

Überprüfen Sie, ob Ruby auf Ihrem System installiert ist. Falls nicht, installieren Sie es unter https://ruby-lang.org:

ruby --version

3

Erstellen Sie ein Ruby-Skript (main.rb)

Erstellen Sie eine Datei „main.rb“ mit dem folgenden 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

Führen Sie das Skript aus

Führen Sie Ihr Ruby-Skript aus, um die aktuelle Blocknummer anzuzeigen:

Ruby main.rb

Los

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr Go-Projekt:

mkdir xai-go-quickstart
cd xai-go-quickstart

2

Go-Installation überprüfen

Überprüfen Sie, ob Go auf Ihrem System installiert ist. Falls nicht, installieren Sie es unter https://golang.org:

go version

3

Erstellen Sie ein Go-Skript (main.go)

Erstellen Sie eine Datei „main.go“ mit dem folgenden 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

Führen Sie das Skript aus

Führen Sie Ihr Go-Skript aus, um die aktuelle Blocknummer anzuzeigen:

go run main.go

Ethers.js

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis und initialisieren Sie ein Node.js-Projekt (vorausgesetzt, Node.js ist bereits installiert):

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

2

Installieren Sie ethers.js

Installieren Sie die Bibliothek „ethers.js“ für die Interaktion mit Ethereum:

npm install ethers

3

Erstellen Sie Ihre Hauptdatei (index.js)

Erstellen Sie eine Datei „index.js“ mit dem folgenden 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

Führen Sie Ihr Projekt aus

Führen Sie Ihr Skript aus, um die aktuelle Blocknummer anzuzeigen:

node index.js

Web3.py

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr web3.py-Projekt:

mkdir xai-web3py-quickstart
cd xai-web3py-quickstart

2

Installieren Sie web3.py (falls noch nicht installiert)

Überprüfen Sie mit `pip list | grep web3`, ob web3.py installiert ist. Falls es nicht gefunden wird, installieren Sie es:

pip install web3

3

Erstellen Sie ein Python-Skript (main.py)

Erstellen Sie eine Datei „main.py“ mit dem folgenden 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

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr eth.rb-Projekt:

mkdir xai-ethrb-quickstart
cd xai-ethrb-quickstart

2

Installieren Sie eth.rb (falls noch nicht installiert)

Überprüfen Sie mit `gem list eth`, ob eth.rb installiert ist. Falls es nicht gefunden wird, installieren Sie es:

Edelstein installieren eth

3

Erstellen Sie ein Ruby-Skript (main.rb)

Erstellen Sie eine Datei „main.rb“ mit dem folgenden 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}"
end

4

Führen Sie das Skript aus

Führen Sie Ihr Ruby-Skript aus, um die aktuelle Blocknummer anzuzeigen:

Ruby main.rb

Ethgo

1

Richten Sie Ihr Projekt ein

Erstellen Sie ein neues Verzeichnis für Ihr Ethgo-Projekt:

mkdir xai-ethgo-quickstart
cd xai-ethgo-quickstart

2

Go-Modul initialisieren und ethgo installieren

Erstellen Sie eine „go.mod“-Datei, um die Abhängigkeiten zu verwalten, und installieren Sie anschließend das ethgo-SDK:

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

3

Erstellen Sie ein Go-Skript (main.go)

Erstellen Sie eine Datei „main.go“ mit dem folgenden Code:

package main

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

Führen Sie das Skript aus

Führen Sie Ihr Go-Skript aus, um die aktuelle Blocknummer anzuzeigen:

go run main.go

Wenn Sie mehr über das Absenden von API-Anfragen erfahren möchten, sehen Sie sich unsere Anleitungen und Beispiel-Apps an.

API-Übersicht

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

Anbieter-Endpunkte

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

Endgerätesicherheit

Sichern Sie Ihre Endpunkte mit Token-Authentifizierung, Ratenbegrenzung, Whitelisting, JWT und bewährten Sicherheitsverfahren

Fehlerreferenz

Reference document for common Xai RPC error codes and troubleshooting tips

Marktplatz-Erweiterungen

Discover powerful add-ons and extensions to enhance your Xai development workflow

Wir ❤️ Feedback!

Wenn Sie Anregungen oder Fragen zu dieser Dokumentation haben, teilen Sie uns diese bitte mit. Wir freuen uns auf Ihre Rückmeldung!