.env.example

# Example runtime environment configuration for Scriptory.
# Copy this file to .env and adjust as needed.
#
# Scriptory runs a complete Hierophant + Magister + Contemplant prover network
# along with a fibonacci example to demonstrate proof generation.

# ============================================================================
# REQUIRED CONFIGURATION
# ============================================================================

# Your public IP address or hostname for Hierophant artifact uploads/downloads.
# Used by clients and Contemplants to upload program inputs and download proofs.
# Examples: "192.168.1.100", "my-server.example.com", "203.0.113.42"
# For local testing with remote Contemplants, use your WAN IP.
THIS_HIEROPHANT_IP=your-public-ip-here

# Hierophant IP address for Contemplants to connect via WebSocket.
# Magister passes this to Contemplants when creating instances on Vast.ai.
# Should match THIS_HIEROPHANT_IP for most deployments.
HIEROPHANT_IP=your-public-ip-here

# Magister address for Hierophant to send drop requests.
# Format: http://[host] (port is specified separately in magister.toml)
# For local testing with remote Contemplants, use your WAN IP.
THIS_MAGISTER_ADDR=http://your-public-ip-here

# Vast.ai API key for managing Contemplant instances.
# Obtain from https://vast.ai/ under Account > API Keys
VAST_API_KEY=your-vast-api-key-here

# Vast.ai template hash for creating Contemplant instances.
# This should be a template containing the Contemplant image.
# The default is the maintained Contemplant template.
VAST_TEMPLATE_HASH=819fdf2e42fc8ceb32f295465b5bb21e

# Number of Contemplant instances to maintain.
# Magister will continuously ensure this many instances are running on Vast.ai.
NUMBER_INSTANCES=1

# Prover type: "cpu" or "cuda" (default: "cpu").
# CPU proving is slower but doesn't require GPU-specific setup.
CONTEMPLANT_PROVER_TYPE=cuda

# Moongate CUDA prover endpoint (default: none).
# Only used when prover_type is "cuda". If not set, Contemplant will spin up
# a moongate-server Docker container automatically.
CONTEMPLANT_MOONGATE_ENDPOINT=http://localhost:3000/twirp/

# SSH public keys for debugging access (default: none).
# Allows SSH access to Contemplant instances on port 2222 for debugging.
# Format: newline-separated SSH public keys.
# Note: In environment variables, use literal \n for newlines.
# CONTEMPLANT_SSH_AUTHORIZED_KEYS="ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAbc123... user@host\nssh-rsa AAAAB3NzaC1yc2EAAAADAQAB... another@host"