Passer au contenu principal

Bien débuter avec le développement Ethereum

javascriptethers.jsnœudsrequêtesalchemy
Débutant
Elan Halpern
Moyen(opens in a new tab)
30 octobre 2020
5 minutes de lecture minute read

Logos Ethereum et Alchemy

Ceci est un guide pour les débutants qui souhaitent se lancer dans le développement Ethereum. Pour ce tutoriel, nous allons utiliser Alchemy(opens in a new tab), la principale plateforme de développement blockchain qui sert des millions d'utilisateurs parmi 70 % des principales applications blockchain, dont Maker, 0x, MyEtherWallet, Dharma et Kyber. Alchemy va nous permettre d'accéder à un point de terminaison API sur la chaîne Ethereum afin que nous puissions lire et écrire des transactions.

Nous vous guiderons à travers toutes les étapes, de votre inscription sur Alchemy à votre premier script Web3 ! Aucune expérience préalable dans le développement de blockchain n'est requise !

1. Créez votre compte Alchemy gratuit

Il est très facile de créer un compte sur Alchemy. Inscrivez-vous gratuitement ici(opens in a new tab).

2. Créer une application Alchemy

Pour communiquer avec la chaîne Ethereum et utiliser les services d'Alchemy, vous aurez besoin d'une clé d'API pour authentifier vos requêtes.

Vous pouvez créer vos clés API depuis le tableau de bord(opens in a new tab). Pour créer un nouvelle clé, cliquez sur « Créer une application » comme indiqué ci-dessous :

Un grand merci à ShapeShift(opens in a new tab) de nous laisser utiliser leur tableau de bord à titre d'exemple !

Tableau de bord Alchemy

Remplissez les détails sous « Créer une application » pour obtenir votre nouvelle clé. Vous pouvez également voir les applications que vous avez faites précédemment et celles faites par votre équipe ici. Tirez les clés existantes en cliquant sur « Voir la clé » pour n'importe quelle application.

Créer une application avec Alchemy : capture d'écran

Vous pouvez également extraire les clés API existantes en passant la souris sur « Apps » et en en sélectionnant une. Vous pouvez « Voir la clé » ici, ainsi que « Modifier l'application » pour mettre des domaines spécifiques sur la liste blanche, voir plusieurs outils de développement et consulter les analyses.

Gif montrant à un utilisateur comment tirer des clés d'API

3. Faire une demande en ligne de commande

Interagissez avec la blockchain Ethereum via Alchemy en utilisant JSON-RPC et curl.

Pour les demandes manuelles, nous recommandons d'interagir avec les JSON-RPC via des demandes POST. Il suffit de passer l'en-tête Content-Type : application/json et votre requête comme corps POST avec les champs suivants :

  • jsonrpc : La version de JSON-RPC - actuellement, seule 2.0 est supportée.
  • méthode : La méthode de l'API de l'ETH. Voir la référence API.(opens in a new tab)
  • params : Une liste de paramètres à transmettre à la méthode.
  • id : L'ID de votre demande. Sera retourné par la réponse afin que vous puissiez garder la trace de la demande à laquelle une réponse appartient.

Voici un exemple que vous pouvez exécuter à partir de la ligne de commande pour obtenir le prix actuel du gaz :

curl https://eth-mainnet.alchemyapi.io/v2/demo \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'

REMARQUE : Remplacez https://eth-mainnet.alchemyapi.io/v2/demo(opens in a new tab) par votre propre clé API https://eth-mainnet.alchemyapi.io/v2/**votre-cle-api.

Résultats :

1{ "id": 73,"jsonrpc": "2.0","result": "0x09184e72a000" // 10000000000000 }
Copier

4. Configurer votre client Web3

Si vous avez un client existant, changez votre URL actuelle de fournisseur de nœuds en une URL Alchemy avec votre clé API : "https://eth-mainnet.alchemyapi.io/v2/your-api-key"

NOTE : Les scripts ci-dessous doivent être exécutés dans un contexte de nœud ou sauvegardé dans un fichier, et non exécutés en ligne de commande. Si vous n'avez pas encore installé Node ou npm, consultez ce rapide guide d'installation pour macs(opens in a new tab).

De nombreuses bibliothèques Web3(opens in a new tab) peuvent être intégrées à Alchemy, cependant, nous recommandons d'utiliser Alchemy Web3(opens in a new tab), un remplacement drop-in pour Web3.js, construit et configuré pour fonctionner de façon transparente avec Alchemy. Cela présente de nombreux avantages, comme les tentatives automatiques et la prise en charge robuste de WebSocket.

Pour installer AlchemyWeb3.js, accédez au répertoire de votre projet et exécutez :

Avec Yarn :

1yarn add @alch/alchemy-web3

Avec NPM :

1npm install @alch/alchemy-web3

Pour interagir avec l'infrastructure de nœuds d'Alchemy, exécutez en NodeJS ou ajoutez ceci à un fichier JavaScript :

1const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
2const web3 = createAlchemyWeb3(
3 "https://eth-mainnet.alchemyapi.io/v2/votre-clé-api"
4)
Copier

5. Écrivez votre premier script Web3 !

Maintenant pour nous salir les mains avec un peu de programmation Web3, nous allons écrire un script simple qui affiche le dernier numéro de bloc du réseau principal Ethereum.

1. Si vous ne l'avez pas déjà fait, dans votre terminal, créez un nouveau répertoire de projet et cd dedans :

1mkdir web3-example
2cd web3-example

2. Installez la dépendance Alchemy Web3 (ou toute dépendance Web3) dans votre projet si vous ne l'avez pas déjà fait :

1npm install @alch/alchemy-web3

3. Créez un fichier nommé index.js et ajoutez le contenu suivant :

Vous devrez remplacer demo avec votre clé API Alchemy HTTP.

1async function main() {
2 const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
3 const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo")
4 const blockNumber = await web3.eth.getBlockNumber()
5 console.log("The latest block number is " + blockNumber)
6}
7main()
Copier

Vous n'êtes pas familiarisé avec l'asynchronisme ? Consultez ce Medium post(opens in a new tab).

4. Exécutez-le dans votre terminal en utilisant le nœud

1node index.js

5. Vous devriez maintenant voir apparaître le dernier numéro de bloc dans votre console !

1The latest block number is 11043912

Wahou ! Félicitations ! Vous venez de rédiger votre premier script Web3 avec Alchemy 🎉

Vous ne savez pas quoi faire ensuite ? Essayez de déployer votre premier contrat intelligent et mettez la main à la pâte avec un peu de programmation Solidity dans notre Guide de contrats intelligents « Hello World »(opens in a new tab), ou testez vos connaissances avec le Tableau de bord de démonstration(opens in a new tab) !

S'inscrire gratuitement à Alchemy(opens in a new tab), consulter notre documentation(opens in a new tab), et pour les dernières nouvelles, nous suivre sur Twitter(opens in a new tab).

Dernière modification: @phrobinet(opens in a new tab), 15 août 2023

Ce tutoriel vous a été utile ?