devenv

type ChainConfig struct {
	// Image defaults to DefaultImage.
	Image string
	// TmpDir is bind-mounted as the firehose storage directory, and is also where tier1 keeps
	// its merged blocks and its state store. Wiping it between runs is what forces a cold
	// backprocess.
	TmpDir string
	// Burst is the number of blocks produced immediately at genesis. This is the knob that
	// decides how much there is to backprocess.
	Burst int
	// BlockRate is the number of blocks per minute produced after the burst.
	BlockRate int
	// ExtraReaderArgs are appended to the reader node arguments verbatim.
	ExtraReaderArgs string
	// StartupTimeout bounds the wait for the container to serve. A large Burst pushes this
	// out — the node produces every genesis block before it starts serving — so it scales
	// with the burst when left at zero.
	StartupTimeout time.Duration
}

type Tier1Config struct {
	TmpDir string
	// RelayerEndpoint is the block stream tier1 reads live blocks from, normally the mapped
	// 10014 port of the dummy blockchain container.
	RelayerEndpoint string
	// Tier2Endpoint is where subrequests are sent.
	Tier2Endpoint string
	// Tier2Secret must match the tier2 secret when one is configured.
	Tier2Secret string
	// StateBundleSize is the segment size. Small values mean many small jobs, which is what
	// makes a backprocess visible: 100 over a 200k block burst is 2000 segments per stage.
	StateBundleSize uint64
	// MaxSubrequests is how many tier2 jobs may run at once.
	MaxSubrequests uint64
	// MaxWorkersPerSession caps the workers a single request may hold, defaulting to
	// MaxSubrequests. Lower it to observe a request that is throttled by the session pool
	// rather than by the job scheduler.
	MaxWorkersPerSession uint64
	// MetricsPrefix distinguishes the metric set when several tier1s run in one process.
	MetricsPrefix                 string
	LiveBackFillerFinalBlockDelay uint64
	// ReadyTimeout bounds the wait for the app to report ready, two minutes when left at zero.
	// Tier1 bootstraps its block hub from the merged blocks on disk before it answers, so a
	// large genesis burst pushes this well past the handful of seconds a small one needs.
	ReadyTimeout time.Duration
	// FoundationalStoresConfigPath is a JSON file of identifier → endpoint.
	FoundationalStoresConfigPath string
	// HostedStoreRegistryAddress is the control-plane gRPC address used to resolve
	// hosted foundational stores that are not in the JSON file.
	HostedStoreRegistryAddress string
	// CPUEviction configures the CPU-based request evictor. The zero value leaves it off.
	// Point SUBSTREAMS_CGROUP_DIR at hand-written cpu.max/cpu.stat files to drive it on a
	// host without cgroups.
	CPUEviction active_requests.EvictorConfig
}

type Tier2Config struct {
	TmpDir string
	// Secret, when set, makes tier2 require "Authorization: Bearer <secret>" on subrequests.
	Secret string
	// ScratchSpace configures the store scratch space backend, empty for the default.
	ScratchSpace string
	// ReadyTimeout bounds the wait for the app to report ready, 30s when left at zero.
	ReadyTimeout time.Duration
}