cost

type Backend string

type Cluster struct {
	// Writers is the number of nodes producing new state. Used only
	// for noting in the report; the PUT cost itself is independent
	// of this once dedup is in place.
	Writers int
	// Readers is the number of read-only nodes pulling from the
	// shared archive. Each contributes its own GET volume.
	Readers int

	// Underlying single-tier workload (per writer × dedup factor,
	// or equivalently the chain-growth rate times the writer-share).
	// In a deduped cluster this is just the chain's intrinsic growth.
	Base Workload

	// ReadsPerReaderRatio is each reader's fraction of the total GET
	// volume relative to one full archive scan per month. 0 = no
	// reads; 1 = one full re-read of the archive per reader per
	// month; 12 = monthly re-reads per reader (very heavy).
	ReadsPerReaderRatio float64

	// EgressPerReaderGBPerMonth models the cross-region egress per
	// reader. Set to 0 if all readers are in the backend's region.
	EgressPerReaderGBPerMonth float64
}

type Estimate struct {
	Backend     Backend
	Workload    string
	StorageUSD  float64
	RequestsUSD float64
	EgressUSD   float64
	TotalUSD    float64
	Notes       string
}

type Pricing struct {
	// StoragePerGBMonth is the monthly $/GB held.
	StoragePerGBMonth float64

	// PutPer1k is the cost per 1000 PUT requests.
	PutPer1k float64
	// GetPer1k is the cost per 1000 GET requests.
	GetPer1k float64

	// EgressPerGB is the cost per GB read OUT of the provider's edge.
	// Intra-region same-cloud reads are normally free; this rate
	// applies to cross-region or cross-cloud egress.
	EgressPerGB float64

	// MinCommitGBMonth is any minimum storage commit baked into the
	// SKU (e.g. Glacier Deep Archive's 180-day minimum).
	MinCommitGBMonth float64

	// Notes captures gotchas (e.g. R2's $0 egress is the headline).
	Notes string
}

type Tiered struct {
	// RatePerSecond is the steady-state byte production rate (e.g. a
	// validator emitting finalized state at X MB/s).
	RatePerSecond float64

	// HotWindow is how long the most-recent data stays on local SSD.
	// Typical values: 24h, 7 days, 30 days.
	HotWindow time.Duration

	// ColdRetention is how long data is held in the cold archive
	// before tier-down or deletion. Use a large value (years) to
	// model "keep forever".
	ColdRetention time.Duration

	// HotBackend selects the local-disk pricing entry (typically
	// BackendPVCBlock).
	HotBackend Backend

	// ColdBackend selects the object-store entry.
	ColdBackend Backend

	// PutsPerByte / GetsPerByte map raw bytes to backend request
	// counts. A pure-stream workload writing 64 KiB objects gives
	// PutsPerByte = 1/65536. A 4 KiB-block content-addressed VFS
	// gives PutsPerByte = 1/4096.
	PutsPerByte float64
	GetsPerByte float64

	// EgressGBPerMonth is what leaves the cold backend's edge per
	// month (intra-region reads are free for most providers).
	EgressGBPerMonth float64
}

type TieredEstimate struct {
	Hot           Estimate
	Cold          Estimate
	TotalUSD      float64
	HotStorageGB  float64
	ColdStorageGB float64
}

type Workload struct {
	// StorageGB is the steady-state stored volume.
	StorageGB float64

	// PutsPerMonth + GetsPerMonth are the request counts at steady
	// state.
	PutsPerMonth float64
	GetsPerMonth float64

	// EgressGBPerMonth is what leaves the provider. Set to 0 if both
	// vfsd and consumers run in the same region as the backend.
	EgressGBPerMonth float64

	// Description is purely cosmetic; surfaces in reports.
	Description string
}