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

#32 in #icp

Download history 318/week @ 2024-06-24 4/week @ 2024-07-01 2/week @ 2024-07-08 123/week @ 2024-07-15 5/week @ 2024-07-22 15/week @ 2024-07-29 3/week @ 2024-08-05 37/week @ 2024-08-12 34/week @ 2024-08-19 97/week @ 2024-08-26 33/week @ 2024-09-02 37/week @ 2024-09-09 605/week @ 2024-09-16 98/week @ 2024-09-23

809 downloads per month

Apache-2.0

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 signer
    • fees: a module that provides a way to calculate the fees for a given transaction
    • conversions: some helpful functions to convert between different types commonly used by the ethers crate
    • eth_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 the request EVM RPC function
    • includes erc20_balance_of built on top of eth_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 the send_raw_transaction EVM RPC function
    • includes transfer_eth and contract_interaction functions built on top of eth_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 request
    • request_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
  • 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 necessary
    use 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–33MB
~523K SLoC