Enum KineticError 

pub enum KineticError {
    InvalidVdfProof,
    InvalidName(NamesError),
    InvalidSignature,
    CommitmentMismatch,
    InvalidDrandPulse(String),
    StorageError(String),
    Internal(String),
    Io(Error),
    ConfigError(String),
    CryptoError(String),
    NetworkError(String),
}

Top-level error type for core Kinetic protocol operations.

Encapsulates all subsystem errors into a single unified enum used across core kernel API boundaries. Subsystem-specific errors should be used directly inside their respective modules; this type is for cross-cutting operations that span multiple domains.

Protocol Context

This is the “catch-all” error type at kernel boundaries. Callers in kinetic-daemon and kinetic-network that cross subsystem lines use this type. For richer context (error codes, retryability, user messages), prefer the domain-specific error types.

Variants

InvalidVdfProof

A VDF proof did not meet the required difficulty target.

Raised when a Wesolowski VDF proof is structurally invalid or does not verify against its challenge hash. See VdfError for finer-grained variants.

InvalidName(NamesError)

Name validation failed.

Wraps NamesError for names that violate LDH rules, exceed length limits, match reserved names (RFC 2606/6761), or are not apex names.

InvalidSignature

An Ed25519 or ML-DSA-65 signature failed verification.

Ed25519 signatures are used for DHT record ownership (reveal records). ML-DSA-65 signatures are used for the daemon identity and governance actions.

CommitmentMismatch

The revealed data’s hash does not match the previously published commitment.

Protocol invariant: a reveal is only accepted if SHA-256(name || salt || payload) == stored_commitment_hash. This variant fires when that invariant is violated.

InvalidDrandPulse(String)

A drand kyn was rejected as invalid.

Raised when the kyn kyn number is wrong, the hex encoding is malformed, or the BLS signature does not verify against the Quicknet chain public key.

StorageError(String)

A storage operation in Sled failed.

Wraps the underlying Sled error message as a string to avoid propagating the sled crate type across the API boundary.

Internal(String)

An unexpected internal engine failure.

Used only for truly unrecoverable states. Prefer domain-specific error variants for expected failure modes.

Io(Error)

An OS I/O failure.

Wraps std::io::Error directly for cases where file or socket I/O fails at a level below any domain-specific handler.

ConfigError(String)

A configuration value was missing or invalid.

Raised by KineticConfig::load on parse failures and by startup validation when required fields are absent.

CryptoError(String)

A cryptographic operation failed.

Covers hashing, key derivation, discriminant generation, and other operations that are not covered by InvalidSignature.

NetworkError(String)

A P2P network interaction failed.

Wraps the network client error message. For richer context use NetworkClientError directly from kinetic-network.

Trait Implementations

impl Debug for KineticError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for KineticError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for KineticError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for KineticError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NamesError> for KineticError

fn from(source: NamesError) -> Self

Converts to this type from the input type.