feat: add shadow build in Makefile and Dockerfile

Author: Sahilgill24

Dockerfile

@@ -30,12 +30,29 @@ ENV RUSTFLAGS="$RUSTFLAGS"
 ARG FEATURES=""
 ENV FEATURES=$FEATURES
 
+# Disable default features (e.g. for `shadow-integration`, which must drop the
+# default `jemalloc` and `devnet4` features). Empty for a normal build.
+ARG NO_DEFAULT_FEATURES=""
+ENV NO_DEFAULT_FEATURES=$NO_DEFAULT_FEATURES
+
+# `--locked` by default; the Shadow build injects an uncommitted `[patch]` and so
+# must build unlocked (pass LOCKED= empty).
+ARG LOCKED="--locked"
+ENV LOCKED=$LOCKED
+
 # Build dependencies
-RUN cargo chef cook --profile $BUILD_PROFILE --features "$FEATURES" --recipe-path recipe.json
+RUN cargo chef cook --profile $BUILD_PROFILE $NO_DEFAULT_FEATURES --features "$FEATURES" --recipe-path recipe.json
 
 # Build application
 COPY --exclude=.git --exclude=dist . .
-RUN cargo build --profile $BUILD_PROFILE --features "$FEATURES" --locked --bin ream
+
+# Shadow simulator compatibility: the quinn-udp fallback is a Cargo `[patch]`,
+# which cannot be feature-gated and is therefore not committed. Set SHADOW=1 to
+# inject it into the manifest before building.
+ARG SHADOW=""
+RUN if [ -n "$SHADOW" ]; then bash shadow/inject-patch.sh; fi
+
+RUN cargo build --profile $BUILD_PROFILE $NO_DEFAULT_FEATURES --features "$FEATURES" $LOCKED --bin ream
 
 # ARG is not resolved in COPY so we have to hack around it by copying the
 # binary to a temporary location

Makefile

@@ -6,6 +6,10 @@ BIN_DIR = "dist/bin"
 # Cargo features for builds.
 FEATURES ?=
 
+# Devnet feature selected for Shadow builds (devnet4/devnet5 are mutually
+# exclusive, and `--no-default-features` drops the default `devnet4`).
+SHADOW_DEVNET ?= devnet5
+
 # Cargo profile for builds.
 PROFILE ?= release
 
@@ -123,6 +127,23 @@ pr: lint update-book-cli clean-deps test # Run all checks for a PR.
 build-%:
 	cross build --bin ream --target $* --features "$(FEATURES)" --profile "$(PROFILE)" $(EXTRA_FLAGS)
 
+##@ Shadow simulator
+
+.PHONY: shadow-build
+shadow-build: # Shadow-compatible binary (single-threaded, no jemalloc, quinn-udp patch).
+	./shadow/build.sh cargo build --profile "$(PROFILE)" \
+		--no-default-features --features "shadow-integration $(SHADOW_DEVNET)" --bin ream
+
+.PHONY: shadow-docker-build
+shadow-docker-build: # Build a Shadow-compatible Docker image, tagged ...:latest-shadow.
+	docker build --file ./Dockerfile . \
+		--build-arg SHADOW=1 \
+		--build-arg NO_DEFAULT_FEATURES=--no-default-features \
+		--build-arg FEATURES="shadow-integration $(SHADOW_DEVNET)" \
+		--build-arg LOCKED= \
+		--build-arg BUILD_PROFILE=$(PROFILE) \
+		--tag ghcr.io/reamlabs/ream:latest-shadow
+
 .PHONY: docker-build-push
 docker-build-push:
 	$(MAKE) build-x86_64-unknown-linux-gnu