waggle_core/
lib.rs

1//! # waggle-core — the sans-I/O domain
2//!
3//! The core performs **no I/O, owns no clock, and generates no entropy**
4//! (design doc `03 §1`). Every effect is a parameter:
5//!
6//! - randomness arrives through [`Entropy`] (blanket-implemented for
7//!   closures — function passing, not global state),
8//! - time arrives as a [`Timestamp`] value in every signature that needs
9//!   one,
10//! - storage never appears here at all (see `waggle-store`).
11//!
12//! This is what lets the identical code run in the native daemon, in
13//! Cloudflare Workers wasm, and under deterministic tests.
14//!
15//! CP-0 shipped the foundation trio: [`Token`], [`Timestamp`], [`Entropy`].
16//! CP-1 adds the domain model: slugs ([`Sharer`], [`Channel`], [`Stage`]),
17//! targets ([`CanonicalUrl`], [`TargetMeta`], [`MediaRef`]), the
18//! three-zone [`AttributionManifest`] with variants, and [`mint`] — a pure
19//! function of `(spec, options, entropy, now)`. The sealed variant matcher
20//! and folds land in CP-2/CP-3 (design docs `02`–`04`).
21//!
22//! ```
23//! use waggle_core::{Entropy, Token};
24//!
25//! // A deterministic entropy source: fine for tests, never for production.
26//! let mut counter = 0u8;
27//! let mut entropy = |buf: &mut [u8]| {
28//!     for b in buf.iter_mut() {
29//!         counter = counter.wrapping_add(41);
30//!         *b = counter;
31//!     }
32//!     Ok(())
33//! };
34//! let token = Token::generate(8, &mut entropy).expect("entropy never fails here");
35//! assert_eq!(token.as_str().len(), 8);
36//! ```
37
38mod context;
39mod contract;
40mod entropy;
41mod event;
42mod fold;
43mod log;
44mod manifest;
45mod matcher;
46mod mint;
47mod reconstruct;
48mod resolve;
49mod slug;
50mod soa;
51mod target;
52mod time;
53mod token;
54pub mod trust;
55
56pub use context::{negotiate, ConsumerHint, ConsumerKind, ResolverContext};
57pub use contract::{
58    Contract, ContractError, Coverage, Region, FULL_COVERAGE_PERMILLE, MAX_CONTRACT_REGIONS,
59};
60pub use entropy::{Entropy, EntropyError};
61pub use event::{ActorClass, Event, FamilyClass, HarnessClass, Seq};
62pub use fold::{
63    outcome_of, replay, Fold, FunnelFold, LineageFold, ManifestFold, Outcome, RegionTouchFold,
64};
65pub use log::{Change, LogRecord};
66pub use manifest::{
67    apply_change, AttributionManifest, Constraint, Disposition, MatchExpr, ModalitySet, Posture,
68    SignatureBlock, Variant, VariantBody, MANIFEST_SCHEMA_VERSION,
69};
70pub use matcher::{select_variant, Selected};
71pub use mint::{mint, MintError, MintOptions, MintSpec};
72pub use reconstruct::{apply_suffix, reconstruct, WorldState};
73pub use resolve::{resolve, Resolution, DEFAULT_REVALIDATE_MS};
74pub use slug::{Channel, Sharer, SlugError, Stage};
75pub use soa::{EventLog, InternTables, StageId, TokenId};
76pub use target::{
77    CanonicalUrl, MediaRef, Sha256Error, Sha256Hex, TargetError, TargetMeta,
78    INLINE_THRESHOLD_BYTES, MANIFEST_SIZE_CAP_BYTES,
79};
80pub use time::Timestamp;
81pub use token::{Token, TokenError, TOKEN_ALPHABET};
waggle_core/lib.rs

waggle_core/
lib.rs
