Skip to main content

Crate topon

Crate topon 

Source
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§

ToponError
Errors returned by Topon operations.

Traits§

DomainHash
Domain-name convenience trait — automatically derived for all GeometricHash types.
GeometricHash
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§

FixedPoint
The fixed-point format this build hashes in, chosen by GMATH_PROFILE (and GMATH_FRAC_BITS on realtime) at compile time.