chains 0.1.0

Rust bindings for the Ethereum Chain List.
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
//!
//! Rust bindings for the [Ethereum Chain List](https://github.com/ethereum-lists/chains).

#![cfg_attr(not(feature = "std"), no_std)]
#![warn(missing_docs, unreachable_pub)]
#![deny(rustdoc::broken_intra_doc_links)]

extern crate alloc;

use alloc::vec::Vec;
use once_cell::sync::Lazy;

#[doc(hidden)]
mod common;

#[cfg(not(feature = "mini"))]
mod normal;
#[cfg(not(feature = "mini"))]
pub use normal::*;

#[cfg(feature = "mini")]
mod mini;
#[cfg(feature = "mini")]
pub use mini::*;

/// A [lazily-initialized][Lazy] [Vector][Vec] which contains all the [EIP-155 chains](https://github.com/ethereum-lists/chains)
/// deserialized into [Chain] structs.
pub static CHAINS: Lazy<Vec<Chain>> = Lazy::new(|| {
    #[cfg(not(feature = "zip"))]
    {
        #[cfg(not(feature = "mini"))]
        const JSON: &str = include_str!("../data/chains.json");
        #[cfg(feature = "mini")]
        const JSON: &str = include_str!("../data/chains_mini.json");

        serde_json::from_str(JSON).unwrap()
    }
    #[cfg(feature = "zip")]
    {
        #[cfg(not(feature = "mini"))]
        const ZIP: &[u8] = include_bytes!("../data/chains.zip");
        #[cfg(feature = "mini")]
        const ZIP: &[u8] = include_bytes!("../data/chains_mini.zip");

        let reader = std::io::Cursor::new(ZIP);
        let mut archive = zip::ZipArchive::new(reader).unwrap();
        let file = archive.by_index(0).unwrap();
        serde_json::from_reader(file).unwrap()
    }
});

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn it_works() {
        let len = CHAINS.len();
        #[cfg(feature = "std")]
        eprintln!("{len}");
        assert!(len >= 600);

        for (_i, chain) in CHAINS.iter().enumerate() {
            #[cfg(feature = "std")]
            eprintln!("{_i}: {chain:?}\n");
            assert!(!chain.name.is_empty());
            assert!(chain.chain_id > 0);
            assert!(!chain.short_name.is_empty());
            // assert!(chain.network_id > 0);
            assert!(!chain.native_currency.name.is_empty());
            assert!(!chain.native_currency.symbol.is_empty());
            assert!(chain.native_currency.decimals > 0);
            // assert!(!chain.rpc.is_empty());
            // assert!(!chain.faucets.is_empty());
            // assert!(!chain.info_url.is_empty());
        }
    }
}