Struct Chain 

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

Type-safe chain identifier with convenient constructors

Provides ergonomic helpers for accessing supported chains while maintaining full compatibility with alloy_chains::NamedChain.

Examples

use odos_sdk::{Chain, OdosChain};

// Convenient constructors
let chain = Chain::ethereum();
let chain = Chain::arbitrum();
let chain = Chain::base();

// From chain ID
let chain = Chain::from_chain_id(1)?;  // Ethereum
let chain = Chain::from_chain_id(42161)?;  // Arbitrum

// Access inner NamedChain
let named = chain.inner();

// Use OdosChain trait methods
let router = chain.v3_router_address()?;

Implementations

impl Chain

pub const fn ethereum() -> Self

Ethereum Mainnet (Chain ID: 1)

Examples

use odos_sdk::Chain;

let chain = Chain::ethereum();
assert_eq!(chain.id(), 1);

pub const fn arbitrum() -> Self

Arbitrum One (Chain ID: 42161)

Examples

use odos_sdk::Chain;

let chain = Chain::arbitrum();
assert_eq!(chain.id(), 42161);

pub const fn optimism() -> Self

Optimism (Chain ID: 10)

Examples

use odos_sdk::Chain;

let chain = Chain::optimism();
assert_eq!(chain.id(), 10);

pub const fn polygon() -> Self

Polygon (Chain ID: 137)

Examples

use odos_sdk::Chain;

let chain = Chain::polygon();
assert_eq!(chain.id(), 137);

pub const fn base() -> Self

Base (Chain ID: 8453)

Examples

use odos_sdk::Chain;

let chain = Chain::base();
assert_eq!(chain.id(), 8453);

pub const fn bsc() -> Self

BNB Smart Chain (Chain ID: 56)

Examples

use odos_sdk::Chain;

let chain = Chain::bsc();
assert_eq!(chain.id(), 56);

pub const fn avalanche() -> Self

Avalanche C-Chain (Chain ID: 43114)

Examples

use odos_sdk::Chain;

let chain = Chain::avalanche();
assert_eq!(chain.id(), 43114);

pub const fn linea() -> Self

Linea (Chain ID: 59144)

Examples

use odos_sdk::Chain;

let chain = Chain::linea();
assert_eq!(chain.id(), 59144);

pub const fn zksync() -> Self

ZkSync Era (Chain ID: 324)

Examples

use odos_sdk::Chain;

let chain = Chain::zksync();
assert_eq!(chain.id(), 324);

pub const fn mantle() -> Self

Mantle (Chain ID: 5000)

Examples

use odos_sdk::Chain;

let chain = Chain::mantle();
assert_eq!(chain.id(), 5000);

pub const fn fraxtal() -> Self

Fraxtal (Chain ID: 252)

Examples

use odos_sdk::Chain;

let chain = Chain::fraxtal();
assert_eq!(chain.id(), 252);

pub const fn sonic() -> Self

Sonic (Chain ID: 146)

Examples

use odos_sdk::Chain;

let chain = Chain::sonic();
assert_eq!(chain.id(), 146);

pub const fn unichain() -> Self

Unichain (Chain ID: 130)

Examples

use odos_sdk::Chain;

let chain = Chain::unichain();
assert_eq!(chain.id(), 130);

pub fn from_chain_id(id: u64) -> OdosChainResult<Self>

Create a chain from a chain ID

Arguments

• id - The EVM chain ID

Returns

• Ok(Chain) - If the chain ID is recognized
• Err(OdosChainError) - If the chain ID is not supported

Examples

use odos_sdk::Chain;

let chain = Chain::from_chain_id(1)?;      // Ethereum
let chain = Chain::from_chain_id(42161)?;  // Arbitrum
let chain = Chain::from_chain_id(8453)?;   // Base

// Unsupported chain
assert!(Chain::from_chain_id(999999).is_err());

pub fn id(&self) -> u64

Get the chain ID

Examples

use odos_sdk::Chain;

assert_eq!(Chain::ethereum().id(), 1);
assert_eq!(Chain::arbitrum().id(), 42161);
assert_eq!(Chain::base().id(), 8453);

pub const fn inner(&self) -> NamedChain

Get the inner NamedChain

Examples

use odos_sdk::Chain;
use alloy_chains::NamedChain;

let chain = Chain::ethereum();
assert_eq!(chain.inner(), NamedChain::Mainnet);

pub fn from_name(name: &str) -> OdosChainResult<Self>

Parse a supported Odos chain from a common human-readable name or alias.

Accepts common aliases such as mainnet, ethereum, arb, op, and numeric chain IDs encoded as strings.

Trait Implementations

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

Formats the value using the given formatter.

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

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Chain

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

Formats the value using the given formatter.

impl From<Chain> for NamedChain

fn from(chain: Chain) -> Self

Converts to this type from the input type.

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(chain: NamedChain) -> Self

Converts to this type from the input type.

impl FromStr for Chain

type Err = OdosChainError

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

fn lo_router_address(&self) -> OdosChainResult<Address>

Get the Limit Order V2 router address for this chain

fn v2_router_address(&self) -> OdosChainResult<Address>

Get the V2 router address for this chain

fn v3_router_address(&self) -> OdosChainResult<Address>

Get the V3 router address for this chain

fn supports_odos(&self) -> bool

Check if this chain supports Odos protocol

fn supports_lo(&self) -> bool

Check if this chain supports Odos Limit Order

fn supports_v2(&self) -> bool

Check if this chain supports Odos V2

fn supports_v3(&self) -> bool

Check if this chain supports Odos V3

fn router_availability(&self) -> RouterAvailability

Get router availability for this chain

fn try_lo_router_address(&self) -> Option<Address>

Try to get the LO router address without errors

fn try_v2_router_address(&self) -> Option<Address>

Try to get the V2 router address without errors

fn try_v3_router_address(&self) -> Option<Address>

Try to get the V3 router address without errors

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, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Chain

impl Eq for Chain

impl StructuralPartialEq for Chain