riglr-events-core

Core event processing abstractions and traits for the riglr ecosystem, providing a unified framework for blockchain event handling across multiple chains.

Overview

riglr-events-core defines the foundational event processing infrastructure used throughout riglr. It provides chain-agnostic abstractions for parsing, processing, and reacting to blockchain events with high performance and reliability.

Key Features

Chain-Agnostic Design: Core abstractions work across Solana, EVM, and future chains
Event Parser Traits: Standardized interface for implementing event parsers
Event Processing Pipeline: Stream-based processing with backpressure
Pattern Matching: Flexible event filtering and routing system
Performance Optimized: Zero-copy parsing where possible
Type Safety: Strongly typed event definitions with compile-time guarantees
Extensible Architecture: Easy to add new event types and chains

Quick Start

Add riglr-events-core to your Cargo.toml:

[dependencies]
riglr-events-core = "0.3.0"
riglr-core = "0.1.0"

# Optional: Enable chain-specific features
riglr-events-core = { version = "0.3.0", features = ["solana", "evm"] }

Documentation

For comprehensive documentation, architecture details, and implementation guides, see: docs/src/concepts/event-parsing.md

The documentation covers:

Event parser trait system
Processing pipeline architecture
Performance optimization techniques
Chain-specific implementations
Event pattern matching
Integration with riglr tools
Testing and benchmarking

License