Skip to main content

Crate strontium_core

Crate strontium_core 

Source
Expand description

§strontium-core

Reusable deterministic simulation tooling migrated into Strontium.

See repository docs for substrate-oriented adoption guides, facade mapping, transport integration guidance, and reference consumer architecture notes.

§Stable Entry Point

Use strontium_core::api as the public facade.

§strontium_core::api::core

  • deterministic executor and scheduler
  • virtual clock
  • seeded RNG
  • trace and reproducibility bundle types
  • reusable virtual filesystem
  • reusable network queue mechanics
  • reusable transport-dispatch mechanics

Representative names from the cleaned facade include Reactor, TaskHandle, Interval, Clock, Rng, Vfs, Network, NetworkClock, NetworkDeliveryReport, DispatchRegistry, RouteOutcome, and DeserializeError.

§strontium_core::api::run

  • simulation config
  • simulation result and outcome types
  • invariant-violation reporting types

Representative names from the cleaned facade include Config, Outcome, RunResult, and InvariantViolation.

§Deliberately Excluded

strontium-core does not expose Palladium runtime bindings such as:

  • pd_runtime::Engine
  • pd_actor supervision and actor setup helpers
  • pd_transport::TransportRegistry adapters
  • Palladium-specific DST scenarios and assertions

Those remain outside strontium-core.

§Benchmarking

Use cargo bench --bench strontium_core to run the current microbenchmark suite for scheduler queue operations, network delivery, and trace append overhead.

Modules§

api