ethrex_common/
constants.rs

1use crate::{H160, H256};
2use ethrex_crypto::keccak::keccak_hash;
3use ethrex_rlp::constants::RLP_NULL;
4use std::{str::FromStr, sync::LazyLock};
5
6/// SYSTEM_ADDRESS used for system contract calls and BAL filtering.
7/// 0xfffffffffffffffffffffffffffffffffffffffe
8pub const SYSTEM_ADDRESS: H160 = H160([
9    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
10    0xFF, 0xFF, 0xFF, 0xFE,
11]);
12
13/// EIP-6110 beacon deposit contract on Ethereum mainnet.
14/// 0x00000000219ab540356cbb839cbe05303d7705fa
15///
16/// Lives here rather than only in `ethrex_vm::system_contracts` so that
17/// `ethrex-common` can reach it: `amsterdam_chain_config` needs it to derive a
18/// `ChainConfig` for the stateless guest, and `ethrex-common` cannot depend on
19/// `ethrex-vm`. `system_contracts` re-uses this value so there is one copy.
20pub const MAINNET_DEPOSIT_CONTRACT_ADDRESS: H160 = H160([
21    0x00, 0x00, 0x00, 0x00, 0x21, 0x9A, 0xB5, 0x40, 0x35, 0x6C, 0xBB, 0x83, 0x9C, 0xBE, 0x05, 0x30,
22    0x3D, 0x77, 0x05, 0xFA,
23]);
24
25// = Keccak256(RLP([])) as of EIP-3675
26pub static DEFAULT_OMMERS_HASH: LazyLock<H256> = LazyLock::new(|| {
27    H256::from_slice(
28        &hex::decode("1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347")
29            .expect("Failed to decode hex from string"),
30    )
31});
32
33// = Sha256([])) as of EIP-7685
34pub static DEFAULT_REQUESTS_HASH: LazyLock<H256> = LazyLock::new(|| {
35    H256::from_slice(
36        &hex::decode("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855")
37            .expect("Failed to decode hex from string"),
38    )
39});
40
41// = Root of empty Trie as of EIP-4895
42pub static EMPTY_WITHDRAWALS_HASH: LazyLock<H256> = LazyLock::new(|| {
43    H256::from_slice(
44        &hex::decode("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421")
45            .expect("Failed to decode hex from string"),
46    )
47});
48
49// Keccak256(""), represents the code hash for an account without code
50pub static EMPTY_KECCAK_HASH: LazyLock<H256> = LazyLock::new(|| {
51    H256::from_slice(
52        &hex::decode("c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470")
53            .expect("Failed to decode hex from string"),
54    )
55});
56
57pub static EMPTY_TRIE_HASH: LazyLock<H256> = LazyLock::new(|| H256(keccak_hash([RLP_NULL])));
58
59// Request related
60pub static DEPOSIT_TOPIC: LazyLock<H256> = LazyLock::new(|| {
61    H256::from_str("649bbc62d0e31342afea4e5cd82d4049e7e1ee912fc0889aa790803be39038c5")
62        .expect("Failed to decode hex from string")
63});
64
65// = Keccak256(RLP([])) as of EIP-7928
66pub static EMPTY_BLOCK_ACCESS_LIST_HASH: LazyLock<H256> = LazyLock::new(|| {
67    H256::from_slice(
68        &hex::decode("1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347")
69            .expect("Failed to decode hex from string"),
70    )
71});
72
73// === EIP-4844 constants ===
74
75/// Gas consumption of a single data blob (== blob byte size).
76pub const GAS_PER_BLOB: u32 = 1 << 17;
77
78// Minimum base fee per blob
79pub const MIN_BASE_FEE_PER_BLOB_GAS: u64 = 1;
80
81// === EIP-7934 constants ===
82
83pub const MAX_BLOCK_SIZE: u64 = 10_485_760;
84pub const RLP_BLOCK_SIZE_SAFETY_MARGIN: u64 = 2_097_152;
85pub const MAX_RLP_BLOCK_SIZE: u64 = MAX_BLOCK_SIZE - RLP_BLOCK_SIZE_SAFETY_MARGIN;
86// Blob base cost defined in EIP-7918
87pub const BLOB_BASE_COST: u64 = 8192;
88
89// === EIP-7825 constants ===
90// https://eips.ethereum.org/EIPS/eip-7825
91pub const POST_OSAKA_GAS_LIMIT_CAP: u64 = 16777216;
92pub const TX_MAX_GAS_LIMIT_AMSTERDAM: u64 = 1 << 24; // 16,777,216
93
94/// EIP-7954 (Amsterdam): maximum size of deployed bytecode, 64 KiB.
95pub const AMSTERDAM_MAX_CODE_SIZE: u64 = 0x10000;
96
97// === EIP-8037 constant ===
98// https://eips.ethereum.org/EIPS/eip-8037
99/// Ceiling on a transaction's whole `gas` field from Amsterdam on, reservoir
100/// included. EIP-7825's `TX_MAX_GAS_LIMIT` above bounds only the execution-gas
101/// dimension, so it is checked against the intrinsic execution cost rather than
102/// against `tx.gas`; this one bounds `tx.gas` itself, keeping the field inside
103/// the range a `u32` can carry.
104pub const TX_MAX_TOTAL_GAS_LIMIT_AMSTERDAM: u64 = u32::MAX as u64; // 4,294,967,295
105
106// === EIP-7928 BAL size cap constants ===
107/// GAS_BLOCK_ACCESS_LIST_ITEM: a flat per-item charge, independent of the
108/// EIP-8038 access-list repricing.
109pub const BAL_ITEM_COST: u64 = 2000;
ethrex_common/constants.rs

ethrex_common/
constants.rs
