hopli/
utils.rs

1//! This module contains errors produced in this crate
2use alloy::{
3    contract::Error as ContractError,
4    hex::FromHexError,
5    primitives::{Address, keccak256},
6    providers::{MulticallError, PendingTransactionError},
7};
8use hoprd_keypair::errors::KeyPairError;
9use thiserror::Error;
10
11pub trait Cmd: clap::Parser + Sized {
12    fn run(self) -> Result<(), HelperErrors>;
13    fn async_run(self) -> impl std::future::Future<Output = Result<(), HelperErrors>> + Send;
14}
15
16/// Enumerates different errors produced by this crate.
17#[derive(Error, Debug)]
18pub enum HelperErrors {
19    /// Error of contract error
20    #[error(transparent)]
21    FromHexError(#[from] FromHexError),
22
23    /// Error of contract error
24    #[error(transparent)]
25    ContractError(#[from] ContractError),
26
27    /// Error propagated by pending transctions
28    #[error(transparent)]
29    PendingTransactionError(#[from] PendingTransactionError),
30
31    /// Error propagated by IO operations
32    #[error(transparent)]
33    UnableToReadFromPath(#[from] std::io::Error),
34
35    /// Error in parsing provided comma-separated addresses
36    #[error("error parsing address: {0:?}")]
37    UnableToParseAddress(String),
38
39    /// System time rrror
40    #[error(transparent)]
41    SystemTime(#[from] std::time::SystemTimeError),
42
43    /// Error when identity cannot be created
44    #[error("unable to create identity")]
45    UnableToCreateIdentity,
46
47    #[error("unable to update identity password")]
48    UnableToUpdateIdentityPassword,
49
50    /// Error due to supplying a non-existing file name
51    #[error("incorrect filename: {0}")]
52    IncorrectFilename(String),
53
54    /// Error when identity existed
55    #[error("identity file exists: {0}")]
56    IdentityFileExists(String),
57
58    /// Fail to read identity
59    #[error("unable to read identity")]
60    UnableToReadIdentity,
61
62    /// Fail to find the identity directory
63    #[error("unable to read identity directory")]
64    MissingIdentityDirectory,
65
66    /// Fail to delete an identity
67    #[error("unable to delete identity")]
68    UnableToDeleteIdentity,
69
70    /// Provided environement does not match with that in the `ethereum/contracts/contracts-addresses.json`
71    #[error("environment info mismatch")]
72    EnvironmentInfoMismatch,
73
74    /// Wrong foundry contract root is provided
75    #[error("unable to set foundry root")]
76    UnableToSetFoundryRoot,
77
78    /// Fail to run foundry
79    #[error("unable to run foundry")]
80    ErrorInRunningFoundry,
81
82    /// Fail to read password
83    #[error("unable read password")]
84    UnableToReadPassword,
85
86    /// Fail to read private key
87    #[error("cannot read private key error: {0}")]
88    UnableToReadPrivateKey(String),
89
90    /// Paramters are missing
91    #[error("missing parameter: {0}")]
92    MissingParameter(String),
93
94    /// Error with the keystore file
95    #[error(transparent)]
96    KeyStoreError(#[from] KeyPairError),
97
98    #[error("deserialization Error: {0}")]
99    /// Serde JSON Error
100    SerdeJson(#[from] serde_json::Error),
101
102    /// Cannot find network details from the given network name
103    #[error("unable to find network details from the given network name ")]
104    UnknownNetwork,
105
106    /// Error with HTTP Json RPC provider
107    #[error(transparent)]
108    RpcError(#[from] hopr_chain_rpc::errors::RpcError),
109
110    /// Fail to make a multicall
111    #[error(transparent)]
112    MulticallError(#[from] MulticallError),
113
114    /// Fail to make a multisend call
115    #[error("internal transaction failure in multisend")]
116    MultiSendError,
117
118    /// Txn caller does not have the minter role
119    #[error("caller does not have the privilege to mint tokens")]
120    NotAMinter,
121
122    /// Error with middleware
123    #[error("middleware Error: {0}")]
124    MiddlewareError(String),
125
126    /// A required smart contract (Safe or module proxy instance) is not deployed
127    #[error("contract not deployed: {0}")]
128    ContractNotDeployed(String),
129
130    // error of parsing addresses
131    #[error("Cannot parse address: {0}")]
132    InvalidAddress(String),
133
134    // general error of parsing
135    #[error("Cannot parse: {0}")]
136    ParseError(String),
137}
138
139/// Multicall3 deployer wallet
140pub const MULTICALL3_DEPLOYER: &str = "05f32b3cc3888453ff71b01135b34ff8e41263f2";
141
142/// Amount of ETH to fund MULTICALL3_DEPLOYER, to deployer Multicall3 contract
143pub const ETH_VALUE_FOR_MULTICALL3_DEPLOYER: u128 = 100_000_000_000_000_000; // 0.1 (anvil) ETH
144
145/// Contract creation code for mullticall3, as in <https://etherscan.io/address/0xcA11bde05977b3631167028862bE2a173976CA11>
146pub const MULTICALL3_CONTRACT_CREATION_CODE: &str = "608060405234801561001057600080fd5b50610ee0806100206000396000f3fe6080604052600436106100f35760003560e01c80634d2301cc1161008a578063a8b0574e11610059578063a8b0574e1461025a578063bce38bd714610275578063c3077fa914610288578063ee82ac5e1461029b57600080fd5b80634d2301cc146101ec57806372425d9d1461022157806382ad56cb1461023457806386d516e81461024757600080fd5b80633408e470116100c65780633408e47014610191578063399542e9146101a45780633e64a696146101c657806342cbb15c146101d957600080fd5b80630f28c97d146100f8578063174dea711461011a578063252dba421461013a57806327e86d6e1461015b575b600080fd5b34801561010457600080fd5b50425b6040519081526020015b60405180910390f35b61012d610128366004610a85565b6102ba565b6040516101119190610bbe565b61014d610148366004610a85565b6104ef565b604051610111929190610bd8565b34801561016757600080fd5b50437fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0140610107565b34801561019d57600080fd5b5046610107565b6101b76101b2366004610c60565b610690565b60405161011193929190610cba565b3480156101d257600080fd5b5048610107565b3480156101e557600080fd5b5043610107565b3480156101f857600080fd5b50610107610207366004610ce2565b73ffffffffffffffffffffffffffffffffffffffff163190565b34801561022d57600080fd5b5044610107565b61012d610242366004610a85565b6106ab565b34801561025357600080fd5b5045610107565b34801561026657600080fd5b50604051418152602001610111565b61012d610283366004610c60565b61085a565b6101b7610296366004610a85565b610a1a565b3480156102a757600080fd5b506101076102b6366004610d18565b4090565b60606000828067ffffffffffffffff8111156102d8576102d8610d31565b60405190808252806020026020018201604052801561031e57816020015b6040805180820190915260008152606060208201528152602001906001900390816102f65790505b5092503660005b8281101561047757600085828151811061034157610341610d60565b6020026020010151905087878381811061035d5761035d610d60565b905060200281019061036f9190610d8f565b6040810135958601959093506103886020850185610ce2565b73ffffffffffffffffffffffffffffffffffffffff16816103ac6060870187610dcd565b6040516103ba929190610e32565b60006040518083038185875af1925050503d80600081146103f7576040519150601f19603f3d011682016040523d82523d6000602084013e6103fc565b606091505b50602080850191909152901515808452908501351761046d577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260846000fd5b5050600101610325565b508234146104e6576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d756c746963616c6c333a2076616c7565206d69736d6174636800000000000060448201526064015b60405180910390fd5b50505092915050565b436060828067ffffffffffffffff81111561050c5761050c610d31565b60405190808252806020026020018201604052801561053f57816020015b606081526020019060019003908161052a5790505b5091503660005b8281101561068657600087878381811061056257610562610d60565b90506020028101906105749190610e42565b92506105836020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166105a66020850185610dcd565b6040516105b4929190610e32565b6000604051808303816000865af19150503d80600081146105f1576040519150601f19603f3d011682016040523d82523d6000602084013e6105f6565b606091505b5086848151811061060957610609610d60565b602090810291909101015290508061067d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b50600101610546565b5050509250929050565b43804060606106a086868661085a565b905093509350939050565b6060818067ffffffffffffffff8111156106c7576106c7610d31565b60405190808252806020026020018201604052801561070d57816020015b6040805180820190915260008152606060208201528152602001906001900390816106e55790505b5091503660005b828110156104e657600084828151811061073057610730610d60565b6020026020010151905086868381811061074c5761074c610d60565b905060200281019061075e9190610e76565b925061076d6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166107906040850185610dcd565b60405161079e929190610e32565b6000604051808303816000865af19150503d80600081146107db576040519150601f19603f3d011682016040523d82523d6000602084013e6107e0565b606091505b506020808401919091529015158083529084013517610851577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260646000fd5b50600101610714565b6060818067ffffffffffffffff81111561087657610876610d31565b6040519080825280602002602001820160405280156108bc57816020015b6040805180820190915260008152606060208201528152602001906001900390816108945790505b5091503660005b82811015610a105760008482815181106108df576108df610d60565b602002602001015190508686838181106108fb576108fb610d60565b905060200281019061090d9190610e42565b925061091c6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff1661093f6020850185610dcd565b60405161094d929190610e32565b6000604051808303816000865af19150503d806000811461098a576040519150601f19603f3d011682016040523d82523d6000602084013e61098f565b606091505b506020830152151581528715610a07578051610a07576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b506001016108c3565b5050509392505050565b6000806060610a2b60018686610690565b919790965090945092505050565b60008083601f840112610a4b57600080fd5b50813567ffffffffffffffff811115610a6357600080fd5b6020830191508360208260051b8501011115610a7e57600080fd5b9250929050565b60008060208385031215610a9857600080fd5b823567ffffffffffffffff811115610aaf57600080fd5b610abb85828601610a39565b90969095509350505050565b6000815180845260005b81811015610aed57602081850181015186830182015201610ad1565b81811115610aff576000602083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160200192915050565b600082825180855260208086019550808260051b84010181860160005b84811015610bb1578583037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe001895281518051151584528401516040858501819052610b9d81860183610ac7565b9a86019a9450505090830190600101610b4f565b5090979650505050505050565b602081526000610bd16020830184610b32565b9392505050565b600060408201848352602060408185015281855180845260608601915060608160051b870101935082870160005b82811015610c52577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa0888703018452610c40868351610ac7565b95509284019290840190600101610c06565b509398975050505050505050565b600080600060408486031215610c7557600080fd5b83358015158114610c8557600080fd5b9250602084013567ffffffffffffffff811115610ca157600080fd5b610cad86828701610a39565b9497909650939450505050565b838152826020820152606060408201526000610cd96060830184610b32565b95945050505050565b600060208284031215610cf457600080fd5b813573ffffffffffffffffffffffffffffffffffffffff81168114610bd157600080fd5b600060208284031215610d2a57600080fd5b5035919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81833603018112610dc357600080fd5b9190910192915050565b60008083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe1843603018112610e0257600080fd5b83018035915067ffffffffffffffff821115610e1d57600080fd5b602001915036819003821315610a7e57600080fd5b8183823760009101908152919050565b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc1833603018112610dc357600080fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa1833603018112610dc357600080fdfea2646970667358221220bb2b5c71a328032f97c676ae39a1ec2148d3e5d6f73d95e9b17910152d61f16264736f6c634300080c0033";
147
148/// Default capability permissions, as in smart contract
149/// ```text
150///     [
151///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultRedeemTicketSafeFunctionPermisson
152///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // RESERVED
153///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultCloseIncomingChannelSafeFunctionPermisson
154///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultInitiateOutgoingChannelClosureSafeFunctionPermisson
155///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultFinalizeOutgoingChannelClosureSafeFunctionPermisson
156///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultFundChannelMultiFunctionPermisson
157///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultSetCommitmentSafeFunctionPermisson
158///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW, // defaultApproveFunctionPermisson
159///       CapabilityPermission.SPECIFIC_FALLBACK_ALLOW  // defaultSendFunctionPermisson
160///     ]
161/// ```
162pub const DEFAULT_CAPABILITY_PERMISSIONS: &str = "010103030303030303030303";
163
164/// Default announcement permissions, where nothing is specified and falls back to the default, as in smart contract
165/// ```text
166///     [
167///       CapabilityPermission.NONE, // defaultRedeemTicketSafeFunctionPermisson
168///       CapabilityPermission.NONE, // RESERVED
169///       CapabilityPermission.NONE, // defaultCloseIncomingChannelSafeFunctionPermisson
170///       CapabilityPermission.NONE, // defaultInitiateOutgoingChannelClosureSafeFunctionPermisson
171///       CapabilityPermission.NONE, // defaultFinalizeOutgoingChannelClosureSafeFunctionPermisson
172///       CapabilityPermission.NONE, // defaultFundChannelMultiFunctionPermisson
173///       CapabilityPermission.NONE, // defaultSetCommitmentSafeFunctionPermisson
174///       CapabilityPermission.NONE, // defaultApproveFunctionPermisson
175///       CapabilityPermission.NONE  // defaultSendFunctionPermisson
176///     ]
177/// ```
178pub const DEFAULT_ANNOUNCEMENT_PERMISSIONS: &str = "010003000000000000000000";
179
180/// Default node permissions, where nothing is specified and falls back to the default, as in smart contract
181/// ```text
182///     [
183///       CapabilityPermission.NONE, // defaultRedeemTicketSafeFunctionPermisson
184///       CapabilityPermission.NONE, // RESERVED
185///       CapabilityPermission.NONE, // defaultCloseIncomingChannelSafeFunctionPermisson
186///       CapabilityPermission.NONE, // defaultInitiateOutgoingChannelClosureSafeFunctionPermisson
187///       CapabilityPermission.NONE, // defaultFinalizeOutgoingChannelClosureSafeFunctionPermisson
188///       CapabilityPermission.NONE, // defaultFundChannelMultiFunctionPermisson
189///       CapabilityPermission.NONE, // defaultSetCommitmentSafeFunctionPermisson
190///       CapabilityPermission.NONE, // defaultApproveFunctionPermisson
191///       CapabilityPermission.NONE  // defaultSendFunctionPermisson
192///     ]
193/// ```
194pub const DEFAULT_NODE_PERMISSIONS: &str = "010303000000000000000000";
195
196/// Safe compatibility fallback handler contract deployed for v1.4.0, as in <https://github.com/safe-global/safe-deployments/blob/b707e5e2994e6f86d76ff7ffade0445c4e49ae9a/src/assets/v1.4.0/compatibility_fallback_handler.json>
197pub const SAFE_COMPATIBILITYFALLBACKHANDLER_ADDRESS: &str = "2a15DE4410d4c8af0A7b6c12803120f43C42B820";
198/// Safe implementation contract deployed for v1.4.1, as in <https://github.com/safe-global/safe-deployments/blob/8c504f44d148f4c898fee02749c88372bae6609a/src/assets/v1.4.1/safe.json>
199pub const SAFE_SAFE_ADDRESS: &str = "41675C099F32341bf84BFc5382aF534df5C7461a";
200/// Safe proxy factory contract deployed for v1.4.0, <https://github.com/safe-global/safe-deployments/blob/b707e5e2994e6f86d76ff7ffade0445c4e49ae9a/src/assets/v1.4.0/safe_proxy_factory.json>
201pub const SAFE_SAFEPROXYFACTORY_ADDRESS: &str = "4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67";
202/// Safe multisend contract deployed for v1.4.0,  <https://github.com/safe-global/safe-deployments/blob/b707e5e2994e6f86d76ff7ffade0445c4e49ae9a/src/assets/v1.4.0/multi_send.json>
203pub const SAFE_MULTISEND_ADDRESS: &str = "38869bf66a61cF6bDB996A6aE40D5853Fd43B526";
204
205/// Topic hash for `NewHoprNodeStakeModule` event
206pub const NEW_HOPR_NODE_STAKE_MODULE_TOPIC: &str = "0x813d391dc490d6c1dae7d3fdd555f337533d1da2c908c6efd36d4cf557a63206";
207/// Topic hash for `NewHoprNodeStakeSafe` event
208pub const NEW_HOPR_NODE_STAKE_SAFE_TOPIC: &str = "0x8231d169f416b666ae7fa43faa24a18899738075a53f32c97617d173b189e386";
209
210/// Starting point for a linked list in safe contract, as in <https://github.com/safe-global/safe-smart-account/blob/2278f7ccd502878feb5cec21dd6255b82df374b5/contracts/base/OwnerManager.sol#L14>
211pub const SENTINEL_OWNERS: &str = "0x0000000000000000000000000000000000000001";
212/// Safe transaction type hash, as in <https://github.com/safe-global/safe-smart-account/blob/2278f7ccd502878feb5cec21dd6255b82df374b5/contracts/Safe.sol#L59>
213pub const SAFE_TX_TYPEHASH: &str = "bb8310d486368db6bd6f849402fdd73ad53d316b5a4b2644ad6efe0f941286d8";
214
215/// Safe domain separator typehash, as in <https://github.com/safe-global/safe-smart-account/blob/2278f7ccd502878feb5cec21dd6255b82df374b5/contracts/Safe.sol#L54>
216pub const DOMAIN_SEPARATOR_TYPEHASH: &str = "47e79534a245952e8b16893a336b85a3d9ea9fa8c573f3d803afb92a79469218";
217
218/// Topic hash for `ExecutionSuccess` event, as in <https://github.com/safe-global/safe-smart-account/blob/2278f7ccd502878feb5cec21dd6255b82df374b5/contracts/interfaces/ISafe.sol#L18>
219pub const SAFE_EXECUTION_SUCCESS: &str = "0x442e715f626346e8c54381002da614f62bee8d27386535b2521ec8540898556e";
220
221/// Implement ethers-rs `get_create2_address` function
222/// Returns the CREATE2 address of a smart contract as specified in
223/// [EIP1014](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1014.md)
224///
225/// keccak256( 0xff ++ senderAddress ++ salt ++ keccak256(init_code))[12..]
226pub fn get_create2_address(from: Address, salt: impl AsRef<[u8]>, init_code: impl AsRef<[u8]>) -> Address {
227    let salt = salt.as_ref();
228    let init_code_hash = keccak256(init_code.as_ref());
229
230    let mut bytes = Vec::with_capacity(1 + 20 + salt.len() + init_code_hash.len());
231    bytes.push(0xff);
232    bytes.extend_from_slice(from.as_slice());
233    bytes.extend_from_slice(salt);
234    bytes.extend_from_slice(&init_code_hash.0);
235
236    let hash = keccak256(bytes);
237
238    let mut bytes = [0u8; 20];
239    bytes.copy_from_slice(&hash[12..]);
240    Address::from(bytes)
241}
hopli/utils.rs

hopli/
utils.rs
