Struct ChainConfigRegistry 

pub struct ChainConfigRegistry { /* private fields */ }

Resolves the full configuration of custom chains by name.

Built-in chains are resolved without this registry; it only holds user-defined chains loaded from a YAML source. Build it explicitly via ChainConfigRegistry::from_configs, ChainConfigRegistry::from_yaml_file, or ChainConfigRegistry::load_default, then install it as the process-wide registry with init_chain_registry.

Implementations

impl ChainConfigRegistry

pub fn empty() -> Self

An empty registry — only built-in chains will resolve.

pub fn from_configs( configs: impl IntoIterator<Item = CustomChainConfig>, ) -> Result<Self, ChainConfigError>

Builds a registry from custom chain configs, keyed by chain name. Rejects duplicate names with ChainConfigError::DuplicateChain rather than silently overriding, so an ambiguous config fails loudly at construction.

pub fn load_default() -> Result<Self, ChainConfigError>

Reads custom chain configs from the path in TYCHO_CHAINS_CONFIG.

Returns an empty registry when the env var is unset, so runs on built-in chains need no config. When it is set, the file is loaded as-is: a missing, unreadable, or malformed file is an error (the operator asked for a config, so a broken one is a mistake, not “no custom chains”), leaving the caller to decide how to react. Install the result with init_chain_registry to make it the process-wide registry.

pub fn load_default_or_empty() -> Self

Like load_default but never fails: a broken TYCHO_CHAINS_CONFIG (missing, unreadable, or malformed file) is logged and degrades to an empty registry rather than aborting. Used by chain_registry to lazily initialise the process-wide registry, so a consumer only needs to set TYCHO_CHAINS_CONFIG — no explicit init call. Call load_default directly when you need to react to the error.

pub fn from_yaml_file(path: &str) -> Result<Self, ChainConfigError>

Parses a registry from a YAML file with a top-level chains: list.

pub fn from_yaml_str(contents: &str) -> Result<Self, ChainConfigError>

Parses a registry from a YAML string with a top-level chains: list.

pub fn get(&self, name: &str) -> Option<&CustomChainConfig>

Returns the config for a custom chain by name, if registered.

pub fn contains(&self, name: &str) -> bool

Whether a custom chain with this name is registered.

Trait Implementations

impl Clone for ChainConfigRegistry

fn clone(&self) -> ChainConfigRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChainConfigRegistry

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

Formats the value using the given formatter.

impl Default for ChainConfigRegistry

fn default() -> ChainConfigRegistry

Returns the “default value” for a type.