feat(tests): add support of eth spec tests

Author: MatusKysel

Cargo.lock

@@ -1,3 +1,6 @@
+[workspace]
+members = [".", "testing/bsc-ef-tests"]
+
 [package]
 name = "reth_bsc"
 version = "0.1.0"

Cargo.toml

@@ -34,3 +34,30 @@ check-features:
 		--package reth-primitives-traits \
 		--package reth-primitives \
 		--feature-powerset
+
+##@ EVM Tests
+
+# Execution spec tests configuration
+EEST_VERSION ?= v5.4.0
+EEST_URL := https://github.com/ethereum/execution-spec-tests/releases/download/$(EEST_VERSION)/fixtures_stable.tar.gz
+EEST_DIR := ./testing/bsc-ef-tests/execution-spec-tests
+
+$(EEST_DIR):
+	@echo "Downloading execution spec tests $(EEST_VERSION)..."
+	mkdir -p $(EEST_DIR)
+	curl -sL $(EEST_URL) | tar -xzf - --strip-components=1 -C $(EEST_DIR)
+
+.PHONY: download-eest
+download-eest: $(EEST_DIR) ## Download execution spec test fixtures
+
+.PHONY: ef-tests
+ef-tests: $(EEST_DIR) ## Run BSC EVM execution spec tests
+	cargo test -p bsc-ef-tests --release --features ef-tests,jemalloc,asm-keccak
+
+.PHONY: ef-tests-nextest
+ef-tests-nextest: $(EEST_DIR) ## Run BSC EVM execution spec tests with nextest (faster)
+	cargo nextest run -p bsc-ef-tests --release --features ef-tests,jemalloc,asm-keccak
+
+.PHONY: clean-eest
+clean-eest: ## Remove downloaded execution spec test fixtures
+	rm -rf $(EEST_DIR)

Makefile

@@ -41,6 +41,27 @@ make build
 make maxperf 
 ```
 
+## Testing
+
+### Ethereum Execution Spec Tests
+
+Run the [Ethereum Execution Spec Tests](https://github.com/ethereum/execution-spec-tests) to validate BSC EVM compatibility:
+
+```bash
+# Download test fixtures (v5.4.0)
+make download-eest
+
+# Run tests
+make ef-tests
+
+# Or use nextest for faster parallel execution (requires cargo-nextest)
+# Install with: cargo install cargo-nextest
+make ef-tests-nextest
+
+# Clean up test fixtures
+make clean-eest
+```
+
 ## Running
 
 ### Full Node (Recommended)

README.md

@@ -0,0 +1,3 @@
+# Test fixtures (downloaded)
+execution-spec-tests/
+ethereum-tests/

testing/bsc-ef-tests/.gitignore

@@ -0,0 +1,51 @@
+[package]
+name = "bsc-ef-tests"
+version = "0.1.0"
+edition = "2021"
+description = "Execution Spec Tests for BSC EVM"
+
+[features]
+ef-tests = []
+jemalloc = ["dep:tikv-jemallocator"]
+asm-keccak = ["alloy-primitives/asm-keccak"]
+
+[dependencies]
+# BSC crate
+reth_bsc = { path = "../.." }
+
+# reth dependencies from the same reth fork
+reth-chainspec = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-consensus = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-ethereum-forks = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-db = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle", features = ["mdbx", "test-utils", "disable-lock"] }
+reth-db-api = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-db-common = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-ethereum-consensus = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-ethereum-primitives = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-evm = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-evm-ethereum = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-primitives = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-primitives-traits = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-provider = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle", features = ["test-utils"] }
+reth-revm = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle", features = ["std"] }
+reth-tracing = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-trie = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+reth-trie-db = { git = "https://github.com/bnb-chain/reth.git", branch = "feat/eip7594-sidecar-toggle" }
+
+# revm
+revm = { version = "34.0.0", features = ["secp256k1", "blst", "c-kzg", "memory_limit"] }
+
+# alloy
+alloy-consensus = "1.1.3"
+alloy-eips = "1.1.3"
+alloy-genesis = "1.1.3"
+alloy-primitives = "1.4.1"
+alloy-rlp = "0.3.12"
+
+# misc
+rayon = "1"
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+thiserror = "2.0"
+tikv-jemallocator = { version = "0.6", optional = true }
+walkdir = "2"

testing/bsc-ef-tests/Cargo.toml

@@ -0,0 +1,27 @@
+//! Test case abstractions
+
+use crate::result::Error;
+use std::path::Path;
+
+/// A single test case.
+pub trait Case: Sized {
+    /// Load the test from the given path.
+    fn load(path: &Path) -> Result<Self, Error>;
+
+    /// Run the test.
+    fn run(&self) -> Result<(), Error>;
+}
+
+/// A collection of test cases.
+#[derive(Debug)]
+pub struct Cases<T> {
+    /// The test cases.
+    pub tests: Vec<T>,
+}
+
+impl<T: Case> Cases<T> {
+    /// Run all test cases.
+    pub fn run(&self) -> Vec<Result<(), Error>> {
+        self.tests.iter().map(|case| case.run()).collect()
+    }
+}