Crate evm_coder

evm-coder

Library for seamless call translation between Rust and Solidity code

By encoding solidity definitions in Rust, this library also provides generation of solidity interfaces for ethereum developers

Overview

Most of this library functionality shouldn’t be used directly, but via macros

• solidity_interface
• ToLog
• AbiCoder

Modules

abi

Implementation of EVM RLP reader/writer

custom_signature

A module for custom signature support.

sealed

Sealed traits.

types

Solidity type definitions (aliases from solidity name to rust type) To be used in solidity_interface definitions, to make sure there is no type conflict between Rust code and generated definitions

Macros

dummy_contract

Implement dummy Contract trait, used for tests Allows contract methods to return either T, or Result<T, String> for any T

event_topic

Returns solidity topic (hash) by its textual representation

fn_selector

Returns solidity function selector (first 4 bytes of hash) by its textual representation

generate_stubgen

Generate “tests”, which will generate solidity code on execution and print it to stdout Script at .maintain/scripts/generate_api.sh can split this output from test runtime

make_signature

Macro to create signatures of types and functions.

Structs

DummyPost

Example of PostInfo, used in tests

Enums

ERC165Call

Implementation of ERC165 is implicitly generated for all interfaces in solidity_interface, this structure holds parsed data for ERC165Call subvariant

Traits

Call

Parseable EVM call, this trait should be implemented with solidity_interface macro

Callable

Type callable with ethereum message, may be implemented by solidity_interface macro on interface implementation, or for externally-owned real EVM contract

Contract

Contract configuration

ToLog

Implementation of this trait should not be written manually, instead use crate::ToLog proc macros.

ToTopic

Only items implementing ToTopic may be used as #[indexed] field in crate::ToLog macro usage.

Type Definitions

ResultOf

Contract specific result type

ResultWithPostInfoOf

Contract specific result type

Attribute Macros

solidity_interface

Derives call enum implementing crate::Callable and crate::Call from impl block.

Derive Macros

AbiCoder

Macro to include support for structures and enums in Solidity.

ToLog

Derives ToLog for enum