Comment interagir avec un contrat intelligent à l'aide de Web3.js?

web3.js permet aux développeurs d'interagir avec les contrats intelligents Ethereum en fournissant des outils pour lire des données, envoyer des transactions et écouter les événements via des connexions HTTP, IPC ou WebSocket.

Jul 23, 2025 at 03:21 pm

Qu'est-ce que Web3.js et pourquoi est-il utilisé pour l'interaction des contrats intelligents?

Web3.js est une collection de bibliothèques qui permettent aux développeurs d'interagir avec un nœud Ethereum local ou distant à l'aide de HTTP, IPC ou WebSocket. Il fournit un moyen pratique de communiquer avec la blockchain Ethereum, permettant aux développeurs d'envoyer des transactions, de lire les données de la blockchain et d'interagir avec les contrats intelligents déployés .

Les contrats intelligents sont des accords d'auto-exécution avec les termes directement écrits en code. Ils s'exécutent sur la machine virtuelle Ethereum (EVM) et sont accessibles via des comptes externes ou d'autres contrats. Pour effectuer des actions sur un contrat intelligent, comme l'appel des fonctions ou l'envoi d'éther - Web3.js offre une API robuste et flexible. Cela en fait un outil préféré pour les développeurs créant des applications décentralisées (DAPP) qui nécessitent une interaction backend avec le réseau Ethereum.

Configuration de l'environnement pour l'intégration Web3.js

Avant d'interagir avec un contrat intelligent, il est essentiel de configurer correctement l'environnement de développement. La première étape consiste à installer Web3.js dans votre projet. Cela peut être fait en utilisant NPM:

 npm install web3

Une fois installé, vous pouvez importer et initialiser l'objet Web3 dans votre fichier JavaScript. L'objet web3 se connecte à un nœud Ethereum, qui peut être un nœud local ou un éloigné comme infura ou alchimie .

 const Web3 = require('web3');
 const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');

Pour interagir avec un contrat intelligent spécifique, vous aurez besoin de l' adresse du contrat et de l' ABI (interface binaire d'application) . L'ABI est un fichier JSON qui décrit les fonctions, les événements et les paramètres du contrat. Il agit comme une interface entre le contrat intelligent et votre application.

Connexion à un contrat intelligent

Après avoir configuré l'environnement, l'étape suivante consiste à se connecter au contrat intelligent à l'aide de son ABI et de son adresse. Cela se fait en créant une instance de contrat dans web3.js.

 const contractAddress = '0x...'; // Replace with your contract address
 const abi = [...]; // Replace with your contract's ABI const Contract = New Web3.eth.Contract (ABI, contractAddress);

Une fois l'instance de contrat créée, vous pouvez appeler ses méthodes ou lui envoyer des transactions. Il existe deux types d'interactions: les opérations de lecture (qui ne modifient pas l'état de la blockchain) et les opérations d'écriture (qui le font). Les opérations de lecture sont généralement gratuites et peuvent être exécutées à l'aide de la méthode call() , tandis que les opérations d'écriture nécessitent une transaction et consommer du gaz.

Lire les données d'un contrat intelligent

Pour récupérer des données à partir d'un contrat intelligent sans modifier l'état de la blockchain, vous pouvez utiliser la méthode call() . Ceci est utile pour des fonctions comme getBalance() ou getName() qui renvoient les valeurs.

 contract.methods.name().call()
 .then(console.log)
 .catch(console.error);

Dans cet exemple, la fonction name() du contrat est appelée et le résultat est imprimé sur la console. Puisqu'il s'agit d'une opération de lecture, aucune transaction n'est envoyée à la blockchain et aucun frais de gaz n'est engagé . Il est important de noter que la fonction doit être marquée comme view ou pure dans la solidité pour que cela fonctionne correctement.

Si la fonction nécessite des paramètres, ils peuvent être transmis directement dans la méthode call() . Par exemple:

 contract.methods.balanceOf('0x...').call()
 .then(console.log)
 .catch(console.error);

Cela récupère l'équilibre d'une adresse Ethereum spécifique à partir d'un contrat de jeton ERC-20.

Envoi des transactions à un contrat intelligent

Pour modifier l'état de la blockchain, comme le transfert de jetons ou la mise à jour des données du contrat, vous devez envoyer une transaction . Cela implique de signer la transaction avec la clé privée de l'expéditeur et de payer des frais de gaz.

 const account = '0x...'; // Replace with your Ethereum account address
 const privateKey = '0x...'; // Replace with your private key web3.eth.accounts.wallet.add (privateKey);



contrat.methods.transfer ('0xrecipentAddress', '100')
 .Send ({de: Compte, Gas: 200000})
 .on ('transactionhash', hash => console.log (hash)))
 .on ('réception', reçu => console.log (réception))
 .on ('error', error => console.error (erreur));

Dans cet exemple, la fonction transfer() d'un contrat de jeton ERC-20 est appelée. La méthode .send() est utilisée pour exécuter la transaction. Il nécessite l'adresse de l'expéditeur et une limite de gaz. Des événements tels que transactionHash , receipt et error peuvent être utilisés pour surveiller l'état de la transaction.

Avant d'envoyer une transaction, il est crucial de gérer la clé privée en toute sécurité . Ne le codez jamais dans le code de production et envisagez d'utiliser des services de portefeuille comme Metamask ou des portefeuilles matériels pour une meilleure sécurité.

Gérer les événements et écouter des journaux de contrat

Les contrats intelligents peuvent émettre des événements lorsque certaines actions se produisent. Ces événements sont stockés dans les journaux de la blockchain et peuvent être surveillés à l'aide de Web3.js. Ceci est utile pour suivre les actions des utilisateurs, les mises à jour de contrat ou les alertes système.

 contract.events.Transfer({
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event))
 .on('error', error => console.error(error));

Le code ci-dessus écoute tous les événements Transfer émis par le contrat. Les paramètres fromBlock et toBlock définissent la plage de blocs pour rechercher des événements. Cette fonctionnalité permet aux développeurs de créer des applications en temps réel qui réagissent aux activités sur chaîne.

Vous pouvez également utiliser des filtres pour réduire les événements en fonction de critères spécifiques. Par exemple, le filtrage des transferts à une adresse particulière:

 contract.events.Transfer({
 filter: { to: '0xRecipientAddress' },
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event));

---

Questions fréquemment posées

Q: Quelle est la différence entre Call () et Send () dans web3.js?

R: La méthode call() est utilisée pour lire les données de la blockchain sans modifier son état et ne nécessite pas de gaz. La méthode send() est utilisée pour exécuter des transactions qui modifient l'état de la blockchain et nécessitent des frais de gaz.

Q: Puis-je interagir avec un contrat intelligent sans clé privée?

R: Oui, vous pouvez effectuer des opérations de lecture à l'aide call() sans clé privée. Cependant, les opérations d'écriture à l'aide send() nécessitent un compte Ethereum valide avec un éther suffisant pour payer le gaz.

Q: Comment puis-je obtenir l'ABI d'un contrat intelligent déployé?

R: L'ABI est généré lorsque vous compilez le code de solidité. Si le contrat est déjà déployé, vous pouvez récupérer son ABI des explorateurs de blocs comme Etherscan si le code source du contrat est vérifié.

Q: Que dois-je faire si ma transaction est bloquée?

R: Vous pouvez vérifier l'état de la transaction à l'aide d'outils comme Etherscan ou en écoutant des événements comme receipt . Si la transaction est en attente trop longtemps, vous devrez peut-être augmenter le prix du gaz et le renvoyer.