Expand description
§Topon — Geodineum Geometric Hash Library
Deterministic geometric hashing that maps arbitrary input to points on Riemannian manifolds. Unlike traditional hashes, Topon output has meaningful geometric structure: distances, geodesics, and containment.
§Modes
mode::domain— Domain name hashing (irrational mixing, proven quality)mode::speed— Throughput-optimized (expanding multiply-mod-1 sponge)mode::hierarchical— Tree-structured input on hyperbolic space
§Quick start
use topon::{domain_hasher, DomainHash};
let hasher = domain_hasher();
let coords = hasher.hash_domain("example.geo").unwrap();§Hash stability
Hash values are part of the public contract, not just the API. Until
1.0 output may change between releases: any release that changes output
for any input bumps the minor version; patch releases are bit-identical.
Output depends on the compile-time GMATH_PROFILE — values are only
comparable between builds using the same profile. The profile fixes
FixedPoint, the g_math format every coordinate is stored in.
Re-exports§
pub use crate::core::config::CoordinateConfig;pub use crate::core::config::MAX_DIMENSION;pub use crate::core::manifold::geodesic_distance;pub use crate::core::manifold::ManifoldType;pub use crate::mixing::geodesic::GeodesicWalk;pub use crate::mixing::geodesic::LabelOrder;pub use crate::mixing::geodesic::WalkLimits;pub use mode::domain::DomainHasher;pub use mode::speed::SpeedHasher;pub use mode::hierarchical::HierarchicalHasher;
Modules§
- compat
- Free-function convenience API.
- core
- Core mathematical foundations for geometric hashing.
- eval
- Evaluation harness for comparing geometric hashing approaches.
- mixing
- Mixing strategies — algorithmic building blocks for geometric hashing.
- mode
- User-facing hashing modes.
Enums§
- Topon
Error - Errors returned by Topon operations.
Traits§
- Domain
Hash - Domain-name convenience trait — automatically derived for all
GeometricHashtypes. - Geometric
Hash - Core geometric hashing trait.
Functions§
- domain_
hasher - Create the default domain hasher (irrational mixing, S^128).
- hierarchical_
hasher - Create a hierarchical hasher for tree-structured input.
- speed_
hasher - Create a speed-optimized hasher for arbitrary byte input.
Type Aliases§
- Fixed
Point - The fixed-point format this build hashes in, chosen by
GMATH_PROFILE(andGMATH_FRAC_BITSon realtime) at compile time.