The quickest way to start building on Starknet 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 are available in cURL as well as popular SDKs and programming languages.

Get Your Starknet Endpoint

1

Créez un compte Quicknode

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

2

Accédez à votre tableau de bord

Ouvrez le tableau de bord des endpoints depuis le menu latéral gauche pour gérer tous vos endpoints blockchain

3

Créez un nouvel endpoint

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

4

Copiez vos URL de fournisseur

Gardez l'URL HTTP à portée de main. Vous l'utiliserez dans vos requêtes ci-dessous.

En savoir plus sur le tableau de bord

Pour une présentation détaillée du tableau de bord Quicknode, consultez notre guide

Envoyer votre première requête

Your endpoint is ready. Now, let's make your first call to the Starknet blockchain. We'll use the starknet_blockNumber méthode qui renvoie le numéro du dernier bloc. Sélectionnez votre langage ou SDK préféré et suivez les étapes ci-dessous pour envoyer votre première requête.

cURL

1

Vérifier l'installation de cURL

La plupart des systèmes basés sur *nix prennent en charge cURL nativement. 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

Dans votre terminal, copiez-collez la commande cURL suivante pour récupérer le dernier numéro de bloc :

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

3

Exemple de réponse

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": 2004149
}

JavaScript

1

Configurer votre projet

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

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

2

Créez un fichier JavaScript (app.js)

Add the code into your JavaScript file and execute the file in your terminal with the `node fileName.js` to retrieve the current block number.

const https = require('https');

const data = JSON.stringify({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_blockNumber",
  "params": []
});

const options = {
  hostname: '{your-endpoint-name}.quiknode.pro',
  path: '/{your-token}/rpc/v0_8',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length
  }
};

const req = https.request(options, (res) => {
  let result = '';
  res.on('data', (chunk) => {
    result += chunk;
  });
  res.on('end', () => {
    console.log(result);
  });
});

req.on('error', (error) => {
  console.error('Error:', error);
});

req.write(data);
req.end();

3

Exécutez le script

Exécutez votre script JavaScript :

node app.js

Python

1

Configurer votre projet

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

mkdir starknet-python-quickstart
cd starknet-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 install requests

4

Créez un script Python (app.py)

To run the Python code below, add the code to a file and execute it with the `python file.py` command in your terminal window.

import requests
import json

url = "YOUR_QUICKNODE_ENDPOINT_URL/rpc/v0_8"

payload = json.dumps({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_blockNumber",
  "params": []
})

headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

5

Exécutez le script

Exécutez votre script Python :

python app.py

Ruby

1

Configurer votre projet

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

mkdir starknet-ruby-quickstart
cd starknet-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/rpc/v0_8")

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({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_blockNumber",
  "params": []
})

response = https.request(request)
result = JSON.parse(response.read_body)

puts "Block number: #{result["result"]}"

4

Exécutez le script

Execute your Ruby script to see the current block number:

ruby main.rb

Si vous souhaitez en savoir plus sur la création de requêtes API, consultez nos guides et nos exemples d'applications.

Présentation de l'API

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

Points d'accès du fournisseur

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

Sécurité des points de terminaison

Sécurisez vos points d'accès avec l'authentification par jeton, la limitation de débit, la liste blanche, le JWT et les meilleures pratiques de sécurité

Référence des erreurs

Reference document for common Starknet RPC error codes and troubleshooting tips

Modules complémentaires du Marketplace

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

Nous ❤️ les commentaires !

Si vous avez des commentaires ou des questions concernant cette documentation, faites-le nous savoir. Nous serions ravis de vous entendre !