(test-harness): reusable WAVS integration test harness (#1147)

Cargo.toml

@@ -6,6 +6,7 @@ members = [
     "packages/engine",
     "packages/gui/shared",
     "packages/layer-tests",
+    "packages/test-harness",
     "packages/types",
     "packages/utils",
     "packages/version-pins",
@@ -125,30 +126,30 @@ walkdir = "2.5.0"
 wildmatch = "2.5.0"
 
 # EVM-specific dependencies
-alloy-node-bindings = "=1.0.42"
+alloy-node-bindings = "1.0.42"
 alloy-json-abi = "1.4.1"
 alloy-primitives = { version = "1.4.1", features = ["serde"] }
-alloy-provider = { version = "=1.0.42", features = ["ws", "pubsub"] }
+alloy-provider = { version = "1.0.42", features = ["ws", "pubsub"] }
 alloy-sol-types = "1.4.1"
 alloy-sol-macro = { version = "1.4.1", features = ["json"] }
-alloy-transport = "=1.0.42"
-alloy-transport-http = "=1.0.42"
-alloy-rpc-client = "=1.0.42"
-alloy-contract = "=1.0.42"
-alloy-signer = "=1.0.42"
-alloy-signer-local = { version = "=1.0.42", features = ["mnemonic"] }
-alloy-network = "=1.0.42"
-alloy-rpc-types-eth = "=1.0.42"
+alloy-transport = "1.0.42"
+alloy-transport-http = "1.0.42"
+alloy-rpc-client = "1.0.42"
+alloy-contract = "1.0.42"
+alloy-signer = "1.0.42"
+alloy-signer-local = { version = "1.0.42", features = ["mnemonic"] }
+alloy-network = "1.0.42"
+alloy-rpc-types-eth = "1.0.42"
 
-alloy-consensus-any = "=1.0.42"
-alloy-consensus = "=1.0.42"
-alloy-eips = "=1.0.42"
-alloy-network-primitives = "=1.0.42"
-alloy-serde = "=1.0.42"
-alloy-tx-macros = "=1.0.42"
-alloy-eip2930 = "=0.2.1"
-alloy-eip7702 = "=0.6.1"
-alloy-json-rpc = "=1.6.3"
+alloy-consensus-any = "1.0.42"
+alloy-consensus = "1.0.42"
+alloy-eips = "1.0.42"
+alloy-network-primitives = "1.0.42"
+alloy-serde = "1.0.42"
+alloy-tx-macros = "1.0.42"
+alloy-eip2930 = "0.2.1"
+alloy-eip7702 = "0.6.1"
+alloy-json-rpc = "1.6.3"
 
 layer-climb = "0.9.0"
 layer-climb-address = { version = "0.9.0", features = [
@@ -282,6 +283,7 @@ awsm_web = {version = "0.45.0", default-features = false, features = ["dom", "fi
 # local
 utils = { path = "packages/utils" }
 wavs = { path = "packages/wavs" }
+wavs-test-harness = { path = "packages/test-harness" }
 wavs-engine = { path = "packages/engine" }
 wavs-types = { path = "packages/types" }
 wavs-cli = { path = "packages/cli" }

justfile

@@ -181,6 +181,14 @@ cosmwasm-build-inner CONTRACT_PATH:
 test-wavs-e2e:
     ulimit -n 65536 && RUST_LOG=debug,alloy_rpc=off,alloy_provider=off,wasmtime=off,cranelift=off,hyper_util=off cargo test -p layer-tests
 
+# reusable integration test harness — local Anvil + in-process runner (deterministic, no fork required)
+test-harness:
+    cargo test -p wavs-test-harness
+
+# reusable integration test harness — pinned-fork tier (requires FORK_RPC_URL)
+test-harness-fork:
+    cargo test -p wavs-test-harness --features fork
+
 update-submodules:
     git submodule update --init --recursive
 

packages/test-harness/Cargo.toml

@@ -0,0 +1,63 @@
+[package]
+name = "wavs-test-harness"
+description = "Reusable integration test harness for WAVS apps — chain control, service lifecycle, and contract assertions"
+version.workspace = true
+edition.workspace = true
+authors.workspace = true
+rust-version.workspace = true
+repository.workspace = true
+license.workspace = true
+publish = false
+
+# Features are additive. `fork` and `inproc` are on by default because the harness
+# is only useful when at least one runner tier is enabled. `subprocess` is preview
+# and stays off by default to keep the dep graph small.
+#
+# Consumers should add `wavs-test-harness` as a [dev-dependencies] entry only —
+# never as a regular dependency — to keep the `utils/test-utils` feature out of
+# their production builds.
+[features]
+default = ["fork", "inproc"]
+fork = []
+inproc = []
+subprocess = []
+
+[dependencies]
+utils = { workspace = true, features = ["test-utils"] }
+wavs-types = { workspace = true, features = ["full"] }
+wavs-engine = { workspace = true }
+wasmtime = { workspace = true }
+tempfile = { workspace = true }
+
+anyhow = { workspace = true }
+async-trait = { workspace = true }
+futures = { workspace = true }
+serde = { workspace = true }
+serde_json = { workspace = true }
+thiserror = { workspace = true }
+tokio = { workspace = true }
+toml = { workspace = true }
+tracing = { workspace = true }
+tracing-subscriber = { workspace = true }
+
+alloy-contract = { workspace = true }
+alloy-network = { workspace = true }
+alloy-node-bindings = { workspace = true }
+alloy-primitives = { workspace = true }
+alloy-provider = { workspace = true, features = ["anvil-api", "anvil-node"] }
+alloy-signer = { workspace = true }
+alloy-signer-local = { workspace = true }
+alloy-sol-types = { workspace = true }
+alloy-sol-macro = { workspace = true }
+alloy-rpc-types-eth = { workspace = true }
+
+# Subprocess runner-only deps. Cheap enough to leave outside the feature gate.
+reqwest = { workspace = true, features = ["json"] }
+
+[target.'cfg(unix)'.dependencies]
+libc = "0.2"
+
+[dev-dependencies]
+tokio = { workspace = true }
+tempfile = { workspace = true }
+temp-env = { workspace = true }