Crate kinetic_core 

kinetic-core

The foundational shared kernel for the Kinetic decentralized naming network.

kinetic-core contains the core models, protocol constants, cryptographic state machines, error hierarchies, and common I/O utilities used across all Kinetic binaries and sub-crates.

Architecture & Module Map

• config — Daemon configuration structures (KineticConfig) and network port defaults.
• types — Shared wire-format types (DnsZone, DnsRecord, Commitment, VdfProof) and name normalization rules.
• error — Unified error logbook (KineticError), domain errors (ResolutionError, PublishError, RegistrationError), and stable error codes.
• traits — Core abstraction traits (StorageEngine and VdfEngine).
• governance — Council state machine and parameter rulebooks governing privileged protocol actions.
• consensus_math — Deterministic math routines for VDF difficulty scaling, name-length pricing, and grace period calculations.
• drand — Client interface for the drand distributed randomness beacon used in time-bound operations.
• net — Network security primitives, IP classification, and SSRF prevention guards.
• shutdown — Cross-platform graceful shutdown listeners.
• api_error (Non-WASM) — HTTP status code mapping and Axum-compatible API error responses (ApiError).
• request_id (Non-WASM) — Idempotency key generators for daemon API requests.

Re-exports

pub use api_error::ApiError;

pub use error::KineticError;

pub use error::PublishError;

pub use error::RecordRejectReason;

pub use error::RegistrationError;

pub use error::ResolutionError;

pub use error::Severity;

pub use error::VdfRejectReason;

Modules

api_error

HTTP API error types compatible with axum and tower response extractors. RFC 7807 Problem Details HTTP API error serialization boundary.

config

Config file loading, default values, and port constants for all Kinetic binaries. Global configuration models, default values, and port definitions for Kinetic.

consensus_math

Mathematical helpers for consensus: VDF difficulty scaling and name-length fees. Consensus difficulty math, Squatter Cliff curve, and inverse-square name takeover calculations.

constants

Global protocol constants. Protocol-level constants and magic numbers for the Kinetic network.

drand

drand beacon client for epoch-bound randomness and Sybil-resistance. League of Entropy Drand Quicknet randomness beacon client and cache manager.

error

Unified error taxonomy: KineticError, ResolutionError, PublishError, and RegistrationError. Unified error taxonomy and logbook registry for Kinetic.

governance

Protocol governance: council proposals, voting, and parameter updates. Network governance state transitions, threshold voting logic, and engine drivers.

net

Network security utilities for SSRF prevention. Network IP address validation and Server-Side Request Forgery (SSRF) defenses.

request_id

Idempotency key helpers for deduplicating daemon API requests. Task-local correlation ID for request tracing across asynchronous call trees.

shutdown

Cross-platform graceful shutdown signal listener. Cross-platform async signal handling for graceful node shutdown.

traits

Core trait definitions: StorageEngine and VdfEngine. Core trait abstractions and dependency inversion interfaces for the Kinetic engine.

types

Shared wire-format types for P2P messages, DNS zones, and name records. Core wire-format domain models and protocol primitives.