💥 Add EIP-2935-based Utility Functions (#316)

### 🕓 Changelog

This PR adds [EIP-2935](https://eips.ethereum.org/EIPS/eip-2935)-based
utility functions. These functions can be used to access the historical
block hashes beyond the default `256`-block limit. We use the
[EIP-2935](https://eips.ethereum.org/EIPS/eip-2935) history contract,
which maintains a ring buffer of the last `8,191` block hashes stored in
state. For the blocks within the last `256` blocks, we use the native
[`BLOCKHASH`](https://www.evm.codes/?fork=cancun#40) opcode. For blocks
between `257` and `8,191` blocks ago, the function `_block_hash` queries
via the specified [`get`](https://eips.ethereum.org/EIPS/eip-2935#get)
method the [EIP-2935](https://eips.ethereum.org/EIPS/eip-2935) history
contract. For blocks older than `8,191` or future blocks (including the
current one), we return zero, matching the
[`BLOCKHASH`](https://www.evm.codes/?fork=cancun#40) behaviour.

It's important to note that the Vyper built-in function
[`blockhash`](https://docs.vyperlang.org/en/stable/built-in-functions.html#blockhash)
reverts if the block number is more than `256` blocks behind the current
block. We explicitly handle this case (i.e. `delta > 8191`) to ensure
the function returns an empty `bytes32` value rather than reverting
(i.e. exactly matching the
[`BLOCKHASH`](https://www.evm.codes/?fork=cancun#40) opcode behaviour).

In the stateless fuzzing tests we use `uint64` as upper bound for the
`block.number` due to Revm's internal
[saturation](https://github.com/bluealloy/revm/blob/b2c789d42d4eee93ce111f1a7d3d0708f1e34180/crates/interpreter/src/instructions/host.rs#L144)
of `block.number` to `u64::MAX` (see also my issue
[here](foundry-rs/foundry#10367)). If
`requested_number >= block_number` (after saturation), Revm returns
`U256::ZERO`
[early](https://github.com/bluealloy/revm/blob/b2c789d42d4eee93ce111f1a7d3d0708f1e34180/crates/interpreter/src/instructions/host.rs#L148-L157)
without querying the database.

Eventually, `block.number` is replaced with the
[`vm.getBlockNumber()`](https://book.getfoundry.sh/cheatcodes/get-block-number)
cheat code in the tests.

---------

Signed-off-by: Pascal Marco Caversaccio <[email protected]>

Author: pcaversaccio

.gas-snapshot

@@ -2,6 +2,11 @@
 
 ## [`0.1.2`](https://github.com/pcaversaccio/snekmate/releases/tag/v0.1.2) (Unreleased)
 
+### 💥 New Features
+
+- **Utility Functions**
+  - [`block_hash`](https://github.com/pcaversaccio/snekmate/blob/v0.1.2/src/snekmate/utils/block_hash.vy): Add [EIP-2935](https://eips.ethereum.org/EIPS/eip-2935)-based utility functions. ([#316](https://github.com/pcaversaccio/snekmate/pull/316))
+
 ### 📄 Licensing
 
 - Add the [MIT License](https://opensource.org/license/mit) as a dual-licensing option. ([#315](https://github.com/pcaversaccio/snekmate/pull/315))

.gas-snapshot-venom

@@ -76,6 +76,7 @@ src
     └── utils
         ├── base64 — "Base64 Encoding and Decoding Functions"
         ├── batch_distributor — "Batch Sending Both Native and ERC-20 Tokens"
+        ├── block_hash — "Utility Functions to Access Historical Block Hashes"
         ├── create_address — "`CREATE` EVM Opcode Utility Function for Address Calculation"
         ├── create2_address — "`CREATE2` EVM Opcode Utility Functions for Address Calculations"
         ├── ecdsa — "Elliptic Curve Digital Signature Algorithm (ECDSA) Secp256k1-Based Functions"
@@ -93,6 +94,7 @@ src
         └── mocks
             ├── base64_mock — "`base64` Module Reference Implementation"
             ├── batch_distributor_mock — "`batch_distributor` Module Reference Implementation"
+            ├── block_hash_mock — "`block_hash` Module Reference Implementation"
             ├── create_address_mock — "`create_address` Module Reference Implementation"
             ├── create2_address_mock — "`create2_address` Module Reference Implementation"
             ├── ecdsa_mock — "`ecdsa` Module Reference Implementation"
@@ -186,6 +188,7 @@ This repository contains [Foundry](https://github.com/foundry-rs/foundry)-based
 | `erc1155`                   |       ✅       |            ✅            |         ✅          |
 | `base64`                    |       ✅       |            ❌            |         ❌          |
 | `batch_distributor`         |       ✅       |            ✅            |         ✅          |
+| `block_hash`                |       ✅       |            ✅            |         ❌          |
 | `create_address`            |       ✅       |            ✅            |         ❌          |
 | `create2_address`           |       ✅       |            ✅            |         ❌          |
 | `ecdsa`                     |       ✅       |            ✅            |         ❌          |

CHANGELOG.md

@@ -21,7 +21,7 @@
   "bugs": {
     "url": "https://github.com/pcaversaccio/snekmate/issues"
   },
-  "packageManager": "pnpm@10.9.0",
+  "packageManager": "pnpm@10.10.0",
   "scripts": {
     "prettier:check": "npx prettier -c \"**/*.{md,sol,js,json,yml,yaml,sh}\"",
     "prettier:fix": "npx prettier -w \"**/*.{md,sol,js,json,yml,yaml,sh}\"",
@@ -42,12 +42,12 @@
     "@openzeppelin/merkle-tree": "^1.0.8",
     "eslint": "^9.25.1",
     "eslint-config-prettier": "^10.1.2",
-    "ethers": "^6.13.5",
+    "ethers": "^6.13.7",
     "keccak256": "^1.0.6",
     "merkletreejs": "^0.5.2",
     "prettier": "^3.5.3",
     "prettier-plugin-sh": "^0.17.2",
-    "prettier-plugin-solidity": "^1.4.2",
+    "prettier-plugin-solidity": "^1.4.3",
     "solhint": "^5.0.5"
   },
   "pnpm": {