hopli/
methods.rs

1//! This module contains all the methods used for onchain interaction, especially with Safe instance, Mutlicall, and
2//! Multisend contracts.
3//!
4//! [SafeTxOperation] corresponds to the `Operation` Enum used in Safe smart contract.
5//!
6//! [MultisendTransaction] struct is used for building transactions interacting with Multisend contract
7
8#![allow(clippy::too_many_arguments)]
9
10use std::{ops::Add, str::FromStr, sync::Arc};
11
12use IMulticall3Extract::IMulticall3ExtractInstance;
13use SafeSingleton::{SafeSingletonInstance, execTransactionCall, removeOwnerCall, setupCall};
14use alloy::{
15    network::TransactionBuilder,
16    primitives::{Address, B256, Bytes, U256, keccak256, utils::format_units},
17    providers::{
18        CallInfoTrait, CallItem, MULTICALL3_ADDRESS, MulticallBuilder, MulticallError, Provider, WalletProvider,
19        bindings::IMulticall3::{Call3, Call3Value, aggregate3Call, aggregate3ValueCall},
20    },
21    rpc::types::TransactionRequest,
22    signers::{Signer, local::PrivateKeySigner},
23    sol,
24    sol_types::{SolCall, SolValue},
25};
26use hex_literal::hex;
27use hopr_bindings::{
28    hoprnetworkregistry::HoprNetworkRegistry::HoprNetworkRegistryInstance,
29    hoprnodemanagementmodule::HoprNodeManagementModule::{
30        HoprNodeManagementModuleInstance, addChannelsAndTokenTargetCall, includeNodeCall, removeNodeCall,
31        scopeTargetTokenCall,
32    },
33    hoprnodesaferegistry::HoprNodeSafeRegistry::{HoprNodeSafeRegistryInstance, deregisterNodeBySafeCall},
34    hoprnodestakefactory::HoprNodeStakeFactory::{HoprNodeStakeFactoryInstance, cloneCall},
35    hoprtoken::HoprToken::{HoprTokenInstance, approveCall},
36};
37use hopr_crypto_types::keypairs::{ChainKeypair, Keypair};
38use tracing::{debug, info};
39
40use crate::utils::{
41    DEFAULT_ANNOUNCEMENT_PERMISSIONS, DEFAULT_CAPABILITY_PERMISSIONS, DEFAULT_NODE_PERMISSIONS,
42    DOMAIN_SEPARATOR_TYPEHASH, HelperErrors, SAFE_COMPATIBILITYFALLBACKHANDLER_ADDRESS, SAFE_MULTISEND_ADDRESS,
43    SAFE_SAFE_ADDRESS, SAFE_SAFEPROXYFACTORY_ADDRESS, SAFE_TX_TYPEHASH, SENTINEL_OWNERS, get_create2_address,
44};
45
46sol!(
47    #![sol(abi)]
48    #![sol(rpc)]
49    contract SafeSingleton {
50        event ExecutionSuccess(bytes32 indexed txHash, uint256 payment);
51
52        function setup(address[],uint256,address,bytes,address,address,uint256,address);
53        function execTransaction(address to, uint256 value, bytes calldata data, uint8 operation, uint256 safeTxGas, uint256 baseGas, uint256 gasPrice, address gasToken, address payable refundReceiver, bytes memory signatures) public payable returns (bool);
54        function removeOwner(address prevOwner, address owner, uint256 _threshold) public;
55        function getThreshold() public view returns (uint256);
56        function getOwners() public view returns (address[] memory);
57        function nonce() public view returns (uint256);
58        function domainSeparator() public view returns (bytes32);
59        function encodeTransactionData(address to, uint256 value, bytes calldata data, uint8 operation, uint256 safeTxGas, uint256 baseGas, uint256 gasPrice, address gasToken, address refundReceiver, uint256 _nonce) public view returns (bytes memory);
60        function getTransactionHash(address to, uint256 value, bytes calldata data, uint8 operation, uint256 safeTxGas, uint256 baseGas, uint256 gasPrice, address gasToken, address refundReceiver, uint256 _nonce) public view returns (bytes32);
61        function isModuleEnabled(address module) public view returns (bool);
62    }
63);
64
65sol!(
66    #![sol(abi)]
67    #![sol(rpc)]
68    contract ModuleSingleton {
69        function isNode(address) external view returns (bool);
70        function getTargets() external view returns (uint256[] memory);
71        function owner() public view returns (address);
72    }
73);
74
75sol!(
76    #![sol(abi)]
77    #![sol(rpc)]
78    function multiSend(bytes memory transactions) public payable;
79);
80
81sol!(
82    #![sol(abi)]
83    #![sol(rpc)]
84    interface IMulticall3Extract {
85        function getEthBalance(address addr) external view returns (uint256 balance);
86    }
87);
88
89/// Enums of Safe transaction operation
90#[derive(Debug, Clone, PartialEq, Eq)]
91pub enum SafeTxOperation {
92    Call,
93    DelegateCall,
94}
95impl SafeTxOperation {
96    /// convert the SafeTxOperation to exact one byte
97    pub fn to_byte(&self) -> [u8; 1] {
98        match self {
99            SafeTxOperation::Call => hex!("00"),
100            SafeTxOperation::DelegateCall => hex!("01"),
101        }
102    }
103}
104
105impl From<SafeTxOperation> for u8 {
106    fn from(s: SafeTxOperation) -> u8 {
107        s as u8
108    }
109}
110
111/// Struct to make a multisend transaction, mainly used by safe instances
112#[derive(Debug, Clone)]
113pub struct MultisendTransaction {
114    // data paylaod encoded with selector
115    pub encoded_data: Bytes,
116    // transaction type
117    pub tx_operation: SafeTxOperation,
118    // target address
119    pub to: Address,
120    // payable eth sending along the tx
121    pub value: U256,
122}
123
124/// Methods for Multisend transaction
125impl MultisendTransaction {
126    /// encode a multisend transaction
127    fn encode_packed(&self) -> Vec<u8> {
128        let tx_operation_bytes: Bytes = self.tx_operation.to_byte().into();
129
130        let value = (
131            tx_operation_bytes,                  // 1 bytes
132            self.to,                             // 20 bytes
133            U256::from(self.value),              // 32 bytes
134            U256::from(self.encoded_data.len()), // 32 bytes
135            self.encoded_data.clone(),           // bytes
136        );
137        value.abi_encode_packed()
138    }
139
140    /// build a multisend transaction data payload
141    fn build_multisend_tx(transactions: Vec<MultisendTransaction>) -> Vec<u8> {
142        let mut payload: Vec<u8> = Vec::new();
143        for transaction in transactions {
144            payload = [payload, transaction.encode_packed()].concat();
145        }
146        debug!("payload {:?}", hex::encode(&payload));
147        payload
148    }
149}
150
151/// get the domain separator of a safe instance
152/// contract_address should be safe address
153fn get_domain_separator(chain_id: U256, contract_address: Address) -> [u8; 32] {
154    keccak256(
155        (
156            B256::from_str(DOMAIN_SEPARATOR_TYPEHASH)
157                .unwrap_or_else(|_| panic!("decode the DOMAIN_SEPARATOR_TYPEHASH")), // DOMAIN_SEPARATOR_TYPEHASH
158            chain_id,         // getChainId
159            contract_address, // this
160        )
161            .abi_encode(),
162    )
163    .into()
164}
165
166/// Implement getTransactionHash() function as in vendor/solidity/safe-contracts-1.4.1/contracts/Safe.sol
167/// Note that `safeTxGas`, `baseGas`, and `gasPrice` are zero; `gasToken` is also address zero
168fn get_safe_transaction_hash(
169    to: Address,
170    value: U256,
171    data: Vec<u8>,
172    operation: SafeTxOperation,
173    refund_address: Address,
174    nonce: U256,
175    domain_separator: [u8; 32],
176) -> [u8; 32] {
177    // first encodeTransactionData()
178    let data_hash = keccak256(data);
179
180    let encoded = (
181        B256::from_str(SAFE_TX_TYPEHASH).unwrap_or_else(|_| panic!("failed to decode the SAFE_TX_TYPEHASH")), // SAFE_TX_TYPEHASH
182        to,                                                                                                   // to
183        value,                                                                                                // value
184        data_hash,                   // keccak256
185        U256::from(operation as u8), // operation
186        U256::ZERO,                  // safeTxGas
187        U256::ZERO,                  // baseGas
188        U256::ZERO,                  // gasPrice
189        Address::ZERO,               // gasToken
190        refund_address,              // refundReceiver
191        nonce,                       // _nonce
192    )
193        .abi_encode();
194
195    let safe_hash = keccak256(encoded);
196
197    let encoded_transaction_data = (hex!("1901"), domain_separator, safe_hash).abi_encode_packed();
198
199    let transaction_hash = keccak256(encoded_transaction_data);
200    debug!("transaction_hash {:?}", hex::encode(transaction_hash));
201    transaction_hash.0
202}
203
204/// Use safe to delegatecall to multisend contract
205/// Note that when no additional signature is provided, the safe must have a threshold of one,
206/// so that the transaction can be executed.
207/// Note that the refund address is the caller (safe owner) wallet
208pub async fn send_multisend_safe_transaction_with_threshold_one<P: WalletProvider + Provider>(
209    safe: SafeSingletonInstance<Arc<P>>,
210    signer_key: ChainKeypair,
211    multisend_contract: Address,
212    multisend_txns: Vec<MultisendTransaction>,
213    chain_id: U256,
214    nonce: U256,
215) -> Result<(), HelperErrors> {
216    // get signer
217    let signer = safe.provider().default_signer_address();
218    // let signer = safe.client().default_sender().expect("client must have a sender");
219    let wallet = PrivateKeySigner::from_slice(signer_key.secret().as_ref()).expect("failed to construct wallet");
220
221    // prepare a safe transaction:
222    // 1. calculate total value
223    let total_value = multisend_txns
224        .clone()
225        .into_iter()
226        .fold(U256::ZERO, |acc, cur| acc.add(cur.value));
227    // 2. prepare tx payload
228    let tx_payload = MultisendTransaction::build_multisend_tx(multisend_txns);
229    let multisend_payload = multiSendCall {
230        transactions: tx_payload.into(),
231    }
232    .abi_encode();
233    // 3. get domain separator
234    let domain_separator = get_domain_separator(chain_id, *safe.address());
235
236    debug!("multisend_payload {:?}", hex::encode(&multisend_payload));
237
238    // get transaction hash
239    let transaction_hash = get_safe_transaction_hash(
240        multisend_contract,
241        total_value,
242        multisend_payload.clone(),
243        SafeTxOperation::DelegateCall,
244        signer,
245        nonce,
246        domain_separator,
247    );
248
249    // sign the transaction
250    let signature = wallet
251        .sign_hash(&B256::from_slice(&transaction_hash))
252        .await
253        .unwrap_or_else(|_| panic!("failed to sign a transaction hash"));
254    debug!("signature {:?}", hex::encode(signature.as_bytes()));
255
256    // execute the transaction
257    let tx_receipt = safe
258        .execTransaction(
259            multisend_contract,
260            total_value,
261            multisend_payload.into(),
262            SafeTxOperation::DelegateCall.into(),
263            U256::ZERO,
264            U256::ZERO,
265            U256::ZERO,
266            Address::ZERO,
267            signer,
268            Bytes::from(signature.as_bytes()),
269        )
270        .send()
271        .await?
272        // .unwrap_or_else(|_| panic!("failed to exeute a pending transaction"))
273        .get_receipt()
274        .await?;
275
276    tx_receipt
277        .decoded_log::<SafeSingleton::ExecutionSuccess>()
278        .ok_or(HelperErrors::MultiSendError)?;
279    Ok(())
280}
281
282/// Deploy a MULTICALL contract into Anvil local chain for testing
283pub async fn deploy_multicall3_for_testing<P: Provider>(provider: Arc<P>) -> Result<(), HelperErrors> {
284    // Fund Multicall3 deployer and deploy ERC1820Registry
285    let tx = TransactionRequest::default()
286        .with_to(Address::from_str(crate::utils::MULTICALL3_DEPLOYER).expect("failed to parse MULTICALL3_DEPLOYER"))
287        .with_value(U256::from(crate::utils::ETH_VALUE_FOR_MULTICALL3_DEPLOYER));
288
289    provider
290        .send_transaction(tx)
291        .await?
292        .watch()
293        // .map_err(|e| ContractError::MiddlewareError { e })?
294        .await?;
295
296    provider.send_raw_transaction(
297        &hex!("f90f538085174876e800830f42408080b90f00608060405234801561001057600080fd5b50610ee0806100206000396000f3fe6080604052600436106100f35760003560e01c80634d2301cc1161008a578063a8b0574e11610059578063a8b0574e1461025a578063bce38bd714610275578063c3077fa914610288578063ee82ac5e1461029b57600080fd5b80634d2301cc146101ec57806372425d9d1461022157806382ad56cb1461023457806386d516e81461024757600080fd5b80633408e470116100c65780633408e47014610191578063399542e9146101a45780633e64a696146101c657806342cbb15c146101d957600080fd5b80630f28c97d146100f8578063174dea711461011a578063252dba421461013a57806327e86d6e1461015b575b600080fd5b34801561010457600080fd5b50425b6040519081526020015b60405180910390f35b61012d610128366004610a85565b6102ba565b6040516101119190610bbe565b61014d610148366004610a85565b6104ef565b604051610111929190610bd8565b34801561016757600080fd5b50437fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0140610107565b34801561019d57600080fd5b5046610107565b6101b76101b2366004610c60565b610690565b60405161011193929190610cba565b3480156101d257600080fd5b5048610107565b3480156101e557600080fd5b5043610107565b3480156101f857600080fd5b50610107610207366004610ce2565b73ffffffffffffffffffffffffffffffffffffffff163190565b34801561022d57600080fd5b5044610107565b61012d610242366004610a85565b6106ab565b34801561025357600080fd5b5045610107565b34801561026657600080fd5b50604051418152602001610111565b61012d610283366004610c60565b61085a565b6101b7610296366004610a85565b610a1a565b3480156102a757600080fd5b506101076102b6366004610d18565b4090565b60606000828067ffffffffffffffff8111156102d8576102d8610d31565b60405190808252806020026020018201604052801561031e57816020015b6040805180820190915260008152606060208201528152602001906001900390816102f65790505b5092503660005b8281101561047757600085828151811061034157610341610d60565b6020026020010151905087878381811061035d5761035d610d60565b905060200281019061036f9190610d8f565b6040810135958601959093506103886020850185610ce2565b73ffffffffffffffffffffffffffffffffffffffff16816103ac6060870187610dcd565b6040516103ba929190610e32565b60006040518083038185875af1925050503d80600081146103f7576040519150601f19603f3d011682016040523d82523d6000602084013e6103fc565b606091505b50602080850191909152901515808452908501351761046d577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260846000fd5b5050600101610325565b508234146104e6576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d756c746963616c6c333a2076616c7565206d69736d6174636800000000000060448201526064015b60405180910390fd5b50505092915050565b436060828067ffffffffffffffff81111561050c5761050c610d31565b60405190808252806020026020018201604052801561053f57816020015b606081526020019060019003908161052a5790505b5091503660005b8281101561068657600087878381811061056257610562610d60565b90506020028101906105749190610e42565b92506105836020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166105a66020850185610dcd565b6040516105b4929190610e32565b6000604051808303816000865af19150503d80600081146105f1576040519150601f19603f3d011682016040523d82523d6000602084013e6105f6565b606091505b5086848151811061060957610609610d60565b602090810291909101015290508061067d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b50600101610546565b5050509250929050565b43804060606106a086868661085a565b905093509350939050565b6060818067ffffffffffffffff8111156106c7576106c7610d31565b60405190808252806020026020018201604052801561070d57816020015b6040805180820190915260008152606060208201528152602001906001900390816106e55790505b5091503660005b828110156104e657600084828151811061073057610730610d60565b6020026020010151905086868381811061074c5761074c610d60565b905060200281019061075e9190610e76565b925061076d6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166107906040850185610dcd565b60405161079e929190610e32565b6000604051808303816000865af19150503d80600081146107db576040519150601f19603f3d011682016040523d82523d6000602084013e6107e0565b606091505b506020808401919091529015158083529084013517610851577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260646000fd5b50600101610714565b6060818067ffffffffffffffff81111561087657610876610d31565b6040519080825280602002602001820160405280156108bc57816020015b6040805180820190915260008152606060208201528152602001906001900390816108945790505b5091503660005b82811015610a105760008482815181106108df576108df610d60565b602002602001015190508686838181106108fb576108fb610d60565b905060200281019061090d9190610e42565b925061091c6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff1661093f6020850185610dcd565b60405161094d929190610e32565b6000604051808303816000865af19150503d806000811461098a576040519150601f19603f3d011682016040523d82523d6000602084013e61098f565b606091505b506020830152151581528715610a07578051610a07576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b506001016108c3565b5050509392505050565b6000806060610a2b60018686610690565b919790965090945092505050565b60008083601f840112610a4b57600080fd5b50813567ffffffffffffffff811115610a6357600080fd5b6020830191508360208260051b8501011115610a7e57600080fd5b9250929050565b60008060208385031215610a9857600080fd5b823567ffffffffffffffff811115610aaf57600080fd5b610abb85828601610a39565b90969095509350505050565b6000815180845260005b81811015610aed57602081850181015186830182015201610ad1565b81811115610aff576000602083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160200192915050565b600082825180855260208086019550808260051b84010181860160005b84811015610bb1578583037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe001895281518051151584528401516040858501819052610b9d81860183610ac7565b9a86019a9450505090830190600101610b4f565b5090979650505050505050565b602081526000610bd16020830184610b32565b9392505050565b600060408201848352602060408185015281855180845260608601915060608160051b870101935082870160005b82811015610c52577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa0888703018452610c40868351610ac7565b95509284019290840190600101610c06565b509398975050505050505050565b600080600060408486031215610c7557600080fd5b83358015158114610c8557600080fd5b9250602084013567ffffffffffffffff811115610ca157600080fd5b610cad86828701610a39565b9497909650939450505050565b838152826020820152606060408201526000610cd96060830184610b32565b95945050505050565b600060208284031215610cf457600080fd5b813573ffffffffffffffffffffffffffffffffffffffff81168114610bd157600080fd5b600060208284031215610d2a57600080fd5b5035919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81833603018112610dc357600080fd5b9190910192915050565b60008083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe1843603018112610e0257600080fd5b83018035915067ffffffffffffffff821115610e1d57600080fd5b602001915036819003821315610a7e57600080fd5b8183823760009101908152919050565b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc1833603018112610dc357600080fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa1833603018112610dc357600080fdfea2646970667358221220bb2b5c71a328032f97c676ae39a1ec2148d3e5d6f73d95e9b17910152d61f16264736f6c634300080c00331ca0edce47092c0f398cebf3ffc267f05c8e7076e3b89445e0fe50f6332273d4569ba01b0b9d000e19b24c5869b0fc3b22b0d6fa47cd63316875cbbd577d76e6fde086")
298            ).await?
299            .watch()
300            // .map_err(|e| ContractError::MiddlewareError {e})?
301            .await?;
302    Ok(())
303}
304
305/// Get chain id and safe nonce
306pub async fn get_chain_id_and_safe_nonce<P: Provider>(
307    safe: SafeSingletonInstance<P>,
308) -> Result<(U256, U256), HelperErrors> {
309    let provider = safe.provider();
310    let multicall = provider.multicall().get_chain_id().add(safe.nonce());
311    let (get_chain_id_return, nonce_return) = multicall.aggregate().await?;
312
313    Ok((get_chain_id_return, nonce_return))
314}
315
316/// Get native balance and hopr token balance for given addresses
317pub async fn get_native_and_token_balances<P: Provider>(
318    hopr_token: HoprTokenInstance<P>,
319    addresses: Vec<Address>,
320) -> Result<(Vec<U256>, Vec<U256>), MulticallError> {
321    let provider = hopr_token.provider();
322    let multicall3_instance = IMulticall3ExtractInstance::new(MULTICALL3_ADDRESS, provider);
323
324    // if there is less than two addresses, use multicall3 on each address
325    // otherwise, make multicall on all addresses
326    if addresses.is_empty() {
327        Ok((vec![], vec![]))
328    } else if addresses.len() == 1 {
329        let address = addresses[0];
330        let multicall = provider
331            .multicall()
332            .get_eth_balance(address)
333            .add(hopr_token.balanceOf(address));
334
335        let (native_balance, token_balance) = multicall.aggregate().await?;
336        Ok((vec![native_balance], vec![token_balance]))
337    } else {
338        let mut native_balances_multicall = MulticallBuilder::new_dynamic(provider);
339        let mut token_balances_multicall = MulticallBuilder::new_dynamic(provider);
340
341        for address in addresses {
342            native_balances_multicall =
343                native_balances_multicall.add_dynamic(multicall3_instance.getEthBalance(address));
344            token_balances_multicall = token_balances_multicall.add_dynamic(hopr_token.balanceOf(address));
345            // balances_multicall.add_call(hopr_token.balanceOf(address));
346        }
347
348        let native_balances_return = native_balances_multicall.aggregate().await?;
349        let token_balances_return = token_balances_multicall.aggregate().await?;
350
351        Ok((native_balances_return, token_balances_return))
352    }
353}
354
355/// Transfer some HOPR tokens from the caller to the list of addresses
356/// Address_i receives amounts_i HOPR tokens.
357/// When there's not enough token in caller's balance, if the caller is
358/// a minter, mint the missing tokens. If not, returns error
359///
360/// Attention! Do not use this function to distribute large amount of tokens
361///
362/// Note that to save gas in batch funding, we use multicall to facilitate token distribution via `transferFrom`
363/// To use this functionality, caller must grant Multicall3 contract the exact allowance equal to the sum of tokens
364/// to be transferred. As it's a separate function, there is a window between granting the allowance and executing
365/// the transactin. Attacker may take advantage of this window and steal tokens from the caller's account.
366///
367/// TODO: To mitigate this risk, create a MulticallErc777Recipient contract to enable receiption of tokens
368/// on the multicall contract and purposely re-entrance with forwarded payload
369pub async fn transfer_or_mint_tokens<P: Provider + WalletProvider>(
370    hopr_token: HoprTokenInstance<Arc<P>>,
371    addresses: Vec<Address>,
372    amounts: Vec<U256>,
373) -> Result<U256, HelperErrors> {
374    let provider = hopr_token.provider();
375    let caller = hopr_token.provider().default_signer_address();
376
377    // check if two vectors have the same length
378    assert_eq!(
379        addresses.len(),
380        amounts.len(),
381        "addresses and amounts are of different lengths in transfer_or_mint_tokens"
382    );
383
384    // early return if no recipient is provided
385    if addresses.is_empty() {
386        return Ok(U256::ZERO);
387    }
388
389    // calculate the sum of tokens to be sent
390    let total = amounts.iter().fold(U256::ZERO, |acc, cur| acc.add(cur));
391    info!("total amount of HOPR tokens to be transferred {:?}", total.to_string());
392
393    // get caller balance and its role
394    let encoded_minter_role = keccak256(b"MINTER_ROLE");
395    let multicall = provider
396        .multicall()
397        .add(
398            hopr_token.balanceOf(caller), /* .method::<_, U256>("balanceOf", caller)
399                                           * .map_err(|e| HelperErrors::MulticallError(e.to_string()))?,
400                                           * false, */
401        )
402        .add(
403            hopr_token.hasRole(encoded_minter_role, caller), /* hopr_token
404                                                              *     .method::<_, bool>("hasRole",
405                                                              * (encoded_minter_role, caller))
406                                                              *     .map_err(|e|
407                                                              * HelperErrors::MulticallError(e.to_string()))?,
408                                                              * false, */
409        );
410    let (token_balance_return, has_role_return) = multicall.aggregate().await?;
411
412    // compare the total with caller's current balance. If caller doens't have enough balance, try to mint some.
413    // Otherwise, revert
414    if total.gt(&token_balance_return) {
415        info!("caller does not have enough balance to transfer tokens to recipients.");
416        if has_role_return {
417            info!("caller tries to mint tokens");
418            hopr_token
419                .mint(caller, total, Bytes::default(), Bytes::default())
420                .send()
421                .await?
422                // .unwrap_or_else(|_| panic!("failed to exeute a pending transaction"))
423                .watch()
424                .await?;
425            // .unwrap_or_else(|_| panic!("failed to resolve a transaction receipt"));
426        } else {
427            return Err(HelperErrors::NotAMinter);
428        }
429    }
430
431    // when there are multiple recipients, use multicall; when single recipient, direct transfer
432    if addresses.len() == 1 {
433        info!("doing direct transfer...");
434
435        // direct transfer
436        hopr_token
437            .transfer(addresses[0], amounts[0])
438            .send()
439            .await?
440            // .unwrap_or_else(|_| panic!("failed to exeute a pending transaction"))
441            .watch()
442            .await?;
443        // .unwrap_or_else(|_| panic!("failed to resolve a transaction receipt"));
444    } else {
445        info!("using multicall...");
446        // use multicall
447        // TODO: introduce a new ERC777Recipient contract and batch the following separated steps into one, to mitigate
448        // the attack vector approve the multicall to be able to transfer from caller's wallet
449        hopr_token
450            .approve(MULTICALL3_ADDRESS, total)
451            .send()
452            .await?
453            // .unwrap_or_else(|_| panic!("failed to exeute a pending transaction"))
454            .watch()
455            .await?;
456
457        let calls: Vec<Call3> = addresses
458            .clone()
459            .into_iter()
460            .enumerate()
461            .map(|(i, addr)| {
462                let calldata = hopr_token.transferFrom(caller, addr, amounts[i]);
463                let call = Call3 {
464                    target: *hopr_token.address(),
465                    allowFailure: false,
466                    callData: calldata.calldata().clone(),
467                };
468                call
469            })
470            .collect::<Vec<_>>();
471        let aggregate3_payload = aggregate3Call { calls }.abi_encode();
472        let tx = TransactionRequest::default()
473            .with_to(MULTICALL3_ADDRESS)
474            .with_input(aggregate3_payload);
475        provider.send_transaction(tx).await?.watch().await?;
476    }
477
478    Ok(total)
479}
480
481/// Transfer some native tokens from the caller to the list of addresses
482/// Address_i receives amounts_i native tokens.
483pub async fn transfer_native_tokens<P: Provider + WalletProvider>(
484    provider: Arc<P>,
485    addresses: Vec<Address>,
486    amounts: Vec<U256>,
487) -> Result<U256, HelperErrors> {
488    // check if two vectors have the same length
489    assert_eq!(
490        addresses.len(),
491        amounts.len(),
492        "addresses and amounts are of different lengths in transfer_native_tokens"
493    );
494    // calculate the sum of tokens to be sent
495    let total = amounts.iter().fold(U256::ZERO, |acc, cur| acc.add(cur));
496    info!(
497        "total amount of native tokens to be transferred {:?}",
498        total.to_string()
499    );
500
501    let calls: Vec<Call3Value> = addresses
502        .clone()
503        .into_iter()
504        .enumerate()
505        .map(|(i, addr)| Call3Value {
506            target: addr,
507            allowFailure: false,
508            value: amounts[i],
509            callData: Bytes::default(),
510        })
511        .collect::<Vec<_>>();
512    let aggregate3_value_payload = aggregate3ValueCall { calls }.abi_encode();
513    let tx = TransactionRequest::default()
514        .with_to(MULTICALL3_ADDRESS)
515        .with_input(aggregate3_value_payload)
516        .with_value(total);
517    provider.send_transaction(tx).await?.watch().await?;
518    Ok(total)
519}
520
521/// Get registered safes for given nodes on the network registry
522pub async fn get_registered_safes_for_nodes_on_network_registry<P: Provider + WalletProvider>(
523    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
524    node_addresses: Vec<Address>,
525) -> Result<Vec<Address>, MulticallError> {
526    let provider = network_registry.provider();
527
528    let mut dynamic_multicall = MulticallBuilder::new_dynamic(provider.clone());
529
530    for node in node_addresses {
531        dynamic_multicall = dynamic_multicall.add_dynamic(network_registry.nodeRegisterdToAccount(node));
532    }
533
534    let response = dynamic_multicall.aggregate().await?;
535
536    Ok(response)
537}
538
539/// Register safes and nodes to the network registry, and force-sync the eligibility to true.
540/// It returns the number of removed nodes and nodes being added.
541/// - If nodes have been registered to a different safe, overwrite it (remove the old safe and regsiter with the new
542///   safe)
543/// - If ndoes have been registered to the same safe, no op
544/// - If nodes have not been registered to any safe, register it
545///
546/// After all the nodes have been added to the network registry, force-sync the eligibility of all the added safes to
547/// true
548pub async fn register_safes_and_nodes_on_network_registry<P: Provider + WalletProvider + Clone>(
549    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
550    safe_addresses: Vec<Address>,
551    node_addresses: Vec<Address>,
552) -> Result<(usize, usize), HelperErrors> {
553    assert_eq!(
554        safe_addresses.len(),
555        node_addresses.len(),
556        "unmatched lengths of safes and nodes"
557    );
558
559    // check registered safes of given node addresses
560    let registered_safes =
561        get_registered_safes_for_nodes_on_network_registry(network_registry.clone(), node_addresses.clone()).await?;
562
563    let mut nodes_to_remove: Vec<Address> = Vec::new();
564    let mut safes_to_add: Vec<Address> = Vec::new();
565    let mut nodes_to_add: Vec<Address> = Vec::new();
566
567    for (i, registered_safe) in registered_safes.iter().enumerate() {
568        if registered_safe.eq(&Address::ZERO) {
569            // no entry, add to network registry
570            safes_to_add.push(safe_addresses[i]);
571            nodes_to_add.push(node_addresses[i]);
572        } else if registered_safe.ne(&safe_addresses[i]) {
573            // remove first then add
574            nodes_to_remove.push(node_addresses[i]);
575            safes_to_add.push(safe_addresses[i]);
576            nodes_to_add.push(node_addresses[i]);
577        } else {
578            // no-op
579        }
580    }
581
582    if !nodes_to_remove.is_empty() {
583        // need to remove some nodes
584        network_registry
585            .managerDeregister(nodes_to_remove.clone())
586            .send()
587            .await?
588            .watch()
589            .await?;
590    }
591
592    network_registry
593        .managerRegister(safes_to_add.clone(), nodes_to_add.clone())
594        .send()
595        .await?
596        .watch()
597        .await?;
598
599    // force sync their eligibility
600    network_registry
601        .managerForceSync(safes_to_add.clone(), vec![true; safes_to_add.len()])
602        .send()
603        .await?
604        .watch()
605        .await?;
606
607    Ok((nodes_to_remove.len(), nodes_to_add.len()))
608}
609
610/// Deregister safes and nodes from the network registry. Does not do any action on the eligibility.
611/// It returns the number of removed nodes
612/// - If nodes have been registered to a safe, remove the node
613/// - If nodes have not been registered to any safe, no op
614pub async fn deregister_nodes_from_network_registry<P: Provider + WalletProvider + Clone>(
615    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
616    node_addresses: Vec<Address>,
617) -> Result<usize, HelperErrors> {
618    // check registered safes of given node addresses
619    let registered_safes =
620        get_registered_safes_for_nodes_on_network_registry(network_registry.clone(), node_addresses.clone()).await?;
621
622    let mut nodes_to_remove: Vec<Address> = Vec::new();
623
624    for (i, registered_safe) in registered_safes.iter().enumerate() {
625        if registered_safe.ne(&Address::ZERO) {
626            // remove the node
627            nodes_to_remove.push(node_addresses[i]);
628        }
629    }
630
631    if !nodes_to_remove.is_empty() {
632        // need to remove some nodes
633        network_registry
634            .managerDeregister(nodes_to_remove.clone())
635            .send()
636            .await?
637            .watch()
638            .await?;
639    }
640    Ok(nodes_to_remove.len())
641}
642
643/// Force-sync the eligibility to given values. This can only be called with a manager account
644pub async fn force_sync_safes_on_network_registry<P: Provider>(
645    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
646    safe_addresses: Vec<Address>,
647    eligibilities: Vec<bool>,
648) -> Result<(), HelperErrors> {
649    assert_eq!(
650        safe_addresses.len(),
651        eligibilities.len(),
652        "unmatched lengths of safes and eligibilities"
653    );
654
655    // force sync their eligibility
656    network_registry
657        .managerForceSync(safe_addresses, eligibilities)
658        .send()
659        .await?
660        .watch()
661        .await?;
662
663    Ok(())
664}
665
666pub async fn toggle_network_registry_status<P: Provider>(
667    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
668    status: bool,
669) -> Result<(), HelperErrors> {
670    let current_status = network_registry.enabled().call().await?;
671
672    info!(
673        current_status = ?current_status,
674        desired_status = ?status,
675        "Toggling network registry status",
676    );
677
678    if current_status == status {
679        info!("Network registry is already in the desired state: {:?}", status);
680        return Ok(());
681    }
682
683    if status {
684        info!("Enabling the network registry");
685        // enable network registry
686        network_registry.enableRegistry().send().await?.watch().await?;
687    } else {
688        info!("Disabling the network registry");
689        // disable network registry
690        network_registry.disableRegistry().send().await?.watch().await?;
691    }
692    Ok(())
693}
694
695/// Helper function to predict module address. Note that here the caller is the contract deployer
696pub fn predict_module_address(
697    caller: Address,
698    nonce: B256,
699    factory_address: Address,
700    implementation_address: Address,
701) -> Result<Address, HelperErrors> {
702    let module_salt = keccak256((caller, nonce).abi_encode_packed());
703    debug!("module_salt {:?}", module_salt);
704
705    let module_creation_code = (
706        Bytes::copy_from_slice(&hex!("3d602d80600a3d3981f3363d3d373d3d3d363d73")),
707        implementation_address,
708        Bytes::copy_from_slice(&hex!("5af43d82803e903d91602b57fd5bf3")),
709    )
710        .abi_encode_packed();
711    debug!("module_creation_code {:?}", module_creation_code);
712
713    let predict_module_addr = get_create2_address(factory_address, module_salt, module_creation_code);
714    debug!("predict_module_addr {:?}", predict_module_addr);
715
716    Ok(predict_module_addr)
717}
718
719/// Helper function to predict safe address
720pub fn predict_safe_address(
721    stake_factory: Address,
722    admins: Vec<Address>,
723    nonce: B256,
724    safe_fallback: Address,
725    safe_singleton: Address,
726    safe_factory: Address,
727) -> Result<Address, HelperErrors> {
728    let mut temp_admins = admins.clone();
729    temp_admins[0] = stake_factory;
730
731    let initializer = setupCall {
732        _0: temp_admins,
733        _1: U256::ONE,
734        _2: Address::ZERO,
735        _3: Bytes::from(hex!("00")),
736        _4: safe_fallback,
737        _5: Address::ZERO,
738        _6: U256::ZERO,
739        _7: Address::ZERO,
740    }
741    .abi_encode();
742
743    let safe_salt = get_salt_from_salt_nonce(initializer, nonce)?;
744    debug!("safe_salt {:?}", hex::encode(safe_salt));
745
746    let predict_safe_addr = deploy_proxy(safe_singleton, safe_salt, safe_factory)?;
747    debug!("predict_safe_addr {:?}", hex::encode(predict_safe_addr));
748
749    Ok(predict_safe_addr)
750}
751
752/// helper function to get salt nonce
753fn get_salt_from_salt_nonce(initializer: Vec<u8>, salt_nonce: B256) -> Result<[u8; 32], HelperErrors> {
754    let hashed_initializer = keccak256(initializer);
755    let encoded = (hashed_initializer, salt_nonce).abi_encode_packed();
756
757    Ok(keccak256(encoded).into())
758}
759
760/// helper function to compute create2 safe proxy address
761fn deploy_proxy(safe_singleton: Address, safe_salt: [u8; 32], safe_factory: Address) -> Result<Address, HelperErrors> {
762    let safe_creation_code = (
763        Bytes::from_static(&hex!("608060405234801561001057600080fd5b506040516101e63803806101e68339818101604052602081101561003357600080fd5b8101908080519060200190929190505050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614156100ca576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806101c46022913960400191505060405180910390fd5b806000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505060ab806101196000396000f3fe608060405273ffffffffffffffffffffffffffffffffffffffff600054167fa619486e0000000000000000000000000000000000000000000000000000000060003514156050578060005260206000f35b3660008037600080366000845af43d6000803e60008114156070573d6000fd5b3d6000f3fea264697066735822122003d1488ee65e08fa41e58e888a9865554c535f2c77126a82cb4c0f917f31441364736f6c63430007060033496e76616c69642073696e676c65746f6e20616464726573732070726f7669646564")),
764        Bytes::from_static(&hex!("000000000000000000000000")),    // pad address to bytes32
765        safe_singleton,
766    ).abi_encode_packed();
767    debug!("safe_creation_code {:?}", hex::encode(safe_creation_code.clone()));
768
769    let predict_safe_addr = get_create2_address(safe_factory, safe_salt, safe_creation_code);
770    debug!("predict_safe_addr {:?}", hex::encode(predict_safe_addr));
771
772    Ok(predict_safe_addr.0.into())
773}
774
775pub fn prepare_safe_tx_multicall_payload_from_owner_contract(
776    deployed_safe: Address,
777    target: Address,
778    refund_address: Address,
779    tx_payload: Vec<u8>,
780) -> CallItem<execTransactionCall> {
781    let approval_hash_sig = (
782        Bytes::from_static(&hex!("000000000000000000000000")),
783        MULTICALL3_ADDRESS,
784        Bytes::from_static(&hex!(
785            "0000000000000000000000000000000000000000000000000000000000000000"
786        )),
787        Bytes::from_static(&hex!("01")),
788    )
789        .abi_encode_packed();
790
791    let input = execTransactionCall {
792        to: target,
793        value: U256::ZERO,
794        data: Bytes::from(tx_payload),
795        operation: 0u8,
796        safeTxGas: U256::ZERO,
797        baseGas: U256::ZERO,
798        gasPrice: U256::ZERO,
799        gasToken: Address::ZERO,
800        refundReceiver: refund_address,
801        signatures: Bytes::from(approval_hash_sig),
802    }
803    .abi_encode();
804
805    CallItem::<execTransactionCall>::new(deployed_safe, input.into())
806}
807
808/// Deploy a safe and a module proxies via HoprStakeFactory contract with default permissions and announcement targets
809/// Within one multicall, as an owner of the safe:
810/// - deploy a safe proxy instance and a module proxy instance with multicall as an owner
811/// - add announcement as a permitted target in the deployed module proxy
812/// - approve token transfer to be done for the safe by channel contracts
813/// - if node addresses are known, include nodes to the module by safe
814/// - transfer safe ownership to actual admins
815/// - set desired threshold
816/// - if node addresses are known, include nodes and safes to the network registry.
817///
818/// Returns safe proxy address and module proxy address
819#[allow(clippy::too_many_arguments)]
820pub async fn deploy_safe_module_with_targets_and_nodes<P: WalletProvider + Provider>(
821    hopr_node_stake_factory: HoprNodeStakeFactoryInstance<Arc<P>>,
822    hopr_token_address: Address,
823    hopr_channels_address: Address,
824    hopr_module_implementation_address: Address,
825    hopr_announcement_address: Address,
826    allowance: U256,
827    node_addresses: Option<Vec<Address>>,
828    admins: Vec<Address>,
829    threshold: U256,
830) -> Result<(SafeSingletonInstance<Arc<P>>, HoprNodeManagementModuleInstance<Arc<P>>), HelperErrors> {
831    let caller = hopr_node_stake_factory.provider().default_signer_address();
832    let provider = hopr_node_stake_factory.provider();
833
834    // check safes owners are provided and threshold is valid
835    assert!(!admins.is_empty(), "safe must have valid admin(s)");
836    assert!(
837        threshold.ge(&U256::ONE) && threshold.le(&U256::from(admins.len())),
838        "safe threshold must be at least one and not greater than the total number of admins"
839    );
840    assert!(
841        !admins.contains(&MULTICALL3_ADDRESS),
842        "multicall contract cannot be an admin"
843    );
844
845    // build a new temporary admin
846    let mut temporary_admins: Vec<Address> = admins.clone();
847    temporary_admins.insert(0, MULTICALL3_ADDRESS);
848    info!(
849        "temporary_admins expends from admin from {:?} addresses to {:?}",
850        admins.len(),
851        temporary_admins.len()
852    );
853
854    // build the default permissions of capabilities
855    let default_target =
856    // let default_target: [u8; 32] =
857        U256::from_str(format!("{hopr_channels_address:?}{DEFAULT_CAPABILITY_PERMISSIONS}").as_str())
858            .unwrap();
859    debug!("default target {:?}", default_target);
860    // salt nonce
861    let curr_nonce = provider
862        .get_transaction_count(caller)
863        .pending()
864        .await
865        .map_err(|e| HelperErrors::MiddlewareError(e.to_string()))?;
866    let nonce = keccak256((caller, U256::from(curr_nonce)).abi_encode_packed());
867
868    debug!("curr_nonce {} and nonce {:?}", curr_nonce, nonce);
869
870    // predict module and safe address
871    let module_address = predict_module_address(
872        MULTICALL3_ADDRESS,
873        nonce,
874        *hopr_node_stake_factory.address(),
875        hopr_module_implementation_address,
876    )?;
877    info!("predicted module address {:?}", module_address.to_string());
878
879    let safe_address = predict_safe_address(
880        *hopr_node_stake_factory.address(),
881        temporary_admins.clone(),
882        nonce,
883        Address::from_str(SAFE_COMPATIBILITYFALLBACKHANDLER_ADDRESS).unwrap(),
884        Address::from_str(SAFE_SAFE_ADDRESS).unwrap(),
885        Address::from_str(SAFE_SAFEPROXYFACTORY_ADDRESS).unwrap(),
886    )?;
887    info!("predicted safe address {:?}", safe_address.to_string());
888
889    let deployed_module = HoprNodeManagementModuleInstance::new(module_address, provider.clone());
890    let deployed_safe = SafeSingleton::new(safe_address, provider.clone());
891
892    // Use multicall to deploy a safe proxy instance and a module proxy instance with multicall as an owner
893    let mut multicall_payloads: Vec<Call3> = vec![];
894    let safe_address = *deployed_safe.address();
895    multicall_payloads.push(Call3 {
896        target: *hopr_node_stake_factory.address(),
897        allowFailure: false,
898        callData: cloneCall {
899            moduleSingletonAddress: hopr_module_implementation_address,
900            admins: temporary_admins,
901            nonce: nonce.into(),
902            defaultTarget: default_target.into(),
903        }
904        .abi_encode()
905        .into(),
906    });
907    info!("Safe and module deployment multicall payload is created");
908
909    // add announcement as a permitted target in the deployed module proxy
910    let announcement_target =
911        U256::from_str(format!("{hopr_announcement_address:?}{DEFAULT_ANNOUNCEMENT_PERMISSIONS}").as_str()).unwrap();
912    let scope_announcement_tx_payload = scopeTargetTokenCall {
913        defaultTarget: announcement_target,
914    }
915    .abi_encode();
916
917    let multicall_payload_2 = prepare_safe_tx_multicall_payload_from_owner_contract(
918        // multicall.clone(),
919        safe_address,
920        module_address,
921        caller,
922        scope_announcement_tx_payload,
923    );
924    // let multicall = multicall.add_call(multicall_payload_2);
925    multicall_payloads.push(multicall_payload_2.to_call3());
926    info!("Announcement contract scoping multicall payload is created");
927
928    // approve token transfer to be done for the safe by channel contracts
929    let approve_tx_payload = approveCall {
930        spender: hopr_channels_address,
931        value: allowance,
932    }
933    .abi_encode();
934
935    let multicall_payload_3 = prepare_safe_tx_multicall_payload_from_owner_contract(
936        safe_address,
937        hopr_token_address,
938        caller,
939        approve_tx_payload,
940    );
941    // let multicall = multicall.add_call(multicall_payload_3);
942    multicall_payloads.push(multicall_payload_3.to_call3());
943
944    info!("Token transfer approval multicall payload is created");
945
946    // if node addresses are known, include nodes to the module by safe
947    if let Some(nodes) = node_addresses {
948        for node in nodes {
949            let node_target =
950                U256::from_str(&format!("{node:?}{DEFAULT_NODE_PERMISSIONS}")).expect("Invalid node_target format");
951
952            let encoded_call = includeNodeCall {
953                nodeDefaultTarget: node_target,
954            }
955            .abi_encode();
956
957            let payload = prepare_safe_tx_multicall_payload_from_owner_contract(
958                safe_address,
959                module_address,
960                caller,
961                encoded_call,
962            );
963
964            multicall_payloads.push(payload.to_call3());
965        }
966
967        info!("Nodes inclusion multicall payload is created");
968    } else {
969        info!("No node has been provided. Skip node inclusion action for multicall payload generation");
970    }
971
972    // renounce ownership granted to multicall so that only actual admins are included. Set the threshold.
973    let remove_owner_tx_payload = removeOwnerCall {
974        prevOwner: Address::from_str(SENTINEL_OWNERS).unwrap(),
975        owner: MULTICALL3_ADDRESS,
976        _threshold: threshold,
977    }
978    .abi_encode();
979
980    let multicall_payload_5 = prepare_safe_tx_multicall_payload_from_owner_contract(
981        safe_address,
982        safe_address,
983        caller,
984        remove_owner_tx_payload,
985    );
986    // let multicall = multicall.add_call(multicall_payload_5);
987
988    multicall_payloads.push(multicall_payload_5.to_call3());
989    info!("Admins and threshold setting multicall payload is created");
990
991    // build multicall transaction
992    let aggregate3_payload = aggregate3Call {
993        calls: multicall_payloads,
994    }
995    .abi_encode();
996    let tx = TransactionRequest::default()
997        .with_to(MULTICALL3_ADDRESS)
998        .with_input(aggregate3_payload);
999    let tx_receipt = provider.send_transaction(tx).await?.get_receipt().await?;
1000    info!("multicall is sent {:?}", tx_receipt.transaction_hash.to_string());
1001
1002    let safe_address_from_log = tx_receipt
1003        .decoded_log::<hopr_bindings::hoprnodestakefactory::HoprNodeStakeFactory::NewHoprNodeStakeSafe>()
1004        .ok_or_else(|| HelperErrors::ContractNotDeployed("cannot find safe from log".into()))?
1005        .instance;
1006    let module_address_from_log = tx_receipt
1007        .decoded_log::<hopr_bindings::hoprnodestakefactory::HoprNodeStakeFactory::NewHoprNodeStakeModule>()
1008        .ok_or_else(|| HelperErrors::ContractNotDeployed("cannot find module from log".into()))?
1009        .instance;
1010
1011    assert_eq!(
1012        safe_address,
1013        safe_address_from_log,
1014        "safe address mismatch: predicted {:?} actual {:?}",
1015        safe_address.to_string(),
1016        safe_address_from_log.to_string(),
1017    );
1018    assert_eq!(
1019        module_address,
1020        module_address_from_log,
1021        "module address mismatch: predicted {:?} actual {:?}",
1022        module_address.to_string(),
1023        module_address_from_log.to_string(),
1024    );
1025    Ok((deployed_safe, deployed_module))
1026}
1027
1028/// Get registered safes for given nodes on the node-safe registry
1029pub async fn get_registered_safes_for_nodes_on_node_safe_registry<P: Provider>(
1030    node_safe_registry: HoprNodeSafeRegistryInstance<P>,
1031    node_addresses: Vec<Address>,
1032) -> Result<Vec<Address>, MulticallError> {
1033    let provider = node_safe_registry.provider();
1034    let mut dyn_multicall = MulticallBuilder::new_dynamic(provider);
1035
1036    for node in node_addresses {
1037        dyn_multicall = dyn_multicall.add_dynamic(node_safe_registry.nodeToSafe(node));
1038    }
1039
1040    let native_balances_return = dyn_multicall.aggregate().await?;
1041
1042    Ok(native_balances_return)
1043}
1044
1045/// Deregister safes and nodes from the node-safe registry.
1046/// It returns the number of removed nodes
1047/// - If nodes have been registered to a safe, remove the node
1048/// - If nodes have not been registered to any safe, no op
1049///
1050/// When deregsitering one node, also remove the node from the module
1051pub async fn deregister_nodes_from_node_safe_registry_and_remove_from_module<P: WalletProvider + Provider>(
1052    node_safe_registry: HoprNodeSafeRegistryInstance<Arc<P>>,
1053    node_addresses: Vec<Address>,
1054    module_addresses: Vec<Address>,
1055    owner_chain_key: ChainKeypair,
1056) -> Result<u32, HelperErrors> {
1057    let provider = node_safe_registry.provider();
1058    // check registered safes of given node addresses
1059    let registered_safes =
1060        get_registered_safes_for_nodes_on_node_safe_registry(node_safe_registry.clone(), node_addresses.clone())
1061            .await
1062            .unwrap();
1063
1064    let mut nodes_to_remove_counter = 0u32;
1065
1066    for (i, registered_safe) in registered_safes.iter().enumerate() {
1067        if registered_safe.ne(&Address::ZERO) {
1068            // connect to safe
1069            let safe = SafeSingleton::new(registered_safe.to_owned(), provider.clone());
1070            // update counter
1071            nodes_to_remove_counter += 1;
1072            // get chain id and nonce
1073            let (chain_id, safe_nonce) = get_chain_id_and_safe_nonce(safe.clone()).await?;
1074
1075            // for each safe, prepare a multisend transaction to dergister node from safe and remove node from module
1076            let multisend_txns: Vec<MultisendTransaction> = vec![
1077                MultisendTransaction {
1078                    // build multisend tx payload
1079                    encoded_data: deregisterNodeBySafeCall {
1080                        nodeAddr: node_addresses[i],
1081                    }
1082                    .abi_encode()
1083                    .into(),
1084                    tx_operation: SafeTxOperation::Call,
1085                    to: *node_safe_registry.address(),
1086                    value: U256::ZERO,
1087                },
1088                MultisendTransaction {
1089                    // build multisend tx payload
1090                    encoded_data: removeNodeCall {
1091                        nodeAddress: node_addresses[i],
1092                    }
1093                    .abi_encode()
1094                    .into(),
1095                    tx_operation: SafeTxOperation::Call,
1096                    to: module_addresses[i],
1097                    value: U256::ZERO,
1098                },
1099            ];
1100
1101            // send safe transaction
1102            send_multisend_safe_transaction_with_threshold_one(
1103                safe,
1104                owner_chain_key.clone(),
1105                Address::from_str(SAFE_MULTISEND_ADDRESS).unwrap(),
1106                multisend_txns,
1107                chain_id,
1108                safe_nonce,
1109            )
1110            .await?;
1111        }
1112    }
1113
1114    Ok(nodes_to_remove_counter)
1115}
1116
1117/// Include nodes to the module
1118pub async fn include_nodes_to_module<P: WalletProvider + Provider>(
1119    safe: SafeSingletonInstance<Arc<P>>,
1120    node_addresses: Vec<Address>,
1121    module_address: Address,
1122    owner_chain_key: ChainKeypair,
1123) -> Result<(), HelperErrors> {
1124    // get chain id and nonce
1125    let (chain_id, safe_nonce) = get_chain_id_and_safe_nonce(safe.clone()).await?;
1126
1127    // prepare a multisend transaction to include each node to the  module
1128    let mut multisend_txns: Vec<MultisendTransaction> = Vec::new();
1129    for node_address in node_addresses {
1130        let node_target = U256::from_str(format!("{node_address:?}{DEFAULT_NODE_PERMISSIONS}").as_str()).unwrap();
1131        multisend_txns.push(MultisendTransaction {
1132            encoded_data: includeNodeCall {
1133                nodeDefaultTarget: node_target,
1134            }
1135            .abi_encode()
1136            .into(),
1137            tx_operation: SafeTxOperation::Call,
1138            to: module_address,
1139            value: U256::ZERO,
1140        });
1141    }
1142
1143    // send safe transaction
1144    send_multisend_safe_transaction_with_threshold_one(
1145        safe,
1146        owner_chain_key.clone(),
1147        Address::from_str(SAFE_MULTISEND_ADDRESS).unwrap(),
1148        multisend_txns,
1149        chain_id,
1150        safe_nonce,
1151    )
1152    .await?;
1153
1154    Ok(())
1155}
1156
1157/// Migrate nodes to be able to run in a new network.
1158// - scope the Channel contract of the new network to the module as target and set default permissions.
1159// - scope the Announcement contract as target to the module
1160// - approve HOPR tokens of the Safe proxy to be transferred by the new Channels contract
1161pub async fn migrate_nodes<P: WalletProvider + Provider>(
1162    safe: SafeSingletonInstance<Arc<P>>,
1163    module_addresses: Address,
1164    channels_address: Address,
1165    token_address: Address,
1166    announcement_address: Address,
1167    allowance: U256,
1168    owner_chain_key: ChainKeypair,
1169) -> Result<(), HelperErrors> {
1170    let (chain_id, safe_nonce) = get_chain_id_and_safe_nonce(safe.clone()).await?;
1171
1172    let mut multisend_txns: Vec<MultisendTransaction> = Vec::new();
1173
1174    // scope channels and tokens contract of the network
1175    let default_target =
1176        U256::from_str(format!("{channels_address:?}{DEFAULT_CAPABILITY_PERMISSIONS}").as_str()).unwrap();
1177    debug!("default target {:?}", default_target);
1178
1179    multisend_txns.push(MultisendTransaction {
1180        // build multisend tx payload
1181        encoded_data: addChannelsAndTokenTargetCall {
1182            defaultTarget: default_target,
1183        }
1184        .abi_encode()
1185        .into(),
1186        tx_operation: SafeTxOperation::Call,
1187        to: module_addresses,
1188        value: U256::ZERO,
1189    });
1190
1191    // scope announcement contract of the new network
1192    let announcement_target =
1193        U256::from_str(format!("{announcement_address:?}{DEFAULT_ANNOUNCEMENT_PERMISSIONS}").as_str()).unwrap();
1194
1195    multisend_txns.push(MultisendTransaction {
1196        // build multisend tx payload
1197        encoded_data: scopeTargetTokenCall {
1198            defaultTarget: announcement_target,
1199        }
1200        .abi_encode()
1201        .into(),
1202        tx_operation: SafeTxOperation::Call,
1203        to: module_addresses,
1204        value: U256::ZERO,
1205    });
1206
1207    // approve token transfer by the new Channels contract
1208    multisend_txns.push(MultisendTransaction {
1209        // build multisend tx payload
1210        encoded_data: approveCall {
1211            spender: channels_address,
1212            value: allowance,
1213        }
1214        .abi_encode()
1215        .into(),
1216        tx_operation: SafeTxOperation::Call,
1217        to: token_address,
1218        value: U256::ZERO,
1219    });
1220
1221    // send safe transaction
1222    send_multisend_safe_transaction_with_threshold_one(
1223        safe,
1224        owner_chain_key.clone(),
1225        Address::from_str(SAFE_MULTISEND_ADDRESS).unwrap(),
1226        multisend_txns,
1227        chain_id,
1228        safe_nonce,
1229    )
1230    .await?;
1231
1232    Ok(())
1233}
1234
1235/// Quick check if the following values are correct, for one single node:
1236/// 1. node xDAI balance
1237/// 2. If node has been included on Network Registry
1238/// 3. If node and safe are associated on Node Safe Registry
1239pub async fn debug_node_safe_module_setup_on_balance_and_registries<P: Provider>(
1240    network_registry: HoprNetworkRegistryInstance<Arc<P>>,
1241    node_safe_registry: HoprNodeSafeRegistryInstance<Arc<P>>,
1242    node_address: &Address,
1243) -> Result<Address, MulticallError> {
1244    let provider = network_registry.provider();
1245    // let mut multicall = Multicall::new(provider.clone(), Some(MULTICALL_ADDRESS))
1246    //     .await
1247    //     .expect("cannot create multicall");
1248
1249    info!("checking for node {:?}", node_address);
1250    let multicall = provider
1251        .multicall()
1252        // 1. node xDAI balance
1253        .get_eth_balance(*node_address)
1254        // 2. get safe address from the Network Registry
1255        .add(network_registry.nodeRegisterdToAccount(*node_address))
1256        // 3. get the safe address from the Node Safe Registry
1257        .add(node_safe_registry.nodeToSafe(*node_address));
1258
1259    let (node_native_balance, safe_in_network_registry, safe_in_nodesafe_registry) = multicall.aggregate().await?;
1260
1261    info!(
1262        "node does{:?} have xDAI balance {:?}",
1263        if node_native_balance.ge(
1264            &U256::from_str("100000000000000000").unwrap() // 0.1 ether
1265        ) {
1266            ""
1267        } else {
1268            " NOT"
1269        },
1270        format_units(node_native_balance, "ether").unwrap_or("Unknown balance".into())
1271    );
1272
1273    if safe_in_network_registry.eq(&Address::ZERO) {
1274        info!("Please register the node to the network registry");
1275    } else {
1276        info!("safe in network registry {:?}", safe_in_network_registry);
1277    }
1278
1279    if safe_in_nodesafe_registry.eq(&Address::ZERO) {
1280        info!("Please start the node. It will auto-register to node-safe registry");
1281    } else {
1282        info!("safe in node-safe registry {:?}", safe_in_nodesafe_registry);
1283    }
1284    info!(
1285        "Safes in both registies should match: {:?}",
1286        safe_in_network_registry.eq(&safe_in_nodesafe_registry)
1287    );
1288
1289    Ok(safe_in_network_registry)
1290}
1291
1292/// Quick check if the following values are correct, for one single node:
1293/// 4. If Safe is owned by the correct owner(s)
1294/// 5. Safe’s wxHOPR balance and allowance
1295/// 6. if the module is enabled
1296/// 7. if node is included in the module
1297/// 8. Get all the targets of the safe (then check if channel and announcement are there)
1298/// 9. Get the owner of the module
1299pub async fn debug_node_safe_module_setup_main<P: Provider>(
1300    hopr_token: HoprTokenInstance<Arc<P>>,
1301    module_address: &Address,
1302    node_address: &Address,
1303    safe_address: &Address,
1304    channel_address: &Address,
1305    announce_address: &Address,
1306) -> Result<(), MulticallError> {
1307    let provider = hopr_token.provider();
1308
1309    let safe = SafeSingleton::new(safe_address.to_owned(), provider.clone());
1310    let module = ModuleSingleton::new(module_address.to_owned(), provider.clone());
1311
1312    info!("checking for safe {:?} module {:?}", safe_address, module_address);
1313    let multicall = provider
1314        .multicall()
1315        // 4. get owners of the safe
1316        .add(safe.getOwners())
1317        // 5.a. get the wxHOPR balance for the safe address
1318        .add(hopr_token.balanceOf(*safe_address))
1319        // 5.b. get the wxHOPR balance for the safe address
1320        .add(hopr_token.allowance(*safe_address, *channel_address))
1321        // 6. if the module is enabled
1322        .add(safe.isModuleEnabled(*module_address))
1323        // 7. if node is included in the module
1324        .add(module.isNode(*node_address))
1325        // 7. get targets of the safe
1326        .add(module.getTargets())
1327        // 8. get owner of the module
1328        .add(module.owner());
1329
1330    let (
1331        safe_owners,
1332        safe_wxhopr_balance,
1333        safe_wxhopr_allownace,
1334        is_module_enabled,
1335        is_node_included,
1336        module_targets,
1337        module_owner,
1338    ) = multicall.aggregate().await?;
1339
1340    info!("safe has owners: {:?}", safe_owners);
1341    info!(
1342        "safe has wxHOPR balance: {:?}",
1343        format_units(safe_wxhopr_balance, "ether").unwrap_or("Unknown balance".into())
1344    );
1345    info!(
1346        "safe has wxHOPR allowance: {:?}",
1347        format_units(safe_wxhopr_allownace, "ether").unwrap_or("Unknown balance".into())
1348    );
1349    info!("module is enabled: {:?}", is_module_enabled);
1350    info!("node is included in the module: {:?}", is_node_included);
1351    info!("module has targets:");
1352    for target in module_targets {
1353        let target_address = format!("{target:#x}");
1354        let has_channels = target_address.contains(&format!("{channel_address:#x}"));
1355        let has_announcement = target_address.contains(&format!("{announce_address:#x}"));
1356        // check if it contains channel and announcement
1357        info!(
1358            "Target {:?} has channels {:?} has announcement {:?}",
1359            target_address, has_channels, has_announcement
1360        );
1361    }
1362
1363    info!(
1364        "module owner: {:?} same as safe address: {:?}",
1365        module_owner,
1366        module_owner.eq(safe_address)
1367    );
1368    Ok(())
1369}
1370
1371#[cfg(test)]
1372mod tests {
1373    use std::vec;
1374
1375    use alloy::{
1376        contract::Result as ContractResult,
1377        network::{EthereumWallet, TransactionBuilder},
1378        primitives::address,
1379        providers::{Identity, RootProvider, fillers::*},
1380        rpc::types::TransactionRequest,
1381        sol_types::SolValue,
1382    };
1383    use hopr_bindings::{
1384        hoprannouncements::HoprAnnouncements, hoprchannels::HoprChannels, hoprnetworkregistry::HoprNetworkRegistry,
1385        hoprnodesaferegistry::HoprNodeSafeRegistry, hoprnodestakefactory::HoprNodeStakeFactory, hoprtoken::HoprToken,
1386    };
1387    use hopr_chain_types::ContractInstances;
1388    use hopr_crypto_types::keypairs::{ChainKeypair, Keypair};
1389    use hopr_primitive_types::prelude::BytesRepresentable;
1390
1391    use super::*;
1392
1393    pub type AnvilRpcClient = FillProvider<
1394        JoinFill<
1395            JoinFill<Identity, JoinFill<GasFiller, JoinFill<BlobGasFiller, JoinFill<NonceFiller, ChainIdFiller>>>>,
1396            WalletFiller<EthereumWallet>,
1397        >,
1398        RootProvider,
1399    >;
1400    /// Used for testing. Creates RPC client to the local Anvil instance.
1401    #[cfg(not(target_arch = "wasm32"))]
1402    pub fn create_rpc_client_to_anvil(
1403        anvil: &alloy::node_bindings::AnvilInstance,
1404        signer: &hopr_crypto_types::keypairs::ChainKeypair,
1405    ) -> Arc<AnvilRpcClient> {
1406        use alloy::{
1407            providers::ProviderBuilder, rpc::client::ClientBuilder, signers::local::PrivateKeySigner,
1408            transports::http::ReqwestTransport,
1409        };
1410        use hopr_crypto_types::keypairs::Keypair;
1411
1412        let wallet = PrivateKeySigner::from_slice(signer.secret().as_ref()).expect("failed to construct wallet");
1413
1414        let transport_client = ReqwestTransport::new(anvil.endpoint_url());
1415
1416        let rpc_client = ClientBuilder::default().transport(transport_client.clone(), transport_client.guess_local());
1417
1418        let provider = ProviderBuilder::new().wallet(wallet).connect_client(rpc_client);
1419
1420        Arc::new(provider)
1421    }
1422
1423    fn get_random_address_for_testing() -> Address {
1424        // Creates a random Ethereum address, only used for testing
1425        Address::new(hopr_crypto_random::random_bytes::<
1426            { hopr_primitive_types::primitives::Address::SIZE },
1427        >())
1428    }
1429
1430    async fn deploy_safe_suites<P: Provider>(provider: Arc<P>) -> ContractResult<()> {
1431        // Check if safe suite has been deployed. If so, skip this step
1432        let code = provider
1433            .get_code_at(address!("0x914d7Fec6aaC8cd542e72Bca78B30650d45643d7"))
1434            .await?;
1435        // .map_err(|e| ContractError::MiddlewareError { e })?;
1436
1437        // only deploy contracts when needed
1438        if code.is_empty() {
1439            debug!("deploying safe code");
1440            // Deploy Safe diamond deployment proxy singleton
1441            let safe_diamond_proxy_address = {
1442                // Fund Safe singleton deployer 0.01 anvil-eth and deploy Safe singleton
1443                let tx = TransactionRequest::default()
1444                    .with_to(address!("E1CB04A0fA36DdD16a06ea828007E35e1a3cBC37"))
1445                    .with_value(U256::from(10000000000000000u128));
1446
1447                provider.send_transaction(tx).await?.watch().await?;
1448
1449                let tx = provider.send_raw_transaction(
1450            &hex!("f8a78085174876e800830186a08080b853604580600e600039806000f350fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf382f4f5a00dc4d1d21b308094a30f5f93da35e4d72e99115378f135f2295bea47301a3165a0636b822daad40aa8c52dd5132f378c0c0e6d83b4898228c7e21c84e631a0b891")
1451                ).await?.get_receipt()
1452                .await?;
1453                // .unwrap();
1454                tx.contract_address.unwrap()
1455            };
1456            debug!("Safe diamond proxy singleton {:?}", safe_diamond_proxy_address);
1457
1458            // Deploy minimum Safe suite
1459            // 1. Safe proxy factory deploySafeProxyFactory();
1460            let _tx_safe_proxy_factory = TransactionRequest::default().with_to(safe_diamond_proxy_address).with_input(
1461            hex!("0000000000000000000000000000000000000000000000000000000000000000608060405234801561001057600080fd5b50610bee806100206000396000f3fe608060405234801561001057600080fd5b50600436106100575760003560e01c80631688f0b91461005c5780633408e4701461016b57806353e5d93514610189578063d18af54d1461020c578063ec9e80bb1461033b575b600080fd5b61013f6004803603606081101561007257600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001906401000000008111156100af57600080fd5b8201836020820111156100c157600080fd5b803590602001918460018302840111640100000000831117156100e357600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192908035906020019092919050505061044a565b604051808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b6101736104fe565b6040518082815260200191505060405180910390f35b61019161050b565b6040518080602001828103825283818151815260200191508051906020019080838360005b838110156101d15780820151818401526020810190506101b6565b50505050905090810190601f1680156101fe5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b61030f6004803603608081101561022257600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff1690602001909291908035906020019064010000000081111561025f57600080fd5b82018360208201111561027157600080fd5b8035906020019184600183028401116401000000008311171561029357600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f82011690508083019250505050505050919291929080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050610536565b604051808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b61041e6004803603606081101561035157600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff1690602001909291908035906020019064010000000081111561038e57600080fd5b8201836020820111156103a057600080fd5b803590602001918460018302840111640100000000831117156103c257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290803590602001909291905050506106e5565b604051808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b60008083805190602001208360405160200180838152602001828152602001925050506040516020818303038152906040528051906020012090506104908585836107a8565b91508173ffffffffffffffffffffffffffffffffffffffff167f4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e23586604051808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a2509392505050565b6000804690508091505090565b60606040518060200161051d906109c5565b6020820181038252601f19601f82011660405250905090565b6000808383604051602001808381526020018273ffffffffffffffffffffffffffffffffffffffff1660601b8152601401925050506040516020818303038152906040528051906020012060001c905061059186868361044a565b9150600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16146106dc578273ffffffffffffffffffffffffffffffffffffffff16631e52b518838888886040518563ffffffff1660e01b8152600401808573ffffffffffffffffffffffffffffffffffffffff1681526020018473ffffffffffffffffffffffffffffffffffffffff16815260200180602001838152602001828103825284818151815260200191508051906020019080838360005b83811015610674578082015181840152602081019050610659565b50505050905090810190601f1680156106a15780820380516001836020036101000a031916815260200191505b5095505050505050600060405180830381600087803b1580156106c357600080fd5b505af11580156106d7573d6000803e3d6000fd5b505050505b50949350505050565b6000808380519060200120836106f96104fe565b60405160200180848152602001838152602001828152602001935050505060405160208183030381529060405280519060200120905061073a8585836107a8565b91508173ffffffffffffffffffffffffffffffffffffffff167f4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e23586604051808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a2509392505050565b60006107b3846109b2565b610825576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252601f8152602001807f53696e676c65746f6e20636f6e7472616374206e6f74206465706c6f7965640081525060200191505060405180910390fd5b600060405180602001610837906109c5565b6020820181038252601f19601f820116604052508573ffffffffffffffffffffffffffffffffffffffff166040516020018083805190602001908083835b602083106108985780518252602082019150602081019050602083039250610875565b6001836020036101000a038019825116818451168082178552505050505050905001828152602001925050506040516020818303038152906040529050828151826020016000f59150600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415610984576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260138152602001807f437265617465322063616c6c206661696c65640000000000000000000000000081525060200191505060405180910390fd5b6000845111156109aa5760008060008651602088016000875af114156109a957600080fd5b5b509392505050565b600080823b905060008111915050919050565b6101e6806109d38339019056fe608060405234801561001057600080fd5b506040516101e63803806101e68339818101604052602081101561003357600080fd5b8101908080519060200190929190505050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614156100ca576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806101c46022913960400191505060405180910390fd5b806000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505060ab806101196000396000f3fe608060405273ffffffffffffffffffffffffffffffffffffffff600054167fa619486e0000000000000000000000000000000000000000000000000000000060003514156050578060005260206000f35b3660008037600080366000845af43d6000803e60008114156070573d6000fd5b3d6000f3fea264697066735822122003d1488ee65e08fa41e58e888a9865554c535f2c77126a82cb4c0f917f31441364736f6c63430007060033496e76616c69642073696e676c65746f6e20616464726573732070726f7669646564a26469706673582212200fd975ca8e62d9bf08aa3d09c74b9bdc9d7acba7621835be4187989ddd0e54b164736f6c63430007060033")
1462        );
1463            // 2. Handler: only CompatibilityFallbackHandler and omit TokenCallbackHandler as it's not used now
1464            let _tx_safe_compatibility_fallback_handler = TransactionRequest::default().with_to(safe_diamond_proxy_address).with_input(
1465            hex!("0000000000000000000000000000000000000000000000000000000000000000608060405234801561001057600080fd5b5061073f806100206000396000f3fe608060405234801561001057600080fd5b50600436106100565760003560e01c806223de291461005b57806301ffc9a714610193578063150b7a02146101f6578063bc197c81146102ec578063f23a6e6114610482575b600080fd5b610191600480360360c081101561007157600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803590602001906401000000008111156100f857600080fd5b82018360208201111561010a57600080fd5b8035906020019184600183028401116401000000008311171561012c57600080fd5b90919293919293908035906020019064010000000081111561014d57600080fd5b82018360208201111561015f57600080fd5b8035906020019184600183028401116401000000008311171561018157600080fd5b9091929391929390505050610582565b005b6101de600480360360208110156101a957600080fd5b8101908080357bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916906020019092919050505061058c565b60405180821515815260200191505060405180910390f35b6102b76004803603608081101561020c57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001909291908035906020019064010000000081111561027357600080fd5b82018360208201111561028557600080fd5b803590602001918460018302840111640100000000831117156102a757600080fd5b90919293919293905050506106c6565b60405180827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916815260200191505060405180910390f35b61044d600480360360a081101561030257600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff1690602001909291908035906020019064010000000081111561035f57600080fd5b82018360208201111561037157600080fd5b8035906020019184602083028401116401000000008311171561039357600080fd5b9091929391929390803590602001906401000000008111156103b457600080fd5b8201836020820111156103c657600080fd5b803590602001918460208302840111640100000000831117156103e857600080fd5b90919293919293908035906020019064010000000081111561040957600080fd5b82018360208201111561041b57600080fd5b8035906020019184600183028401116401000000008311171561043d57600080fd5b90919293919293905050506106db565b60405180827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916815260200191505060405180910390f35b61054d600480360360a081101561049857600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803590602001909291908035906020019064010000000081111561050957600080fd5b82018360208201111561051b57600080fd5b8035906020019184600183028401116401000000008311171561053d57600080fd5b90919293919293905050506106f3565b60405180827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916815260200191505060405180910390f35b5050505050505050565b60007f4e2312e0000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916148061065757507f150b7a02000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806106bf57507f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b9050919050565b600063150b7a0260e01b905095945050505050565b600063bc197c8160e01b905098975050505050505050565b600063f23a6e6160e01b9050969550505050505056fea2646970667358221220f62cd059f3672bb04062df149e7ae71534a8512cca0172e695d98a43cff0c53564736f6c63430007060033")
1466        );
1467            // 3. Library: only MultiSendCallOnly and omit MultiSendCall
1468            let _tx_safe_multisend_call_only = TransactionRequest::default().with_to(safe_diamond_proxy_address).with_input(
1469            hex!("0000000000000000000000000000000000000000000000000000000000000000608060405234801561001057600080fd5b5061019a806100206000396000f3fe60806040526004361061001e5760003560e01c80638d80ff0a14610023575b600080fd5b6100dc6004803603602081101561003957600080fd5b810190808035906020019064010000000081111561005657600080fd5b82018360208201111561006857600080fd5b8035906020019184600183028401116401000000008311171561008a57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192905050506100de565b005b805160205b8181101561015f578083015160f81c6001820184015160601c60158301850151603584018601516055850187016000856000811461012857600181146101385761013d565b6000808585888a5af1915061013d565b600080fd5b50600081141561014c57600080fd5b82605501870196505050505050506100e3565b50505056fea26469706673582212208d297bb003abee230b5dfb38774688f37a6fbb97a82a21728e8049b2acb9b73564736f6c63430007060033")
1470        );
1471            // 4. Safe singleton deploySafe();
1472            let _tx_safe_singleton = TransactionRequest::default().with_to(safe_diamond_proxy_address).with_input(
1473            hex!("0000000000000000000000000000000000000000000000000000000000000000608060405234801561001057600080fd5b506001600481905550615c1b80620000296000396000f3fe6080604052600436106101d15760003560e01c8063affed0e0116100f7578063e19a9dd911610095578063f08a032311610064578063f08a03231461156b578063f698da25146115bc578063f8dc5dd9146115e7578063ffa1ad741461166257610226565b8063e19a9dd9146112bf578063e318b52b14611310578063e75235b8146113a1578063e86637db146113cc57610226565b8063cc2f8452116100d1578063cc2f84521461100c578063d4d9bdcd146110d9578063d8d11f7814611114578063e009cfde1461124e57610226565b8063affed0e014610d89578063b4faba0914610db4578063b63e800d14610e9c57610226565b80635624b25b1161016f5780636a7612021161013e5780636a761202146109895780637d83297414610b45578063934f3a1114610bb4578063a0e67e2b14610d1d57610226565b80635624b25b146107f05780635ae6bd37146108ae578063610b5925146108fd578063694e80c31461094e57610226565b80632f54bf6e116101ab5780632f54bf6e146104c85780633408e4701461052f578063468721a71461055a5780635229073f1461066f57610226565b80630d582f131461029357806312fb68e0146102ee5780632d9ad53d1461046157610226565b36610226573373ffffffffffffffffffffffffffffffffffffffff167f3d0ce9bfc3ed7d6862dbb28b2dea94561fe714a1b4d019aa8af39730d1ad7c3d346040518082815260200191505060405180910390a2005b34801561023257600080fd5b5060007f6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d560001b905080548061026757600080f35b36600080373360601b365260008060143601600080855af13d6000803e8061028e573d6000fd5b3d6000f35b34801561029f57600080fd5b506102ec600480360360408110156102b657600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001909291905050506116f2565b005b3480156102fa57600080fd5b5061045f6004803603608081101561031157600080fd5b81019080803590602001909291908035906020019064010000000081111561033857600080fd5b82018360208201111561034a57600080fd5b8035906020019184600183028401116401000000008311171561036c57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290803590602001906401000000008111156103cf57600080fd5b8201836020820111156103e157600080fd5b8035906020019184600183028401116401000000008311171561040357600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f82011690508083019250505050505050919291929080359060200190929190505050611ad8565b005b34801561046d57600080fd5b506104b06004803603602081101561048457600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff1690602001909291905050506123d6565b60405180821515815260200191505060405180910390f35b3480156104d457600080fd5b50610517600480360360208110156104eb57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff1690602001909291905050506124a8565b60405180821515815260200191505060405180910390f35b34801561053b57600080fd5b5061054461257a565b6040518082815260200191505060405180910390f35b34801561056657600080fd5b506106576004803603608081101561057d57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803590602001906401000000008111156105c457600080fd5b8201836020820111156105d657600080fd5b803590602001918460018302840111640100000000831117156105f857600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290803560ff169060200190929190505050612587565b60405180821515815260200191505060405180910390f35b34801561067b57600080fd5b5061076c6004803603608081101561069257600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803590602001906401000000008111156106d957600080fd5b8201836020820111156106eb57600080fd5b8035906020019184600183028401116401000000008311171561070d57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290803560ff16906020019092919050505061278d565b60405180831515815260200180602001828103825283818151815260200191508051906020019080838360005b838110156107b4578082015181840152602081019050610799565b50505050905090810190601f1680156107e15780820380516001836020036101000a031916815260200191505b50935050505060405180910390f35b3480156107fc57600080fd5b506108336004803603604081101561081357600080fd5b8101908080359060200190929190803590602001909291905050506127c3565b6040518080602001828103825283818151815260200191508051906020019080838360005b83811015610873578082015181840152602081019050610858565b50505050905090810190601f1680156108a05780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b3480156108ba57600080fd5b506108e7600480360360208110156108d157600080fd5b810190808035906020019092919050505061284a565b6040518082815260200191505060405180910390f35b34801561090957600080fd5b5061094c6004803603602081101561092057600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050612862565b005b34801561095a57600080fd5b506109876004803603602081101561097157600080fd5b8101908080359060200190929190505050612bea565b005b610b2d60048036036101408110156109a057600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803590602001906401000000008111156109e757600080fd5b8201836020820111156109f957600080fd5b80359060200191846001830284011164010000000083111715610a1b57600080fd5b9091929391929390803560ff169060200190929190803590602001909291908035906020019092919080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190640100000000811115610aa757600080fd5b820183602082011115610ab957600080fd5b80359060200191846001830284011164010000000083111715610adb57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050612d24565b60405180821515815260200191505060405180910390f35b348015610b5157600080fd5b50610b9e60048036036040811015610b6857600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190505050613253565b6040518082815260200191505060405180910390f35b348015610bc057600080fd5b50610d1b60048036036060811015610bd757600080fd5b810190808035906020019092919080359060200190640100000000811115610bfe57600080fd5b820183602082011115610c1057600080fd5b80359060200191846001830284011164010000000083111715610c3257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f82011690508083019250505050505050919291929080359060200190640100000000811115610c9557600080fd5b820183602082011115610ca757600080fd5b80359060200191846001830284011164010000000083111715610cc957600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050613278565b005b348015610d2957600080fd5b50610d32613307565b6040518080602001828103825283818151815260200191508051906020019060200280838360005b83811015610d75578082015181840152602081019050610d5a565b505050509050019250505060405180910390f35b348015610d9557600080fd5b50610d9e6134b0565b6040518082815260200191505060405180910390f35b348015610dc057600080fd5b50610e9a60048036036040811015610dd757600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190640100000000811115610e1457600080fd5b820183602082011115610e2657600080fd5b80359060200191846001830284011164010000000083111715610e4857600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192905050506134b6565b005b348015610ea857600080fd5b5061100a6004803603610100811015610ec057600080fd5b8101908080359060200190640100000000811115610edd57600080fd5b820183602082011115610eef57600080fd5b80359060200191846020830284011164010000000083111715610f1157600080fd5b909192939192939080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190640100000000811115610f5c57600080fd5b820183602082011115610f6e57600080fd5b80359060200191846001830284011164010000000083111715610f9057600080fd5b9091929391929390803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff1690602001909291905050506134d8565b005b34801561101857600080fd5b506110656004803603604081101561102f57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190505050613696565b60405180806020018373ffffffffffffffffffffffffffffffffffffffff168152602001828103825284818151815260200191508051906020019060200280838360005b838110156110c45780820151818401526020810190506110a9565b50505050905001935050505060405180910390f35b3480156110e557600080fd5b50611112600480360360208110156110fc57600080fd5b81019080803590602001909291905050506139f9565b005b34801561112057600080fd5b50611238600480360361014081101561113857600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001909291908035906020019064010000000081111561117f57600080fd5b82018360208201111561119157600080fd5b803590602001918460018302840111640100000000831117156111b357600080fd5b9091929391929390803560ff169060200190929190803590602001909291908035906020019092919080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190505050613b98565b6040518082815260200191505060405180910390f35b34801561125a57600080fd5b506112bd6004803603604081101561127157600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050613bc5565b005b3480156112cb57600080fd5b5061130e600480360360208110156112e257600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050613f4c565b005b34801561131c57600080fd5b5061139f6004803603606081101561133357600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050614138565b005b3480156113ad57600080fd5b506113b6614796565b6040518082815260200191505060405180910390f35b3480156113d857600080fd5b506114f060048036036101408110156113f057600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001909291908035906020019064010000000081111561143757600080fd5b82018360208201111561144957600080fd5b8035906020019184600183028401116401000000008311171561146b57600080fd5b9091929391929390803560ff169060200190929190803590602001909291908035906020019092919080359060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001909291905050506147a0565b6040518080602001828103825283818151815260200191508051906020019080838360005b83811015611530578082015181840152602081019050611515565b50505050905090810190601f16801561155d5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b34801561157757600080fd5b506115ba6004803603602081101561158e57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050614948565b005b3480156115c857600080fd5b506115d161499f565b6040518082815260200191505060405180910390f35b3480156115f357600080fd5b506116606004803603606081101561160a57600080fd5b81019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803573ffffffffffffffffffffffffffffffffffffffff16906020019092919080359060200190929190505050614a1d565b005b34801561166e57600080fd5b50611677614e46565b6040518080602001828103825283818151815260200191508051906020019080838360005b838110156116b757808201518184015260208101905061169c565b50505050905090810190601f1680156116e45780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6116fa614e7f565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16141580156117645750600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b801561179c57503073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b61180e576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff16600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff161461190f576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303400000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60026000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508160026000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506003600081548092919060010191905055508173ffffffffffffffffffffffffffffffffffffffff167f9465fa0c962cc76958e6373a993326400c1c94f8be2fe3a952adfa7f60b2ea2660405160405180910390a28060045414611ad457611ad381612bea565b5b5050565b611aec604182614f2290919063ffffffff16565b82511015611b62576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b6000808060008060005b868110156123ca57611b7e8882614f5c565b80945081955082965050505060008460ff1614156120035789898051906020012014611c12576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323700000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8260001c9450611c2c604188614f2290919063ffffffff16565b8260001c1015611ca4576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8751611cbd60208460001c614f8b90919063ffffffff16565b1115611d31576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60006020838a01015190508851611d6782611d5960208760001c614f8b90919063ffffffff16565b614f8b90919063ffffffff16565b1115611ddb576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60606020848b010190506320c13b0b60e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19168773ffffffffffffffffffffffffffffffffffffffff166320c13b0b8d846040518363ffffffff1660e01b8152600401808060200180602001838103835285818151815260200191508051906020019080838360005b83811015611e7d578082015181840152602081019050611e62565b50505050905090810190601f168015611eaa5780820380516001836020036101000a031916815260200191505b50838103825284818151815260200191508051906020019080838360005b83811015611ee3578082015181840152602081019050611ec8565b50505050905090810190601f168015611f105780820380516001836020036101000a031916815260200191505b5094505050505060206040518083038186803b158015611f2f57600080fd5b505afa158015611f43573d6000803e3d6000fd5b505050506040513d6020811015611f5957600080fd5b81019080805190602001909291905050507bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614611ffc576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323400000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b5050612248565b60018460ff161415612117578260001c94508473ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614806120a057506000600860008773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008c81526020019081526020016000205414155b612112576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323500000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b612247565b601e8460ff1611156121df5760018a60405160200180807f19457468657265756d205369676e6564204d6573736167653a0a333200000000815250601c018281526020019150506040516020818303038152906040528051906020012060048603858560405160008152602001604052604051808581526020018460ff1681526020018381526020018281526020019450505050506020604051602081039080840390855afa1580156121ce573d6000803e3d6000fd5b505050602060405103519450612246565b60018a85858560405160008152602001604052604051808581526020018460ff1681526020018381526020018281526020019450505050506020604051602081039080840390855afa158015612239573d6000803e3d6000fd5b5050506020604051035194505b5b5b8573ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1611801561230f5750600073ffffffffffffffffffffffffffffffffffffffff16600260008773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b80156123485750600173ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1614155b6123ba576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330323600000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8495508080600101915050611b6c565b50505050505050505050565b60008173ffffffffffffffffffffffffffffffffffffffff16600173ffffffffffffffffffffffffffffffffffffffff16141580156124a15750600073ffffffffffffffffffffffffffffffffffffffff16600160008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b9050919050565b6000600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16141580156125735750600073ffffffffffffffffffffffffffffffffffffffff16600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b9050919050565b6000804690508091505090565b6000600173ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141580156126525750600073ffffffffffffffffffffffffffffffffffffffff16600160003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b6126c4576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303400000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b6126f1858585857fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff614faa565b90508015612741573373ffffffffffffffffffffffffffffffffffffffff167f6895c13664aa4f67288b25d7a21d7aaa34916e355fb9b6fae0a139a9085becb860405160405180910390a2612785565b3373ffffffffffffffffffffffffffffffffffffffff167facd2c8702804128fdb0db2bb49f6d127dd0181c13fd45dbfe16de0930e2bd37560405160405180910390a25b949350505050565b6000606061279d86868686612587565b915060405160203d0181016040523d81523d6000602083013e8091505094509492505050565b606060006020830267ffffffffffffffff811180156127e157600080fd5b506040519080825280601f01601f1916602001820160405280156128145781602001600182028036833780820191505090505b50905060005b8381101561283f5780850154806020830260208501015250808060010191505061281a565b508091505092915050565b60076020528060005260406000206000915090505481565b61286a614e7f565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16141580156128d45750600173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b612946576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff16600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614612a47576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60016000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508060016000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508073ffffffffffffffffffffffffffffffffffffffff167fecdf3a3effea5783a3c4c2140e677577666428d44ed9d474a0b3a4c9943f844060405160405180910390a250565b612bf2614e7f565b600354811115612c6a576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b6001811015612ce1576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b806004819055507f610f7ff2b304ae8903c3de74c60c6ab1f7d6226b3f52c5161905bb5ad4039c936004546040518082815260200191505060405180910390a150565b6000806000612d3e8e8e8e8e8e8e8e8e8e8e6005546147a0565b905060056000815480929190600101919050555080805190602001209150612d67828286613278565b506000612d72614ff6565b9050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614612f58578073ffffffffffffffffffffffffffffffffffffffff166375f0bb528f8f8f8f8f8f8f8f8f8f8f336040518d63ffffffff1660e01b8152600401808d73ffffffffffffffffffffffffffffffffffffffff1681526020018c8152602001806020018a6001811115612e1557fe5b81526020018981526020018881526020018781526020018673ffffffffffffffffffffffffffffffffffffffff1681526020018573ffffffffffffffffffffffffffffffffffffffff168152602001806020018473ffffffffffffffffffffffffffffffffffffffff16815260200183810383528d8d82818152602001925080828437600081840152601f19601f820116905080830192505050838103825285818151815260200191508051906020019080838360005b83811015612ee7578082015181840152602081019050612ecc565b50505050905090810190601f168015612f145780820380516001836020036101000a031916815260200191505b509e505050505050505050505050505050600060405180830381600087803b158015612f3f57600080fd5b505af1158015612f53573d6000803e3d6000fd5b505050505b6101f4612f7f6109c48b01603f60408d0281612f7057fe5b0461502790919063ffffffff16565b015a1015612ff5576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330313000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60005a905061305e8f8f8f8f8080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050508e60008d14613053578e613059565b6109c45a035b614faa565b93506130735a8261504190919063ffffffff16565b90508380613082575060008a14155b8061308e575060008814155b613100576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330313300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60008089111561311a57613117828b8b8b8b615061565b90505b841561315d57837f442e715f626346e8c54381002da614f62bee8d27386535b2521ec8540898556e826040518082815260200191505060405180910390a2613196565b837f23428b18acfb3ea64b08dc0c1d296ea9c09702c09083ca5272e64d115b687d23826040518082815260200191505060405180910390a25b5050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614613242578073ffffffffffffffffffffffffffffffffffffffff16639327136883856040518363ffffffff1660e01b815260040180838152602001821515815260200192505050600060405180830381600087803b15801561322957600080fd5b505af115801561323d573d6000803e3d6000fd5b505050505b50509b9a5050505050505050505050565b6008602052816000526040600020602052806000526040600020600091509150505481565b60006004549050600081116132f5576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b61330184848484611ad8565b50505050565b6060600060035467ffffffffffffffff8111801561332457600080fd5b506040519080825280602002602001820160405280156133535781602001602082028036833780820191505090505b50905060008060026000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690505b600173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146134a757808383815181106133fe57fe5b602002602001019073ffffffffffffffffffffffffffffffffffffffff16908173ffffffffffffffffffffffffffffffffffffffff1681525050600260008273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081806001019250506133bd565b82935050505090565b60055481565b600080825160208401855af4806000523d6020523d600060403e60403d016000fd5b6135238a8a80806020026020016040519081016040528093929190818152602001838360200280828437600081840152601f19601f8201169050808301925050505050505089615267565b600073ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16146135615761356084615767565b5b6135af8787878080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f82011690508083019250505050505050615838565b60008211156135c9576135c782600060018685615061565b505b3373ffffffffffffffffffffffffffffffffffffffff167f141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a88b8b8b8b8960405180806020018581526020018473ffffffffffffffffffffffffffffffffffffffff1681526020018373ffffffffffffffffffffffffffffffffffffffff1681526020018281038252878782818152602001925060200280828437600081840152601f19601f820116905080830192505050965050505050505060405180910390a250505050505050505050565b60606000600173ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff1614806136da57506136d9846123d6565b5b61374c576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303500000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600083116137c2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303600000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8267ffffffffffffffff811180156137d957600080fd5b506040519080825280602002602001820160405280156138085781602001602082028036833780820191505090505b5091506000600160008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1691505b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16141580156138da5750600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b80156138e557508381105b156139a057818382815181106138f757fe5b602002602001019073ffffffffffffffffffffffffffffffffffffffff16908173ffffffffffffffffffffffffffffffffffffffff1681525050600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1691508080600101915050613870565b600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16146139ee578260018203815181106139e357fe5b602002602001015191505b808352509250929050565b600073ffffffffffffffffffffffffffffffffffffffff16600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff161415613afb576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330333000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b6001600860003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000838152602001908152602001600020819055503373ffffffffffffffffffffffffffffffffffffffff16817ff2a0eb156472d1440255b0d7c1e19cc07115d1051fe605b0dce69acfec884d9c60405160405180910390a350565b6000613bad8c8c8c8c8c8c8c8c8c8c8c6147a0565b8051906020012090509b9a5050505050505050505050565b613bcd614e7f565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614158015613c375750600173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b613ca9576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8073ffffffffffffffffffffffffffffffffffffffff16600160008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614613da9576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600160008273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600160008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506000600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508073ffffffffffffffffffffffffffffffffffffffff167faab4fa2b463f581b2b32cb3b7e3b704b9ce37cc209b5fb4d77e593ace405427660405160405180910390a25050565b613f54614e7f565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146140c6578073ffffffffffffffffffffffffffffffffffffffff166301ffc9a77fe6d7a83a000000000000000000000000000000000000000000000000000000006040518263ffffffff1660e01b815260040180827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916815260200191505060206040518083038186803b15801561401857600080fd5b505afa15801561402c573d6000803e3d6000fd5b505050506040513d602081101561404257600080fd5b81019080805190602001909291905050506140c5576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475333303000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b5b60007f4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c860001b90508181558173ffffffffffffffffffffffffffffffffffffffff167f1151116914515bc0891ff9047a6cb32cf902546f83066499bcf8ba33d2353fa260405160405180910390a25050565b614140614e7f565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16141580156141aa5750600173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156141e257503073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b614254576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff16600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614614355576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303400000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16141580156143bf5750600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b614431576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff16600260008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614614531576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303500000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555080600260008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506000600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff167ff8d49fc529812e9a7c5c50e69c20f0dccc0db8fa95c98bc58cc9a4f1c1299eaf60405160405180910390a28073ffffffffffffffffffffffffffffffffffffffff167f9465fa0c962cc76958e6373a993326400c1c94f8be2fe3a952adfa7f60b2ea2660405160405180910390a2505050565b6000600454905090565b606060007fbb8310d486368db6bd6f849402fdd73ad53d316b5a4b2644ad6efe0f941286d860001b8d8d8d8d60405180838380828437808301925050509250505060405180910390208c8c8c8c8c8c8c604051602001808c81526020018b73ffffffffffffffffffffffffffffffffffffffff1681526020018a815260200189815260200188600181111561483157fe5b81526020018781526020018681526020018581526020018473ffffffffffffffffffffffffffffffffffffffff1681526020018373ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019b505050505050505050505050604051602081830303815290604052805190602001209050601960f81b600160f81b6148bd61499f565b8360405160200180857effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff19168152600101847effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff191681526001018381526020018281526020019450505050506040516020818303038152906040529150509b9a5050505050505050505050565b614950614e7f565b61495981615767565b8073ffffffffffffffffffffffffffffffffffffffff167f5ac6c46c93c8d0e53714ba3b53db3e7c046da994313d7ed0d192028bc7c228b060405160405180910390a250565b60007f47e79534a245952e8b16893a336b85a3d9ea9fa8c573f3d803afb92a7946921860001b6149cd61257a565b30604051602001808481526020018381526020018273ffffffffffffffffffffffffffffffffffffffff168152602001935050505060405160208183030381529060405280519060200120905090565b614a25614e7f565b806001600354031015614aa0576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614158015614b0a5750600173ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b614b7c576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff16600260008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614614c7c576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303500000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600260008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506000600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600360008154809291906001900391905055508173ffffffffffffffffffffffffffffffffffffffff167ff8d49fc529812e9a7c5c50e69c20f0dccc0db8fa95c98bc58cc9a4f1c1299eaf60405160405180910390a28060045414614e4157614e4081612bea565b5b505050565b6040518060400160405280600581526020017f312e342e3100000000000000000000000000000000000000000000000000000081525081565b3073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614614f20576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330333100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b565b600080831415614f355760009050614f56565b6000828402905082848281614f4657fe5b0414614f5157600080fd5b809150505b92915050565b60008060008360410260208101860151925060408101860151915060ff60418201870151169350509250925092565b600080828401905083811015614fa057600080fd5b8091505092915050565b6000600180811115614fb857fe5b836001811115614fc457fe5b1415614fdd576000808551602087018986f49050614fed565b600080855160208701888a87f190505b95945050505050565b6000807f4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c860001b9050805491505090565b6000818310156150375781615039565b825b905092915050565b60008282111561505057600080fd5b600082840390508091505092915050565b600080600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161461509e57826150a0565b325b9050600073ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff1614156151b85761510a3a86106150e7573a6150e9565b855b6150fc888a614f8b90919063ffffffff16565b614f2290919063ffffffff16565b91508073ffffffffffffffffffffffffffffffffffffffff166108fc839081150290604051600060405180830381858888f193505050506151b3576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330313100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b61525d565b6151dd856151cf888a614f8b90919063ffffffff16565b614f2290919063ffffffff16565b91506151ea848284615b0e565b61525c576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330313200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b5b5095945050505050565b6000600454146152df576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b8151811115615356576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303100000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60018110156153cd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60006001905060005b83518110156156d35760008482815181106153ed57fe5b60200260200101519050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16141580156154615750600173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b801561549957503073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156154d157508073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614155b615543576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303300000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff16600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614615644576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475332303400000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b80600260008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508092505080806001019150506153d6565b506001600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550825160038190555081600481905550505050565b3073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415615809576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475334303000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b60007f6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d560001b90508181555050565b600073ffffffffffffffffffffffffffffffffffffffff1660016000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff161461593a576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475331303000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b6001806000600173ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614615b0a576159f682615bd2565b615a68576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330303200000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b615a978260008360017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff614faa565b615b09576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260058152602001807f475330303000000000000000000000000000000000000000000000000000000081525060200191505060405180910390fd5b5b5050565b60008063a9059cbb8484604051602401808373ffffffffffffffffffffffffffffffffffffffff168152602001828152602001925050506040516020818303038152906040529060e01b6020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff83818316178352505050509050602060008251602084016000896127105a03f13d60008114615bb55760208114615bbd5760009350615bc8565b819350615bc8565b600051158215171593505b5050509392505050565b600080823b90506000811191505091905056fea264697066735822122057398fa72884cf9a6cb78aab2fb58a6b927f0e9d97d75b015daaee0959a153bf64736f6c63430007060033")
1474        );
1475            // 5. Safe multisend:
1476            let _tx_safe_multisend = TransactionRequest::default().with_to(safe_diamond_proxy_address).with_input(
1477                hex!("000000000000000000000000000000000000000000000000000000000000000060a060405234801561001057600080fd5b503073ffffffffffffffffffffffffffffffffffffffff1660808173ffffffffffffffffffffffffffffffffffffffff1660601b8152505060805160601c6102756100646000398060e052506102756000f3fe60806040526004361061001e5760003560e01c80638d80ff0a14610023575b600080fd5b6100dc6004803603602081101561003957600080fd5b810190808035906020019064010000000081111561005657600080fd5b82018360208201111561006857600080fd5b8035906020019184600183028401116401000000008311171561008a57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192905050506100de565b005b7f000000000000000000000000000000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff161415610183576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260308152602001806102106030913960400191505060405180910390fd5b805160205b8181101561020a578083015160f81c6001820184015160601c6015830185015160358401860151605585018701600085600081146101cd57600181146101dd576101e8565b6000808585888a5af191506101e8565b6000808585895af491505b5060008114156101f757600080fd5b8260550187019650505050505050610188565b50505056fe4d756c746953656e642073686f756c64206f6e6c792062652063616c6c6564207669612064656c656761746563616c6ca264697066735822122021102e6d5bc1da75411b41fe2792a1748bf5c49c794e51e81405ccd2399da13564736f6c63430007060033")
1478            );
1479            // other omitted libs: SimulateTxAccessor, CreateCall, and SignMessageLib
1480            // broadcast those transactions
1481            provider.send_transaction(_tx_safe_proxy_factory).await?.watch().await?;
1482            provider
1483                .send_transaction(_tx_safe_compatibility_fallback_handler)
1484                .await?
1485                .watch()
1486                .await?;
1487            provider
1488                .send_transaction(_tx_safe_multisend_call_only)
1489                .await?
1490                .watch()
1491                .await?;
1492            provider.send_transaction(_tx_safe_singleton).await?.watch().await?;
1493            provider.send_transaction(_tx_safe_multisend).await?.watch().await?;
1494        }
1495        Ok(())
1496    }
1497
1498    #[tokio::test]
1499    async fn test_native_and_token_balances_in_anvil_with_multicall() -> anyhow::Result<()> {
1500        // create a keypair
1501        let kp = ChainKeypair::random();
1502        let kp_address = Address::from(&kp.public().to_address().into());
1503
1504        // launch local anvil instance
1505        let anvil = hopr_chain_types::utils::create_anvil(None);
1506        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1507        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1508        // deploy hopr contracts
1509        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1510            .await
1511            .expect("failed to deploy");
1512        // deploy multicall contract
1513        deploy_multicall3_for_testing(client.clone()).await?;
1514
1515        // get native and token balances
1516        let (native_balance, token_balance) = get_native_and_token_balances(instances.token, vec![kp_address]).await?;
1517        assert_eq!(native_balance.len(), 1, "invalid native balance lens");
1518        assert_eq!(token_balance.len(), 1, "invalid token balance lens");
1519        assert_eq!(native_balance[0].to::<u64>(), 0u64, "wrong native balance");
1520        assert_eq!(token_balance[0].to::<u64>(), 0u64, "wrong token balance");
1521        drop(anvil);
1522        Ok(())
1523    }
1524
1525    #[tokio::test]
1526    async fn test_transfer_or_mint_tokens_in_anvil_with_multicall() -> anyhow::Result<()> {
1527        let _ = env_logger::builder().is_test(true).try_init();
1528
1529        let mut addresses: Vec<Address> = Vec::new();
1530        for _ in 0..4 {
1531            addresses.push(get_random_address_for_testing());
1532        }
1533        let desired_amount = vec![U256::from(1), U256::from(2), U256::from(3), U256::from(4)];
1534
1535        // launch local anvil instance
1536        let anvil = hopr_chain_types::utils::create_anvil(None);
1537        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1538        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1539        // deploy hopr contracts
1540        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1541            .await
1542            .expect("failed to deploy");
1543
1544        // deploy multicall contract
1545        deploy_multicall3_for_testing(client.clone()).await?;
1546        // grant deployer token minter role
1547        let encoded_minter_role = keccak256(b"MINTER_ROLE");
1548        instances
1549            .token
1550            .grantRole(encoded_minter_role, contract_deployer.public().to_address().into())
1551            .send()
1552            .await?
1553            .watch()
1554            .await?;
1555
1556        // test the deployer has minter role now
1557        let check_minter_role = instances
1558            .token
1559            .hasRole(encoded_minter_role, contract_deployer.public().to_address().into())
1560            .call()
1561            .await?;
1562        assert!(check_minter_role, "deployer does not have minter role yet");
1563
1564        // transfer or mint tokens to addresses
1565        let total_transferred_amount =
1566            transfer_or_mint_tokens(instances.token.clone(), addresses.clone(), desired_amount.clone()).await?;
1567
1568        // get native and token balances
1569        let (native_balance, token_balance) = get_native_and_token_balances(instances.token, addresses.clone()).await?;
1570
1571        assert_eq!(native_balance.len(), 4, "invalid native balance lens");
1572        assert_eq!(token_balance.len(), 4, "invalid token balance lens");
1573        for (i, amount) in desired_amount.iter().enumerate() {
1574            assert_eq!(&token_balance[i], amount, "token balance unmatch");
1575        }
1576
1577        assert_eq!(
1578            total_transferred_amount,
1579            U256::from(10),
1580            "amount transferred does not equal to the desired amount"
1581        );
1582        Ok(())
1583    }
1584
1585    #[tokio::test]
1586    async fn test_transfer_or_mint_tokens_in_anvil_with_one_recipient() -> anyhow::Result<()> {
1587        let addresses: Vec<Address> = vec![get_random_address_for_testing()];
1588        let desired_amount = vec![U256::from(42)];
1589
1590        // launch local anvil instance
1591        let anvil = hopr_chain_types::utils::create_anvil(None);
1592        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1593        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1594        // deploy hopr contracts
1595        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1596            .await
1597            .expect("failed to deploy");
1598
1599        // deploy multicall contract
1600        deploy_multicall3_for_testing(client.clone()).await?;
1601        // grant deployer token minter role
1602        let encoded_minter_role = keccak256(b"MINTER_ROLE");
1603        instances
1604            .token
1605            .grantRole(encoded_minter_role, contract_deployer.public().to_address().into())
1606            .send()
1607            .await?
1608            .watch()
1609            .await?;
1610
1611        // test the deployer has minter role now
1612        let check_minter_role = instances
1613            .token
1614            .hasRole(encoded_minter_role, contract_deployer.public().to_address().into())
1615            .call()
1616            .await?;
1617        assert!(check_minter_role, "deployer does not have minter role yet");
1618
1619        // transfer or mint tokens to addresses
1620        let total_transferred_amount =
1621            transfer_or_mint_tokens(instances.token.clone(), addresses.clone(), desired_amount.clone()).await?;
1622
1623        // get native and token balances
1624        let (native_balance, token_balance) = get_native_and_token_balances(instances.token, addresses.clone()).await?;
1625        assert_eq!(native_balance.len(), 1, "invalid native balance lens");
1626        assert_eq!(token_balance.len(), 1, "invalid token balance lens");
1627        for (i, amount) in desired_amount.iter().enumerate() {
1628            assert_eq!(&token_balance[i], amount, "token balance unmatch");
1629        }
1630
1631        assert_eq!(
1632            total_transferred_amount, desired_amount[0],
1633            "amount transferred does not equal to the desired amount"
1634        );
1635        Ok(())
1636    }
1637
1638    #[tokio::test]
1639    async fn test_transfer_or_mint_tokens_in_anvil_without_recipient() -> anyhow::Result<()> {
1640        let addresses: Vec<Address> = Vec::new();
1641        let desired_amount: Vec<U256> = Vec::new();
1642
1643        // launch local anvil instance
1644        let anvil = hopr_chain_types::utils::create_anvil(None);
1645        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1646        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1647        // deploy hopr contracts
1648        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1649            .await
1650            .expect("failed to deploy");
1651
1652        // deploy multicall contract
1653        deploy_multicall3_for_testing(client.clone()).await?;
1654
1655        // transfer or mint tokens to addresses
1656        let total_transferred_amount =
1657            transfer_or_mint_tokens(instances.token.clone(), addresses.clone(), desired_amount.clone()).await?;
1658
1659        // get native and token balances
1660        let (native_balance, token_balance) = get_native_and_token_balances(instances.token, addresses.clone()).await?;
1661        assert_eq!(native_balance.len(), 0, "invalid native balance lens");
1662        assert_eq!(token_balance.len(), 0, "invalid token balance lens");
1663        // for (i, amount) in desired_amount.iter().enumerate() {
1664        //     assert_eq!(token_balance[i].as_u64(), amount.as_u64(), "token balance unmatch");
1665        // }
1666
1667        assert_eq!(
1668            total_transferred_amount,
1669            U256::from(0),
1670            "amount transferred does not equal to the desired amount"
1671        );
1672        Ok(())
1673    }
1674
1675    #[tokio::test]
1676    async fn test_transfer_native_tokens_in_anvil_with_multicall() -> anyhow::Result<()> {
1677        let mut addresses: Vec<Address> = Vec::new();
1678        for _ in 0..4 {
1679            addresses.push(get_random_address_for_testing());
1680        }
1681        let desired_amount = vec![U256::from(1), U256::from(2), U256::from(3), U256::from(4)];
1682
1683        // launch local anvil instance
1684        let anvil = hopr_chain_types::utils::create_anvil(None);
1685        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1686        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1687        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1688            .await
1689            .expect("failed to deploy");
1690
1691        // deploy multicall contract
1692        deploy_multicall3_for_testing(client.clone()).await?;
1693
1694        // transfer native tokens to addresses
1695        let total_transferred_amount =
1696            transfer_native_tokens(client.clone(), addresses.clone(), desired_amount.clone()).await?;
1697
1698        // get native and token balances
1699        let (native_balance, token_balance) = get_native_and_token_balances(instances.token, addresses.clone()).await?;
1700        assert_eq!(native_balance.len(), 4, "invalid native balance lens");
1701        assert_eq!(token_balance.len(), 4, "invalid token balance lens");
1702        for (i, amount) in desired_amount.iter().enumerate() {
1703            assert_eq!(&native_balance[i], amount, "native balance unmatch");
1704        }
1705
1706        assert_eq!(
1707            total_transferred_amount,
1708            U256::from(10),
1709            "amount transferred does not equal to the desired amount"
1710        );
1711        Ok(())
1712    }
1713
1714    #[tokio::test]
1715    async fn test_register_safes_and_nodes_then_deregister_nodes_in_anvil_with_multicall() -> anyhow::Result<()> {
1716        let mut safe_addresses: Vec<Address> = Vec::new();
1717        let mut node_addresses: Vec<Address> = Vec::new();
1718        for _ in 0..4 {
1719            safe_addresses.push(get_random_address_for_testing());
1720            node_addresses.push(get_random_address_for_testing());
1721        }
1722
1723        // launch local anvil instance
1724        let anvil = hopr_chain_types::utils::create_anvil(None);
1725        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1726        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1727        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1728            .await
1729            .expect("failed to deploy");
1730        // deploy multicall contract
1731        deploy_multicall3_for_testing(client.clone()).await?;
1732
1733        // register some nodes
1734        let (removed_amt, added_amt) = register_safes_and_nodes_on_network_registry(
1735            instances.network_registry.clone(),
1736            safe_addresses.clone(),
1737            node_addresses.clone(),
1738        )
1739        .await?;
1740
1741        assert_eq!(removed_amt, 0, "should not remove any safe");
1742        assert_eq!(added_amt, 4, "there should be 4 additions");
1743
1744        // get registered safes from nodes
1745        let registered_safes = get_registered_safes_for_nodes_on_network_registry(
1746            instances.network_registry.clone(),
1747            node_addresses.clone(),
1748        )
1749        .await?;
1750
1751        assert_eq!(safe_addresses.len(), registered_safes.len(), "returned length unmatch");
1752        for (i, safe_addr) in safe_addresses.iter().enumerate() {
1753            assert_eq!(safe_addr, &registered_safes[i], "registered safe addresses unmatch");
1754        }
1755
1756        // deregister 3 of them
1757        let deregisterd_nodes = deregister_nodes_from_network_registry(
1758            instances.network_registry.clone(),
1759            node_addresses.split_at(3).0.to_vec(),
1760        )
1761        .await?;
1762        assert_eq!(deregisterd_nodes, 3, "cannot deregister all the nodes");
1763
1764        // re-register 4 of them
1765        let (removed_amt_2, added_amt_2) = register_safes_and_nodes_on_network_registry(
1766            instances.network_registry.clone(),
1767            safe_addresses.clone(),
1768            node_addresses.clone(),
1769        )
1770        .await?;
1771
1772        assert_eq!(removed_amt_2, 0, "should not remove any safe");
1773        assert_eq!(added_amt_2, 3, "there should be 3 additions");
1774        Ok(())
1775    }
1776
1777    #[tokio::test]
1778    async fn test_deploy_proxy() -> anyhow::Result<()> {
1779        let prediction = deploy_proxy(
1780            address!("41675c099f32341bf84bfc5382af534df5c7461a"),
1781            hex!("09e458584ce79e57b65cb303dc136c5d53e17b676599b9b7bc03815e0eef5172"),
1782            Address::from_str(SAFE_SAFEPROXYFACTORY_ADDRESS)?,
1783        )?;
1784
1785        assert_eq!(
1786            prediction,
1787            address!("ec5c8d045dfa1f93785125c26e187e9439f67105"),
1788            "cannot reproduce proxy"
1789        );
1790        Ok(())
1791    }
1792    #[tokio::test]
1793    async fn test_get_salt_from_salt_nonce() -> anyhow::Result<()> {
1794        let salt = get_salt_from_salt_nonce(
1795            hex!("b63e800d00000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001400000000000000000000000002a15de4410d4c8af0a7b6c12803120f43c42b8200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000098b275485c406573d042848d66eb9d63fca311c00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000").into(),
1796            B256::from_str("E5EAFDE6416CCB48925026B6313D62A98C0997E03591E29EB4CF1EA968D6BC8F")?// &U256::from_str("103994836888229670573364883831672511342967953907147914065931589108526220754063")?.into(),
1797        )?;
1798
1799        assert_eq!(
1800            salt.to_vec(),
1801            Bytes::from_str("09e458584ce79e57b65cb303dc136c5d53e17b676599b9b7bc03815e0eef5172")?,
1802            "cannot reproduce salt"
1803        );
1804        Ok(())
1805    }
1806
1807    #[tokio::test]
1808    async fn test_safe_and_module_address_prediction() -> anyhow::Result<()> {
1809        // testing value extracted from https://dashboard.tenderly.co/tx/xdai/0x510e3ac3dc7939cae2525a0b0f096ad709b23d94169e0fbf2e1154fdd6911c49?trace=0
1810        let _ = env_logger::builder().is_test(true).try_init();
1811
1812        // prepare some input data
1813        let mut admin_addresses: Vec<Address> = Vec::new();
1814        for _ in 0..2 {
1815            admin_addresses.push(get_random_address_for_testing());
1816        }
1817
1818        // launch local anvil instance
1819        let anvil = hopr_chain_types::utils::create_anvil(None);
1820        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1821        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1822        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1823            .await
1824            .expect("failed to deploy");
1825        // deploy multicall contract
1826        deploy_multicall3_for_testing(client.clone()).await?;
1827        // deploy safe suits
1828        deploy_safe_suites(client.clone()).await?;
1829
1830        let caller = client.default_signer_address();
1831
1832        // build the default permissions of capabilities
1833        let default_target = format!("{:?}{}", instances.channels.address(), DEFAULT_CAPABILITY_PERMISSIONS);
1834        debug!("default target {:?}", default_target);
1835        // salt nonce
1836        let curr_nonce = client.get_transaction_count(caller).pending().await?;
1837        let nonce = keccak256((caller, U256::from(curr_nonce)).abi_encode_packed());
1838
1839        let module_address = predict_module_address(
1840            caller,
1841            nonce,
1842            *instances.stake_factory.address(),
1843            *instances.module_implementation.address(),
1844        )?;
1845        debug!("predict_module_addr {:?}", module_address);
1846
1847        let safe_address = predict_safe_address(
1848            *instances.stake_factory.address(),
1849            vec![address!("9062a96b9e947b2b57283e705c97b871f5eb6561")],
1850            nonce,
1851            Address::from_str(SAFE_COMPATIBILITYFALLBACKHANDLER_ADDRESS)?,
1852            Address::from_str(SAFE_SAFE_ADDRESS)?,
1853            Address::from_str(SAFE_SAFEPROXYFACTORY_ADDRESS)?,
1854        )?;
1855
1856        debug!("predict_safe_address {:?}", safe_address);
1857
1858        // deploy a safe proxy instance and a module proxy instance with multicall as an owner
1859        let deployment_receipt = instances
1860            .stake_factory
1861            .clone(
1862                *instances.module_implementation.address(),
1863                vec![caller],
1864                nonce.into(),
1865                U256::from_str(&default_target)?.into(),
1866            )
1867            .send()
1868            .await?
1869            .get_receipt()
1870            .await?;
1871
1872        // parse the safe and module addresses
1873        let module_log = deployment_receipt
1874            .decoded_log::<HoprNodeStakeFactory::NewHoprNodeStakeModule>()
1875            .ok_or_else(|| anyhow::anyhow!("Module log not found"))?;
1876
1877        let safe_log = deployment_receipt
1878            .decoded_log::<HoprNodeStakeFactory::NewHoprNodeStakeSafe>()
1879            .ok_or_else(|| anyhow::anyhow!("Module log not found"))?;
1880
1881        let module_addr = module_log.instance;
1882        let safe_addr = safe_log.instance;
1883
1884        assert_eq!(module_addr, module_address, "module prediction does not match");
1885        assert_eq!(safe_addr, safe_address, "safe prediction does not match");
1886        Ok(())
1887    }
1888
1889    #[tokio::test]
1890    async fn test_deploy_safe_and_module() -> anyhow::Result<()> {
1891        let _ = env_logger::builder().is_test(true).try_init();
1892
1893        // prepare some input data
1894        let mut admin_addresses: Vec<Address> = Vec::new();
1895        for _ in 0..2 {
1896            admin_addresses.push(get_random_address_for_testing());
1897        }
1898        let mut node_addresses: Vec<Address> = Vec::new();
1899        for _ in 0..2 {
1900            node_addresses.push(get_random_address_for_testing());
1901        }
1902
1903        // launch local anvil instance
1904        let anvil = hopr_chain_types::utils::create_anvil(None);
1905        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1906        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1907        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1908            .await
1909            .expect("failed to deploy");
1910        // deploy multicall contract
1911        deploy_multicall3_for_testing(client.clone()).await?;
1912        // deploy safe suits
1913        deploy_safe_suites(client.clone()).await?;
1914
1915        // register some nodes
1916        let (safe, node_module) = deploy_safe_module_with_targets_and_nodes(
1917            instances.stake_factory,
1918            *instances.token.address(),
1919            *instances.channels.address(),
1920            *instances.module_implementation.address(),
1921            *instances.announcements.address(),
1922            U256::MAX,
1923            Some(node_addresses.clone()),
1924            admin_addresses.clone(),
1925            U256::from(2),
1926        )
1927        .await?;
1928
1929        // check announcement is a target
1930        let try_get_announcement_target = node_module
1931            .tryGetTarget(*instances.announcements.address())
1932            .call()
1933            .await?;
1934
1935        assert!(try_get_announcement_target._0, "announcement is not a target");
1936
1937        // check allowance for channel contract has increased
1938        let allowance = instances
1939            .token
1940            .allowance(*safe.address(), *instances.channels.address())
1941            .call()
1942            .await?;
1943
1944        assert_eq!(allowance, U256::MAX, "allowance is not set");
1945
1946        // check nodes have been included in the module
1947        for node_address in node_addresses {
1948            let is_node_included = node_module.isNode(node_address).call().await?;
1949            assert!(is_node_included, "failed to include a node");
1950        }
1951
1952        // check owners are provided admins
1953        let owners = safe.getOwners().call().await?;
1954        let thresold = safe.getThreshold().call().await?;
1955
1956        assert_eq!(owners.len(), 2, "should have 2 owners");
1957        for (i, owner) in owners.iter().enumerate() {
1958            assert_eq!(owner, &admin_addresses[i], "admin is wrong");
1959        }
1960        assert_eq!(thresold, U256::from(2), "threshold should be two");
1961        Ok(())
1962    }
1963
1964    #[tokio::test]
1965    async fn test_safe_tx_via_multisend() -> anyhow::Result<()> {
1966        // set allowance for token transfer for the safe multiple times
1967        let _ = env_logger::builder().is_test(true).try_init();
1968
1969        // prepare some input data
1970        let desired_amount = vec![U256::from(1), U256::from(2), U256::from(3), U256::from(4)];
1971
1972        // launch local anvil instance
1973        let anvil = hopr_chain_types::utils::create_anvil(None);
1974        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
1975        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
1976        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
1977            .await
1978            .expect("failed to deploy");
1979        // deploy multicall contract
1980        deploy_multicall3_for_testing(client.clone()).await?;
1981        // deploy safe suits
1982        deploy_safe_suites(client.clone()).await?;
1983
1984        // create a safe
1985        let (safe, _node_module) = deploy_safe_module_with_targets_and_nodes(
1986            instances.stake_factory,
1987            *instances.token.address(),
1988            *instances.channels.address(),
1989            *instances.module_implementation.address(),
1990            *instances.announcements.address(),
1991            U256::MAX,
1992            None,
1993            vec![contract_deployer.public().to_address().into()],
1994            U256::from(1),
1995        )
1996        .await?;
1997
1998        // check owner of safe
1999        let is_owner = safe.getOwners().call().await?;
2000        assert_eq!(is_owner.len(), 1, "safe has too many owners");
2001        assert_eq!(
2002            is_owner[0].0.0,
2003            contract_deployer.public().to_address().as_ref(),
2004            "safe wrong owner"
2005        );
2006
2007        // check allowance for channel contract is zero
2008        let allowance = instances
2009            .token
2010            .allowance(*safe.address(), *instances.channels.address())
2011            .call()
2012            .await?;
2013
2014        assert_eq!(allowance, U256::MAX, "allowance initiation is wrong");
2015
2016        let mut multisend_txns: Vec<MultisendTransaction> = Vec::new();
2017        for val in desired_amount {
2018            multisend_txns.push(MultisendTransaction {
2019                // build multisend tx payload
2020                encoded_data: approveCall {
2021                    spender: *instances.channels.address(),
2022                    value: val,
2023                }
2024                .abi_encode()
2025                .into(),
2026                tx_operation: SafeTxOperation::Call,
2027                to: *instances.token.address(),
2028                value: U256::ZERO,
2029            });
2030        }
2031
2032        // get chain_id and safe_nonce
2033        let chain_id = client.get_chain_id().await?;
2034        let safe_nonce = safe.nonce().call().await?;
2035        debug!("safe address {:?}", safe.address());
2036        debug!("chain_id {:?}", chain_id);
2037        debug!("safe_nonce {:?}", safe_nonce);
2038
2039        // send safe transaction
2040        send_multisend_safe_transaction_with_threshold_one(
2041            safe.clone(),
2042            contract_deployer,
2043            Address::from_str(SAFE_MULTISEND_ADDRESS)?,
2044            multisend_txns,
2045            U256::from(chain_id),
2046            safe_nonce,
2047        )
2048        .await?;
2049
2050        // check allowance for channel contract is 4
2051        let new_allowance = instances
2052            .token
2053            .allowance(*safe.address(), *instances.channels.address())
2054            .call()
2055            .await?;
2056
2057        assert_eq!(new_allowance, U256::from(4), "final allowance is not desired");
2058        Ok(())
2059    }
2060
2061    #[tokio::test]
2062    async fn test_register_nodes_to_node_safe_registry() -> anyhow::Result<()> {
2063        // set allowance for token transfer for the safe multiple times
2064        let _ = env_logger::builder().is_test(true).try_init();
2065
2066        // launch local anvil instance
2067        let anvil = hopr_chain_types::utils::create_anvil(None);
2068        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
2069        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
2070        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
2071            .await
2072            .expect("failed to deploy");
2073        // deploy multicall contract
2074        deploy_multicall3_for_testing(client.clone()).await?;
2075        // deploy safe suits
2076        deploy_safe_suites(client.clone()).await?;
2077
2078        let deployer_vec: Vec<Address> = vec![contract_deployer.public().to_address().into()];
2079
2080        // create a safe
2081        let (safe, node_module) = deploy_safe_module_with_targets_and_nodes(
2082            instances.stake_factory,
2083            *instances.token.address(),
2084            *instances.channels.address(),
2085            *instances.module_implementation.address(),
2086            *instances.announcements.address(),
2087            U256::MAX,
2088            Some(deployer_vec.clone()),
2089            deployer_vec.clone(),
2090            U256::from(1),
2091        )
2092        .await?;
2093
2094        // register one node to safe
2095        instances
2096            .safe_registry
2097            .registerSafeByNode(*safe.address())
2098            .send()
2099            .await?
2100            .watch()
2101            .await?;
2102
2103        // get registration info
2104        let get_registered_safe =
2105            get_registered_safes_for_nodes_on_node_safe_registry(instances.safe_registry.clone(), deployer_vec.clone())
2106                .await?;
2107
2108        assert_eq!(get_registered_safe.len(), 1, "cannot read registered safe");
2109        assert_eq!(&get_registered_safe[0], safe.address(), "registered safe is wrong");
2110
2111        // deregister the node from safe
2112        deregister_nodes_from_node_safe_registry_and_remove_from_module(
2113            instances.safe_registry.clone(),
2114            deployer_vec.clone(),
2115            vec![*node_module.address()],
2116            contract_deployer.clone(),
2117        )
2118        .await?;
2119
2120        // get registration info (updated)
2121        let get_registered_safe =
2122            get_registered_safes_for_nodes_on_node_safe_registry(instances.safe_registry.clone(), deployer_vec.clone())
2123                .await?;
2124
2125        assert_eq!(get_registered_safe.len(), 1, "cannot read registered safe");
2126        assert_eq!(get_registered_safe[0], Address::ZERO, "node is still registered");
2127
2128        // node is removed
2129        let is_removed = node_module
2130            .isNode(contract_deployer.public().to_address().into())
2131            .call()
2132            .await?;
2133        assert!(!is_removed, "node is not removed");
2134        Ok(())
2135    }
2136
2137    #[tokio::test]
2138    async fn test_include_nodes_to_module() -> anyhow::Result<()> {
2139        // set allowance for token transfer for the safe multiple times
2140        let _ = env_logger::builder().is_test(true).try_init();
2141
2142        let mut node_addresses: Vec<Address> = Vec::new();
2143        for _ in 0..2 {
2144            node_addresses.push(get_random_address_for_testing());
2145        }
2146
2147        // launch local anvil instance
2148        let anvil = hopr_chain_types::utils::create_anvil(None);
2149        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
2150        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
2151        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
2152            .await
2153            .expect("failed to deploy");
2154        // deploy multicall contract
2155        deploy_multicall3_for_testing(client.clone()).await?;
2156        // deploy safe suits
2157        deploy_safe_suites(client.clone()).await?;
2158
2159        let deployer_vec: Vec<Address> = vec![contract_deployer.public().to_address().into()];
2160
2161        // create a safe
2162        let (safe, node_module) = deploy_safe_module_with_targets_and_nodes(
2163            instances.stake_factory,
2164            *instances.token.address(),
2165            *instances.channels.address(),
2166            *instances.module_implementation.address(),
2167            *instances.announcements.address(),
2168            U256::MAX,
2169            None,
2170            deployer_vec.clone(),
2171            U256::from(1),
2172        )
2173        .await?;
2174
2175        // check ndoes are not included
2176        for node_addr in node_addresses.clone() {
2177            // node is removed
2178            let node_is_not_included = node_module.isNode(node_addr).call().await?;
2179            assert!(!node_is_not_included, "node should not be included");
2180        }
2181
2182        // include nodes to safe
2183        include_nodes_to_module(safe, node_addresses.clone(), *node_module.address(), contract_deployer).await?;
2184
2185        // check nodes are included
2186        // check nodes are not included
2187        for node_addr in node_addresses {
2188            // node is removed
2189            let node_is_included = node_module.isNode(node_addr).call().await?;
2190            assert!(node_is_included, "node should be included");
2191        }
2192        Ok(())
2193    }
2194
2195    #[tokio::test]
2196    async fn test_migrate_nodes_to_new_network() -> anyhow::Result<()> {
2197        // set allowance for token transfer for the safe multiple times
2198        let _ = env_logger::builder().is_test(true).try_init();
2199
2200        let mut node_addresses: Vec<Address> = Vec::new();
2201        for _ in 0..2 {
2202            node_addresses.push(get_random_address_for_testing());
2203        }
2204
2205        // launch local anvil instance
2206        let anvil = hopr_chain_types::utils::create_anvil(None);
2207        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
2208        let self_address: Address = contract_deployer.public().to_address().into();
2209        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
2210        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
2211            .await
2212            .expect("failed to deploy");
2213        // deploy multicall contract
2214        deploy_multicall3_for_testing(client.clone()).await?;
2215        // deploy safe suits
2216        deploy_safe_suites(client.clone()).await?;
2217
2218        // deploy some new contracts for the new network
2219        let new_safe_registry = HoprNodeSafeRegistry::deploy(client.clone()).await?;
2220        let new_token = HoprToken::deploy(client.clone()).await?;
2221        let new_channels = HoprChannels::deploy(
2222            client.clone(),
2223            *new_token.address(),
2224            1_u32,
2225            *new_safe_registry.address(),
2226        )
2227        .await?;
2228        let new_announcements = HoprAnnouncements::deploy(client.clone(), *new_safe_registry.address()).await?;
2229        let _new_network_registry = HoprNetworkRegistry::deploy(
2230            client.clone(),
2231            instances.network_registry_proxy.address().into(),
2232            self_address,
2233            self_address,
2234        )
2235        .await?;
2236
2237        let deployer_vec: Vec<Address> = vec![self_address];
2238
2239        // create a safe
2240        let (safe, node_module) = deploy_safe_module_with_targets_and_nodes(
2241            instances.stake_factory,
2242            *instances.token.address(),
2243            *instances.channels.address(),
2244            *instances.module_implementation.address(),
2245            *instances.announcements.address(),
2246            U256::MAX,
2247            None,
2248            deployer_vec.clone(),
2249            U256::from(1),
2250        )
2251        .await?;
2252
2253        // check new network is not included
2254        let old_channels_inclusion = node_module.tryGetTarget(*instances.channels.address()).call().await?;
2255        assert!(old_channels_inclusion._0, "old channel should be included");
2256        let new_channels_inclusion = node_module.tryGetTarget(*new_channels.address()).call().await?;
2257        assert!(!new_channels_inclusion._0, "new channel should not be included");
2258
2259        // migrate nodes
2260        migrate_nodes(
2261            safe,
2262            *node_module.address(),
2263            *new_channels.address(),
2264            *new_token.address(),
2265            *new_announcements.address(),
2266            U256::MAX,
2267            contract_deployer,
2268        )
2269        .await?;
2270
2271        // check new network is included
2272        let old_channels_inclusion = node_module.tryGetTarget(*instances.channels.address()).call().await?;
2273        assert!(old_channels_inclusion._0, "old channel should still be included");
2274        let new_channels_inclusion = node_module.tryGetTarget(*new_channels.address()).call().await?;
2275        assert!(new_channels_inclusion._0, "new channel should now be included");
2276        Ok(())
2277    }
2278
2279    #[tokio::test]
2280    async fn test_debug_node_safe_module_setup_on_balance_and_registries() -> anyhow::Result<()> {
2281        // set allowance for token transfer for the safe multiple times
2282        let _ = env_logger::builder().is_test(true).try_init();
2283
2284        let mut node_addresses: Vec<Address> = Vec::new();
2285        for _ in 0..2 {
2286            node_addresses.push(get_random_address_for_testing());
2287        }
2288
2289        // launch local anvil instance
2290        let anvil = hopr_chain_types::utils::create_anvil(None);
2291        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
2292        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
2293        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
2294            .await
2295            .expect("failed to deploy");
2296        // deploy multicall contract
2297        deploy_multicall3_for_testing(client.clone()).await?;
2298        // deploy safe suits
2299        deploy_safe_suites(client.clone()).await?;
2300
2301        let deployer_vec: Vec<Address> = vec![contract_deployer.public().to_address().into()];
2302
2303        // create a safe
2304        let (safe, _) = deploy_safe_module_with_targets_and_nodes(
2305            instances.stake_factory,
2306            *instances.token.address(),
2307            *instances.channels.address(),
2308            *instances.module_implementation.address(),
2309            *instances.announcements.address(),
2310            U256::MAX,
2311            None,
2312            deployer_vec.clone(),
2313            U256::from(1),
2314        )
2315        .await?;
2316        let registered_safe_before_registration = debug_node_safe_module_setup_on_balance_and_registries(
2317            instances.network_registry.clone(),
2318            instances.safe_registry.clone(),
2319            &node_addresses[0],
2320        )
2321        .await?;
2322
2323        assert_eq!(
2324            registered_safe_before_registration,
2325            Address::ZERO,
2326            "safe is already registered"
2327        );
2328
2329        // register some nodes
2330        let (..) = register_safes_and_nodes_on_network_registry(
2331            instances.network_registry.clone(),
2332            vec![*safe.address()],
2333            vec![node_addresses[0]],
2334        )
2335        .await?;
2336
2337        let registered_safe_after_registration = debug_node_safe_module_setup_on_balance_and_registries(
2338            instances.network_registry.clone(),
2339            instances.safe_registry.clone(),
2340            &node_addresses[0],
2341        )
2342        .await?;
2343
2344        assert_eq!(
2345            &registered_safe_after_registration,
2346            safe.address(),
2347            "safe is not registered"
2348        );
2349        Ok(())
2350    }
2351
2352    #[tokio::test]
2353    async fn test_debug_node_safe_module_setup_main() -> anyhow::Result<()> {
2354        // set allowance for token transfer for the safe multiple times
2355        let _ = env_logger::builder().is_test(true).try_init();
2356
2357        let mut node_addresses: Vec<Address> = Vec::new();
2358        for _ in 0..2 {
2359            node_addresses.push(get_random_address_for_testing());
2360        }
2361
2362        // launch local anvil instance
2363        let anvil = hopr_chain_types::utils::create_anvil(None);
2364        let contract_deployer = ChainKeypair::from_secret(anvil.keys()[0].to_bytes().as_ref())?;
2365        let client = create_rpc_client_to_anvil(&anvil, &contract_deployer);
2366        let instances = ContractInstances::deploy_for_testing(client.clone(), &contract_deployer)
2367            .await
2368            .expect("failed to deploy");
2369        // deploy multicall contract
2370        deploy_multicall3_for_testing(client.clone()).await?;
2371        // deploy safe suits
2372        deploy_safe_suites(client.clone()).await?;
2373
2374        let deployer_vec: Vec<Address> = vec![contract_deployer.public().to_address().into()];
2375
2376        // create a safe
2377        let (safe, node_module) = deploy_safe_module_with_targets_and_nodes(
2378            instances.stake_factory,
2379            *instances.token.address(),
2380            *instances.channels.address(),
2381            *instances.module_implementation.address(),
2382            *instances.announcements.address(),
2383            U256::MAX,
2384            None,
2385            deployer_vec.clone(),
2386            U256::from(1),
2387        )
2388        .await?;
2389
2390        // register some nodes
2391        let (..) = register_safes_and_nodes_on_network_registry(
2392            instances.network_registry.clone(),
2393            vec![*safe.address()],
2394            vec![node_addresses[0]],
2395        )
2396        .await?;
2397
2398        debug_node_safe_module_setup_main(
2399            instances.token.clone(),
2400            node_module.address(),
2401            &node_addresses[0],
2402            safe.address(),
2403            instances.channels.address(),
2404            instances.announcements.address(),
2405        )
2406        .await?;
2407        Ok(())
2408    }
2409}