feat(providers): add a subset of admin namespace

.github/workflows/ci.yml

@@ -13,6 +13,7 @@ env:
     ETHERSCAN_API_KEY_ETHEREUM: I5BXNZYP5GEDWFINGVEZKYIVU2695NPQZB
     ETHERSCAN_API_KEY_CELO: B13XSMUT6Q3Q4WZ5DNQR8RXDBA2KNTMT4M
     GOERLI_PRIVATE_KEY: "fa4a1a79e869a96fcb42727f75e3232d6865a82ea675bb95de967a7fe6a773b2"
+    GETH_BUILD: 1.10.26-e5eb32ac
 
 jobs:
     tests:
@@ -36,9 +37,9 @@ jobs:
             - name: Install geth
               run: |
                   mkdir -p "$HOME/bin"
-                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  tar -xvf geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  mv geth-linux-amd64-1.9.23-8c2f2715/geth $HOME/bin/geth
+                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-$GETH_BUILD.tar.gz
+                  tar -xvf geth-linux-amd64-$GETH_BUILD.tar.gz
+                  mv geth-linux-amd64-$GETH_BUILD/geth $HOME/bin/geth
                   chmod u+x "$HOME/bin/geth"
                   export PATH=$HOME/bin:$PATH
                   geth version
@@ -79,9 +80,9 @@ jobs:
             - name: Install geth
               run: |
                   mkdir -p "$HOME/bin"
-                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  tar -xvf geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  mv geth-linux-amd64-1.9.23-8c2f2715/geth $HOME/bin/geth
+                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-$GETH_BUILD.tar.gz
+                  tar -xvf geth-linux-amd64-$GETH_BUILD.tar.gz
+                  mv geth-linux-amd64-$GETH_BUILD/geth $HOME/bin/geth
                   chmod u+x "$HOME/bin/geth"
                   export PATH=$HOME/bin:$PATH
                   geth version
@@ -201,9 +202,9 @@ jobs:
             - name: Install geth (for state overrides example)
               run: |
                   mkdir -p "$HOME/bin"
-                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  tar -xvf geth-linux-amd64-1.9.23-8c2f2715.tar.gz
-                  mv geth-linux-amd64-1.9.23-8c2f2715/geth $HOME/bin/geth
+                  wget -q https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-$GETH_BUILD.tar.gz
+                  tar -xvf geth-linux-amd64-$GETH_BUILD.tar.gz
+                  mv geth-linux-amd64-$GETH_BUILD/geth $HOME/bin/geth
                   chmod u+x "$HOME/bin/geth"
                   export PATH=$HOME/bin:$PATH
                   geth version

CHANGELOG.md

@@ -221,6 +221,8 @@
 
 ### Unreleased
 
+-   Add a subset of the `admin` namespace 
+    [1880](https://github.com/gakonst/ethers-rs/pull/1880)
 -   Return String for net version
     [1376](https://github.com/gakonst/ethers-rs/pull/1376)
 -   Stream of paginated logs that load logs in small pages

ethers-core/Cargo.toml

@@ -27,7 +27,7 @@ tiny-keccak = { version = "2.0.2", default-features = false }
 # misc
 chrono = { version = "0.4", default-features = false }
 serde = { version = "1.0.124", default-features = false, features = ["derive"] }
-serde_json = { version = "1.0.64", default-features = false }
+serde_json = { version = "1.0.64", default-features = false, features = ["arbitrary_precision"] }
 thiserror = { version = "1.0", default-features = false }
 bytes = { version = "1.3.0", features = ["serde"] }
 hex = { version = "0.4.3", default-features = false, features = ["std"] }

ethers-core/src/types/fee.rs

@@ -1,7 +1,5 @@
-use std::str::FromStr;
-
-use crate::types::U256;
-use serde::{de::Deserializer, Deserialize, Serialize};
+use crate::{types::U256, utils::from_int_or_hex};
+use serde::{Deserialize, Serialize};
 
 #[derive(Deserialize, Serialize, Debug, Clone)]
 #[serde(rename_all = "camelCase")]
@@ -19,19 +17,3 @@ pub struct FeeHistory {
     #[serde(default)]
     pub reward: Vec<Vec<U256>>,
 }
-
-fn from_int_or_hex<'de, D>(deserializer: D) -> Result<U256, D::Error>
-where
-    D: Deserializer<'de>,
-{
-    #[derive(Deserialize)]
-    #[serde(untagged)]
-    enum IntOrHex {
-        Int(u64),
-        Hex(String),
-    }
-    match IntOrHex::deserialize(deserializer)? {
-        IntOrHex::Int(n) => Ok(U256::from(n)),
-        IntOrHex::Hex(s) => U256::from_str(s.as_str()).map_err(serde::de::Error::custom),
-    }
-}

ethers-core/src/utils/genesis.rs

@@ -0,0 +1,170 @@
+use std::collections::HashMap;
+
+use crate::{
+    types::{Address, Bytes, H256, U256, U64},
+    utils::{from_int_or_hex, from_int_or_hex_opt},
+};
+use serde::{Deserialize, Serialize};
+
+/// This represents the chain configuration, specifying the genesis block, header fields, and hard
+/// fork switch blocks.
+#[derive(Clone, Debug, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct Genesis {
+    /// The fork configuration for this network.
+    pub config: ChainConfig,
+
+    /// The genesis header nonce.
+    pub nonce: U64,
+
+    /// The genesis header timestamp.
+    pub timestamp: U64,
+
+    /// The genesis header extra data.
+    pub extra_data: Bytes,
+
+    /// The genesis header gas limit.
+    pub gas_limit: U64,
+
+    /// The genesis header difficulty.
+    #[serde(deserialize_with = "from_int_or_hex")]
+    pub difficulty: U256,
+
+    /// The genesis header mix hash.
+    pub mix_hash: H256,
+
+    /// The genesis header coinbase address.
+    pub coinbase: Address,
+
+    /// The initial state of the genesis block.
+    pub alloc: HashMap<Address, GenesisAccount>,
+}
+
+/// An account in the state of the genesis block.
+#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
+pub struct GenesisAccount {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub nonce: Option<u64>,
+    pub balance: U256,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub code: Option<Bytes>,
+    #[serde(flatten, skip_serializing_if = "Option::is_none")]
+    pub storage: Option<HashMap<H256, H256>>,
+}
+
+/// Represents a node's chain configuration.
+///
+/// See [geth's `ChainConfig`
+/// struct](https://github.com/ethereum/go-ethereum/blob/64dccf7aa411c5c7cd36090c3d9b9892945ae813/params/config.go#L349)
+/// for the source of each field.
+#[derive(Clone, Debug, Deserialize, Serialize, Default)]
+#[serde(default, rename_all = "camelCase")]
+pub struct ChainConfig {
+    /// The network's chain ID.
+    pub chain_id: u64,
+
+    /// The homestead switch block (None = no fork, 0 = already homestead).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub homestead_block: Option<u64>,
+
+    /// The DAO fork switch block (None = no fork).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub dao_fork_block: Option<u64>,
+
+    /// Whether or not the node supports the DAO hard-fork.
+    pub dao_fork_support: bool,
+
+    /// The EIP-150 hard fork block (None = no fork).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub eip150_block: Option<u64>,
+
+    /// The EIP-150 hard fork hash.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub eip150_hash: Option<H256>,
+
+    /// The EIP-155 hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub eip155_block: Option<u64>,
+
+    /// The EIP-158 hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub eip158_block: Option<u64>,
+
+    /// The Byzantium hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub byzantium_block: Option<u64>,
+
+    /// The Constantinople hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub constantinople_block: Option<u64>,
+
+    /// The Petersburg hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub petersburg_block: Option<u64>,
+
+    /// The Istanbul hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub istanbul_block: Option<u64>,
+
+    /// The Muir Glacier hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub muir_glacier_block: Option<u64>,
+
+    /// The Berlin hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub berlin_block: Option<u64>,
+
+    /// The London hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub london_block: Option<u64>,
+
+    /// The Arrow Glacier hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub arrow_glacier_block: Option<u64>,
+
+    /// The Gray Glacier hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub gray_glacier_block: Option<u64>,
+
+    /// Virtual fork after the merge to use as a network splitter.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub merge_netsplit_block: Option<u64>,
+
+    /// The Shanghai hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub shanghai_block: Option<u64>,
+
+    /// The Cancun hard fork block.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub cancun_block: Option<u64>,
+
+    /// Total difficulty reached that triggers the merge consensus upgrade.
+    #[serde(skip_serializing_if = "Option::is_none", deserialize_with = "from_int_or_hex_opt")]
+    pub terminal_total_difficulty: Option<U256>,
+
+    /// A flag specifying that the network already passed the terminal total difficulty. Its
+    /// purpose is to disable legacy sync without having seen the TTD locally.
+    pub terminal_total_difficulty_passed: bool,
+
+    /// Ethash parameters.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ethash: Option<EthashConfig>,
+
+    /// Clique parameters.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub clique: Option<CliqueConfig>,
+}
+
+/// Empty consensus configuration for proof-of-work networks.
+#[derive(Clone, Debug, Deserialize, Serialize)]
+pub struct EthashConfig {}
+
+/// Consensus configuration for Clique.
+#[derive(Clone, Debug, Deserialize, Serialize)]
+pub struct CliqueConfig {
+    /// Number of seconds between blocks to enforce.
+    pub period: u64,
+
+    /// Epoch length to reset votes and checkpoints.
+    pub epoch: u64,
+}