Makefile

# ceps-rust-ts-client: Make entrypoints (humans + CI).

SHELL := /bin/bash
.SHELLFLAGS := -eu -o pipefail -c

ROOT := $(CURDIR)
CURRENT_DIR := .

# Optional overrides for adjacent checkouts
NCTL_DOCKER_PRODUCT ?= $(ROOT)/../casper-nctl-2-docker
CEP18_PRODUCT ?= $(ROOT)/../cep-18
CEP78_PRODUCT ?= $(ROOT)/../cep-78-enhanced-nft
CEP85_PRODUCT ?= $(ROOT)/../cep-1155
CEP95_PRODUCT ?= $(ROOT)/../cep-95

NCTL_PROFILE ?= dev
NCTL_MCP_IMAGE ?= interchouette/casper-nctl-2-docker-mcp:$(NCTL_PROFILE)
CASPER_SDK_MCP_IMAGE ?= interchouette/casper-rust-wasm-sdk-mcp:dev

WASM_CRATE := ceps-client-wasm
CLI_CRATE := ceps-client-cli
MCP_CRATE := ceps-rust-ts-client-mcp
COMMON_CRATE := ceps-client

WEB_OUT_DIR := pkg
NODEJS_OUT_DIR := pkg-nodejs
WASM_DIR := $(ROOT)/tests/wasm

# Docker / GHCR image naming
IMAGE_NAME := ceps-rust-ts-client
MCP_IMAGE_NAME := ceps-rust-ts-client-mcp
IMAGE_TAG ?= local
HUB_USER ?= interchouette
GHCR_PERSONAL ?= groussac
GHCR_WORKER ?= interchouette
GHCR_ORG ?= interchouette-itc
DOCKER_CONTEXT_BIN ?= $(ROOT)/target/release/ceps-client-cli
DOCKERFILE := $(ROOT)/docker/Dockerfile
MCP_DOCKERFILE := $(ROOT)/mcp/Dockerfile
COMPOSE_MCP := $(ROOT)/docker/docker-compose.mcp.yml
CEPS_MCP_IMAGE ?= interchouette/ceps-rust-ts-client-mcp:dev

CARGO := cargo

.DEFAULT_GOAL := help

.PHONY: help prepare \
	build check doc doc-check clean \
	format lint clippy check-lint \
	coverage coverage-summary coverage-html audit deny machete outdated \
	test unit-test integration-test e2e-test examples ts-test wasm-bindgen-test \
	pack web nodejs web-schema nodejs-schema schema-check \
	run-cli \
	release-cli-bin release-mcp-bin \
	docker-build docker-tag docker-push-hub docker-push-ghcr-personal docker-push-ghcr-itc docker-push-ghcr docker-push \
	docker-build-mcp docker-tag-mcp docker-push-mcp-hub docker-push-mcp-ghcr-personal docker-push-mcp-ghcr-itc docker-push-mcp-ghcr docker-push-mcp \
	mcp-build run-mcp run-mcp-http mcp-http mcp-http-stop mcp-test mcp-test-live \
	nctl-start nctl-start-all nctl-stop nctl-stop-all nctl-status nctl-endpoints \
	sdk-mcp-http sdk-mcp-http-stop \
	wasm-from-ceps \
	ci-local

help:
	@echo "ceps-rust-ts-client Make targets"
	@echo ""
	@echo "Build / lint"
	@echo "  prepare            rustup wasm32 target"
	@echo "  build              cargo build --workspace"
	@echo "  check              cargo check --workspace"
	@echo "  doc / doc-check    rustdoc + closet file presence"
	@echo "  format / lint / clippy / check-lint"
	@echo "  clean              cargo clean"
	@echo ""
	@echo "Test"
	@echo "  test               unit + integration"
	@echo "  unit-test          ceps-client + ceps-client-wasm lib tests"
	@echo "  integration-test   tests/rust (NCTL for live cases)"
	@echo "  e2e-test           CLI-driven e2e"
	@echo "  examples           run examples/"
	@echo "  ts-test            Vitest against pkg-nodejs"
	@echo ""
	@echo "WASM pack"
	@echo "  pack / web / nodejs   wasm-pack release (needs wasm-opt on PATH)"
	@echo "  web-schema / nodejs-schema   schema-only wasm packs (no CEP clients)"
	@echo ""
	@echo "CLI / MCP"
	@echo "  run-cli            cargo run -p $(CLI_CRATE) -- \$$(CLI_ARGS)"
	@echo "  release-cli-bin    cargo build -p $(CLI_CRATE) --release (+ strip)"
	@echo "  mcp-build / run-mcp / run-mcp-http / mcp-test / mcp-test-live"
	@echo "  mcp-http / mcp-http-stop   compose HTTP :6790"
	@echo "  release-mcp-bin / docker-build-mcp / docker-push-mcp"
	@echo ""
	@echo "Docker / GHCR (IMAGE_TAG=dev|semver|latest)"
	@echo "  docker-build / docker-tag / docker-push-hub / docker-push-ghcr / docker-push"
	@echo ""
	@echo "NCTL / contracts"
	@echo "  nctl-start / nctl-status / nctl-endpoints"
	@echo "  sdk-mcp-http / sdk-mcp-http-stop"
	@echo "  wasm-from-ceps     stage tip WASMs into tests/wasm/"
	@echo ""
	@echo "CI"
	@echo "  ci-local           check-lint + unit-test + mcp-test (no NCTL)"

prepare:
	rustup target add wasm32-unknown-unknown

build:
	$(CARGO) build --workspace

check:
	$(CARGO) check --workspace

doc:
	$(CARGO) doc -p $(COMMON_CRATE) --no-deps
	@mkdir -p docs/api-rust
	@rm -rf docs/api-rust/ceps_client docs/api-rust/src
	@cp -a target/doc/ceps_client docs/api-rust/
	@cp -a target/doc/src docs/api-rust/ 2>/dev/null || true
	@printf '%s\n' \
		'<!DOCTYPE html><html><head><meta charset="utf-8">' \
		'<meta http-equiv="refresh" content="0; url=ceps_client/index.html">' \
		'<title>ceps-client rustdoc</title>' \
		'<script>location.replace("ceps_client/index.html");</script>' \
		'</head><body>' \
		'<a href="ceps_client/index.html">ceps_client</a></body></html>' \
		> docs/api-rust/index.html
	@touch docs/api-rust/.nojekyll
	@printf '%s\n' \
		'<!DOCTYPE html><html><head><meta charset="utf-8">' \
		'<meta http-equiv="refresh" content="0; url=api-rust/ceps_client/index.html">' \
		'<title>ceps-rust-ts-client docs</title>' \
		'<script>location.replace("api-rust/ceps_client/index.html");</script>' \
		'</head><body>' \
		'<a href="api-rust/ceps_client/index.html">ceps_client rustdoc</a></body></html>' \
		> docs/index.html
	@touch docs/.nojekyll
	@echo "doc: rustdoc → docs/api-rust/ (Pages root docs/index.html → api-rust)"

doc-check:
	@set -euo pipefail; \
	missing=0; \
	for f in \
		docs/README.md docs/getting-started.md docs/architecture.md docs/cli.md \
		docs/testing.md docs/contributing.md docs/wasm-ts.md docs/ci.md \
		docs/sdk.md docs/docker.md docs/SECURITY.md docs/releases.md \
		docs/api-wasm/README.md \
		docs/cep18/README.md docs/cep18/1-quickstart.md docs/cep18/8-api.md \
		docs/cep78/README.md docs/cep78/2-install-modes.md docs/cep78/5-session-wasms.md docs/cep78/9-api.md \
		docs/cep85/README.md docs/cep85/6-entity-keys.md docs/cep85/9-api.md \
		docs/cep95/README.md docs/cep95/1-quickstart.md docs/cep95/8-api.md; do \
		if [ ! -f "$$f" ]; then echo "doc-check: missing $$f"; missing=1; fi; \
	done; \
	exit $$missing

clean:
	$(CARGO) clean
	@echo "clean: left $(WASM_CRATE)/$(WEB_OUT_DIR) and $(NODEJS_OUT_DIR) in place (committed packs); rebuild with make pack"
format:
	$(CARGO) fmt

lint: format clippy

clippy: prepare
	$(CARGO) clippy -p $(COMMON_CRATE) --lib -- -D warnings
	$(CARGO) clippy -p $(CLI_CRATE) --bins -- -D warnings
	$(CARGO) clippy -p $(WASM_CRATE) --lib -- -D warnings
	$(CARGO) clippy -p $(MCP_CRATE) --lib --bins -- -D warnings

check-lint: clippy
	$(CARGO) fmt -- --check

COVERAGE_IGNORE := examples/|benches/|tests/

# Live NCTL cases already run under `integration-test` / `mcp-test-live`.
# Re-running them under llvm-cov (often in parallel) hits flaky RPC DispatchGone.
COVERAGE_TEST_ARGS := --skip live --test-threads=1

coverage:
	mkdir -p coverage
	RUSTUP_TOOLCHAIN=stable $(CARGO) llvm-cov --workspace --locked --lcov \
		--ignore-filename-regex '$(COVERAGE_IGNORE)' \
		--output-path coverage/lcov.info \
		-- $(COVERAGE_TEST_ARGS)

coverage-summary:
	RUSTUP_TOOLCHAIN=stable $(CARGO) llvm-cov --workspace --locked --summary-only \
		--ignore-filename-regex '$(COVERAGE_IGNORE)' \
		-- $(COVERAGE_TEST_ARGS)

coverage-html:
	mkdir -p coverage
	RUSTUP_TOOLCHAIN=stable $(CARGO) llvm-cov --workspace --locked --html \
		--ignore-filename-regex '$(COVERAGE_IGNORE)' \
		--output-dir coverage/html \
		-- $(COVERAGE_TEST_ARGS)

audit:
	$(CARGO) audit

deny:
	$(CARGO) deny check

machete:
	$(CARGO) machete

outdated:
	$(CARGO) outdated --workspace

unit-test:
	$(CARGO) test -p $(COMMON_CRATE) -- --test-threads=1 --nocapture
	$(CARGO) test -p $(COMMON_CRATE) --no-default-features --features schema -- --test-threads=1 --nocapture
	$(CARGO) test -p $(WASM_CRATE) --lib -- --test-threads=1 --nocapture

schema-check: prepare
	$(CARGO) check -p $(COMMON_CRATE) --no-default-features --features schema
	$(CARGO) check -p $(COMMON_CRATE)
	$(CARGO) check -p $(WASM_CRATE) --target wasm32-unknown-unknown --no-default-features --features schema
	$(CARGO) check -p $(WASM_CRATE) --target wasm32-unknown-unknown
	$(MAKE) nodejs-schema
	@grep -q 'cep18SchemaJson\|schemaJson' "$(WASM_CRATE)/pkg-nodejs-schema/ceps_client_wasm.d.ts"
	@! grep -q 'CEP18Client\|CEP78Client\|CEP85Client\|CEP95Client' "$(WASM_CRATE)/pkg-nodejs-schema/ceps_client_wasm.d.ts"

pack: web nodejs

web: prepare
	cd $(WASM_CRATE) && wasm-pack build --target web --release --out-dir $(WEB_OUT_DIR) $(CURRENT_DIR)
	@cp -f "$(ROOT)/README.md" "$(WASM_CRATE)/$(WEB_OUT_DIR)/README.md"

nodejs: prepare
	cd $(WASM_CRATE) && wasm-pack build --target nodejs --release --out-dir $(NODEJS_OUT_DIR) $(CURRENT_DIR)
	@cp -f "$(ROOT)/README.md" "$(WASM_CRATE)/$(NODEJS_OUT_DIR)/README.md"

web-schema: prepare
	cd $(WASM_CRATE) && wasm-pack build --target web --release --out-dir pkg-schema \
		-- --no-default-features --features schema
	@cp -f "$(ROOT)/README.md" "$(WASM_CRATE)/pkg-schema/README.md"

nodejs-schema: prepare
	cd $(WASM_CRATE) && wasm-pack build --target nodejs --release --out-dir pkg-nodejs-schema \
		-- --no-default-features --features schema
	@cp -f "$(ROOT)/README.md" "$(WASM_CRATE)/pkg-nodejs-schema/README.md"

integration-test:
	cd tests/rust && $(CARGO) test -- --test-threads=1 --nocapture

e2e-test:
	@echo "e2e-test: run CLI status smoke"
	$(CARGO) run -p $(CLI_CRATE) -- status
	$(CARGO) run -p $(CLI_CRATE) -- cep18 info
	$(CARGO) run -p $(CLI_CRATE) -- cep78 info
	$(CARGO) run -p $(CLI_CRATE) -- cep85 info
	$(CARGO) run -p $(CLI_CRATE) -- cep95 info
	@echo "e2e-test: put-transaction rejects invalid JSON"
	@tmp=$$(mktemp); \
	  printf '%s\n' '{"not":"a_transaction"}' > "$$tmp"; \
	  if $(CARGO) run -p $(CLI_CRATE) -- put-transaction --transaction-file "$$tmp" --no-wait; then \
	    rm -f "$$tmp"; echo "expected put-transaction to fail"; exit 1; \
	  fi; \
	  rm -f "$$tmp"

examples:
	$(CARGO) run -p $(COMMON_CRATE) --example cep18_install
	$(CARGO) run -p $(COMMON_CRATE) --example cep78_install
	$(CARGO) run -p $(COMMON_CRATE) --example cep85_install
	$(CARGO) run -p $(COMMON_CRATE) --example cep95_install

ts-test:
	@test -d $(WASM_CRATE)/$(NODEJS_OUT_DIR) || $(MAKE) nodejs
	cd tests/ts && npm install && npm test

wasm-bindgen-test: prepare
	cd $(WASM_CRATE) && wasm-pack test --node

test: unit-test integration-test

run-cli:
	$(CARGO) run -p $(CLI_CRATE) -- $(CLI_ARGS)

release-cli-bin:
	$(CARGO) build -p $(CLI_CRATE) --release
	@strip -s "$(ROOT)/target/release/ceps-client-cli" 2>/dev/null || strip "$(ROOT)/target/release/ceps-client-cli"
	@echo "release-cli-bin: $(ROOT)/target/release/ceps-client-cli"

release-mcp-bin:
	$(CARGO) build -p $(MCP_CRATE) --release
	@strip -s "$(ROOT)/target/release/ceps-rust-ts-client-mcp" 2>/dev/null || strip "$(ROOT)/target/release/ceps-rust-ts-client-mcp"
	@echo "release-mcp-bin: $(ROOT)/target/release/ceps-rust-ts-client-mcp"

mcp-build:
	$(CARGO) build -p $(MCP_CRATE) --release

run-mcp:
	$(CARGO) run -p $(MCP_CRATE) --release

run-mcp-http:
	$(CARGO) run -p $(MCP_CRATE) --release -- --http --listen 127.0.0.1:6790

mcp-test:
	$(CARGO) test -p $(MCP_CRATE) --lib

mcp-test-live:
	$(CARGO) test -p $(MCP_CRATE) --lib -- --ignored --test-threads=1 --nocapture

mcp-http:
	CEPS_MCP_IMAGE="$(CEPS_MCP_IMAGE)" docker compose -f "$(COMPOSE_MCP)" up -d

mcp-http-stop:
	-docker compose -f "$(COMPOSE_MCP)" down

docker-build-mcp: release-mcp-bin
	@test -d "$(WASM_DIR)/cep18" || { echo "docker-build-mcp: missing $(WASM_DIR); run make wasm-from-ceps"; exit 1; }
	cp -f "$(ROOT)/target/release/ceps-rust-ts-client-mcp" "$(ROOT)/mcp/ceps-rust-ts-client-mcp"
	rm -rf "$(ROOT)/mcp/wasm"
	cp -a "$(WASM_DIR)" "$(ROOT)/mcp/wasm"
	docker build -f "$(MCP_DOCKERFILE)" \
		-t "$(MCP_IMAGE_NAME):$(IMAGE_TAG)" \
		"$(ROOT)/mcp"
	rm -f "$(ROOT)/mcp/ceps-rust-ts-client-mcp"
	rm -rf "$(ROOT)/mcp/wasm"
	@echo "docker-build-mcp: $(MCP_IMAGE_NAME):$(IMAGE_TAG)"

docker-tag-mcp:
	docker tag "$(MCP_IMAGE_NAME):$(IMAGE_TAG)" "$(HUB_USER)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(MCP_IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_PERSONAL)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(MCP_IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_WORKER)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(MCP_IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_ORG)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"

docker-push-mcp-hub:
	docker push "$(HUB_USER)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"

docker-push-mcp-ghcr-personal:
	docker push "ghcr.io/$(GHCR_PERSONAL)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"

docker-push-mcp-ghcr-itc:
	docker push "ghcr.io/$(GHCR_WORKER)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"
	docker push "ghcr.io/$(GHCR_ORG)/$(MCP_IMAGE_NAME):$(IMAGE_TAG)"

docker-push-mcp-ghcr: docker-push-mcp-ghcr-personal docker-push-mcp-ghcr-itc

docker-push-mcp: docker-tag-mcp docker-push-mcp-hub docker-push-mcp-ghcr

docker-build:
	@test -f "$(DOCKER_CONTEXT_BIN)" || { \
		echo "docker-build: missing $(DOCKER_CONTEXT_BIN); run make release-cli-bin first"; \
		exit 1; \
	}
	cp -f "$(DOCKER_CONTEXT_BIN)" "$(ROOT)/docker/ceps-client-cli"
	docker build -f "$(DOCKERFILE)" \
		-t "$(IMAGE_NAME):$(IMAGE_TAG)" \
		"$(ROOT)/docker"
	rm -f "$(ROOT)/docker/ceps-client-cli"
	@echo "docker-build: $(IMAGE_NAME):$(IMAGE_TAG)"

docker-tag:
	docker tag "$(IMAGE_NAME):$(IMAGE_TAG)" "$(HUB_USER)/$(IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_PERSONAL)/$(IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_WORKER)/$(IMAGE_NAME):$(IMAGE_TAG)"
	docker tag "$(IMAGE_NAME):$(IMAGE_TAG)" "ghcr.io/$(GHCR_ORG)/$(IMAGE_NAME):$(IMAGE_TAG)"

docker-push-hub:
	docker push "$(HUB_USER)/$(IMAGE_NAME):$(IMAGE_TAG)"

docker-push-ghcr-personal:
	docker push "ghcr.io/$(GHCR_PERSONAL)/$(IMAGE_NAME):$(IMAGE_TAG)"

docker-push-ghcr-itc:
	docker push "ghcr.io/$(GHCR_WORKER)/$(IMAGE_NAME):$(IMAGE_TAG)"
	docker push "ghcr.io/$(GHCR_ORG)/$(IMAGE_NAME):$(IMAGE_TAG)"

docker-push-ghcr: docker-push-ghcr-personal docker-push-ghcr-itc

docker-push: docker-tag docker-push-hub docker-push-ghcr

define require_nctl
	@test -d "$(NCTL_DOCKER_PRODUCT)" || { \
		echo "NCTL product not found at $(NCTL_DOCKER_PRODUCT)"; \
		echo "Set NCTL_DOCKER_PRODUCT or clone casper-nctl-2-docker as a sibling."; \
		exit 1; \
	}
endef

nctl-start:
	$(require_nctl)
	$(MAKE) -C "$(NCTL_DOCKER_PRODUCT)" start $(NCTL_PROFILE)

nctl-start-all:
	$(require_nctl)
	$(MAKE) -C "$(NCTL_DOCKER_PRODUCT)" start-all $(NCTL_PROFILE)

nctl-stop:
	$(require_nctl)
	$(MAKE) -C "$(NCTL_DOCKER_PRODUCT)" stop $(NCTL_PROFILE)

nctl-stop-all:
	$(require_nctl)
	$(MAKE) -C "$(NCTL_DOCKER_PRODUCT)" stop-all $(NCTL_PROFILE)

nctl-status:
	$(require_nctl)
	$(MAKE) -C "$(NCTL_DOCKER_PRODUCT)" status $(NCTL_PROFILE)

nctl-endpoints:
	$(require_nctl)
	@echo "RPC  http://127.0.0.1:11101"
	@echo "SSE  http://127.0.0.1:18101/events"
	@echo "BIN  127.0.0.1:28101"
	@echo "NCTL MCP HTTP  http://127.0.0.1:8790/mcp"
	@echo "SDK  MCP HTTP  http://127.0.0.1:5790/mcp"
	@echo "NCTL_DOCKER_PRODUCT=$(NCTL_DOCKER_PRODUCT) profile=$(NCTL_PROFILE)"

sdk-mcp-http:
	CASPER_SDK_MCP_IMAGE="$(CASPER_SDK_MCP_IMAGE)" \
		bash "$(ROOT)/.cursor/scripts/sdk-ensure.sh"

sdk-mcp-http-stop:
	-docker stop casper-rust-wasm-sdk-mcp-cursor 2>/dev/null
	-docker rm casper-rust-wasm-sdk-mcp-cursor 2>/dev/null

wasm-from-ceps:
	@mkdir -p "$(WASM_DIR)"
	@set -euo pipefail; \
	for pair in \
		"$(CEP18_PRODUCT)|cep18" \
		"$(CEP78_PRODUCT)|cep78" \
		"$(CEP85_PRODUCT)|cep85" \
		"$(CEP95_PRODUCT)|cep95"; do \
		root="$${pair%%|*}"; name="$${pair##*|}"; \
		if [ ! -d "$$root" ]; then \
			echo "wasm-from-ceps: skip $$name (missing $$root)"; \
			continue; \
		fi; \
		tip="$$root/tests/wasm"; \
		if [ -d "$$tip" ] && find "$$tip" -type f -name '*.wasm' -print -quit | grep -q .; then \
			found=$$(find "$$tip" -type f -name '*.wasm' | sort); \
		else \
			found=$$( { \
				find "$$root" -type f -name '*.wasm' \
					! -path '*/target/debug/*' ! -path '*/node_modules/*' \
					! -path '*/.git/*' 2>/dev/null; \
			} | awk 'NF' | while read -r f; do \
				printf '%s\t%s\n' "$$(stat -c '%Y' "$$f" 2>/dev/null || echo 0)" "$$f"; \
			done | sort -nr | cut -f2- | awk -F/ '{ base=$$NF; if (!seen[base]++) print }'); \
		fi; \
		if [ -z "$$found" ]; then \
			echo "wasm-from-ceps: no wasm under $$root (build contracts there first)"; \
			continue; \
		fi; \
		rm -rf "$(WASM_DIR)/$$name"; \
		mkdir -p "$(WASM_DIR)/$$name"; \
		echo "$$found" | while read -r f; do \
			cp -f "$$f" "$(WASM_DIR)/$$name/"; \
			echo "  staged $$name/$$(basename "$$f")"; \
		done; \
	done; \
	echo "wasm-from-ceps: done -> $(WASM_DIR)"

ci-local: check-lint unit-test mcp-test doc-check schema-check