Enum NoxuError 

pub enum NoxuError {
    EnvironmentFailure {
        reason: EnvironmentFailureReason,
        msg: String,
    },
    EnvironmentWedged(String),
    EnvironmentNotFound(String),
    EnvironmentLocked(String),
    LogWriteFailure(String),
    DiskLimitExceeded {
        used: u64,
        limit: u64,
    },
    ThreadInterrupted,
    DatabaseNotFound(String),
    DatabaseAlreadyExists(String),
    DatabaseClosed,
    EnvironmentClosed,
    CursorClosed,
    LockConflict(String),
    DeadlockDetected,
    LockTimeout {
        timeout_ms: u64,
        detail: String,
    },
    LockNotAvailable,
    TransactionTimeout {
        timeout_ms: u64,
        txn_id: i64,
    },
    LockPreempted,
    TransactionAborted(String),
    KeyExists,
    UniqueConstraintViolation(String),
    DeleteConstraintViolation(String),
    ForeignConstraintViolation(String),
    DuplicateDataException,
    SecondaryIntegrityException(String),
    SequenceExists(String),
    SequenceNotFound(String),
    SequenceOverflow,
    SequenceIntegrity(String),
    NotFound,
    ReadOnly,
    ReplicaWrite,
    InsufficientReplicas {
        required: u32,
        available: u32,
    },
    RollbackRequired(String),
    LogChecksumMismatch(String),
    LogFileNotFound(String),
    IoError(Error),
    VersionMismatch(String),
    OperationNotAllowed(String),
    IllegalArgument(String),
    Timeout,
    InvalidOperation(String),
    Unsupported(String),
}

Errors that can occur when using Noxu DB.

Implements exception hierarchy:

• NoxuError::EnvironmentFailure — potentially fatal; check NoxuError::is_fatal_to_environment. Carries an EnvironmentFailureReason for discriminating the cause.
• Operation-failure variants are retryable after abort (NoxuError::is_retryable).
• HA / replication variants (NoxuError::InsufficientReplicas, NoxuError::ReplicaWrite, NoxuError::RollbackRequired).

Variants

EnvironmentFailure

A failure has occurred that may require the environment to be closed and re-opened. Check NoxuError::is_fatal_to_environment / NoxuError::reason to determine whether restart is required.

Fields

reason: EnvironmentFailureReason

The root cause of the failure.

msg: String

Human-readable detail message.

EnvironmentWedged(String)

The environment is permanently wedged and cannot recover even after close/re-open. Operator intervention or backup restore is required.

EnvironmentNotFound(String)

The environment home directory was not found and allow_create = false.

EnvironmentLocked(String)

The environment is already open by another process.

LogWriteFailure(String)

An I/O error occurred while writing to the log. The disk may be full.

DiskLimitExceeded

The disk limit (MAX_DISK / FREE_DISK) was exceeded.

Fields

used: u64

Bytes currently used by the environment.

limit: u64

Configured limit in bytes.

ThreadInterrupted

The calling thread was interrupted while performing a

DatabaseNotFound(String)

The requested database was not found in the environment.

DatabaseAlreadyExists(String)

An attempt was made to create a database that already exists.

DatabaseClosed

An operation was attempted on a closed database.

EnvironmentClosed

An operation was attempted on a closed environment.

CursorClosed

An operation was attempted on a closed cursor.

LockConflict(String)

A lock conflict occurred (locker blocked and could not acquire).

Retryable.

DeadlockDetected

A deadlock was detected between two or more transactions.

Retryable.

LockTimeout

A lock-wait timeout expired.

Retryable.

Fields

timeout_ms: u64

How long the locker waited before giving up.

detail: String

Full diagnostic message from the lock manager (owner, requester, LSN). Empty string when not available.

LockNotAvailable

A lock was requested with no-wait semantics and was not immediately available.

Retryable.

TransactionTimeout

A transaction-level timeout expired.

Retryable.

Fields

timeout_ms: u64

Transaction-level timeout in milliseconds.

txn_id: i64

ID of the timed-out transaction.

LockPreempted

A lock was preempted by a higher-priority locker (HA).

Retryable.

TransactionAborted(String)

The transaction was aborted.

KeyExists

The key already exists (put_no_overwrite / cursor put_no_dup_data).

UniqueConstraintViolation(String)

A unique-index constraint was violated.

DeleteConstraintViolation(String)

A delete was attempted on a primary record referenced by a secondary index.

ForeignConstraintViolation(String)

A foreign-key constraint was violated.

DuplicateDataException

Duplicate data was supplied to a putNoDupData operation in a duplicate-sorted database.

SecondaryIntegrityException(String)

A secondary database integrity constraint was violated.

SequenceExists(String)

A sequence with the given name already exists.

SequenceNotFound(String)

A sequence with the given name was not found.

SequenceOverflow

A sequence has overflowed or underflowed its range.

SequenceIntegrity(String)

A sequence integrity violation was detected.

NotFound

A key or data item was not found.

ReadOnly

The database or environment is in read-only mode.

ReplicaWrite

A write was attempted on a replica node.

InsufficientReplicas

Insufficient replicas acknowledged the commit.

Fields

required: u32

Acknowledgement quorum required.

available: u32

Number of replicas that responded.

RollbackRequired(String)

The transaction must be rolled back due to a replication state change.

LogChecksumMismatch(String)

A log checksum mismatch was detected (potential corruption).

Fatal: the environment will be invalidated.

LogFileNotFound(String)

A log file was not found.

IoError(Error)

An I/O error occurred.

VersionMismatch(String)

A version mismatch occurred (e.g. on-disk format vs. code version).

OperationNotAllowed(String)

The operation is not allowed in the current state.

IllegalArgument(String)

An illegal argument was provided to a method.

Mirrors IllegalArgumentException (DB flavour).

Timeout

The operation timed out (non-lock, non-txn — e.g. network or sync).

InvalidOperation(String)

An invalid operation was requested.

Unsupported(String)

The requested operation is recognised by the API but not yet implemented. The argument names the operation (for example "Get::SearchLte").

Returned by API arms that previously fell through to a silent OperationStatus::NotFound; users now see a loud, typed error instead of a misleading miss. Tracked in docs/src/internal/api-audit-2026-05-cursor.md Finding 3.

Implementations

impl NoxuError

pub fn is_retryable(&self) -> bool

Returns true if the failed operation may be retried after aborting the current transaction.

Mirrors OperationFailureException.isRetryable().

pub fn is_fatal_to_environment(&self) -> bool

Returns true if this error is fatal to the environment.

After a fatal error the environment must be closed and re-opened. Subsequent operations on an invalidated environment will return EnvironmentClosed.

Mirrors EnvironmentFailureException detection + isValid().

pub fn reason(&self) -> Option<&EnvironmentFailureReason>

Returns the EnvironmentFailureReason if this is an EnvironmentFailure variant, None otherwise.

Mirrors EnvironmentFailureException.getReason().

pub fn is_corrupted(&self) -> bool

Returns true if the environment log is persistently corrupted.

Mirrors EnvironmentFailureException.isCorrupted().

pub fn is_lock_conflict(&self) -> bool

Returns true if this is a lock-conflict error.

pub fn is_lock_timeout(&self) -> bool

Returns true if this is a lock or transaction timeout.

pub fn is_database_not_found(&self) -> bool

Returns true if the named database was not found.

pub fn is_operation_failure(&self) -> bool

Returns true for any OperationFailureException-equivalent.

pub fn environment(msg: impl Into<String>) -> Self

Creates an EnvironmentFailure with UnexpectedState reason. Use when the specific reason is unknown.

pub fn environment_with_reason( reason: EnvironmentFailureReason, msg: impl Into<String>, ) -> Self

Creates an EnvironmentFailure with an explicit reason.

pub fn database(msg: impl Into<String>) -> Self

Creates an OperationNotAllowed error.

pub fn invalid_argument(msg: impl Into<String>) -> Self

Creates an IllegalArgument error.

pub fn lock_conflict(msg: impl Into<String>) -> Self

Creates a LockConflict error.

pub fn lock_timeout(timeout_ms: u64) -> Self

Creates a LockTimeout error.

pub fn database_not_found(name: impl Into<String>) -> Self

Creates a DatabaseNotFound error.

pub fn disk_limit_exceeded(used: u64, limit: u64) -> Self

Creates a DiskLimitExceeded error.

Trait Implementations

impl Debug for NoxuError

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

Formats the value using the given formatter.

impl Display for NoxuError

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

Formats the value using the given formatter.

impl Error for NoxuError

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<DbiError> for NoxuError

fn from(e: DbiError) -> Self

Converts to this type from the input type.

impl From<Error> for NoxuError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<TxnError> for NoxuError

fn from(e: TxnError) -> Self

Converts to this type from the input type.