mirror of https://github.com/status-im/evmc.git
463 lines
18 KiB
Markdown
463 lines
18 KiB
Markdown
# Changelog
|
|
|
|
Documentation of all notable changes to the **EVMC** project.
|
|
|
|
The format is based on [Keep a Changelog],
|
|
and this project adheres to [Semantic Versioning].
|
|
|
|
|
|
## [7.2.0] — unreleased
|
|
|
|
### Added
|
|
|
|
- Added **Java** bindings.
|
|
[#455](https://github.com/ethereum/evmc/pull/455)
|
|
- The C++ EVMC basic types `address` and `bytes32` have all the comparison operators supported.
|
|
[#474](https://github.com/ethereum/evmc/pull/474)
|
|
- New **evmc command-line tool** has been added. At the moment it supports
|
|
command _run_ for executing bytecode in any EVMC-compatible VM implementation.
|
|
Try `evmc run --help` for more information.
|
|
|
|
|
|
## [7.1.0] — 2019-11-29
|
|
|
|
### Added
|
|
|
|
- Added `MockedHost` C++ class (in form of header-only `evmc::mocked_host` library)
|
|
which can be used to emulate Host behavior when testing VM implementations.
|
|
[#456](https://github.com/ethereum/evmc/pull/456)
|
|
- In the Rust bindings added more type aliases (`MessageKind`, `MessageFlags`, `StatusCode`,
|
|
`StorageStatus`, `Revision`).
|
|
[#206](https://github.com/ethereum/evmc/pull/206)
|
|
- In CMake the `evmc::evmc_cpp` target has been added which represents the C++ EVMC API.
|
|
[#470](https://github.com/ethereum/evmc/pull/470)
|
|
|
|
### Changed
|
|
|
|
- Require Rust 1.37.0 as a minimum.
|
|
- In the Rust bindings mark read-only functions in `ExecutionContext` as non-mutating.
|
|
[#444](https://github.com/ethereum/evmc/pull/444)
|
|
- In the C++ `HostInterface` the logically read-only methods are marked with `const`.
|
|
[#461](https://github.com/ethereum/evmc/pull/461)
|
|
- Updated dependencies of the Rust bindings to latest stable versions.
|
|
[#462](https://github.com/ethereum/evmc/pull/462)
|
|
|
|
## [7.0.0] „Istanbul Ready” — 2019-11-11
|
|
|
|
This version of EVMC delivers compatibility with Istanbul EVM revision.
|
|
The ABI breaking change has been required in this case so some other
|
|
backward-incompatible changes are also included and deprecated APIs have been
|
|
removed.
|
|
|
|
### Added
|
|
|
|
- Support for **Istanbul** EIP-1344 (CHAINID opcode).
|
|
`chain_id` added to `evmc_tx_context` struct.
|
|
[#375](https://github.com/ethereum/evmc/pull/375)
|
|
- Support for **Istanbul** EIP-1884 (Repricing for trie-size-dependent opcodes).
|
|
[#372](https://github.com/ethereum/evmc/pull/372)
|
|
- The **Berlin** EVM revision number has been added.
|
|
[#407](https://github.com/ethereum/evmc/pull/407)
|
|
- In C++ API, an overload for `VM::execute()` has been added that omits
|
|
the Host context and interface parameters. This is useful for Precompiles VMs
|
|
that do not interact with the Host.
|
|
[#302](https://github.com/ethereum/evmc/pull/302)
|
|
- In C++ API, the `VM::has_capability()` method has been added.
|
|
[#465](https://github.com/ethereum/evmc/pull/465)
|
|
|
|
### Changed
|
|
|
|
- The `evmc_instance` renamed to `evmc_vm`.
|
|
[#430](https://github.com/ethereum/evmc/pull/430)
|
|
- The `evmc_context` renamed to `evmc_host_context`.
|
|
[#426](https://github.com/ethereum/evmc/pull/426)
|
|
- The `evmc_host_interface` is now separated from `evmc_host_context`.
|
|
This simplifies language bindings which implement the `evmc_host_interface`.
|
|
[#427](https://github.com/ethereum/evmc/pull/427)
|
|
- The `evmc::vm` renamed to `evmc::VM` in C++ API.
|
|
[#252](https://github.com/ethereum/evmc/pull/252)
|
|
- Previously deprecated `helpers.hpp` header file has been removed.
|
|
[#410](https://github.com/ethereum/evmc/pull/410)
|
|
- Previously deprecated `EVMC_CONSTANTINOPLE2` and `EVMC_LATEST_REVISION` revisions have been removed.
|
|
[#411](https://github.com/ethereum/evmc/pull/411)
|
|
- Previously deprecated tracing API has been removed.
|
|
[#429](https://github.com/ethereum/evmc/pull/429)
|
|
- In `evmc::instructions` library the undefined instructions have `0` gas cost
|
|
instead of previous `-1` value.
|
|
[#425](https://github.com/ethereum/evmc/pull/425)
|
|
- The EVM instruction tables have been redesigned to be more useful.
|
|
[#435](https://github.com/ethereum/evmc/pull/435)
|
|
- The EVMC loader trims all extensions (previously only the last one)
|
|
from the EVMC module file name.
|
|
[#439](https://github.com/ethereum/evmc/pull/439)
|
|
- The EVMC loader no longer ties to guess the VM create function name
|
|
by dropping prefix words from the name.
|
|
[#440](https://github.com/ethereum/evmc/pull/440)
|
|
- The helper function `evmc_is_abi_compatible()` returns now `bool`
|
|
instead of `int`.
|
|
[#442](https://github.com/ethereum/evmc/pull/442)
|
|
- In the Rust bindings make `ExecutionContext` optional within `execute`.
|
|
[#350](https://github.com/ethereum/evmc/pull/350)
|
|
- A set of small improvements to C++ API.
|
|
[#445](https://github.com/ethereum/evmc/pull/445)
|
|
[#449](https://github.com/ethereum/evmc/pull/449)
|
|
[#451](https://github.com/ethereum/evmc/pull/451)
|
|
|
|
|
|
|
|
## [6.3.1] - 2019-08-19
|
|
|
|
### Added
|
|
|
|
- Added `LoadAndConfigure` method to the Go API.
|
|
[#404](https://github.com/ethereum/evmc/pull/404)
|
|
|
|
### Deprecated
|
|
|
|
- Previously deprecated `is_zero()` helper has been removed,
|
|
but replaced with new `evmc::is_zero()` in API compatible way.
|
|
[#406](https://github.com/ethereum/evmc/pull/406)
|
|
|
|
### Fixed
|
|
|
|
- In C++ API the `get_balance()` method now returns expected `evmc::uint256be`
|
|
instead of `evmc_uint256be`.
|
|
[#403](https://github.com/ethereum/evmc/pull/403)
|
|
- [Cable] upgraded to 0.4.4 to fix incompatibility with older versions.
|
|
[#405](https://github.com/ethereum/evmc/pull/405)
|
|
|
|
## [6.3.0] - 2019-08-12
|
|
|
|
### Added
|
|
|
|
- Experimental support for _Precompiles_ -
|
|
EVMC modules containing implementations of Ethereum precompiled contracts.
|
|
To learn more read
|
|
the [EVMC Precompiles](https://github.com/ethereum/evmc/issues/259) feature description.
|
|
[#267](https://github.com/ethereum/evmc/pull/267)
|
|
- The `vm::get_capabilities()` method has been added in C++ API.
|
|
[#301](https://github.com/ethereum/evmc/pull/301)
|
|
- A CMake helper for running evmc-vmtester.
|
|
[#303](https://github.com/ethereum/evmc/pull/303)
|
|
- The loader module introduces standardized EVMC module configuration string
|
|
which contains path to the module and additional options.
|
|
E.g. `./modules/vm.so,engine=compiler,trace,verbosity=2`.
|
|
A VM can be loaded, created and configured atomically with
|
|
new `evmc_load_and_configure()` function.
|
|
[#313](https://github.com/ethereum/evmc/pull/313)
|
|
- Full support for 32-bit architectures has been added.
|
|
[#327](https://github.com/ethereum/evmc/pull/327)
|
|
- The C/C++ API for creating execution results in VMs has been extended
|
|
to handle common usage cases.
|
|
[#333](https://github.com/ethereum/evmc/pull/333)
|
|
- Support for moving `evmc::vm` objects in C++ API.
|
|
[#341](https://github.com/ethereum/evmc/pull/341)
|
|
- The basic types `address` and `bytes32` have received their C++ wrappers
|
|
to assure they are always initialized.
|
|
They also have convenient overloaded operators for comparison
|
|
and usage as keys in standard containers.
|
|
[#357](https://github.com/ethereum/evmc/pull/357)
|
|
- The C++ EVMC basic types `address` and `bytes32` have user defined literals.
|
|
[#359](https://github.com/ethereum/evmc/pull/359)
|
|
```cpp
|
|
auto a = 0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359_address;
|
|
auto b = 0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3_bytes32;
|
|
```
|
|
- CMake option `EVMC_INSTALL` (`ON` by default) to disable installing EVMC targets.
|
|
This may be useful when EVMC is included in other project as git submodule or subtree.
|
|
[#360](https://github.com/ethereum/evmc/pull/360)
|
|
- The `evmc-vmtester` tool received support for EVMC module configuration.
|
|
E.g. `evmc-vmtester ./my_vm,mode=interpreter`.
|
|
[#366](https://github.com/ethereum/evmc/pull/366)
|
|
- In `evmc-vm` Rust crate, `ExecutionResult` now has `success`, `failure` and `revert` helpers.
|
|
[#297](https://github.com/ethereum/evmc/pull/297)
|
|
[#368](https://github.com/ethereum/evmc/pull/368)
|
|
- Introduction of `evmc-declare` Rust crate with a procedural macro for easy VM declaration.
|
|
[#262](https://github.com/ethereum/evmc/pull/262)
|
|
[#316](https://github.com/ethereum/evmc/pull/316)
|
|
- Introduction of `ExecutionMessage` wrapper in the `evmc-vm` Rust crate.
|
|
[#324](https://github.com/ethereum/evmc/pull/324)
|
|
- Added type aliases and traits on basic types in the `evmc-vm` Rust crate.
|
|
[#342](https://github.com/ethereum/evmc/pull/342)
|
|
[#343](https://github.com/ethereum/evmc/pull/343)
|
|
|
|
### Changed
|
|
|
|
- A lot of documentation fixes, improvements and cleanups.
|
|
[#271](https://github.com/ethereum/evmc/pull/271)
|
|
[#272](https://github.com/ethereum/evmc/pull/272)
|
|
[#276](https://github.com/ethereum/evmc/pull/276)
|
|
[#280](https://github.com/ethereum/evmc/pull/280)
|
|
[#345](https://github.com/ethereum/evmc/pull/345)
|
|
- In C++ API `evmc::result::raw()` renamed to `evmc::result::release_raw()`.
|
|
[#293](https://github.com/ethereum/evmc/pull/293)
|
|
- In `evmc_load_and_create()` the `error_code` is optional (can be `NULL`).
|
|
[#311](https://github.com/ethereum/evmc/pull/311)
|
|
|
|
### Deprecated
|
|
|
|
- The usage of `evmc/helpers.hpp` has been deprecated. Use `evmc/evmc.hpp`
|
|
which provides the same features.
|
|
[#358](https://github.com/ethereum/evmc/pull/358)
|
|
- The tracing API has been deprecated as there have been some design flaws discovered.
|
|
New API is expected to be introduced in future.
|
|
[#376](https://github.com/ethereum/evmc/pull/376)
|
|
|
|
### Fixed
|
|
|
|
- The `vmtester` tool now builds with MSVC with `/std:c++17`.
|
|
[#261](https://github.com/ethereum/evmc/issues/261)
|
|
[#263](https://github.com/ethereum/evmc/pull/263)
|
|
- The `evmc_release_result()` helper has been fixed.
|
|
[#266](https://github.com/ethereum/evmc/issues/266)
|
|
[#279](https://github.com/ethereum/evmc/pull/279)
|
|
- The missing include guard in `evmc.hpp` has been fixed.
|
|
[#300](https://github.com/ethereum/evmc/pull/300)
|
|
- A loaded VM with incompatible ABI version is now properly destroyed.
|
|
[#305](https://github.com/ethereum/evmc/issues/305)
|
|
[#306](https://github.com/ethereum/evmc/pull/306)
|
|
|
|
|
|
## [6.2.2] - 2019-05-16
|
|
|
|
### Fixed
|
|
|
|
- Compilation error of `evmc::result::raw()` in Visual Studio fixed.
|
|
[#281](https://github.com/ethereum/evmc/pull/281)
|
|
- The `evmc::result`'s move assignment operator fixed.
|
|
[#282](https://github.com/ethereum/evmc/pull/282)
|
|
|
|
## [6.2.1] - 2019-04-29
|
|
|
|
### Fixed
|
|
|
|
- Disallow implicit conversion from C++ `evmc::result` to `evmc_result`
|
|
causing unintendent premature releasing of resources.
|
|
[#256](https://github.com/ethereum/evmc/issues/256)
|
|
[#257](https://github.com/ethereum/evmc/issues/257)
|
|
|
|
|
|
## [6.2.0] - 2019-04-25
|
|
|
|
### Added
|
|
|
|
- CMake option `EVMC_TEST_TOOLS` to build evmc-vmtester without bothering with internal unit tests.
|
|
[#216](https://github.com/ethereum/evmc/pull/216)
|
|
- The full C++ EVMC API for both VM and Host implementations.
|
|
[#217](https://github.com/ethereum/evmc/pull/217)
|
|
[#226](https://github.com/ethereum/evmc/pull/226)
|
|
- Initial and rough **bindings for Rust**. It is possible to implement an
|
|
EVMC VM in Rust utilising some helpers.
|
|
[#201](https://github.com/ethereum/evmc/pull/201)
|
|
[#202](https://github.com/ethereum/evmc/pull/202)
|
|
[#233](https://github.com/ethereum/evmc/pull/233)
|
|
- Handling of DLL loading errors greatly improved by
|
|
new `evmc_last_error_msg()` function.
|
|
[#230](https://github.com/ethereum/evmc/pull/230)
|
|
[#232](https://github.com/ethereum/evmc/pull/232)
|
|
|
|
### Changed
|
|
|
|
- The minimum supported GCC version is 6 (bumped from undocumented version 4.8).
|
|
[#195](https://github.com/ethereum/evmc/pull/195)
|
|
- Go bindings improved by introduction of the `TxContext` struct.
|
|
[#197](https://github.com/ethereum/evmc/pull/197)
|
|
- A lot improvements to the `evmc-vmtester` tool.
|
|
[#221](https://github.com/ethereum/evmc/pull/221)
|
|
[#234](https://github.com/ethereum/evmc/pull/234)
|
|
[#238](https://github.com/ethereum/evmc/pull/238)
|
|
[#241](https://github.com/ethereum/evmc/pull/241)
|
|
[#242](https://github.com/ethereum/evmc/pull/242)
|
|
- [Cable] upgraded to version 0.2.17.
|
|
[#251](https://github.com/ethereum/evmc/pull/251)
|
|
|
|
### Deprecated
|
|
|
|
- The `EVMC_CONSTANTINOPLE2` revision name is deprecated, replaced with `EVMC_PETERSBURG`.
|
|
[#196](https://github.com/ethereum/evmc/pull/196)
|
|
|
|
|
|
## [6.1.1] - 2019-02-13
|
|
|
|
### Added
|
|
|
|
- Documentation of elements of `evmc_revision`.
|
|
[#192](https://github.com/ethereum/evmc/pull/192)
|
|
|
|
### Fixed
|
|
|
|
- Fixed compilation with GCC 5 because of the "deprecated" attribute applied
|
|
to an enum element.
|
|
[#190](https://github.com/ethereum/evmc/pull/190)
|
|
|
|
|
|
## [6.1.0] - 2019-01-24
|
|
|
|
### Added
|
|
|
|
- The **Istanbul** EVM revision has been added.
|
|
[#174](https://github.com/ethereum/evmc/pull/174)
|
|
- The `is_zero()` C++ helper for basic data types has been added.
|
|
[#182](https://github.com/ethereum/evmc/pull/182)
|
|
- Reserved the post-Constantinople EVM revision number.
|
|
[#186](https://github.com/ethereum/evmc/pull/186)
|
|
- The C++ wrappers for VM and execution result objects have been added.
|
|
[#187](https://github.com/ethereum/evmc/pull/187)
|
|
|
|
### Deprecated
|
|
|
|
- The `EVMC_LATEST_REVISION` name has been deprecated, replaced with `EVMC_MAX_REVISION`.
|
|
[#184](https://github.com/ethereum/evmc/pull/184)
|
|
|
|
|
|
## [6.0.2] - 2019-01-16
|
|
|
|
### Fixed
|
|
|
|
- Add missing salt argument for CREATE2 in Host in Go bindings.
|
|
[#179](https://github.com/ethereum/evmc/pull/179)
|
|
|
|
|
|
## [6.0.1] - 2018-11-10
|
|
|
|
### Fixed
|
|
|
|
- Integration of EVMC as a CMake subproject is easier because
|
|
Hunter is not loaded unless building tests (`EVMC_TESTING=ON`) is requested.
|
|
[#169](https://github.com/ethereum/evmc/pull/169)
|
|
|
|
|
|
## [6.0.0] - 2018-10-24
|
|
|
|
### Added
|
|
|
|
- [EVMC Host implementation example](https://github.com/ethereum/evmc/blob/master/examples/example_host.cpp).
|
|
[#116](https://github.com/ethereum/evmc/pull/116)
|
|
- Support for Constantinople SSTORE net gas metering.
|
|
[#127](https://github.com/ethereum/evmc/pull/127)
|
|
- Support for Constantinople CREATE2 salt in Go bindings.
|
|
[#133](https://github.com/ethereum/evmc/pull/133)
|
|
- A VM can now report its **capabilities** (i.e. EVM and/or ewasm).
|
|
[#144](https://github.com/ethereum/evmc/pull/144)
|
|
- Introduction of the `evmc_bytes32` type.
|
|
[#152](https://github.com/ethereum/evmc/pull/152)
|
|
- [EVMC Host implementation guide](https://ethereum.github.io/evmc/hostguide.html).
|
|
[#159](https://github.com/ethereum/evmc/pull/159)
|
|
- [EVMC VM implementation guide](https://ethereum.github.io/evmc/vmguide.html).
|
|
[#160](https://github.com/ethereum/evmc/pull/160)
|
|
|
|
### Changed
|
|
|
|
- EVMC loader symbol searching has been generalized.
|
|
[#119](https://github.com/ethereum/evmc/pull/119)
|
|
- The `evmc_context_fn_table` renamed to `evmc_host_interface`.
|
|
[#125](https://github.com/ethereum/evmc/pull/125)
|
|
- The `evmc_message` fields reordered.
|
|
[#128](https://github.com/ethereum/evmc/pull/128)
|
|
- The `evmc_set_option()` now returns more information about the failure cause.
|
|
[#136](https://github.com/ethereum/evmc/pull/136)
|
|
- In C the `bool` type is used instead of `int` for true/false flags.
|
|
[#138](https://github.com/ethereum/evmc/pull/138)
|
|
[#140](https://github.com/ethereum/evmc/pull/140)
|
|
- Simplification of signatures of Host methods.
|
|
[#154](https://github.com/ethereum/evmc/pull/154)
|
|
|
|
|
|
## [5.2.0] - 2018-08-28
|
|
|
|
### Added
|
|
|
|
- Use also "evmc_create" function name for loading EVMC DLLs.
|
|
[#81](https://github.com/ethereum/evmc/pull/81)
|
|
|
|
### Changed
|
|
|
|
- Documentation improvements, including documentation for the VM Tester.
|
|
[#97](https://github.com/ethereum/evmc/pull/97)
|
|
[#107](https://github.com/ethereum/evmc/pull/107)
|
|
|
|
### Fixed
|
|
|
|
- The `evmc.h` header compatibility with C++98 fixed.
|
|
[#92](https://github.com/ethereum/evmc/pull/92)
|
|
- Compilation and build configuration fixes.
|
|
[#93](https://github.com/ethereum/evmc/pull/93)
|
|
[#103](https://github.com/ethereum/evmc/pull/103)
|
|
|
|
|
|
## [5.1.0] - 2018-08-23
|
|
|
|
### Added
|
|
|
|
- **Go language bindings** for EVMC.
|
|
[#41](https://github.com/ethereum/evmc/pull/41)
|
|
- New error codes.
|
|
[#56](https://github.com/ethereum/evmc/pull/56)
|
|
[#62](https://github.com/ethereum/evmc/pull/62)
|
|
- More helper functions.
|
|
[#67](https://github.com/ethereum/evmc/pull/67)
|
|
[#68](https://github.com/ethereum/evmc/pull/68)
|
|
[#70](https://github.com/ethereum/evmc/pull/70)
|
|
|
|
### Changed
|
|
|
|
- Documentation has been extended.
|
|
[#58](https://github.com/ethereum/evmc/pull/58)
|
|
- Optional Result Storage helper module has been separated.
|
|
[#59](https://github.com/ethereum/evmc/pull/59)
|
|
- [Cable] upgraded to 0.2.11.
|
|
[#75](https://github.com/ethereum/evmc/pull/75)
|
|
- The license changed from MIT to **Apache 2.0**.
|
|
[#77](https://github.com/ethereum/evmc/pull/77)
|
|
|
|
### Fixed
|
|
|
|
- Go bindings: Properly handle unknown error codes.
|
|
[#72](https://github.com/ethereum/evmc/pull/72)
|
|
|
|
|
|
## [5.0.0] - 2018-08-10
|
|
|
|
### Added
|
|
|
|
- List of status codes extended and reordered.
|
|
[#23](https://github.com/ethereum/evmc/pull/23)
|
|
[#24](https://github.com/ethereum/evmc/pull/24)
|
|
- VM Tracing API.
|
|
[#32](https://github.com/ethereum/evmc/pull/32)
|
|
- The support library with **metrics tables for EVM1 instructions**.
|
|
[#33](https://github.com/ethereum/evmc/pull/33)
|
|
[#34](https://github.com/ethereum/evmc/pull/34)
|
|
- Ability to create EVMC CMake package.
|
|
[#35](https://github.com/ethereum/evmc/pull/35)
|
|
- The loader support library for VM dynamic loading.
|
|
[#40](https://github.com/ethereum/evmc/pull/40)
|
|
- Constantinople: Support for `CREATE2` instruction.
|
|
[#45](https://github.com/ethereum/evmc/pull/45)
|
|
- Constantinople: Support for `EXTCODEHASH` instruction.
|
|
[#49](https://github.com/ethereum/evmc/pull/49)
|
|
- Constantinople: Storage status is reported back from `evmc_set_storage()`.
|
|
[#52](https://github.com/ethereum/evmc/pull/52)
|
|
|
|
|
|
[7.2.0]: https://github.com/ethereum/evmc/compare/v7.1.0...master
|
|
[7.1.0]: https://github.com/ethereum/evmc/releases/tag/v7.1.0
|
|
[7.0.0]: https://github.com/ethereum/evmc/releases/tag/v7.0.0
|
|
[6.3.1]: https://github.com/ethereum/evmc/releases/tag/v6.3.1
|
|
[6.3.0]: https://github.com/ethereum/evmc/releases/tag/v6.3.0
|
|
[6.2.2]: https://github.com/ethereum/evmc/releases/tag/v6.2.2
|
|
[6.2.1]: https://github.com/ethereum/evmc/releases/tag/v6.2.1
|
|
[6.2.0]: https://github.com/ethereum/evmc/releases/tag/v6.2.0
|
|
[6.1.1]: https://github.com/ethereum/evmc/releases/tag/v6.1.1
|
|
[6.1.0]: https://github.com/ethereum/evmc/releases/tag/v6.1.0
|
|
[6.0.2]: https://github.com/ethereum/evmc/releases/tag/v6.0.2
|
|
[6.0.1]: https://github.com/ethereum/evmc/releases/tag/v6.0.1
|
|
[6.0.0]: https://github.com/ethereum/evmc/releases/tag/v6.0.0
|
|
[5.2.0]: https://github.com/ethereum/evmc/releases/tag/v5.2.0
|
|
[5.1.0]: https://github.com/ethereum/evmc/releases/tag/v5.1.0
|
|
[5.0.0]: https://github.com/ethereum/evmc/releases/tag/v5.0.0
|
|
|
|
[Cable]: https://github.com/ethereum/cable
|
|
[Keep a Changelog]: https://keepachangelog.com/en/1.0.0/
|
|
[Semantic Versioning]: https://semver.org
|