signet-test-utils 0.14.0

Common utilities for testing Signet components
Documentation 
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
122
123

mod host_spec;
pub use host_spec::HostBlockSpec;

mod notif_spec;
pub use notif_spec::{ExExNotification, NotificationSpec, NotificationWithSidecars};

mod ru_spec;
pub use ru_spec::RuBlockSpec;

use alloy::{
    consensus::{
        constants::GWEI_TO_WEI, SignableTransaction, TxEip1559, TxEnvelope, TypedTransaction,
    },
    eips::Encodable2718,
    primitives::{Address, TxKind, B256, U256},
    rpc::types::mev::EthSendBundle,
    signers::{local::PrivateKeySigner, SignerSync},
    sol_types::SolCall,
};
use signet_bundle::SignetEthBundle;

/// Sign a transaction with a wallet.
pub fn sign_tx_with_key_pair(wallet: &PrivateKeySigner, tx: TypedTransaction) -> TxEnvelope {
    let signature = wallet.sign_hash_sync(&tx.signature_hash()).unwrap();
    TxEnvelope::new_unhashed(tx, signature)
}

/// Make a wallet with a deterministic keypair.
pub fn make_wallet(i: u8) -> PrivateKeySigner {
    PrivateKeySigner::from_bytes(&B256::repeat_byte(i)).unwrap()
}

/// Make a simple send transaction.
pub fn simple_send(to: Address, amount: U256, nonce: u64, ru_chain_id: u64) -> TypedTransaction {
    TxEip1559 {
        nonce,
        gas_limit: 21_000,
        to: TxKind::Call(to),
        value: amount,
        chain_id: ru_chain_id,
        max_fee_per_gas: GWEI_TO_WEI as u128 * 100,
        max_priority_fee_per_gas: GWEI_TO_WEI as u128,
        ..Default::default()
    }
    .into()
}

/// Create and sign a simple send transaction.
pub fn signed_simple_send(
    wallet: &PrivateKeySigner,
    to: Address,
    amount: U256,
    nonce: u64,
    ru_chain_id: u64,
) -> TxEnvelope {
    let tx = simple_send(to, amount, nonce, ru_chain_id);
    sign_tx_with_key_pair(wallet, tx)
}

/// Make a simple contract call transaction.
pub fn simple_call<T>(
    to: Address,
    input: &T,
    value: U256,
    nonce: u64,
    chain_id: u64,
) -> TypedTransaction
where
    T: SolCall,
{
    TxEip1559 {
        nonce,
        gas_limit: 2_100_000,
        to: TxKind::Call(to),
        value,
        chain_id,
        max_fee_per_gas: GWEI_TO_WEI as u128 * 100,
        max_priority_fee_per_gas: GWEI_TO_WEI as u128,
        input: input.abi_encode().into(),
        ..Default::default()
    }
    .into()
}

/// Create and sign a simple contract call transaction.
pub fn signed_simple_call(
    wallet: &PrivateKeySigner,
    to: Address,
    input: &impl SolCall,
    value: U256,
    nonce: u64,
    chain_id: u64,
) -> TxEnvelope {
    let tx = simple_call(to, input, value, nonce, chain_id);
    sign_tx_with_key_pair(wallet, tx)
}

/// Create a simple bundle from a list of transactions.
pub fn simple_bundle(
    txs: Vec<TxEnvelope>,
    host_txs: Vec<TxEnvelope>,
    block_number: u64,
) -> SignetEthBundle {
    let txs = txs.into_iter().map(|tx| tx.encoded_2718().into()).collect();
    let host_txs = host_txs.into_iter().map(|tx| tx.encoded_2718().into()).collect();

    SignetEthBundle {
        bundle: EthSendBundle {
            txs,
            block_number,
            min_timestamp: None,
            max_timestamp: None,
            reverting_tx_hashes: vec![],
            replacement_uuid: Some(uuid::Uuid::new_v4().to_string()),
            dropping_tx_hashes: vec![],
            refund_percent: None,
            refund_recipient: None,
            refund_tx_hashes: vec![],
            extra_fields: Default::default(),
        },
        host_txs,
    }
}