gluonscan-core 0.1.0

Core domain types and adapter ports for gluonscan: the read + normalize contract.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

//! Chains and ecosystems.

/// A broad on-chain ecosystem. Determines which kind of access an adapter needs.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Ecosystem {
    /// EVM-compatible chains.
    Evm,
    /// Solana.
    Solana,
    /// Bitcoin.
    Bitcoin,
}

/// A supported chain. `#[non_exhaustive]` so adding a chain is never a breaking change.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Chain {
    /// Ethereum mainnet.
    Ethereum,
    /// Base.
    Base,
    /// Arbitrum One.
    Arbitrum,
    /// OP Mainnet.
    Optimism,
    /// Polygon PoS.
    Polygon,
    /// BNB Smart Chain.
    Bnb,
    /// Monad.
    Monad,
    /// Hyperliquid EVM.
    Hyperliquid,
    /// Solana.
    Solana,
    /// Bitcoin.
    Bitcoin,
}

impl Chain {
    /// Every known chain — useful for enabling "all chains" and for exhaustive tests.
    pub const ALL: &'static [Chain] = &[
        Chain::Ethereum,
        Chain::Base,
        Chain::Arbitrum,
        Chain::Optimism,
        Chain::Polygon,
        Chain::Bnb,
        Chain::Monad,
        Chain::Hyperliquid,
        Chain::Solana,
        Chain::Bitcoin,
    ];

    /// The ecosystem this chain belongs to.
    pub fn ecosystem(self) -> Ecosystem {
        match self {
            Chain::Solana => Ecosystem::Solana,
            Chain::Bitcoin => Ecosystem::Bitcoin,
            _ => Ecosystem::Evm,
        }
    }

    /// The EVM chain id, or `None` for non-EVM chains.
    pub fn evm_chain_id(self) -> Option<u64> {
        Some(match self {
            Chain::Ethereum => 1,
            Chain::Optimism => 10,
            Chain::Bnb => 56,
            Chain::Polygon => 137,
            Chain::Base => 8453,
            Chain::Arbitrum => 42161,
            Chain::Monad => 143,
            Chain::Hyperliquid => 999,
            Chain::Solana | Chain::Bitcoin => return None,
        })
    }
}