evmc/CHANGELOG.md

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