2023-11-01 03:32:09 +00:00
|
|
|
# Nimbus
|
2024-09-29 12:37:09 +00:00
|
|
|
# Copyright (c) 2020-2024 Status Research & Development GmbH
|
2023-11-01 03:32:09 +00:00
|
|
|
# Licensed under either of
|
|
|
|
# * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0)
|
|
|
|
# * MIT license ([LICENSE-MIT](LICENSE-MIT) or
|
|
|
|
# http://opensource.org/licenses/MIT)
|
|
|
|
# at your option. This file may not be copied, modified, or distributed except
|
|
|
|
# according to those terms.
|
|
|
|
|
2022-12-02 04:35:41 +00:00
|
|
|
import
|
|
|
|
eth/common,
|
|
|
|
stint,
|
|
|
|
evmc/evmc,
|
|
|
|
../utils/utils
|
2020-01-16 04:20:13 +00:00
|
|
|
|
|
|
|
const
|
EVMC: Byte-endian conversions for 256-bit numeric values
Perform byte-endian conversion for 256-bit numeric values, but not 256-bit
hashes. These conversions are necessary for EVMC binary compatibility.
In new EVMC, all host-side conversions are explicit, calling `flip256`.
These conversions are performed in the EVMC "glue" code, which deals with the
binary interface, so the host services aren't aware of conversions.
We intend to skip these conversions when Nimbus host calls Nimbus EVM, even
when it's a shared library, using a negotiated EVMC extension. But for now
we're focused on correctness and cross-validation with third party EVMs.
The overhead of endian conversion is not too high because most EVMC host calls
access the database anyway. `getTxContext` does not, so the conversions from
that are cached here. Also, well-optimised EVMs don't call it often.
It is arguable whether endian conversion should occur for storage slots (`key`).
In favour of no conversion: Slot keys are 32-byte blobs, and this is clear in
the EVMC definition where slot keys are `evmc_bytes32` (not `evmc_uint256be`),
meaning treating as a number is _not_ expected by EVMC. Although they are
often small numbers, sometimes they are a hash from the contract code plus a
number. Slot keys are hashed on the host side with Keccak256 before any
database calls, so the host side does not look at them numerically.
In favour of conversion: They are often small numbers and it is helpful to log
them as such, rather than a long string of zero digits with 1-2 non-zero. The
representation in JSON has leading zeros removed, like a number rather than a
32-byte blob. There is also an interesting space optimisation when the keys
are used unhashed in storage.
Nimbus currently treats slot keys on the host side as numbers, and the tests
pass when endian conversion is done. So to remain consistent with other parts
of Nimbus we convert slot keys.
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-11-24 15:54:59 +00:00
|
|
|
evmc_native* {.booldefine.} = false
|
2020-01-16 04:20:13 +00:00
|
|
|
|
2024-10-16 06:51:38 +00:00
|
|
|
func toEvmc*(a: Address): evmc_address {.inline.} =
|
2024-09-29 12:37:09 +00:00
|
|
|
evmc_address(bytes: a.data)
|
2020-01-16 04:20:13 +00:00
|
|
|
|
2024-10-16 06:51:38 +00:00
|
|
|
func toEvmc*(h: Hash32): evmc_bytes32 {.inline.} =
|
2024-09-29 12:37:09 +00:00
|
|
|
doAssert sizeof(h) == sizeof(evmc_bytes32)
|
|
|
|
evmc_bytes32(bytes: h.data)
|
|
|
|
|
|
|
|
func toEvmc*(h: ContractSalt): evmc_bytes32 {.inline.} =
|
Transaction: EVMC fix, `CREATE2` salt is a 256-bit blob not a number
This changes fixes a bug in `CREATE2` ops when used with EVMC.
Because it changes the salt type, it affects non-EVMC code as well.
The salt was passed through EVMC with the wrong byte order, although this went
unnoticed as the Nimbus host flipped the byte order before using it.
This was found when running Nimbus with third-party EVM,
["evmone"](https://github.com/ethereum/evmone).
There are different ways to remedy this.
If treated as a number, Nimbus EVM would byte-flip the value when calling EVMC,
then Nimbus host would flip the received value. Finally, it would be flipped a
third time when generating the address in `generateSafeAddress`. The first two
flips can be eliminated by negotiation (like other numbers), but there would
always be one flip.
As a bit pattern, Nimbus EVM would flip the same way it does when dealing with
hashes on the stack (e.g. with `getBlockHash`). Nimbus host wouldn't flip at
all - and when using third-party EVMs there would be no flips in Nimbus.
Because this value is not for arithmetic, any bit pattern is valid, and there
shouldn't be any flips when using a third-party EVM, the bit-pattern
interpretation is favoured. The only flip is done in Nimbus EVM (and might be
eliminated in an optimised version).
As suggested, we'll define a new "opaque 256 bits" type to hold this value.
(Similar to `Hash256`, but the salt isn't necessarily a hash.)
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-06-09 22:32:42 +00:00
|
|
|
doAssert sizeof(h) == sizeof(evmc_bytes32)
|
2020-01-16 04:20:13 +00:00
|
|
|
cast[evmc_bytes32](h)
|
|
|
|
|
2022-04-08 04:54:11 +00:00
|
|
|
func toEvmc*(n: UInt256): evmc_uint256be {.inline.} =
|
2020-01-16 04:20:13 +00:00
|
|
|
when evmc_native:
|
|
|
|
cast[evmc_uint256be](n)
|
|
|
|
else:
|
2023-09-13 02:32:38 +00:00
|
|
|
cast[evmc_uint256be](n.toBytesBE)
|
2020-01-16 04:20:13 +00:00
|
|
|
|
|
|
|
func fromEvmc*(T: type, n: evmc_bytes32): T {.inline.} =
|
2024-09-29 12:37:09 +00:00
|
|
|
when T is ContractSalt:
|
Transaction: EVMC fix, `CREATE2` salt is a 256-bit blob not a number
This changes fixes a bug in `CREATE2` ops when used with EVMC.
Because it changes the salt type, it affects non-EVMC code as well.
The salt was passed through EVMC with the wrong byte order, although this went
unnoticed as the Nimbus host flipped the byte order before using it.
This was found when running Nimbus with third-party EVM,
["evmone"](https://github.com/ethereum/evmone).
There are different ways to remedy this.
If treated as a number, Nimbus EVM would byte-flip the value when calling EVMC,
then Nimbus host would flip the received value. Finally, it would be flipped a
third time when generating the address in `generateSafeAddress`. The first two
flips can be eliminated by negotiation (like other numbers), but there would
always be one flip.
As a bit pattern, Nimbus EVM would flip the same way it does when dealing with
hashes on the stack (e.g. with `getBlockHash`). Nimbus host wouldn't flip at
all - and when using third-party EVMs there would be no flips in Nimbus.
Because this value is not for arithmetic, any bit pattern is valid, and there
shouldn't be any flips when using a third-party EVM, the bit-pattern
interpretation is favoured. The only flip is done in Nimbus EVM (and might be
eliminated in an optimised version).
As suggested, we'll define a new "opaque 256 bits" type to hold this value.
(Similar to `Hash256`, but the salt isn't necessarily a hash.)
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-06-09 22:32:42 +00:00
|
|
|
doAssert sizeof(n) == sizeof(T)
|
|
|
|
cast[T](n)
|
2024-09-29 12:37:09 +00:00
|
|
|
elif T is Hash32:
|
|
|
|
Hash32(n.bytes)
|
2022-04-08 04:54:11 +00:00
|
|
|
elif T is UInt256:
|
2020-01-16 04:20:13 +00:00
|
|
|
when evmc_native:
|
2022-04-08 04:54:11 +00:00
|
|
|
cast[UInt256](n)
|
2020-01-16 04:20:13 +00:00
|
|
|
else:
|
2022-04-08 04:54:11 +00:00
|
|
|
UInt256.fromBytesBE(n.bytes)
|
2020-01-16 04:20:13 +00:00
|
|
|
else:
|
|
|
|
{.error: "cannot convert unsupported evmc type".}
|
|
|
|
|
2024-10-16 06:51:38 +00:00
|
|
|
func fromEvmc*(a: evmc_address): Address {.inline.} =
|
|
|
|
Address(a.bytes)
|
2020-01-16 04:20:13 +00:00
|
|
|
|
|
|
|
when isMainModule:
|
Transaction: EVMC fix, `CREATE2` salt is a 256-bit blob not a number
This changes fixes a bug in `CREATE2` ops when used with EVMC.
Because it changes the salt type, it affects non-EVMC code as well.
The salt was passed through EVMC with the wrong byte order, although this went
unnoticed as the Nimbus host flipped the byte order before using it.
This was found when running Nimbus with third-party EVM,
["evmone"](https://github.com/ethereum/evmone).
There are different ways to remedy this.
If treated as a number, Nimbus EVM would byte-flip the value when calling EVMC,
then Nimbus host would flip the received value. Finally, it would be flipped a
third time when generating the address in `generateSafeAddress`. The first two
flips can be eliminated by negotiation (like other numbers), but there would
always be one flip.
As a bit pattern, Nimbus EVM would flip the same way it does when dealing with
hashes on the stack (e.g. with `getBlockHash`). Nimbus host wouldn't flip at
all - and when using third-party EVMs there would be no flips in Nimbus.
Because this value is not for arithmetic, any bit pattern is valid, and there
shouldn't be any flips when using a third-party EVM, the bit-pattern
interpretation is favoured. The only flip is done in Nimbus EVM (and might be
eliminated in an optimised version).
As suggested, we'll define a new "opaque 256 bits" type to hold this value.
(Similar to `Hash256`, but the salt isn't necessarily a hash.)
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-06-09 22:32:42 +00:00
|
|
|
import ../constants
|
2020-01-16 04:20:13 +00:00
|
|
|
var a: evmc_address
|
|
|
|
a.bytes[19] = 3.byte
|
|
|
|
var na = fromEvmc(a)
|
|
|
|
assert(a == toEvmc(na))
|
|
|
|
var b = stuint(10, 256)
|
|
|
|
var eb = b.toEvmc
|
2022-04-08 04:54:11 +00:00
|
|
|
assert(b == fromEvmc(UInt256, eb))
|
2020-01-16 04:20:13 +00:00
|
|
|
var h = EMPTY_SHA3
|
|
|
|
var eh = toEvmc(h)
|
2024-10-16 06:51:38 +00:00
|
|
|
assert(h == fromEvmc(Hash32, eh))
|
2022-09-03 18:15:35 +00:00
|
|
|
var s = cast[ContractSalt](EMPTY_ROOT_HASH)
|
Transaction: EVMC fix, `CREATE2` salt is a 256-bit blob not a number
This changes fixes a bug in `CREATE2` ops when used with EVMC.
Because it changes the salt type, it affects non-EVMC code as well.
The salt was passed through EVMC with the wrong byte order, although this went
unnoticed as the Nimbus host flipped the byte order before using it.
This was found when running Nimbus with third-party EVM,
["evmone"](https://github.com/ethereum/evmone).
There are different ways to remedy this.
If treated as a number, Nimbus EVM would byte-flip the value when calling EVMC,
then Nimbus host would flip the received value. Finally, it would be flipped a
third time when generating the address in `generateSafeAddress`. The first two
flips can be eliminated by negotiation (like other numbers), but there would
always be one flip.
As a bit pattern, Nimbus EVM would flip the same way it does when dealing with
hashes on the stack (e.g. with `getBlockHash`). Nimbus host wouldn't flip at
all - and when using third-party EVMs there would be no flips in Nimbus.
Because this value is not for arithmetic, any bit pattern is valid, and there
shouldn't be any flips when using a third-party EVM, the bit-pattern
interpretation is favoured. The only flip is done in Nimbus EVM (and might be
eliminated in an optimised version).
As suggested, we'll define a new "opaque 256 bits" type to hold this value.
(Similar to `Hash256`, but the salt isn't necessarily a hash.)
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-06-09 22:32:42 +00:00
|
|
|
var es = toEvmc(s)
|
|
|
|
assert(s == fromEvmc(ContractSalt, es))
|