Quels sont les événements de Solidity et comment les utiliser?

Comprendre les événements de la solidité

Dans Solidity, les événements sont un moyen pour un contrat de communiquer avec le monde extérieur. Ils permettent aux contrats intelligents d'émettre des journaux qui peuvent être écoutés et traités par des applications décentralisées (DAPP), des portefeuilles et d'autres services externes. Les événements sont particulièrement utiles pour suivre les modifications de l'état du contrat et fournir des mises à jour en temps réel à l'interface frontale.

Les événements Solidity sont déclarés en utilisant le mot-clé de event suivi du nom de l'événement et d'une liste de paramètres. Ces paramètres peuvent être indexés ou non indexés, les paramètres indexés étant consultables dans les journaux. Lorsqu'un événement est émis, il est stocké dans le journal de la transaction, qui fait partie de la blockchain mais n'est pas accessible à d'autres contrats intelligents.

Déclarer les événements de Solidity

Pour déclarer un événement dans Solidity, vous utilisez le mot-clé de event dans la portée du contrat. Voici un exemple de base:

 pragma solidity ^0.8.0; Contracter MyContract {


event MyEvent(address indexed sender, uint256 amount);
 }

Dans cet exemple, MyEvent est un événement qui enregistre l'adresse de l'expéditeur et la quantité d'éther transférée. Le mot-clé indexed permet au paramètre sender d'être utilisé comme filtre lors de l'interrogation des journaux.

Vous pouvez inclure jusqu'à trois paramètres indexés dans un événement. Cette limitation est due à la structure de journal de la machine virtuelle Ethereum (EVM), qui ne permet que jusqu'à trois sujets de filtrage.

Émettre des événements en solidité

Une fois un événement déclaré, il peut être émis en utilisant le mot-clé emit . Cela se fait généralement à l'intérieur d'une fonction où une action notable se produit. Voici comment émettre l'événement déclaré plus tôt:

 function sendFunds(address payable recipient, uint256 amount) public payable { recipient.transfer(amount); emit MyEvent(msg.sender, amount);

}

Dans cette fonction, après avoir transféré des fonds au destinataire, le contrat émet l'événement MyEvent avec l'adresse de l'expéditeur et le montant envoyé. L'instruction emit doit correspondre à la liste des paramètres de l'événement dans le numéro et le type.

Lorsque l'événement est émis, l'EVM crée une entrée de journal qui est stockée dans le reçu de transaction. Ce journal est accessible plus tard par des applications externes.

Écoute d'événements à l'aide de web3.js

Pour utiliser les événements dans un DAPP, vous devez les écouter à l'aide d'un outil comme Web3.js ou Ethers.js. Voici comment vous pouvez configurer un auditeur à l'aide de Web3.js:

• Initialisez Web3 : Connectez-vous à un nœud Ethereum à l'aide d'un fournisseur comme Infura ou Metamask.
• Obtenez l'instance du contrat : utilisez l'ABI du contrat et adressez-vous pour créer un objet contractuel.
• Configurez l'auditeur de l'événement :

 const myContract = new web3.eth.Contract(abi, contractAddress); MyContract.Events.MyEvent ()


.on('data', event => { console.log('Event triggered:', event.returnValues); }) .on('error', error => { console.error('Error listening to event:', error); });
 Ce code écoute l'événement MyEvent et enregistre les données chaque fois qu'elle est émise. La propriété returnValues contient les paramètres passés lorsque l'événement a été déclenché.
 
Cas d'utilisation pratiques d'événements
 Les événements ne sont pas seulement pour l'exploitation forestière; Ils jouent un rôle crucial dans le développement du DAPP. Certains cas d'utilisation courants comprennent:
 

• Transferts de jetons de suivi : les normes ERC-20 et ERC-721 utilisent l'événement Transfer pour se connecter lorsque les jetons sont déplacés entre les comptes.
• Renforcer les mises à jour frontales : lorsqu'un état contractuel change, l'émission d'un événement permet au front-end de mettre à jour en temps réel.
• Audit et surveillance : les événements fournissent un enregistrement transparent et immuable de l'activité contractuelle, ce qui est utile pour la conformité et le débogage.

Par exemple, dans un contrat de vote, vous pourriez émettre un événement chaque fois qu'un vote est exprimé:

event VoteCast(address indexed voter, string proposal);

Cela permet aux systèmes externes de suivre l'activité de vote et d'assurer la transparence.

Meilleures pratiques pour utiliser des événements

Lorsque vous travaillez avec des événements dans Solidity, il est important de suivre les meilleures pratiques pour assurer l'efficacité et la clarté:

• Utilisez des paramètres indexés pour le filtrage : si vous devez interroger les journaux en fonction d'un paramètre spécifique, marquez-le comme indexé.
• Ne pas utiliser les événements : émettre trop d'événements peut augmenter les coûts de gaz et encombrer les journaux.
• Paramètres de l'événement de document : Expliquez clairement ce que chaque paramètre représente dans la déclaration d'événements.
• Utiliser les noms descriptifs : les noms d'événements doivent clairement indiquer l'action qu'ils représentent, telles que TokensTransferred ou OwnershipTransferred .

Évitez d'émettre des événements dans des boucles ou des fonctions à haute fréquence à moins que cela ne soit nécessaire, car cela peut augmenter considérablement la consommation de gaz.

Questions fréquemment posées

Q: Les événements peuvent-ils être utilisés pour communiquer entre les contrats intelligents?

Non, les événements ne peuvent pas être utilisés pour la communication inter-contrat. Ils sont stockés dans les journaux de transaction et ne sont accessibles qu'aux applications hors chaîne.

Q: Combien d'événements de gaz consomment-ils? Les événements consomment du gaz parce qu'ils font partie de la transaction. Le coût exact dépend du nombre et de la taille des paramètres, en particulier s'ils sont indexés ou non.

Q: Les événements sont-ils stockés en permanence sur la blockchain? Oui, les événements sont stockés dans les journaux Ethereum, qui font partie de la blockchain. Cependant, ils ne sont pas directement accessibles aux contrats intelligents.

Q: Puis-je émettre un événement sans aucun paramètre? Oui, vous pouvez déclarer et émettre des événements sans aucun paramètre. Ceci est utile pour signaler qu'une action particulière s'est produite sans avoir besoin de passer des données.