Struct ChainRegistry 

pub struct ChainRegistry { /* private fields */ }

Registry of supported blockchain parsers.

The registry provides runtime lookup of chain parsers by their identifier. It is designed to be cloned cheaply (via Arc) for use across async tasks.

Construction

Use ChainRegistry::new() to create a registry with all production chains, or ChainRegistry::empty() for testing.

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();
println!("Supported chains: {:?}", registry.supported_chains());

if let Some(parser) = registry.get("ethereum") {
    // Use parser...
    println!("Found: {}", parser.id());
}

Implementations

impl ChainRegistry

pub fn new() -> Self

Create a new registry with all supported chain parsers.

Currently supported chains:

• ethereum - Ethereum and EVM-compatible chains
• bitcoin - Bitcoin (Legacy, SegWit, Taproot)
• solana - Solana (Legacy and Versioned messages)

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();
assert_eq!(registry.len(), 3);
assert!(registry.supports("ethereum"));
assert!(registry.supports("bitcoin"));
assert!(registry.supports("solana"));

pub fn empty() -> Self

Create an empty registry (for testing).

This is useful when you need a registry without any production chains, typically for unit tests where you want to register mock chains.

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::empty();
assert!(registry.is_empty());
assert_eq!(registry.len(), 0);

pub fn register<C: Chain + 'static>(&mut self, chain: C)

Register a chain parser.

This is primarily used for testing with mock parsers. In production, use ChainRegistry::new() which registers all supported chains.

Arguments

• chain - The chain parser to register

Note

If a chain with the same ID is already registered, it will be replaced.

Example

use txgate_chain::{ChainRegistry, MockChain};

let mut registry = ChainRegistry::empty();

let mock = MockChain {
    id: "test-chain",
    ..Default::default()
};

registry.register(mock);

assert!(registry.supports("test-chain"));
assert_eq!(registry.len(), 1);

pub fn get(&self, chain_id: &str) -> Option<&dyn Chain>

Look up a chain parser by ID.

Arguments

• chain_id - The chain identifier (e.g., “ethereum”, “bitcoin”)

Returns

• Some(&dyn Chain) if the chain is supported
• None if the chain is not supported

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();

// Look up a chain (returns None if not registered)
let parser = registry.get("ethereum");
// Currently None - parsers will be added in future tasks

// Not found
let missing = registry.get("nonexistent");
assert!(missing.is_none());

pub fn supported_chains(&self) -> Vec<&str>

List all supported chain IDs.

Returns a sorted list of chain identifiers for consistency.

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();

// Get list of all supported chains (sorted alphabetically)
let chains = registry.supported_chains();
assert_eq!(chains, vec!["bitcoin", "ethereum", "solana"]);

pub fn supports(&self, chain_id: &str) -> bool

Check if a chain is supported.

Arguments

• chain_id - The chain identifier to check

Returns

• true if the chain is registered
• false otherwise

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();

// Check if a chain is supported
assert!(registry.supports("ethereum"));
assert!(registry.supports("bitcoin"));
assert!(registry.supports("solana"));
assert!(!registry.supports("unknown"));

pub fn len(&self) -> usize

Get the number of registered chains.

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();
assert_eq!(registry.len(), 3);  // ethereum, bitcoin, solana

let registry = ChainRegistry::empty();
assert_eq!(registry.len(), 0);

pub fn is_empty(&self) -> bool

Check if the registry is empty.

Example

use txgate_chain::ChainRegistry;

let registry = ChainRegistry::new();
assert!(!registry.is_empty());  // has 3 chains registered

let registry = ChainRegistry::empty();
assert!(registry.is_empty());

Trait Implementations

impl Clone for ChainRegistry

fn clone(&self) -> ChainRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChainRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChainRegistry

fn default() -> Self

Returns the “default value” for a type.