Enum SupportedChainId 

#[repr(u64)]
pub enum SupportedChainId {
    Mainnet = 1,
    GnosisChain = 100,
    ArbitrumOne = 42_161,
    Base = 8_453,
    Sepolia = 11_155_111,
    Polygon = 137,
    Avalanche = 43_114,
    BnbChain = 56,
    Linea = 59_144,
    Lens = 232,
    Plasma = 9_745,
    Ink = 57_073,
}

Chains supported by the CoW Protocol orderbook.

Each variant’s numeric discriminant matches the EIP-155 chain ID, so SupportedChainId::Mainnet as u64 == 1. Use try_from_u64 to convert from a raw chain ID, or all to iterate every supported chain.

Example

use cow_chains::SupportedChainId;

let chain = SupportedChainId::try_from_u64(1).unwrap();
assert_eq!(chain, SupportedChainId::Mainnet);
assert_eq!(chain.as_u64(), 1);
assert_eq!(chain.as_str(), "mainnet");
assert!(!chain.is_testnet());

Variants

Mainnet = 1

Ethereum mainnet (chain ID 1).

GnosisChain = 100

Gnosis Chain (chain ID 100).

ArbitrumOne = 42_161

Arbitrum One (chain ID 42161).

Base = 8_453

Base (chain ID 8453).

Sepolia = 11_155_111

Ethereum Sepolia testnet (chain ID 11155111).

Polygon = 137

Polygon PoS (chain ID 137).

Avalanche = 43_114

Avalanche C-Chain (chain ID 43114).

BnbChain = 56

BNB Smart Chain (chain ID 56).

Linea = 59_144

Linea (chain ID 59144).

Lens = 232

Lens Network (chain ID 232).

Plasma = 9_745

Plasma (chain ID 9745).

Ink = 57_073

Ink (chain ID 57073).

Implementations

impl SupportedChainId

pub const fn as_u64(self) -> u64

Return the numeric EIP-155 chain ID.

Returns

The u64 chain ID (e.g. 1 for Mainnet, 100 for Gnosis Chain).

pub const fn try_from_u64(chain_id: u64) -> Option<Self>

Try to construct a SupportedChainId from a raw EIP-155 chain ID.

Parameters

• chain_id — the numeric EIP-155 chain ID.

Returns

Some(variant) if chain_id is supported, None otherwise.

Example

use cow_chains::SupportedChainId;

assert_eq!(SupportedChainId::try_from_u64(1), Some(SupportedChainId::Mainnet));
assert_eq!(SupportedChainId::try_from_u64(11155111), Some(SupportedChainId::Sepolia));
assert_eq!(SupportedChainId::try_from_u64(9999), None);

pub const fn all() -> &'static [Self]

Return a slice of all chains supported by the CoW Protocol orderbook.

Returns

A static slice containing every SupportedChainId variant.

pub const fn as_str(self) -> &'static str

Returns the CoW Protocol API path segment for this chain.

Matches the path used in api_base_url, e.g. "mainnet", "xdai", "sepolia". Useful for constructing API URLs manually.

Returns

A static string suitable for use in API URL paths.

pub const fn is_testnet(self) -> bool

Whether this chain is a testnet.

Returns

true for Sepolia, false for all other chains.

pub const fn is_mainnet(self) -> bool

Returns true for production chains (i.e. not a testnet).

This is the logical complement of Self::is_testnet.

use cow_chains::SupportedChainId;
assert!(SupportedChainId::Mainnet.is_mainnet());
assert!(!SupportedChainId::Sepolia.is_mainnet());

pub const fn is_layer2(self) -> bool

Returns true for layer-2 networks.

Currently includes Arbitrum One, Base, Linea, Ink, and Polygon.

use cow_chains::SupportedChainId;

assert!(SupportedChainId::ArbitrumOne.is_layer2());
assert!(SupportedChainId::Base.is_layer2());
assert!(SupportedChainId::Polygon.is_layer2());
assert!(!SupportedChainId::Mainnet.is_layer2());
assert!(!SupportedChainId::GnosisChain.is_layer2());

pub const fn explorer_network(self) -> &'static str

Return the network segment used in CoW Protocol Explorer URLs.

Mainnet uses an empty segment (orders live at the root path).

Returns

A static string for the URL path segment (empty for Mainnet).

Trait Implementations

impl Clone for SupportedChainId

fn clone(&self) -> SupportedChainId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SupportedChainId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SupportedChainId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SupportedChainId

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

Formats the value using the given formatter.

impl From<SupportedChainId> for u64

fn from(id: SupportedChainId) -> Self

Converts to this type from the input type.

impl Hash for SupportedChainId

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 SupportedChainId

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for SupportedChainId

fn try_from(s: &str) -> Result<Self, Self::Error>

Parse a SupportedChainId from the CoW Protocol API path segment.

Accepts the same strings returned by SupportedChainId::as_str: "mainnet", "xdai", "arbitrum_one", "base", "sepolia", "polygon", "avalanche", "bnb", "linea", "lens", "plasma", "ink".

type Error = CowError

The type returned in the event of a conversion error.

impl TryFrom<u64> for SupportedChainId

type Error = u64

The type returned in the event of a conversion error.

fn try_from(chain_id: u64) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for SupportedChainId

impl Eq for SupportedChainId

impl StructuralPartialEq for SupportedChainId