The Go-side Ringtail purge (commits 6f8f8a22, dc7e4ed0, 85b6e80f) was
not propagated to pkg/rust prose. README, Cargo.toml description, and
the top-level //! docstring in src/lib.rs still said "BLS12-381 +
Ringtail" or "BLS + Ringtail signatures" while the Go consensus stack
renamed to Pulsar (Module-LWE) + Corona (Ring-LWE) per LP-4200.
Update README + Cargo.toml description + lib.rs //! header to use
"Pulsar (Module-LWE threshold, FIPS 204 byte-equal)" — matching the
canonical naming in consensus/CLAUDE.md.
Cargo.lock 1.22.0 → 1.22.1 was already in the working tree from the
pending version bump; commits alongside this prose alignment so the
next crates.io publish carries both.
NOT renamed: public API field names (ringtail_sig, ringtail_pubkey,
collect_ringtail_signatures, etc.) — breaking surface renames need a
deliberate decision and a coordinated minor/major bump. Prose
alignment is the safe patch.
`cargo check --no-default-features` PASS.
- Mark doctest as no_run to avoid Result type conflicts
- Fix ID construction to use full 32-byte arrays
- Update to use underscore for ignored results
- All Rust tests now passing (doctests + unit tests)
This fixes the final CI failure.
BREAKING CHANGE: Package paths have been reorganized for clarity
## Major Changes
### Package Structure
- Collapsed engine/core → engine (removed unnecessary nesting)
- Moved core/types → types (top-level types package)
- Added root facade for single-import experience
- Removed redundant factory.go
### SDK Improvements
All SDKs now provide single-import interfaces:
- Go: import "github.com/luxfi/consensus"
- Python: import lux_consensus as consensus
- Rust: use lux_consensus::*
### Documentation
- Added comprehensive introduction and architecture docs
- Created AI/ML integration guide for researchers
- Added research section with papers and experiments
- Improved sidebar organization and discoverability
### Benefits
- Shallow, obvious import paths
- One responsibility per package
- DRY, composable, orthogonal design
- Idiomatic patterns for each language
- Consistent API across all SDKs
This refactor provides a clean, intuitive developer experience where
one import is enough and things work one way only.
zeekay