Was sind Ereignisse in Solidität und wie kann man sie verwenden?

Soliditätsereignisse ermöglichen Verträge, Daten über das Schlüsselwort "Emit" zu protokollieren, sodass DAPPs Echtzeit-Updates mithilfe von Tools wie Web3.js anhören und verarbeiten können.

Jul 20, 2025 at 08:07 pm

Ereignisse in Solidität verstehen

In Solidität sind Ereignisse eine Möglichkeit für einen Vertrag, mit der externen Welt zu kommunizieren. Sie ermöglichen intelligente Verträge, Protokolle abzugeben, die von dezentralen Anwendungen (DAPPs), Brieftaschen und anderen externen Diensten angehört und verarbeitet werden können. Ereignisse sind besonders nützlich, um Änderungen im Vertragszustand zu verfolgen und Echtzeit-Updates für die Front-End-Oberfläche bereitzustellen.

Soliditätsereignisse werden unter Verwendung des event , gefolgt vom Ereignisnamen und einer Liste von Parametern, deklariert. Diese Parameter können indiziert oder nicht indiziert werden, wobei indizierte Parameter in den Protokollen durchsucht werden können. Wenn ein Ereignis emittiert wird, wird es im Protokoll der Transaktion gespeichert, das Teil der Blockchain ist, aber für andere intelligente Verträge nicht zugänglich ist.

Ereignisse in Solidität deklarieren

Um ein Ereignis in Solidität zu deklarieren, verwenden Sie das event im Vertragsbereich. Hier ist ein grundlegendes Beispiel:

 pragma solidity ^0.8.0; Vertrag mycontract {

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

In diesem Beispiel ist MyEvent ein Ereignis, das die Adresse des Absenders und die Menge des übertragenen Äthers anmelden. Das indexed Schlüsselwort ermöglicht dem Abfragen sender Parameter als Filter beim Abfragen von Protokollen.

Sie können bis zu drei indizierte Parameter in einem Ereignis einbeziehen. Diese Einschränkung ist auf die Protokollstruktur der Ethereum Virtual Machine (EVM) zurückzuführen, die nur bis zu drei Themen für die Filterung ermöglicht.

Ereignisse in Solidität ausgeben

Sobald ein Ereignis deklariert ist, kann es mit dem Keyword emit emittiert werden. Dies erfolgt normalerweise in einer Funktion, bei der eine bemerkenswerte Aktion auftritt. So können Sie das zuvor deklarierte Ereignis ausgeben:

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

}

In dieser Funktion gibt der Vertrag nach Übertragung von Geldern an den Empfänger das MyEvent -Ereignis mit der Adresse des Absenders und dem gesendeten Betrag ab. Die emit -Anweisung muss mit der Parameterliste des Ereignisses in der Nummer und im Typ übereinstimmen.

Wenn das Ereignis emittiert wird, erstellt das EVM einen Protokolleintrag, der in der Transaktionsbeleg gespeichert ist. Dieses Protokoll kann später durch externe Anwendungen zugegriffen werden.

Ereignisse mit web3.js anhören

Um Ereignisse in einem DAPP zu verwenden, müssen Sie sie mit einem Tool wie Web3.js oder Ethers.js anhören . So können Sie einen Hörer mit web3.js einrichten:

• Initialisieren Sie Web3 : Stellen Sie mit einem Anbieter wie Infura oder Metamask eine Verbindung zu einem Ethereum -Knoten her.
• Holen Sie sich die Vertragsinstanz : Verwenden Sie die ABI und die Adresse des Vertrags, um ein Vertragsobjekt zu erstellen.
• Richten Sie den Event -Hörer ein :

 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); });
 Dieser Code hört auf das MyEvent -Ereignis und protokolliert die Daten, wenn sie emittiert sind. Die Eigenschaft returnValues enthält die Parameter, die beim Auslösen des Ereignisses übergeben wurden.
 
Praktische Anwendungsfälle von Ereignissen
 Ereignisse dienen nicht nur zur Protokollierung; Sie spielen eine entscheidende Rolle bei der DAPP -Entwicklung. Einige gemeinsame Anwendungsfälle umfassen:
 
Tracking-Token-Transfers : ERC-20- und ERC-721-Standards verwenden das Transfer , um sich zu protokollieren, wenn die Token zwischen den Konten verschoben werden.
 Benachrichtigung von Front-End-Updates : Wenn sich ein Vertragszustand ändert, kann das Ausgeben eines Ereignisses das Front-End in Echtzeit aktualisieren.
 Prüfung und Überwachung : Ereignisse bieten eine transparente und unveränderliche Aufzeichnung der Vertragsaktivität, was für die Einhaltung und Debuggierung nützlich ist.
 Zum Beispiel können Sie in einem Abstimmungsvertrag jedes Mal, wenn eine Abstimmung abgegeben wird, ein Ereignis abgeben:
 
event VoteCast(address indexed voter, string proposal);
 Auf diese Weise können externe Systeme die Abstimmungsaktivität verfolgen und Transparenz sicherstellen.
 
Best Practices für die Verwendung von Veranstaltungen
 Bei der Arbeit mit Ereignissen in Solidität ist es wichtig, Best Practices zu befolgen, um Effizienz und Klarheit zu gewährleisten:
 
Verwenden Sie indizierte Parameter für die Filterung : Wenn Sie Protokolle basierend auf einem bestimmten Parameter abfragen müssen, markieren Sie es als indiziert.
 Ereignisse nicht überbeanspruchen : Zu viele Ereignisse kann die Gaskosten erhöhen und die Protokolle überladen.
 Dokumentereignisparameter : Erläutern Sie klar, was jeder Parameter in der Ereignisdeklaration darstellt.
 Verwenden Sie beschreibende Namen : Ereignisnamen sollten eindeutig die von ihnen darstellende Aktion angeben, wie z. TokensTransferred oder OwnershipTransferred .
 Vermeiden Sie es, Ereignisse in Schleifen oder Hochfrequenzfunktionen zu emittieren, sofern dies nicht erforderlich ist, da dies den Gasverbrauch erheblich erhöhen kann.
 
Häufig gestellte Fragen
 F: Können Ereignisse verwendet werden, um zwischen intelligenten Verträgen zu kommunizieren?

Nein, Ereignisse können nicht für die Kommunikation zwischen den Vertragsabrechnungen verwendet werden. Sie werden in den Transaktionsprotokollen gespeichert und sind nur für aperkette Anwendungen zugänglich.

F: Wie viel Gas verbrauchen Ereignisse?

Ereignisse verbrauchen Gas, weil sie Teil der Transaktion sind. Die genauen Kosten hängen von der Anzahl und Größe der Parameter ab, insbesondere unabhängig davon, ob sie indiziert sind oder nicht.

F: Werden Ereignisse dauerhaft auf der Blockchain gespeichert?

Ja, Ereignisse werden in den Ethereum -Protokollen gespeichert, die Teil der Blockchain sind. Sie sind jedoch nicht direkt zu intelligenten Verträgen zugänglich.

F: Kann ich ein Ereignis ohne Parameter abgeben?

Ja, Sie können Ereignisse ohne Parameter deklarieren und abgeben. Dies ist nützlich für die Signalisierung, dass eine bestimmte Aktion aufgetreten ist, ohne Daten zu übergeben müssen.