justfile

REPO_ROOT := `realpath ..`  # path to the root of the optimism monorepo
KURTOSIS_DIR := REPO_ROOT + "/kurtosis-devnet"
ACCEPTOR_VERSION := env_var_or_default("ACCEPTOR_VERSION", "v3.10.2")
DOCKER_REGISTRY := env_var_or_default("DOCKER_REGISTRY", "us-docker.pkg.dev/oplabs-tools-artifacts/images")
ACCEPTOR_IMAGE := env_var_or_default("ACCEPTOR_IMAGE", DOCKER_REGISTRY + "/op-acceptor:" + ACCEPTOR_VERSION)

# Default recipe - runs acceptance tests
default:
    @just acceptance-test base

jovian:
    @just acceptance-test jovian

interop:
    @just acceptance-test interop

cgt:
    @just acceptance-test cgt

acceptance-test-all:
    @just _acceptance-test base all

# Run acceptance tests with mise-managed binary
# Usage: just acceptance-test [gate]
# Examples:
#   just acceptance-test base            # In-process with specific gate
#   just acceptance-test-all             # In-process all-tests mode
acceptance-test gate="base":
    @just _acceptance-test "{{gate}}" gate

_acceptance-test gate mode:
    #!/usr/bin/env bash
    set -euo pipefail

    MODE="{{mode}}"

    if [[ "$MODE" != "gate" && "$MODE" != "all" ]]; then
        echo "error: invalid mode '$MODE' (expected gate|all)." >&2
        exit 1
    fi

    if [[ "$MODE" == "gate" && "{{gate}}" == "" ]]; then
        echo "error: gate must be non-empty for gate mode; use 'just acceptance-test-all' for all tests." >&2
        exit 1
    fi

    if [[ "$MODE" == "all" ]]; then
        echo -e "DEVNET: in-memory, MODE: all tests\n"
    else
        echo -e "DEVNET: in-memory, GATE: {{gate}}\n"
    fi

    # Build dependencies for in-process mode if not in CI.
    # In CI jobs already take care of this, so we skip it.
    if [[ -z "${CIRCLECI:-}" ]]; then
        echo "Building contracts (local build)..."
        cd {{REPO_ROOT}}
        echo " - Updating submodules..."
        git submodule update --init --recursive --single-branch -j 8
        echo " - Installing mise..."
        mise install
        cd packages/contracts-bedrock
        echo " - Installing contracts..."
        just install
        echo " - Forge build..."
        just build-no-tests
        cd {{REPO_ROOT}}

        echo "Checking cannon dependencies..."
        if [ ! -e {{REPO_ROOT}}/cannon/bin/cannon ] || [ ! -e {{REPO_ROOT}}/op-program/bin/prestate-mt64.bin.gz ]; then
            echo "Building cannon dependencies..."
            cd {{REPO_ROOT}}
            make cannon-prestates
        fi

        echo "Building Rust binaries (kona-node, op-rbuilder, rollup-boost)..."
        cd {{REPO_ROOT}}
        just build-rust-release
    fi

    cd {{REPO_ROOT}}/op-acceptance-tests

    if ! command -v mise >/dev/null; then
        echo "error: mise is required for acceptance-test runs." >&2
        exit 1
    fi

    if ! mise install op-acceptor; then
        echo "error: failed to install op-acceptor with mise." >&2
        exit 1
    fi

    BINARY_PATH=$(mise which op-acceptor)
    echo "Using mise-managed binary: $BINARY_PATH"
    LOG_LEVEL="$(echo "${LOG_LEVEL:-info}" | grep -E '^(debug|info|warn|error)$' || echo 'info')"
    echo "LOG_LEVEL: $LOG_LEVEL"

    if [[ "$MODE" == "all" ]]; then
        CMD_ARGS=(
            "$BINARY_PATH"
            "--orchestrator" "sysgo"
            "--testdir" "{{REPO_ROOT}}/op-acceptance-tests/..."
            "--validators" "./acceptance-tests.yaml"
            "--log.level" "${LOG_LEVEL}"
            "--exclude-gates" "flake-shake"
            "--allow-skips"
            "--timeout" "120m"
            "--show-progress"
        )
    else
        CMD_ARGS=(
            "$BINARY_PATH"
            "--orchestrator" "sysgo"
            "--gate" "{{gate}}"
            "--testdir" "{{REPO_ROOT}}"
            "--validators" "./acceptance-tests.yaml"
            "--log.level" "${LOG_LEVEL}"
            "--allow-skips"
            "--show-progress"
        )

        if [[ "{{gate}}" != "flake-shake" ]]; then
            CMD_ARGS+=("--exclude-gates" "flake-shake")
        fi
    fi

    "${CMD_ARGS[@]}"

clean:
    rm -rf tests/interop/loadtest/artifacts


# Build, vet, lint and test Go code in ./cmd
cmd-check:
    #!/usr/bin/env bash
    set -euo pipefail

    cd {{REPO_ROOT}}/op-acceptance-tests

    echo "Downloading Go modules..."
    go mod download

    echo "Building ./cmd/..."
    go build ./cmd/...

    echo "Running go vet on ./cmd/..."
    go vet ./cmd/...

    echo "Running unit tests for ./cmd/..."
    go test -v ./cmd/...