riglr-config 0.3.0

Unified configuration management for RIGLR applications
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# riglr-config

Unified, hierarchical configuration management for RIGLR applications.

## Overview

`riglr-config` provides a fail-fast, environment-driven configuration system that ensures your riglr applications are configured correctly before they start. It consolidates all configuration concerns into a single, well-structured system with strong typing and comprehensive validation.

### Key Features

- **Fail-Fast Validation**: Configuration errors crash at startup, not runtime
- **Environment-Driven**: All configuration loaded from environment variables
- **Multi-Chain Support**: Dynamic chain configuration via `RPC_URL_{CHAIN_ID}` convention
- **Type-Safe**: Strongly typed configuration with compile-time guarantees
- **Hierarchical Structure**: Logical organization of related settings

📚 **[View Full Documentation](https://riglr.dev/concepts/configuration)** for detailed usage guides and examples.

## Quick Start

```rust
use riglr_config::Config;

// Load configuration from environment (fail-fast)
let config = Config::from_env();

// Access configuration values
println!("Redis URL: {}", config.database.redis_url);
println!("Environment: {:?}", config.app.environment);

// Get RPC URL for any chain
if let Some(rpc_url) = config.network.get_rpc_url("ethereum") {
    println!("Ethereum RPC: {}", rpc_url);
}
```


## Address Validation (v0.3.0+)

Address validation is decoupled from the core configuration to maintain chain-agnostic architecture:

```rust
use riglr_config::{Config, AddressValidator};
use riglr_evm_common::validation::EvmAddressValidator;

let config = Config::from_env();

// Optional: Validate blockchain addresses
config.network.validate_config(Some(&EvmAddressValidator))?;
```


## Configuration Structure

- **app**: Server settings, transaction defaults, retry configuration
- **database**: Redis (required), Neo4j, ClickHouse
- **network**: RPC URLs for all chains, contract addresses
- **providers**: API keys for AI, blockchain, and market data providers
- **features**: Feature flags for enabling/disabling functionality

## Required Environment Variables

```bash
REDIS_URL=redis://localhost:6379
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
RPC_URL_1=https://eth-mainnet.alchemyapi.io/v2/your-key  # Or any EVM chain
```

## Dynamic Chain Support

Add new chains without code changes:

```bash
# Using chain ID
export RPC_URL_137=https://polygon-rpc.com

# Using network name
export RPC_URL_POLYGON=https://polygon-rpc.com
```

📚 **[View Full Documentation](https://riglr.dev/concepts/configuration)** for complete environment variable reference, chain configuration, and migration guides.