erst.example.toml

# ERST Configuration File
# Copy this to ~/.erst.toml or .erst.toml in your project directory
# Environment variables override these settings
# CLI flags override everything

# RPC URL for the Stellar network (single URL)
rpc_url = "https://soroban-testnet.stellar.org"

# Multi-RPC URLs for automatic fallback (array syntax)
# rpc_urls = ["https://rpc1.stellar.org", "https://rpc2.stellar.org"]

# Network: public, testnet, futurenet, or standalone
network = "testnet"

# Path to the ERST simulator (optional)
# simulator_path = "/path/to/simulator"

# Log level: trace, debug, info, warn, error
# This controls both the Go CLI and the Rust simulator (via ERST_LOG_LEVEL).
log_level = "info"

# Cache directory for storing traces and snapshots
# cache_path = "~/.erst/cache"

# Maximum depth of the call tree before it is truncated.
# Truncation prevents stack overflows during trace analysis and visualization.
# Default is 50.
max_trace_depth = 50

# Maximum source map cache size (e.g., 500MB, 1GB)
# When exceeded, oldest entries are automatically evicted.
# Examples: "500MB", "1GB", 524288000 (bytes)
# max_cache_size = "500MB"

# Opt-in anonymous crash reporting.
# When enabled, fatal panics and unhandled errors send a minimal report
# (error message, stack trace, OS/arch, version) to the maintainer.
# No transaction data or personal information is ever included.
# Can also be set via ERST_CRASH_REPORTING=true in the environment.
# crash_reporting = false

# Sentry DSN for crash reporting (alternative or complement to crash_endpoint).
# Obtain from your Sentry project settings. Leave commented to disable Sentry.
# Can also be set via ERST_SENTRY_DSN in the environment.
# crash_sentry_dsn = "https://<key>@<org>.ingest.sentry.io/<project>"

# Override the crash report collection endpoint (optional).
# Defaults to https://crash.erst.dev/v1/report when crash_reporting is true
# and no Sentry DSN is set. Can also be set via ERST_CRASH_ENDPOINT.
# crash_endpoint = "https://crash.erst.dev/v1/report"

# Audit HSM Configuration
# ERST_PKCS11_MODULE = "/usr/lib/softhsm/libsofthsm2.so"
# ERST_PKCS11_MAX_RPM = 1000 # Max requests per minute to protect HSM

# Mock HSM Configuration (for local testing and simulation)
# The mock HSM simulates HSM behavior with configurable latency and failure rates.
# Useful for testing contracts that interact with HSMs without actual hardware.
#
# [mock_hsm]
# latency_ms = 50       # Simulated signing delay in milliseconds
# failure_rate = 0.0    # Probability of signing failure (0.0 to 1.0)
# seed_hex = ""         # Optional: 32-byte hex seed for deterministic key generation
#
# Environment variables:
# ERST_SIGNER_TYPE=mock
# ERST_MOCK_HSM_LATENCY_MS=50
# ERST_MOCK_HSM_FAILURE_RATE=0.1
# ERST_MOCK_HSM_SEED=0000000000000000000000000000000000000000000000000000000000000001