.env.example

# Example environment configuration.
# Copy this file to .env and adjust as needed.
# Environment variables override values in hierophant.toml and contemplant.toml.

# Hierophant Configuration
# ========================

# OPTIONAL: Port for gRPC service (default: 9000).
# GRPC_PORT=9000

# OPTIONAL: Port for HTTP and WebSocket service (default: 9010).
# HTTP_PORT=9010

# OPTIONAL: Timeout in seconds for worker responses (default: 30).
# How long to wait for a response from a worker before evicting them.
# WORKER_RESPONSE_TIMEOUT_SECS=30

# OPTIONAL: Publicly reachable address of this Hierophant for artifact uploads.
# This is used by clients to upload program inputs and download proofs.
# THIS_HIEROPHANT_IP=

# OPTIONAL: Public key for signing messages (default: zero address).
# Key pair used for signing messages to the client and retrieving nonces.
# PUB_KEY=0x0000000000000000000000000000000000000000

# OPTIONAL: Create mock proofs instead of real proofs (default: false).
# Witness generation still happens, but proof generation is skipped.
# MOCK_MODE=false

# OPTIONAL: Directory for storing artifacts on disk (default: "artifacts").
# ARTIFACT_STORE_DIRECTORY=artifacts

# OPTIONAL: Maximum number of stdin artifacts stored (default: 50).
# Artifacts can be large, so we limit how many are stored on disk.
# MAX_STDIN_ARTIFACTS_STORED=50

# OPTIONAL: Maximum number of proof artifacts stored (default: 10).
# MAX_PROOF_ARTIFACTS_STORED=10

# Worker Registry Settings
# -------------------------
# These settings control when workers are evicted.

# OPTIONAL: Number of strikes before eviction (default: 3).
# Workers get strikes when they fail to respond to requests.
# MAX_WORKER_STRIKES=3

# OPTIONAL: Maximum seconds between heartbeats before eviction (default: 180).
# Workers must send heartbeats regularly to stay registered.
# MAX_WORKER_HEARTBEAT_INTERVAL_SECS=180

# OPTIONAL: Maximum minutes a worker can spend on a proof (default: 300).
# Workers taking longer than this are considered dead and evicted.
# PROOF_TIMEOUT_MINS=300

# OPTIONAL: Minutes between required progress updates (default: 0).
# Workers must show at least 1% progress every N minutes or be evicted.
# Set to 0 to disable progress checking.
# WORKER_REQUIRED_PROGRESS_INTERVAL_MINS=0

# OPTIONAL: Maximum minutes for execution report phase (default: 45).
# Time allowed for execution report before proof generation starts.
# WORKER_MAX_EXECUTION_REPORT_MINS=45

# Contemplant Configuration
# ==========================

# OPTIONAL: WebSocket address of the Hierophant to connect to.
# Format: ws://[host]:[port]/ws where port is the Hierophant HTTP port.
# HIEROPHANT_WS_ADDRESS=ws://127.0.0.1:9010/ws

# OPTIONAL: Human-readable name for this Contemplant (default: from names.txt).
# CONTEMPLANT_NAME=

# OPTIONAL: Declare which VM(s) this contemplant serves and (optionally) the
# backend for each. Consumed only when no `[[provers]]` entries are present in
# contemplant.toml. Comma-separated list; valid values: "sp1", "risc0".
# CONTEMPLANT_VMS=sp1

# OPTIONAL: Per-VM backend ("cpu" | "cuda"). Defaults to cpu when unset.
# CONTEMPLANT_SP1_BACKEND=cpu
# CONTEMPLANT_RISC0_BACKEND=cpu

# OPTIONAL: Enable RISC Zero Groth16 (onchain-verifiable) proof mode on this
# contemplant. Requires the 2.5 GB of vendored Groth16 assets baked into the
# contemplant image by Dockerfile.contemplant. Leave false for STARK-only
# deployments; set true if this worker should accept /snark/create requests.
# CONTEMPLANT_RISC0_GROTH16=false

# NOTE: sp1-sdk 6.x removed the external moongate-server arrangement (the
# old MOONGATE_ENDPOINT setting). With CONTEMPLANT_SP1_BACKEND=cuda the
# contemplant now spawns ~/.sp1/bin/sp1-gpu-server itself and talks to it
# over a unix socket; the contemplant image vendors that binary.

# OPTIONAL: Heartbeat interval in seconds (default: 30).
# How often to tell Hierophant that this Contemplant is still alive.
# HEARTBEAT_INTERVAL_SECONDS=30

# OPTIONAL: Maximum number of finished proofs stored in memory (default: 2).
# MAX_PROOFS_STORED=2

# OPTIONAL: Magister drop endpoint (default: none).
# Endpoint to notify when this Contemplant should be dropped from its Magister.
# Only set if this Contemplant is managed by a Magister.
# MAGISTER_DROP_ENDPOINT=

# Assessor Settings
# -----------------
# These settings control proof progress monitoring. NOTE: cycle-accurate SP1
# progress tracking watched the old moongate log and has no sp1-gpu-server
# equivalent yet; contemplants currently report static progress for all VMs.

# OPTIONAL: Log polling interval in milliseconds (default: 2000).
# WATCHER_POLLING_INTERVAL_MS=2000

# Build Settings (consumed by the Makefile's docker-h / docker-c goals)
# ---------------------------------------------------------------------

# OPTIONAL: Toggle warm incremental build caches for in-petros source
# builds (default: 1). With 1, BuildKit cache mounts persist cargo's
# registry/git downloads and the incremental target dir across builds, so
# small source changes rebuild in minutes; the pinned petros toolchain and
# locked dependencies mean the cached artifacts derive from exactly the
# same hermetic inputs. Set 0 to exercise the pristine no-local-state
# release flow: the docker layer cache is bypassed and the cargo caches
# start empty, compiling everything from scratch.
# DOCKER_BUILD_CACHE=1

# OPTIONAL: GPU architecture list for the CUDA kernel compiles (openvm's
# CUDA_ARCH plus the derived sppark/risc0 NVCC gencode flags). Unset uses
# the canonical release list from .env.maintainer (CUDA_RELEASE_ARCH:
# 80,86,89,90,120, Ampere through Blackwell). Turing (sm_75) is excluded
# because only risc0 fully supports it; build with CUDA_ARCH=75 for a
# Turing-class risc0 worker or dev GPU. Setting a single arch gives
# roughly 5x faster kernel compiles during iteration. Release builds
# must leave this unset so shipped images cover the whole fleet.
# CUDA_ARCH=75