foundry_common/
constants.rs

1//! Commonly used constants.
2
3use alloy_eips::Typed2718;
4use alloy_network::AnyTxEnvelope;
5use alloy_primitives::{Address, B256, Signature, address};
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/// The system address, the sender of the first transaction in every block:
43pub const MONAD_SYSTEM_ADDRESS: Address = address!("0x6f49a8F621353f12378d0046E7d7e4b9B249DC9e");
44
45/// Transaction identifier of System transaction types
46pub const SYSTEM_TRANSACTION_TYPE: u8 = 126;
47
48/// Default user agent set as the header for requests that don't specify one.
49pub const DEFAULT_USER_AGENT: &str = concat!("foundry/", env!("CARGO_PKG_VERSION"));
50
51/// Prefix for auto-generated type bindings using `forge bind-json`.
52pub const TYPE_BINDING_PREFIX: &str = "string constant schema_";
53
54/// Returns whether the sender is a known L2 system sender that is the first tx in every block.
55///
56/// Transactions from these senders usually don't have a any fee information OR set absurdly high fees that exceed the gas limit (See: <https://github.com/foundry-rs/foundry/pull/10608>)
57///
58/// See: [ARBITRUM_SENDER], [OPTIMISM_SYSTEM_ADDRESS], [MONAD_SYSTEM_ADDRESS] and [Address::ZERO]
59pub fn is_known_system_sender(sender: Address) -> bool {
60    [ARBITRUM_SENDER, OPTIMISM_SYSTEM_ADDRESS, MONAD_SYSTEM_ADDRESS, Address::ZERO]
61        .contains(&sender)
62}
63
64pub fn is_impersonated_tx(tx: &AnyTxEnvelope) -> bool {
65    if let AnyTxEnvelope::Ethereum(tx) = tx {
66        return is_impersonated_sig(tx.signature(), tx.ty());
67    }
68    false
69}
70
71pub fn is_impersonated_sig(sig: &Signature, ty: u8) -> bool {
72    let impersonated_sig =
73        Signature::from_scalars_and_parity(B256::with_last_byte(1), B256::with_last_byte(1), false);
74    if ty != SYSTEM_TRANSACTION_TYPE
75        && (sig == &impersonated_sig || sig.r() == impersonated_sig.r())
76    {
77        return true;
78    }
79    false
80}
81
82#[cfg(test)]
83mod tests {
84    use super::*;
85
86    #[test]
87    fn test_constant_sender() {
88        let arb = address!("0x00000000000000000000000000000000000a4b05");
89        assert_eq!(arb, ARBITRUM_SENDER);
90        let base = address!("0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001");
91        assert_eq!(base, OPTIMISM_SYSTEM_ADDRESS);
92    }
93}
foundry_common/constants.rs

foundry_common/
constants.rs
