riglr-core

The foundational crate for the riglr ecosystem, providing core abstractions for multi-chain tool orchestration and execution within the rig framework.

Overview

riglr-core is designed as a chain-agnostic foundation layer that provides pure abstractions for multi-chain tool orchestration. This crate contains no concrete blockchain implementations or SDK dependencies, ensuring clean separation of concerns.

Key Features

• ApplicationContext: Dependency injection and RPC provider management
• SignerContext: Thread-safe signer management for transactions
• Extension System: Type-safe dependency injection without circular references
• Tool Execution: Resilient execution with retries and error classification
• Idempotency: Built-in duplicate operation prevention
• Metrics: Comprehensive monitoring and observability

Quick Start

Add riglr-core to your Cargo.toml:

[dependencies]
riglr-core = "0.1.0"
riglr-config = "0.1.0"

Documentation

For comprehensive documentation, architecture patterns, and security guidance, see: docs/src/concepts/architecture/core-patterns.md

The documentation covers:

• Production security best practices
• Core architectural patterns (SignerContext, ApplicationContext)
• Tool system design and implementation
• Error handling and resilience patterns
• Developer experience with #[tool] macro
• Testing and quality patterns
• Integration with blockchain-specific crates

Where to Find Implementations

• Solana Signers: See riglr-solana-tools for LocalSolanaSigner and Solana-specific tools
• EVM Signers: See riglr-evm-tools for LocalEvmSigner and EVM-specific tools
• Concrete Examples: Check the examples in each tools crate for usage patterns

License

Licensed under MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)