reth_rpc_server_types/
constants.rs

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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
use std::cmp::max;

/// The default port for the http server
pub const DEFAULT_HTTP_RPC_PORT: u16 = 8545;

/// The default port for the ws server
pub const DEFAULT_WS_RPC_PORT: u16 = 8546;

/// The default port for the auth server.
pub const DEFAULT_AUTH_PORT: u16 = 8551;

/// The default maximum block range allowed to filter
pub const DEFAULT_MAX_BLOCKS_PER_FILTER: u64 = 100_000;

/// The default maximum of logs in a single response.
pub const DEFAULT_MAX_LOGS_PER_RESPONSE: usize = 20_000;

/// The default maximum number tracing requests we're allowing concurrently.
/// Tracing is mostly CPU bound so we're limiting the number of concurrent requests to something
/// lower that the number of cores, in order to minimize the impact on the rest of the system.
pub fn default_max_tracing_requests() -> usize {
    // We reserve 2 cores for the rest of the system
    const RESERVED: usize = 2;

    std::thread::available_parallelism()
        .map_or(25, |cpus| max(cpus.get().saturating_sub(RESERVED), RESERVED))
}

/// The default number of getproof calls we are allowing to run concurrently.
pub const DEFAULT_PROOF_PERMITS: usize = 25;

/// The default IPC endpoint
#[cfg(windows)]
pub const DEFAULT_IPC_ENDPOINT: &str = r"\\.\pipe\reth.ipc";

/// The default IPC endpoint
#[cfg(not(windows))]
pub const DEFAULT_IPC_ENDPOINT: &str = "/tmp/reth.ipc";

/// The engine_api IPC endpoint
#[cfg(windows)]
pub const DEFAULT_ENGINE_API_IPC_ENDPOINT: &str = r"\\.\pipe\reth_engine_api.ipc";

/// The `engine_api` IPC endpoint
#[cfg(not(windows))]
pub const DEFAULT_ENGINE_API_IPC_ENDPOINT: &str = "/tmp/reth_engine_api.ipc";

/// The default limit for blocks count in `eth_simulateV1`.
pub const DEFAULT_MAX_SIMULATE_BLOCKS: u64 = 256;

/// The default eth historical proof window.
pub const DEFAULT_ETH_PROOF_WINDOW: u64 = 0;

/// Maximum eth historical proof window. Equivalent to roughly 6 months of data on a 12
/// second block time, and a month on a 2 second block time.
pub const MAX_ETH_PROOF_WINDOW: u64 = 28 * 24 * 60 * 60 / 2;

/// GPO specific constants
pub mod gas_oracle {
    use alloy_primitives::U256;

    /// The number of transactions sampled in a block
    pub const SAMPLE_NUMBER: usize = 3_usize;

    /// The default maximum number of blocks to use for the gas price oracle.
    pub const MAX_HEADER_HISTORY: u64 = 1024;

    /// Number of recent blocks to check for gas price
    pub const DEFAULT_GAS_PRICE_BLOCKS: u32 = 20;

    /// The percentile of gas prices to use for the estimate
    pub const DEFAULT_GAS_PRICE_PERCENTILE: u32 = 60;

    /// Maximum transaction priority fee (or gas price before London Fork) to be recommended by the
    /// gas price oracle
    pub const DEFAULT_MAX_GAS_PRICE: U256 = U256::from_limbs([500_000_000_000u64, 0, 0, 0]);

    /// The default minimum gas price, under which the sample will be ignored
    pub const DEFAULT_IGNORE_GAS_PRICE: U256 = U256::from_limbs([2u64, 0, 0, 0]);

    /// The default gas limit for `eth_call` and adjacent calls.
    ///
    /// This is different from the default to regular 30M block gas limit `ETHEREUM_BLOCK_GAS_LIMIT`
    /// to allow for more complex calls.
    pub const RPC_DEFAULT_GAS_CAP: u64 = 50_000_000;

    /// Allowed error ratio for gas estimation
    /// Taken from Geth's implementation in order to pass the hive tests
    /// <https://github.com/ethereum/go-ethereum/blob/a5a4fa7032bb248f5a7c40f4e8df2b131c4186a4/internal/ethapi/api.go#L56>
    pub const ESTIMATE_GAS_ERROR_RATIO: f64 = 0.015;

    /// Gas required at the beginning of a call.
    pub const CALL_STIPEND_GAS: u64 = 2_300;
}

/// Cache specific constants
pub mod cache {
    // TODO: memory based limiter is currently disabled pending <https://github.com/paradigmxyz/reth/issues/3503>
    /// Default cache size for the block cache: 500MB
    ///
    /// With an average block size of ~100kb this should be able to cache ~5000 blocks.
    pub const DEFAULT_BLOCK_CACHE_SIZE_BYTES_MB: usize = 500;

    /// Default cache size for the receipts cache: 500MB
    pub const DEFAULT_RECEIPT_CACHE_SIZE_BYTES_MB: usize = 500;

    /// Default cache size for the env cache: 1MB
    pub const DEFAULT_ENV_CACHE_SIZE_BYTES_MB: usize = 1;

    /// Default cache size for the block cache: 5000 blocks.
    pub const DEFAULT_BLOCK_CACHE_MAX_LEN: u32 = 5000;

    /// Default cache size for the receipts cache: 2000 receipts.
    pub const DEFAULT_RECEIPT_CACHE_MAX_LEN: u32 = 2000;

    /// Default cache size for the env cache: 1000 envs.
    pub const DEFAULT_ENV_CACHE_MAX_LEN: u32 = 1000;

    /// Default number of concurrent database requests.
    pub const DEFAULT_CONCURRENT_DB_REQUESTS: usize = 512;
}