Struct alloy_chains::Chain

pub struct Chain(/* private fields */);

Either a known NamedChain or a EIP-155 chain ID.

Implementations

impl Chain

pub const fn from_named(named: NamedChain) -> Self

Creates a new Chain by wrapping a NamedChain.

pub fn from_id(id: u64) -> Self

Creates a new Chain by wrapping a NamedChain.

pub const fn from_id_unchecked(id: u64) -> Self

Creates a new Chain from the given ID, without checking if an associated NamedChain exists.

This is discouraged, as other methods assume that the chain ID is not known, but it is not unsafe.

pub const fn mainnet() -> Self

Returns the mainnet chain.

pub const fn goerli() -> Self

Returns the goerli chain.

pub const fn sepolia() -> Self

Returns the sepolia chain.

pub const fn holesky() -> Self

Returns the holesky chain.

pub const fn optimism_goerli() -> Self

Returns the optimism goerli chain.

pub const fn optimism_mainnet() -> Self

Returns the optimism mainnet chain.

pub const fn base_goerli() -> Self

Returns the base goerli chain.

pub const fn base_mainnet() -> Self

Returns the base mainnet chain.

pub const fn dev() -> Self

Returns the dev chain.

pub const fn kind(&self) -> &ChainKind

Returns the kind of this chain.

pub const fn into_kind(self) -> ChainKind

Returns the kind of this chain.

pub const fn is_optimism(self) -> bool

Returns true if the chain contains Optimism configuration.

pub const fn named(self) -> Option<NamedChain>

Attempts to convert the chain into a named chain.

pub const fn id(self) -> u64

The ID of the chain.

impl Chain

Methods delegated to NamedChain. Note that ChainKind::Id won’t be converted because it was already done at construction.

pub const fn average_blocktime_hint(self) -> Option<Duration>

Returns the chain’s average blocktime, if applicable.

See NamedChain::average_blocktime_hint for more info.

pub const fn is_legacy(self) -> bool

Returns whether the chain implements EIP-1559 (with the type 2 EIP-2718 transaction type).

See NamedChain::is_legacy for more info.

pub const fn supports_shanghai(self) -> bool

Returns whether the chain supports the Shanghai hardfork.

See NamedChain::supports_shanghai for more info.

pub const fn etherscan_urls(self) -> Option<(&'static str, &'static str)>

Returns the chain’s blockchain explorer and its API (Etherscan and Etherscan-like) URLs.

See NamedChain::etherscan_urls for more info.

pub const fn etherscan_api_key_name(self) -> Option<&'static str>

Returns the chain’s blockchain explorer’s API key environment variable’s default name.

See NamedChain::etherscan_api_key_name for more info.

pub fn etherscan_api_key(self) -> Option<String>

Returns the chain’s blockchain explorer’s API key, from the environment variable with the name specified in etherscan_api_key_name.

See NamedChain::etherscan_api_key for more info.

pub fn public_dns_network_protocol(self) -> Option<String>

Returns the address of the public DNS node list for the given chain.

See NamedChain::public_dns_network_protocol for more info.

Trait Implementations

impl Clone for Chain

fn clone(&self) -> Chain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Chain

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

Formats the value using the given formatter.

impl Default for Chain

fn default() -> Self

Returns the “default value” for a type.

impl Display for Chain

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

Formats the value using the given formatter.

impl From<Chain> for u64

fn from(chain: Chain) -> Self

Converts to this type from the input type.

impl From<NamedChain> for Chain

fn from(id: NamedChain) -> Self

Converts to this type from the input type.

impl From<u64> for Chain

fn from(id: u64) -> Self

Converts to this type from the input type.

impl FromStr for Chain

type Err = ParseIntError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Chain

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Chain

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<Chain> for NamedChain

type Error = <NamedChain as TryFrom<u64>>::Error

The type returned in the event of a conversion error.

fn try_from(chain: Chain) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Chain

impl Eq for Chain

impl StructuralEq for Chain

impl StructuralPartialEq for Chain