Expand description
Public library for embedding TURBINE in another Rust program.
Start the runtime with Turbine::builder, then submit work as a
TradeIntent. The CLI (turbine-cli) is a thin wrapper around this crate.
Structs§
- Config
- Top-level configuration. Required sections must be present in the TOML; tuning sections default to sane values when omitted.
- Exec
Report - Outcome of one execution attempt (logged + returned for tests/IPC).
- Execution
Engine - The execution engine: holds the payer keypair, the submitter, and shared state.
- Failure
Event - A failure signal handed to the AI coordinator. Either
tracking_id(preferred) orbundle_idmust resolve to an in-flight record. - FeeDecision
- The tip decision for one bundle.
- HotState
- The single shared hot-state container, held behind an
Arcby every runtime. - Retry
Overrides - AI-sanctioned overrides applied when rebuilding a bundle for an autonomous
retry. Produced by the
coordinator::RetryCoordinatorfrom a governor-clampedturbine_ai::RetryAdjustments. - Trade
Intent - A unit of work for the engine: trade instruction groups (one tx each) plus the accounts the bundle will write-lock (drives the contention-aware fee matrix).
- Turbine
- A running TURBINE engine: Geyser + DPU + Jito submit + AI retry loop.
- Turbine
Builder - Builder for
Turbine. Load a config, thenTurbineBuilder::start.
Enums§
- Congestion
- Localized account-contention level, derived from the write-lock EMA z-score.
Ordered so
max()over a bundle’s write-locked accounts picks the bottleneck. - Deshred
Boot Status - Result of attempting to enable deshred at daemon boot.
- Failure
Class - The observed failure class (from the Jito reject/drop reason, an on-chain error, or a submit timeout). It is passed to the AI analyst as a hint only — the AI performs the authoritative classification and decides the fix (plan §8, revised: every failure is routed to the AI; there is no deterministic fix path).
- Gate
Outcome - Outcome of waiting for the submission window.
- Percentile
- Jito landed-tip percentile buckets (p25–p99).
- Telemetry
Event - A single event on the telemetry bus. Tagged for clean JSON over the WebSocket.
- Turbine
Error - The unified error type for TURBINE. Variants are coarse-grained by component so callers can match on the failing subsystem without leaking internals.
Type Aliases§
- Result
- Convenient result alias used throughout TURBINE crates.