Struct Network

pub struct Network {
    pub network_type: BlockChainType,
    pub slug: String,
    pub name: String,
    pub rpc_urls: Vec<RpcUrl>,
    pub chain_id: Option<u64>,
    pub network_passphrase: Option<String>,
    pub block_time_ms: u64,
    pub confirmation_blocks: u64,
    pub cron_schedule: String,
    pub max_past_blocks: Option<u64>,
    pub store_blocks: Option<bool>,
}

Configuration for connecting to and interacting with a blockchain network.

Defines connection details and operational parameters for a specific blockchain network, supporting both EVM and Stellar-based chains.

Fields

network_type: BlockChainType

Type of blockchain (EVM, Stellar, etc)

slug: String

Unique identifier for this network

name: String

Human-readable name of the network

rpc_urls: Vec<RpcUrl>

List of RPC endpoints with their weights for load balancing

chain_id: Option<u64>

Chain ID for EVM networks

network_passphrase: Option<String>

Network passphrase for Stellar networks

block_time_ms: u64

Average block time in milliseconds

confirmation_blocks: u64

Number of blocks needed for confirmation

cron_schedule: String

Cron expression for how often to check for new blocks

max_past_blocks: Option<u64>

Maximum number of past blocks to process

store_blocks: Option<bool>

Whether to store processed blocks

Implementations

impl Network

pub fn get_recommended_past_blocks(&self) -> u64

Calculates the recommended minimum number of past blocks to maintain for this network.

This function computes a safe minimum value based on three factors:

1. The number of blocks that occur during one cron interval (blocks_per_cron)
2. The required confirmation blocks for the network
3. An additional buffer block (+1)

The formula used is: (cron_interval_ms / block_time_ms) + confirmation_blocks + 1

Returns

• u64 - The recommended minimum number of past blocks to maintain

Note

If the cron schedule parsing fails, the blocks_per_cron component will be 0, resulting in a minimum recommendation of confirmation_blocks + 1

Trait Implementations

impl Clone for Network

fn clone(&self) -> Network

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ConfigLoader for Network

fn resolve_secrets<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Self, ConfigError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Resolve all secrets in the network configuration

fn load_all<'life0, 'async_trait, T>( path: Option<&'life0 Path>, ) -> Pin<Box<dyn Future<Output = Result<T, ConfigError>> + Send + 'async_trait>>

where T: FromIterator<(String, Self)> + 'async_trait, Self: 'async_trait, 'life0: 'async_trait,

Load all network configurations from a directory

Reads and parses all JSON files in the specified directory (or default config directory) as network configurations.

fn load_from_path<'life0, 'async_trait>( path: &'life0 Path, ) -> Pin<Box<dyn Future<Output = Result<Self, ConfigError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Load a network configuration from a specific file

Reads and parses a single JSON file as a network configuration.

fn validate(&self) -> Result<(), ConfigError>

Validate the network configuration

Ensures that:

• The network has a valid name and slug
• At least one RPC URL is specified
• Required chain-specific parameters are present
• Block time and confirmation values are reasonable

fn validate_protocol(&self)

Validate the safety of the protocol used in the network

Returns if safe, or logs a warning message if unsafe.

fn is_json_file(path: &Path) -> bool

Check if a file is a JSON file based on extension

impl Debug for Network

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Network

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Network

fn eq(&self, other: &Network) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Network

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Network