build: migrate from Make to just as command runner

Replace Makefile + 6 .mk include files with a single justfile.
Update all CI workflows (setup-just action) and docs references.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: tac0turtle

.github/workflows/benchmark.yml

@@ -23,8 +23,10 @@ jobs:
           go-version-file: ./go.mod
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Build binaries
-        run: make build-evm build-da
+        run: just build-evm build-da
       - name: Run EVM benchmarks
         run: |
           cd test/e2e && go test -tags evm -bench=. -benchmem -run='^$' \
@@ -53,8 +55,10 @@ jobs:
           go-version-file: ./go.mod
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Build binaries
-        run: make build-evm build-da
+        run: just build-evm build-da
       - name: Run Spamoor smoke test
         run: |
           cd test/e2e && BENCH_JSON_OUTPUT=spamoor_bench.json go test -tags evm \

.github/workflows/dependabot-auto-fix.yml

@@ -22,19 +22,19 @@ jobs:
         with:
           go-version-file: ./go.mod
 
-      - name: Install make (if missing)
-        run: sudo apt-get update && sudo apt-get install -y make
+      - name: Install just
+        uses: extractions/setup-just@v4
 
       - name: Run dependency update
-        run: make deps
+        run: just deps
 
       - name: Commit and push changes
         run: |
           if [ -n "$(git status --porcelain)" ]; then
             git config user.name "github-actions[bot]"
             git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
             git add -A
-            git commit -m "chore: run make deps after Dependabot update"
+            git commit -m "chore: run just deps after Dependabot update"
             git push
           else
             echo "No changes to commit."

.github/workflows/docker-tests.yml

@@ -27,8 +27,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./test/docker-e2e/go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Run Docker E2E Tests
-        run: make test-docker-e2e
+        run: just test-docker-e2e
         env:
           EV_NODE_IMAGE_REPO: ghcr.io/${{ github.repository_owner }}/ev-node-testapp
           EV_NODE_IMAGE_TAG: ${{ inputs.image-tag }}
@@ -44,8 +46,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./test/docker-e2e/go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Run Docker Upgrade E2E Tests
-        run: make test-docker-upgrade-e2e
+        run: just test-docker-upgrade-e2e
         env:
           EVM_IMAGE_REPO: ghcr.io/${{ github.repository_owner }}/ev-node-evm
           EVM_NODE_IMAGE_TAG: ${{ inputs.image-tag }}
@@ -61,8 +65,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./test/docker-e2e/go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Run Docker Compat E2E Tests
-        run: make test-docker-compat
+        run: just test-docker-compat
         env:
           SEQUENCER_EVM_IMAGE_REPO: ghcr.io/${{ github.repository_owner }}/ev-node-evm
           SEQUENCER_EVM_IMAGE_TAG: main # TODO: set this to the last released tag

.github/workflows/test.yml

@@ -17,8 +17,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Build all ev-node binaries
-        run: make build-all
+        run: just build-all
 
   go_mod_tidy_check:
     name: Go Mod Tidy Check
@@ -28,7 +30,8 @@ jobs:
       - uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./go.mod
-      - run: make deps
+      - uses: extractions/setup-just@v4
+      - run: just deps
       - name: check for diff
         run: git diff --exit-code
 
@@ -44,8 +47,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Run unit test
-        run: make test-cover
+        run: just test-cover
       - name: Upload unit test coverage report
         uses: actions/upload-artifact@v6
         with:
@@ -61,8 +66,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: Run integration test
-        run: make test-integration-cover
+        run: just test-integration-cover
       - name: Upload integration test coverage report
         uses: actions/upload-artifact@v6
         with:
@@ -93,8 +100,10 @@ jobs:
           tags: evstack:local-dev
           cache-from: type=gha
           cache-to: type=gha,mode=max
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: E2E Tests
-        run: make test-e2e
+        run: just test-e2e
 
   evm-tests:
     name: Run EVM Execution Tests
@@ -106,8 +115,10 @@ jobs:
         uses: actions/setup-go@v6.2.0
         with:
           go-version-file: ./go.mod
+      - name: Install just
+        uses: extractions/setup-just@v4
       - name: EVM Tests
-        run: make test-evm
+        run: just test-evm
 
   combine_and_upload_coverage:
     name: Combine and Upload Coverage

CLAUDE.md

@@ -8,33 +8,35 @@ ev-node is a sovereign rollup framework built in Go that allows developers to bu
 
 ## Build and Development Commands
 
+Uses [just](https://github.com/casey/just) as the command runner. Run `just help` to list all recipes.
+
 ### Building
 
-- `make build` - Builds the Testapp CLI to `./build/testapp`
-- `make install` - Installs Testapp CLI to your Go bin directory
-- `make build-all` - Builds all ev-node binaries
-- `make docker-build` - Builds Docker image tagged as `evstack:local-dev`
+- `just build` - Builds the Testapp CLI to `./build/testapp`
+- `just install` - Installs Testapp CLI to your Go bin directory
+- `just build-all` - Builds all ev-node binaries
+- `just docker-build` - Builds Docker image tagged as `evstack:local-dev`
 
 ### Testing
 
-- `make test` - Runs unit tests for all go.mod files
-- `make test-integration` - Runs integration tests (15m timeout)
-- `make test-e2e` - Runs end-to-end tests (requires building binaries first)
-- `make test-cover` - Generates code coverage report
-- `make test-all` - Runs all tests including Docker E2E tests
+- `just test` - Runs unit tests for all go.mod files
+- `just test-integration` - Runs integration tests (15m timeout)
+- `just test-e2e` - Runs end-to-end tests (requires building binaries first)
+- `just test-cover` - Generates code coverage report
+- `just test-all` - Runs all tests including Docker E2E tests
 
 ### Linting and Code Quality
 
-- `make lint` - Runs all linters (golangci-lint, markdownlint, hadolint, yamllint, goreleaser check, actionlint)
-- `make lint-fix` - Auto-fixes linting issues where possible
-- `make vet` - Runs go vet
+- `just lint` - Runs all linters (golangci-lint, markdownlint, hadolint, yamllint, goreleaser check, actionlint)
+- `just lint-fix` - Auto-fixes linting issues where possible
+- `just vet` - Runs go vet
 
 ### Development Utilities
 
-- `make deps` - Downloads dependencies and runs go mod tidy for all modules
-- `make proto-gen` - Generates protobuf files (requires Docker)
-- `make mock-gen` - Generates mocks using mockery
-- `make run-n NODES=3` - Run multiple nodes locally (default: 1)
+- `just deps` - Downloads dependencies and runs go mod tidy for all modules
+- `just proto-gen` - Generates protobuf files (requires Docker)
+- `just mock-gen` - Generates mocks using mockery
+- `just run-n 3` - Run multiple nodes locally (default: 1)
 
 ## Code Architecture
 
@@ -91,7 +93,7 @@ go test -race ./package/...
 ### Mock Generation
 
 - Mocks are defined in `.mockery.yaml`
-- Generate with `make mock-gen`
+- Generate with `just mock-gen`
 - Mocks are placed in `mocks/` directories
 
 ## Code Style Guidelines
@@ -128,7 +130,7 @@ go test -race ./package/...
 ### Modifying Protobuf Definitions
 
 1. Edit `.proto` files in `types/pb/`
-2. Run `make proto-gen` to regenerate Go code
+2. Run `just proto-gen` to regenerate Go code
 3. Update any affected code
 4. Run tests to ensure compatibility
 
@@ -157,15 +159,15 @@ go test -race ./package/...
 
 ## Debugging Tips
 
-- Use `make run-n NODES=2` to test multi-node scenarios locally
+- Use `just run-n 2` to test multi-node scenarios locally
 - Check logs for error messages and stack traces
 - Use Go's built-in profiling tools for performance issues
 - The testapp provides a simple way to test changes
 
 ## Contributing Guidelines
 
-- All code must pass linting (`make lint`)
-- All tests must pass (`make test-all`)
+- All code must pass linting (`just lint`)
+- All tests must pass (`just test-all`)
 - Follow the existing code patterns
 - Update tests when changing functionality
 - Keep commits focused and atomic

Makefile

@@ -33,7 +33,7 @@ To install the example `testapp`, simply run the following command at the root o
 ev-node repo:
 
 ```bash
-make install
+just install
 ```
 
 The latest TestApp example is now installed. You can verify the installation by running:
@@ -100,16 +100,16 @@ to ask questions, discuss your ideas, and connect with other contributors.
 
 ```sh
 # Run unit tests
-make test
+just test
 
 # Generate protobuf files (requires Docker)
-make proto-gen
+just proto-gen
 
 # Run linters (requires golangci-lint, markdownlint, hadolint, and yamllint)
-make lint
+just lint
 
 # Lint protobuf files (requires Docker and buf)
-make proto-lint
+just proto-lint
 
 ```
 

README.md

@@ -63,8 +63,8 @@ The generated code is committed to the repository. If you modify the proto files
 # Force regeneration by setting the environment variable
 EV_TYPES_FORCE_PROTO_GEN=1 cargo build
 
-# Or from the repository root (if a make target exists)
-make rust-proto-gen
+# Or from the repository root
+just rust-proto-gen
 ```
 
 **Important**:
@@ -88,7 +88,7 @@ To ensure consistency with CI:
 
 1. Install protoc version 25.1
 2. Use the provided script: `./client/scripts/generate-protos.sh`
-3. Or use the Makefile: `make rust-proto-gen`
+3. Or use just: `just rust-proto-gen`
 
 ### Common Issues
 

client/crates/types/README.md

@@ -10,7 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - `yarn dev` - Start VitePress development server (hot reload enabled)
 - `yarn build` - Build static documentation site
 - `yarn preview` - Preview built site locally
-- `make testlink` - Validate all links in markdown files using lychee
+- `just testlink` - Validate all links in markdown files using lychee
 
 ### Deployment
 
@@ -44,14 +44,14 @@ docs/
 - **Navigation Structure**: Configured in `.vitepress/config.ts` with collapsible sidebar sections
 - **Analytics**: Plausible analytics and Chatbase integration
 - **Content Format**: Markdown files with frontmatter support
-- **Link Validation**: Automated via `make testlink` and GitHub Actions
+- **Link Validation**: Automated via `just testlink` and GitHub Actions
 
 ### Development Workflow
 
 1. Content changes: Edit markdown files in appropriate directories
 2. Navigation changes: Update `.vitepress/config.ts`
 3. Test locally with `yarn dev`
-4. Validate links with `make testlink`
+4. Validate links with `just testlink`
 5. Create PR - preview deployment will be available
 6. Merge to main triggers automatic deployment
 

docs/CLAUDE.md

@@ -30,7 +30,7 @@ STAKING_AMOUNT="1000000000stake"
 Ensure that `.gm` folder is present at `/Users/you/.gm` (if not, follow a [Guide](./gm-world.md) to set it up) and run the following command to (re)generate an entrypoint binary out of the code:
 
 ```sh
-make install
+just install
 ```
 
 Once completed, run the following command to ensure that the `/Users/you/.gm` directory is present: