test(consensus_sim): deterministic multi-node harness with equivocation injection

CMakeLists.txt

@@ -79,6 +79,9 @@ if(CHAINBASE_CHECK_LOCKING)
     set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DCHAINBASE_CHECK_LOCKING")
 endif()
 
+option(BUILD_CONSENSUS_TESTS "Build consensus simulation test harness" OFF)
+option(WITH_COVERAGE "Enable gcov coverage instrumentation for consensus tests" OFF)
+
 if(WIN32)
     set(BOOST_ROOT $ENV{BOOST_ROOT})
     set(Boost_USE_MULTITHREADED ON)
@@ -200,6 +203,11 @@ add_subdirectory(libraries)
 add_subdirectory(plugins)
 add_subdirectory(programs)
 
+if(BUILD_CONSENSUS_TESTS)
+    enable_testing()
+    add_subdirectory(tests/consensus_sim)
+endif()
+
 if(ENABLE_INSTALLER)
 
     set(VERSION_MAJOR 0)

libraries/chain/CMakeLists.txt

@@ -131,6 +131,11 @@ add_dependencies(graphene_chain graphene_protocol graphene_utilities build_hardf
 target_link_libraries(graphene_chain graphene_protocol graphene_utilities fc chainbase appbase ${PATCH_MERGE_LIB})
 target_include_directories(graphene_chain PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/include" "${CMAKE_CURRENT_BINARY_DIR}/include" "${CMAKE_CURRENT_SOURCE_DIR}/../../")
 
+if(WITH_COVERAGE)
+    target_compile_options(graphene_chain PRIVATE --coverage)
+    target_link_options(graphene_chain PUBLIC --coverage)
+endif()
+
 if(MSVC)
     set_source_files_properties(database.cpp PROPERTIES COMPILE_FLAGS "/bigobj")
 endif(MSVC)

libraries/protocol/CMakeLists.txt

@@ -58,6 +58,11 @@ target_link_libraries(graphene_${CURRENT_TARGET} fc) #graphene::version)
 target_include_directories(graphene_${CURRENT_TARGET}
         PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/include" "${CMAKE_CURRENT_SOURCE_DIR}/../../version/include" "${CMAKE_CURRENT_BINARY_DIR}/include" "${CMAKE_CURRENT_BINARY_DIR}/../../version/include")
 
+if(WITH_COVERAGE)
+    target_compile_options(graphene_${CURRENT_TARGET} PRIVATE --coverage)
+    target_link_options(graphene_${CURRENT_TARGET} PUBLIC --coverage)
+endif()
+
 install(TARGETS
         graphene_${CURRENT_TARGET}
 

libraries/utilities/CMakeLists.txt

@@ -3,6 +3,14 @@ include(GetGitRevisionDescription)
 get_git_head_revision(GIT_REFSPEC GRAPHENE_GIT_REVISION_SHA)
 get_git_unix_timestamp(GRAPHENE_GIT_REVISION_UNIX_TIMESTAMP)
 git_describe(GRAPHENE_GIT_REVISION_DESCRIPTION --tags)
+# Fallbacks when git lookup fails (e.g. building inside a container that can't
+# resolve a worktree gitfile pointing to a host path).
+if(NOT GRAPHENE_GIT_REVISION_UNIX_TIMESTAMP MATCHES "^[0-9]+$")
+    set(GRAPHENE_GIT_REVISION_UNIX_TIMESTAMP 0)
+endif()
+if(NOT GRAPHENE_GIT_REVISION_SHA MATCHES "^[a-f0-9]+$")
+    set(GRAPHENE_GIT_REVISION_SHA "")
+endif()
 if(NOT GRAPHENE_GIT_REVISION_DESCRIPTION)
     set(GRAPHENE_GIT_REVISION_DESCRIPTION "unknown")
 endif(NOT GRAPHENE_GIT_REVISION_DESCRIPTION)

share/vizd/docker/Dockerfile-dev

@@ -0,0 +1,72 @@
+# Dockerfile-dev — developer toolchain image for VIZ blockchain
+#
+# PURPOSE: Provides a fully-equipped Linux build environment that mirrors the
+# CI builder stage (same base image and apt packages as Dockerfile-production)
+# WITHOUT baking any source code in. The host worktree is mounted at /workspace
+# so you can iterate on the source without rebuilding this image.
+#
+# BUILD:
+#   docker build -f share/vizd/docker/Dockerfile-dev -t viz-dev .
+#
+# ENTER A SHELL:
+#   docker run --rm -it -v $(pwd):/workspace viz-dev
+#
+# ONE-SHOT COMMAND:
+#   docker run --rm -v $(pwd):/workspace viz-dev bash -c "cd /workspace/build && make -j$(nproc) vizd"
+#
+# ccache is stored in /workspace/.ccache (mounted from the host worktree) so it
+# persists across container runs. Set CCACHE_DIR=/workspace/.ccache inside the
+# container or rely on the ENV below.
+
+FROM phusion/baseimage:noble-1.0.3
+
+ENV LANG=en_US.UTF-8
+
+# ccache configuration — cache directory is mounted from the host worktree so
+# it survives container restarts without polluting the image layers.
+ENV CCACHE_DIR=/workspace/.ccache
+ENV CCACHE_MAXSIZE=2G
+ENV CCACHE_COMPRESS=1
+
+# Install build dependencies (mirrors Dockerfile-production builder stage exactly,
+# plus gcovr for coverage reports and gdb for debugging failing scenarios).
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        autoconf \
+        automake \
+        autotools-dev \
+        binutils \
+        bsdmainutils \
+        build-essential \
+        cmake \
+        git \
+        ccache \
+        gdb \
+        gcovr \
+        libboost-chrono-dev \
+        libboost-context-dev \
+        libboost-coroutine-dev \
+        libboost-date-time-dev \
+        libboost-filesystem-dev \
+        libboost-iostreams-dev \
+        libboost-locale-dev \
+        libboost-program-options-dev \
+        libboost-serialization-dev \
+        libboost-system-dev \
+        libboost-test-dev \
+        libboost-thread-dev \
+        libbz2-dev \
+        liblzma-dev \
+        libzstd-dev \
+        libreadline-dev \
+        libssl-dev \
+        libtool \
+        ncurses-dev \
+        pbzip2 \
+        pkg-config \
+        zlib1g-dev && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /workspace
+
+CMD ["/bin/bash"]

share/vizd/docker/README-dev.md

@@ -0,0 +1,75 @@
+# VIZ Developer Docker Image
+
+`Dockerfile-dev` builds a long-lived Linux toolchain image that mirrors the CI
+builder stage (same base image and packages as `Dockerfile-production`) without
+baking any source code in. Mount the worktree as a volume and compile/test
+inside the container against a real Ubuntu Noble environment.
+
+## Prerequisites
+
+- Docker Desktop (or Docker Engine) running locally.
+- Git submodules initialized on the host **before** using the container:
+
+  ```bash
+  git submodule update --init --recursive
+  ```
+
+## Build the image
+
+Run once from the repository root (or worktree root):
+
+```bash
+docker build -f share/vizd/docker/Dockerfile-dev -t viz-dev .
+```
+
+Typical build time: 3–8 minutes on first run (pulls base image + ~30 apt
+packages). Subsequent builds are fast thanks to Docker layer cache.
+
+## Enter an interactive shell
+
+```bash
+docker run --rm -it -v $(pwd):/workspace viz-dev
+```
+
+Inside the container your worktree is at `/workspace`. Run cmake, make, ctest,
+gcovr, or gdb from there.
+
+## Run a one-shot command
+
+```bash
+docker run --rm -v $(pwd):/workspace viz-dev bash -c "
+  mkdir -p build-docker && cd build-docker
+  cmake -DCMAKE_BUILD_TYPE=Release -DLOW_MEMORY_NODE=OFF ..
+  make -j$(nproc) vizd
+"
+```
+
+## Configure only (no build)
+
+```bash
+docker run --rm -v $(pwd):/workspace viz-dev bash -c "
+  mkdir -p build-docker && cd build-docker
+  cmake -DCMAKE_BUILD_TYPE=Release -DLOW_MEMORY_NODE=OFF .. 2>&1 | tail -30
+"
+```
+
+## ccache
+
+The image sets `CCACHE_DIR=/workspace/.ccache`. When you mount the worktree
+with `-v $(pwd):/workspace`, ccache writes to `<worktree>/.ccache/` on the
+host and persists across container runs. The `.ccache/` directory is listed in
+`.git/info/exclude` so it won't appear in `git status`.
+
+## Clean up
+
+Remove the build directory created inside the worktree:
+
+```bash
+rm -rf build-docker/
+```
+
+Remove the image:
+
+```bash
+docker rmi viz-dev
+```

tests/consensus_sim/.gitignore

@@ -0,0 +1,3 @@
+build.log
+failures/*
+!failures/.gitkeep