8 releases (3 major breaking)
3.2.0 | Sep 17, 2024 |
---|---|
3.1.0 | Sep 17, 2024 |
2.0.0 | Sep 16, 2024 |
1.0.0 | Jul 16, 2024 |
0.1.2 | Jun 26, 2024 |
#33 in #dfinity
850 downloads per month
54KB
1K
SLoC
Why was this library created
- there are some common patterns when interacting with EVM smart contracts from the IC via the EVM RPC canister that can be abstracted away from developers, this helps reduce writing boilerplate code and makes it easier to interact with the EVM RPC canister
- the library provides a set of types and functions that can be used to interact with the EVM
evm_signer
: a module that provides a way to sign messages using the t-ECDSA and get the public key and EVM address of the signerfees
: a module that provides a way to calculate the fees for a given transactionconversions
: some helpful functions to convert between different types commonly used by the ethers crateeth_call
: a module that provides a way to call a smart contract function without modifying the state of the EVM, this is useful for reading data from the EVM and achieved by calling therequest
EVM RPC function- includes
erc20_balance_of
built on top ofeth_call
to get the balance of an ERC20 token eth_send_raw_transaction
: a module that provides a way to send a signed transaction to the EVM, this is useful for modifying the state of the EVM and achieved by calling thesend_raw_transaction
EVM RPC function- includes
transfer_eth
andcontract_interaction
functions built on top ofeth_send_raw_transaction
to send ETH and interact with smart contracts request
: a module that provides a way to make arbitrary RPC requests, includes determening the cycles costs of the requestrequest_costs
: a module that provides a way to calculate the cycles costs of a given RPC request
How to use this library?
- the methods in this crate rely on the
EvmRpcCanister
struct to make inter canister calls to the EVM RPC canister, this struct is used to initiate calls to the EVM RPC Canister- you can use the
evm-rpc-canister-types
crate to create this struct
- you can use the
- import the libary in your rust project
[dependencies] ic-evm-utils= 0.1
- import the crate where needed and pass the
EvmRpcCanister
struct to the functions if necessaryuse ic_evm_utils::eth_send_raw_transaction::{contract_interaction, ContractDetails}; // ... let status = contract_interaction( contract_details, gas, rpc_services, nonce, key_id, vec![], EVM_RPC, // EvmRpcCanister struct ) .await;
Dependencies
~18–34MB
~527K SLoC