Introduction
Whale v0.1.13 is a reusable Chelis shell for betting primitives. It provides sizing, bankroll management, risk assessment, policy enforcement, and backtesting without carrying sport-specific logic. Downstream consumers supply their own domain models and plug into Whale's typed surface.
Dependencies
Section titled “Dependencies”Whale is pinned to:
chelis-std0.4.0shoals0.21.4
Whale depends on Shoals for currency-tagged primitives. Stake values,
bankroll balances, and payout amounts flow through the Shoals.Money type,
so arithmetic respects denomination and rounding rules inherited from the
Shoals currency layer.
Modules
Section titled “Modules”| Module | Purpose |
|---|---|
Whale.Types | Core types: probability, odds, stake fractions, ratings, edge values |
Whale.Sizing | Kelly criterion and its variants (fractional, capped, risk-adjusted, simultaneous) |
Whale.BankRoll | Bankroll tracking, drawdown limits, allocation splits |
Whale.Risk | Risk assessment: expected loss, variance of return, ruin probability |
Whale.Policy | Declarative policy rules that constrain bet placement |
Whale.Guards | Guardrails and hard limits enforced before execution |
Whale.BackTest | Backtesting surface for strategy evaluation over historical data |
Design
Section titled “Design”Whale is deliberately thin. It encodes the mathematical and operational primitives that every betting experiment needs, then gets out of the way. Sport models, market connectors, and settlement logic live in downstream consumers, not in Whale itself. This separation keeps the shell reusable across domains.