Enum Chain 

pub enum Chain {
    Ethereum,
    Arbitrum,
    Optimism,
    Polygon,
    Base,
    Bsc,
    Sonic,
    Avalanche,
    Celo,
    HyperEvm,
}

EVM chains supported by waterpump-evm facades.

Variants are curated to chains where at least one facade has a V3ProtocolConfig. Chain IDs match the canonical EIP-155 values.

Variants

Ethereum

Ethereum mainnet (chain ID 1).

Arbitrum

Arbitrum One (chain ID 42161).

Optimism

Optimism (chain ID 10).

Polygon

Polygon PoS (chain ID 137).

Base

Base (chain ID 8453).

Bsc

BNB Smart Chain (chain ID 56).

Sonic

Sonic (chain ID 146). Home of Shadow Exchange (R14 / R7 Slice C).

Avalanche

Avalanche C-Chain (chain ID 43114).

Celo

Celo (chain ID 42220).

HyperEvm

HyperEVM mainnet (chain ID 999). Home of Project X — R26 / spec docs/superpowers/specs/2026-05-12-r26-hyperevm-prjx-design.md.

Implementations

impl Chain

pub const ALL: &'static [Self]

Exhaustive runtime-iteration array of all supported chains.

pub const fn id(self) -> u64

Canonical EIP-155 chain ID.

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

Human-readable lower-snake-case name (matches CLI value name).

pub const fn wrapped_native(self) -> Option<Address>

Canonical wrapped-native ERC20 for this chain.

Returns None for chains where the native token is already ERC20-compatible (e.g., Celo’s CELO).

Each Some(...) value is source-verified — see commit body for the cast-call / on-chain-fixture provenance trail. Spec §2 documents why wrapped-native is a chain property (not a V3ProtocolConfig property): a single facade CONFIG serves multiple chains with different WETH addresses (Uniswap V3 mainnet CONFIG → 5 chains → 5 different WETHs).

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

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

Formats the value using the given formatter.

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

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 TryFrom<u64> for Chain

type Error = u64

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for Chain

impl Eq for Chain

impl StructuralPartialEq for Chain