foundry_common/
constants.rs

Help
1//! Commonly used constants.
2
3use alloy_consensus::Typed2718;
4use alloy_network::AnyTxEnvelope;
5use alloy_primitives::{address, Address, PrimitiveSignature, B256};
6use std::time::Duration;
7
8/// The dev chain-id, inherited from hardhat
9pub const DEV_CHAIN_ID: u64 = 31337;
10
11/// The first four bytes of the call data for a function call specifies the function to be called.
12pub const SELECTOR_LEN: usize = 4;
13
14/// Maximum size in bytes (0x6000) that a contract can have.
15pub const CONTRACT_MAX_SIZE: usize = 24576;
16
17/// Default request timeout for http requests
18///
19/// Note: this is only used so that connections, that are discarded on the server side won't stay
20/// open forever. We assume some nodes may have some backoff baked into them and will delay some
21/// responses. This timeout should be a reasonable amount of time to wait for a request.
22pub const REQUEST_TIMEOUT: Duration = Duration::from_secs(45);
23
24/// Alchemy free tier cups: <https://docs.alchemy.com/reference/pricing-plans>
25pub const ALCHEMY_FREE_TIER_CUPS: u64 = 330;
26
27/// Logged when an error is indicative that the user is trying to fork from a non-archive node.
28pub const NON_ARCHIVE_NODE_WARNING: &str = "\
29It looks like you're trying to fork from an older block with a non-archive node which is not \
30supported. Please try to change your RPC url to an archive node if the issue persists.";
31
32/// Arbitrum L1 sender address of the first transaction in every block.
33/// `0x00000000000000000000000000000000000a4b05`
34pub const ARBITRUM_SENDER: Address = address!("0x00000000000000000000000000000000000a4b05");
35
36/// The system address, the sender of the first transaction in every block:
37/// `0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001`
38///
39/// See also <https://github.com/ethereum-optimism/optimism/blob/65ec61dde94ffa93342728d324fecf474d228e1f/specs/deposits.md#l1-attributes-deposited-transaction>
40pub const OPTIMISM_SYSTEM_ADDRESS: Address = address!("0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001");
41
42/// Transaction identifier of System transaction types
43pub const SYSTEM_TRANSACTION_TYPE: u8 = 126;
44
45/// Default user agent set as the header for requests that don't specify one.
46pub const DEFAULT_USER_AGENT: &str = concat!("foundry/", env!("CARGO_PKG_VERSION"));
47
48/// Returns whether the sender is a known L2 system sender that is the first tx in every block.
49///
50/// Transactions from these senders usually don't have a any fee information.
51///
52/// See: [ARBITRUM_SENDER], [OPTIMISM_SYSTEM_ADDRESS]
53#[inline]
54pub fn is_known_system_sender(sender: Address) -> bool {
55    [ARBITRUM_SENDER, OPTIMISM_SYSTEM_ADDRESS].contains(&sender)
56}
57
58pub fn is_impersonated_tx(tx: &AnyTxEnvelope) -> bool {
59    if let AnyTxEnvelope::Ethereum(tx) = tx {
60        return is_impersonated_sig(tx.signature(), tx.ty());
61    }
62    false
63}
64
65pub fn is_impersonated_sig(sig: &PrimitiveSignature, ty: u8) -> bool {
66    let impersonated_sig = PrimitiveSignature::from_scalars_and_parity(
67        B256::with_last_byte(1),
68        B256::with_last_byte(1),
69        false,
70    );
71    if ty != SYSTEM_TRANSACTION_TYPE && sig == &impersonated_sig {
72        return true;
73    }
74    false
75}
76
77#[cfg(test)]
78mod tests {
79    use super::*;
80
81    #[test]
82    fn test_constant_sender() {
83        let arb = address!("0x00000000000000000000000000000000000a4b05");
84        assert_eq!(arb, ARBITRUM_SENDER);
85        let base = address!("0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001");
86        assert_eq!(base, OPTIMISM_SYSTEM_ADDRESS);
87    }
88}
foundry_common/constants.rs

foundry_common/
constants.rs
