Skip to content

echoprotocol/evmc

 
 

Repository files navigation

EVMC

chat: on gitter readme style: standard

Ethereum Client-VM Connector API

The EVMC is the low-level ABI between Ethereum Virtual Machines (EVMs) and Ethereum Clients. On the EVM side it supports classic EVM1 and ewasm. On the Client-side it defines the interface for EVM implementations to access Ethereum environment and state.

Usage

Documentation

Please visit the documentation.

Languages support

Language Supported Versions Supported Compilers Feature Support
C C99, C11 GCC 6+, clang 3.8+, MSVC 2015+ Host- and VM-side
C++ C++11, C++14, C++17 GCC 6+, clang 3.8+, MSVC 2015+ Host- and VM-side
Go (bindings) 1.9 - 1.12 Host-side only
Rust (bindings)¹ 2018 edition 1.37.0 and newer VM-side only
Java (bindings) 11 Host-side only

1. Rust support is limited and not complete yet, but it is mostly functional already. Breaking changes are possible at this stage.

Testing tools

  • evmc run (tools/evmc) — executes bytecode in any EVMC-compatible VM implementation.
  • evmc-vmtester (tools/vmtester) — can test any EVM implementation for compatibility with EVMC.
  • evm-test (evmone → test/unittests) — allows running the collection of evmone's unit tests on any EVMC-compatible EVM implementation.
  • evmone-fuzzer (evmone → test/fuzzer) — differential fuzzer for EVMC-compatible EVM implementations.

Related projects

EVMs

Clients

Maintainers

See also the list of EVMC Authors.

Contributing

chat: on gitter

Talk with us on the EVMC Gitter chat.

License

Licensed under the MIT License.

Internal

Making new release

  1. Update CHANGELOG.md, put the release date, update release link.
  2. git add CHANGELOG.md.
  3. Tag new release: bumpversion --allow-dirty prerel.
  4. Prepare CHANGELOG for next release: add unreleased section and link.
  5. git add CHANGELOG.md.
  6. Start new release series: bumpversion --allow-dirty --no-tag minor.

Packages

No packages published

Languages

  • C 41.8%
  • C++ 24.9%
  • CMake 12.3%
  • Rust 11.0%
  • Java 5.7%
  • Go 4.0%
  • Other 0.3%