2026-06-23 20:10:41 +00:00
|
|
|
//! `iroh-driver` — iroh-backed transport driver for the actorized distribution stack.
|
|
|
|
|
//!
|
|
|
|
|
//! This crate owns the concrete iroh endpoint/QUIC/relay machinery. The
|
|
|
|
|
//! distribution crate owns cluster dynamics, protocol actors, routing claims, and
|
|
|
|
|
//! wire message definitions.
|
|
|
|
|
|
feat(engine): substrate-neutral execution engine abstraction
Introduce the swactor engine: a swactor-owned composite that retains a
selected execution substrate, drives the core runtime, and hosts the
async/blocking/timer work that backs actors. Integrations receive one
cloneable EngineHandle and never construct or borrow a raw Tokio
runtime/handle.
Engine crate (crates/engine):
- The contract: spawn / spawn_blocking / timer / interval / now, a
per-implementation capability model with construction-time binding
(require()), and engine-owned time. The engine owns all progression;
actor handlers stay synchronous and never .await.
- TokioBackend owns the Tokio runtime and schedules core ticks and
supporting futures on it; SteppingBackend is a single-threaded
deterministic scheduler with virtual time (the non-Tokio portability
proof). Core is driven through its existing tick() surface; a
self-rescheduling CoreDriver is installed at construction and is the
sole place permitted to call try_tick.
iroh-driver:
- Receives an EngineHandle instead of a raw Tokio Handle. Accepts,
reads, dials, writes, endpoint construction, and teardown schedule
through it; required capabilities (tasks/timers/io) are validated
before the endpoint binds. Engine-hosted interval pumps drive
actor-bridge, datastream, and edge ingress.
myelin:
- One node/orchestrator engine owns core, protocol tick injection, and
transport progression; the application loop only drains
integration-owned queues. Stage-shard process readers, delayed actor
messages, helper stdout/stderr, prompt RPC, and CPU sampling all
schedule through the engine (spawn_blocking / engine tasks / timers).
- Removed the split-engine APIs: install_actor_bridge_pump(period) and
spawn_protocol_ticker(period) use each component's stored engine;
deleted the no-op pump_network callback and its plumbing; deleted the
dashboard raw-Tokio/standalone-runtime conveniences.
Enforcement:
- A clippy disallowed-methods boundary forbids direct runtime/scheduling/
time/core-driving bypasses, denied in swactor-engine, iroh-driver, and
myelin. Retained excluded uses (VastAI provider, provider process
supervision/log capture, OS-signal/stdin/process-control sequencing)
carry narrow allowances with reasons.
Verification:
- Engine contract + unit tests (incl. the SteppingBackend portability
proof), iroh integration tests (capability rejection before binding,
multi-node actor behavior), and a production execution-composition
smoke test that observes engine-driven actor progress with no ambient
Tokio runtime and no manual tick/pump. Workspace all-target/all-feature
clippy and tests are green.
Specs co-located with their crates: ENGINE_SPEC.md in crates/engine,
IROH_DRIVER_SPEC.md in crates/iroh-driver. VastAI remains explicitly out
of scope pending its separate redesign.
2026-08-10 20:23:03 +00:00
|
|
|
// Engine boundary enforcement: disallowed scheduling/time/core-driving methods
|
|
|
|
|
// are hard errors in this crate (ENGINE_SPEC.md §2). All engine-hosted
|
|
|
|
|
// work goes through `EngineHandle`.
|
|
|
|
|
#![deny(clippy::disallowed_methods)]
|
|
|
|
|
|
2026-06-25 12:30:18 +00:00
|
|
|
pub mod datastream_transport;
|
2026-07-30 08:18:02 +00:00
|
|
|
pub mod driver_pumps;
|
2026-07-22 07:50:53 +00:00
|
|
|
pub mod edge_transport;
|
2026-07-30 08:18:02 +00:00
|
|
|
pub mod endpoint_advertisement;
|
2026-06-23 20:10:41 +00:00
|
|
|
pub mod iroh_driver;
|
|
|
|
|
|
2026-07-30 11:31:23 +00:00
|
|
|
pub use endpoint_advertisement::{
|
|
|
|
|
EndpointAddrMask, MVP_IROH_ENDPOINT_ADDR_MASK_ENV, advertised_endpoint,
|
|
|
|
|
};
|
2026-06-23 20:10:41 +00:00
|
|
|
pub use iroh_driver::{
|
2026-07-22 07:50:53 +00:00
|
|
|
ConnType, DatastreamPublishHandle, IrohDriver, IrohDriverConfig, JoinPhase, JoinStatus,
|
|
|
|
|
conn_type_of, discover_lan_ips,
|
2026-06-23 20:10:41 +00:00
|
|
|
};
|
2026-06-25 12:30:18 +00:00
|
|
|
|
2026-07-22 07:50:53 +00:00
|
|
|
pub use edge_transport::{EDGE_ALPN, EdgeSendHandle, EdgeTransportEvent, EdgeTransportFault};
|
|
|
|
|
|
2026-06-25 12:30:18 +00:00
|
|
|
pub use datastream_transport::{
|
|
|
|
|
DATASTREAM_ALPN, DatastreamQuicHeader, DatastreamQuicRead, DatastreamQuicWriteStats,
|
2026-07-12 06:14:34 +00:00
|
|
|
read_events_from_stream, read_next_event, read_next_uni_from_connection, read_stream_header,
|
|
|
|
|
read_stream_into_fanout, spawn_connection_reader, spawn_subscription_writer,
|
|
|
|
|
write_available_subscription, write_event, write_subscription_until_closed,
|
2026-06-25 12:30:18 +00:00
|
|
|
};
|