Enum Chain

#[repr(u64)]
pub enum Chain {
    Mainnet = 1,
    Morden = 2,
    Ropsten = 3,
    Rinkeby = 4,
    Goerli = 5,
    Kovan = 42,
    Holesky = 17_000,
    Sepolia = 11_155_111,
    Optimism = 10,
    OptimismKovan = 69,
    OptimismGoerli = 420,
    OptimismSepolia = 11_155_420,
    Arbitrum = 42_161,
    ArbitrumTestnet = 421_611,
    ArbitrumGoerli = 421_613,
    ArbitrumSepolia = 421_614,
    ArbitrumNova = 42_170,
    Cronos = 25,
    CronosTestnet = 338,
    Rsk = 30,
    BinanceSmartChain = 56,
    BinanceSmartChainTestnet = 97,
    Poa = 99,
    Sokol = 77,
    ScrollSepolia = 534_351,
    Scroll = 534_352,
    ScrollAlphaTestnet = 534_353,
    Metis = 1_088,
    Gnosis = 100,
    Polygon = 137,
    PolygonMumbai = 80_001,
    PolygonAmoy = 80_002,
    PolygonZkEvm = 1_101,
    PolygonZkEvmTestnet = 1_442,
    Fantom = 250,
    FantomTestnet = 4_002,
    Moonbeam = 1_284,
    MoonbeamDev = 1_281,
    Moonriver = 1_285,
    Moonbase = 1_287,
    Dev = 1_337,
    AnvilHardhat = 31_337,
    Evmos = 9_001,
    EvmosTestnet = 9_000,
    Chiado = 10_200,
    Oasis = 26_863,
    Emerald = 42_262,
    EmeraldTestnet = 42_261,
    FilecoinMainnet = 314,
    FilecoinCalibrationTestnet = 314_159,
    Avalanche = 43_114,
    AvalancheFuji = 43_113,
    Celo = 42_220,
    CeloAlfajores = 44_787,
    CeloBaklava = 62_320,
    Aurora = 1_313_161_554,
    AuroraTestnet = 1_313_161_555,
    Canto = 7_700,
    CantoTestnet = 740,
    Boba = 288,
    Base = 8_453,
    BaseGoerli = 84_531,
    BaseSepolia = 84_532,
    Blast = 81_457,
    BlastSepolia = 168_587_773,
    Linea = 59_144,
    LineaTestnet = 59_140,
    ZkSync = 324,
    ZkSyncTestnet = 280,
    Mantle = 5_000,
    MantleTestnet = 5_001,
    Viction = 88,
    Zora = 7_777_777,
    ZoraGoerli = 999,
    ZoraSepolia = 999_999_999,
    Mode = 34_443,
    ModeSepolia = 919,
    Elastos = 20,
}

An Ethereum EIP-155 chain.

Variants

Mainnet = 1

Morden = 2

Ropsten = 3

Rinkeby = 4

Goerli = 5

Kovan = 42

Holesky = 17_000

Sepolia = 11_155_111

Optimism = 10

OptimismKovan = 69

OptimismGoerli = 420

OptimismSepolia = 11_155_420

Arbitrum = 42_161

ArbitrumTestnet = 421_611

ArbitrumGoerli = 421_613

ArbitrumSepolia = 421_614

ArbitrumNova = 42_170

Cronos = 25

CronosTestnet = 338

Rsk = 30

BinanceSmartChain = 56

BinanceSmartChainTestnet = 97

Poa = 99

Sokol = 77

ScrollSepolia = 534_351

Scroll = 534_352

ScrollAlphaTestnet = 534_353

Metis = 1_088

Gnosis = 100

Polygon = 137

PolygonMumbai = 80_001

PolygonAmoy = 80_002

PolygonZkEvm = 1_101

PolygonZkEvmTestnet = 1_442

Fantom = 250

FantomTestnet = 4_002

Moonbeam = 1_284

MoonbeamDev = 1_281

Moonriver = 1_285

Moonbase = 1_287

Dev = 1_337

AnvilHardhat = 31_337

Evmos = 9_001

EvmosTestnet = 9_000

Chiado = 10_200

Oasis = 26_863

Emerald = 42_262

EmeraldTestnet = 42_261

FilecoinMainnet = 314

FilecoinCalibrationTestnet = 314_159

Avalanche = 43_114

AvalancheFuji = 43_113

Celo = 42_220

CeloAlfajores = 44_787

CeloBaklava = 62_320

Aurora = 1_313_161_554

AuroraTestnet = 1_313_161_555

Canto = 7_700

CantoTestnet = 740

Boba = 288

Base = 8_453

BaseGoerli = 84_531

BaseSepolia = 84_532

Blast = 81_457

BlastSepolia = 168_587_773

Linea = 59_144

LineaTestnet = 59_140

ZkSync = 324

ZkSyncTestnet = 280

Mantle = 5_000

MantleTestnet = 5_001

Viction = 88

Zora = 7_777_777

ZoraGoerli = 999

ZoraSepolia = 999_999_999

Mode = 34_443

ModeSepolia = 919

Elastos = 20

Implementations

impl Chain

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

Returns the chain’s average blocktime, if applicable.

It can be beneficial to know the average blocktime to adjust the polling of an HTTP provider for example.

Note: this is not an accurate average, but is rather a sensible default derived from blocktime charts such as Etherscan’s or Polygonscan’s.

Examples

use ethers_core::types::Chain;
use std::time::Duration;

assert_eq!(
    Chain::Mainnet.average_blocktime_hint(),
    Some(Duration::from_millis(12_000)),
);
assert_eq!(
    Chain::Optimism.average_blocktime_hint(),
    Some(Duration::from_millis(2_000)),
);

pub const fn is_legacy(&self) -> bool

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

Examples

use ethers_core::types::Chain;

assert!(!Chain::Mainnet.is_legacy());
assert!(Chain::Celo.is_legacy());

pub const fn supports_push0(&self) -> bool

Returns whether the chain supports the PUSH0 opcode or not.

For more information, see EIP-3855: <https://eips.ethereum.org/EIPS/eip-3855>

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.

Returns (API_URL, BASE_URL)

Examples

use ethers_core::types::Chain;

assert_eq!(
    Chain::Mainnet.etherscan_urls(),
    Some(("https://api.etherscan.io/api", "https://etherscan.io"))
);
assert_eq!(
    Chain::Avalanche.etherscan_urls(),
    Some(("https://api.snowtrace.io/api", "https://snowtrace.io"))
);
assert_eq!(Chain::AnvilHardhat.etherscan_urls(), None);

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.

Examples

use ethers_core::types::Chain;

assert_eq!(Chain::Mainnet.etherscan_api_key_name(), Some("ETHERSCAN_API_KEY"));
assert_eq!(Chain::AnvilHardhat.etherscan_api_key_name(), None);

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.

Examples

use ethers_core::types::Chain;

let chain = Chain::Mainnet;
std::env::set_var(chain.etherscan_api_key_name().unwrap(), "KEY");
assert_eq!(chain.etherscan_api_key().as_deref(), Some("KEY"));

Trait Implementations

impl AsRef<str> for Chain

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Chain

fn clone(&self) -> Chain

Returns a duplicate 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<(), Error>

Formats the value using the given formatter.

impl Default for Chain

fn default() -> Chain

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Chain

fn deserialize<__D>( __deserializer: __D, ) -> Result<Chain, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Chain

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

Formats the value using the given formatter.

impl EnumCount for Chain

const COUNT: usize = 78usize

impl From<Chain> for U128

fn from(chain: Chain) -> U128

Converts to this type from the input type.

impl From<Chain> for U256

fn from(chain: Chain) -> U256

Converts to this type from the input type.

impl From<Chain> for U512

fn from(chain: Chain) -> U512

Converts to this type from the input type.

impl From<Chain> for U64

fn from(chain: Chain) -> U64

Converts to this type from the input type.

impl FromStr for Chain

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Chain, <Chain as FromStr>::Err>

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

impl Hash for Chain

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

where __H: Hasher,

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 IntoEnumIterator for Chain

type Iterator = ChainIter

fn iter() -> ChainIter

impl Ord for Chain

fn cmp(&self, other: &Chain) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Chain

fn eq(&self, other: &Chain) -> 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 PartialOrd for Chain

fn partial_cmp(&self, other: &Chain) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Chain

fn serialize<S>( &self, s: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for Chain

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Chain, <Chain as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<U128> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: U128) -> Result<Chain, <Chain as TryFrom<U128>>::Error>

Performs the conversion.

impl TryFrom<U256> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: U256) -> Result<Chain, <Chain as TryFrom<U256>>::Error>

Performs the conversion.

impl TryFrom<U512> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: U512) -> Result<Chain, <Chain as TryFrom<U512>>::Error>

Performs the conversion.

impl TryFrom<U64> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: U64) -> Result<Chain, <Chain as TryFrom<U64>>::Error>

Performs the conversion.

impl TryFrom<u16> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: u16) -> Result<Chain, <Chain as TryFrom<u16>>::Error>

Performs the conversion.

impl TryFrom<u32> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: u32) -> Result<Chain, <Chain as TryFrom<u32>>::Error>

Performs the conversion.

impl TryFrom<u64> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(number: u64) -> Result<Chain, TryFromPrimitiveError<Chain>>

Performs the conversion.

impl TryFrom<u8> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: u8) -> Result<Chain, <Chain as TryFrom<u8>>::Error>

Performs the conversion.

impl TryFrom<usize> for Chain

type Error = TryFromPrimitiveError<Chain>

The type returned in the event of a conversion error.

fn try_from(value: usize) -> Result<Chain, <Chain as TryFrom<usize>>::Error>

Performs the conversion.

impl TryFromPrimitive for Chain

const NAME: &'static str = "Chain"

type Primitive = u64

type Error = TryFromPrimitiveError<Chain>

fn try_from_primitive( number: <Chain as TryFromPrimitive>::Primitive, ) -> Result<Chain, TryFromPrimitiveError<Chain>>

impl VariantNames for Chain

const VARIANTS: &'static [&'static str]

Names of the variants of this enum

impl Copy for Chain

impl Eq for Chain

impl StructuralPartialEq for Chain