Was sind Ereignisse in einem Smart -Vertrag und wie man sie benutzt?

Soliditätsereignisse ermöglichen es DAPPs, wie Token-Transfers, NFT-Münzen und Echtzeitanalysen effizient zu verfolgen und auf Kettenaktivitäten zu reagieren.

Jul 10, 2025 at 02:14 pm

Ereignisse in Smart Contracts verstehen

Im Bereich der Smartverträge von Solidität dienen Ereignisse als entscheidender Mechanismus für die Kommunikation zwischen Blockchain und externen Anwendungen. Ereignisse sind im Wesentlichen Protokolle, die auf der Virtual Machine (EVM) von Ethereum gespeichert sind und von externen Unternehmen wie Front-End-Anwendungen oder Off-Chain-Diensten zugegriffen werden können. Sie ermöglichen es Entwicklern, die Vertragsaktivität zu überwachen, ohne die Blockchain für Änderungen ständig abfragen zu müssen.

Ein Ereignis wird innerhalb eines Vertrags unter Verwendung des event , gefolgt von einem Namen und Parametern, deklariert. Diese Parameter können indexiert oder nicht indiziert werden, was sich auswirkt, wie sie später abgefragt werden können. Indexierte Parameter wirken wie Filter beim Abrufen von Protokollen, wodurch sie effizienter für die Suche in großen Datensätzen effizienter werden.

---

Ereignisse in Solidität deklarieren

Um ein Ereignis in einem Smart -Vertrag zu deklarieren, definieren Sie es ähnlich wie eine Funktion, jedoch mit dem event . Hier ist ein grundlegendes Beispiel:

 pragma solidity ^0.8.0; Vertrag mycontract {

event Transfer(address indexed from, address indexed to, uint amount); function sendTokens(address recipient, uint amount) public { // logic to transfer tokens emit Transfer(msg.sender, recipient, amount); }
 }

In diesem Fall hat das Transfer drei Parameter: zwei Adressen ( from und to ) und eine uint die den Betrag darstellt. Mit dem indexed Schlüsselwort können diese Felder in den Protokollen durchsuchbar sein.

Indexierte Parameter sollten strategisch verwendet werden, da eine Grenze von bis zu drei indizierten Parametern pro Ereignis vorliegt. Nicht indizierte Parameter werden noch protokolliert, können jedoch nicht direkt über die Log -Abfrageschnittstelle filtriert werden.

---

Ereignisse während der Ausführung emittieren

Sobald ein Ereignis deklariert ist, muss es während der Ausführung einer Funktion unter Verwendung des Schlüsselworts emit -Keyword ausgelöst werden, gefolgt vom Ereignisnamen und seiner Argumente.

So funktioniert die Emission in der Praxis:

• Wenn die Funktion sendTokens aufgerufen wird, wird eine interne Logik ausgeführt.
• Nach der Verarbeitung der Transaktion werden die emit Transfer(...) aufgerufen, wodurch die Ereignisdaten auf der Blockchain aufgezeichnet werden.

Dieses emittierte Ereignis kann dann von Tools wie Web3.js oder Ethers.js in dezentralen Anwendungen (DAPPs) erfasst werden.

Die emit -Anweisung sollte immer am Ende einer Funktion platziert werden, wenn sie vom Ergebnis der Funktionslogik abhängt. Dies stellt sicher, dass das Ereignis erst nach dem erfolgreichen Antrag auf alle staatlichen Änderungen abfeuert.

---

Anhören von Ereignissen mithilfe von Web3 -Bibliotheken

Nach dem Einsatz eines Vertrags mit Ereignissen besteht der nächste Schritt darin, die Hörer so einzurichten, dass diese Ereignisse in Echtzeit erfasst werden. Hier erfahren Sie, wie Sie es mit Web3.js machen:

1. Stellen Sie zunächst sicher, dass Sie Zugriff auf den Vertrag ABI und die Adresse haben.
2. Erstellen Sie eine Vertragsinstanz mit web3.eth.Contract(abi, address) .
3. Verwenden Sie die Methode .events.EventName() um das Zuhören zu beginnen.

Beispiel:

 const contract = new web3.eth.Contract(abi, contractAddress); Contract.Events.transfer ({{

fromBlock: 0
 }, Funktion (Fehler, Ereignis) {
 
console.log(event);
 })
 .on ('Daten', Funktion (Ereignis) {
 
console.log('Event detected:', event.returnValues);
 })
 .on ('error', console.Error);

Stellen Sie sicher, dass Fehler ordnungsgemäß behandelt werden und Ereignisse anhand Ihrer Anwendungsanforderungen anhand von Optionen wie filter oder topics filtern.

---

Praktische Anwendungsfälle für Ereignisse

Ereignisse dienen nicht nur zur Protokollierung - sie führen mehrere kritische Funktionen in DAPPs mit:

• Verfolgung von Benutzeraktionen : Wie Token -Transfers, NFT -Münzen oder Abstimmungsergebnisse.
• Synchronisieren von Backend-Systemen : Off-Chain-Dienste können sofort auf On-Chain-Ereignisse reagieren.
• Prüfung und Analyse : Ereignisse bieten eine strukturierte Möglichkeit, das Vertragsverhalten im Laufe der Zeit zu analysieren.

Zum Beispiel könnte ein dezentraler Austausch jedes Mal, wenn ein Handel auftritt, ein Ereignis ausgeben. Ein Analytics-Dashboard könnte diese Ereignisse anhören und Diagramme in Echtzeit aktualisieren.

Ereignisse sind auch nützlich, um intelligente Verträge während der Entwicklung zu debuggen, indem sie einen Einblick in den Ausführungsfluss und die staatlichen Änderungen geben.

---

FAQs über Soliditätsereignisse

F: Kann ich ein Ereignis nach der Bereitstellung ändern?

Nein, sobald ein Vertrag eingesetzt ist, werden seine Ereignisdefinitionen festgelegt. Alle Änderungen erfordern die Neuanpassung des Vertrags.

F: Wie viel Gas verbrauchen Ereignisse?

Die Veranstaltungen sind im Vergleich zu Lagerabläufen relativ kostengünstig, kosten jedoch immer noch Gas. Jedes Ereignisprotokoll erhöht die Gasverbrauch der Transaktion je nach Anzahl und Größe der Parameter.

F: Sind Ereignisse über verschiedene Blockchains zugänglich?

Ereignisse sind spezifisch für die Kette, in der der Vertrag eingesetzt wurde. Cross-Chain-Wechselwirkungen würden zusätzliche Infrastruktur wie Brücken oder Relayer benötigen.

F: Bleiben Ereignisse für immer auf der Blockchain?

Ja, Ereignisse sind Teil der Blockchain -Geschichte und bleiben zugänglich, solange die Kette existiert. Der Zugriff auf historische Protokolle erfordert jedoch möglicherweise Archivknoten oder APIs von Drittanbietern.