pub enum FatalStorageError {
Show 21 variants CreateDatabaseDirectory(PathBuf, Error), DuplicateBlockIndex { height: u64, first: BlockHash, second: BlockHash, }, DuplicateEraIdIndex { era_id: EraId, first: BlockHash, second: BlockHash, }, DuplicateDeployIndex { deploy_hash: DeployHash, first: BlockHashAndHeight, second: BlockHashAndHeight, }, InternalStorage(LmdbExtError), FailedToOverwriteBlock, UnableToMoveFile { source_path: PathBuf, dest_path: PathBuf, original_error: Error, }, MissingStorageFiles { missing_files: Vec<PathBuf>, }, BlockValidation(BlockValidationError), BlockHeaderNotStoredUnderItsHash { queried_block_hash_bytes: Vec<u8>, found_block_header_hash: BlockHash, block_header: Box<BlockHeader>, }, NoBlockHeaderForBlockBody { block_body_hash: Digest, block_body: Box<BlockBody>, }, SignatureVerification(Error), CorruptedBlockSignatureIndex { raw_key: Vec<u8>, block_hash_bytes: Vec<u8>, }, InvalidSwitchBlock(Box<BlockHeader>), UnexpectedBlockBodyPart { block_body_hash: Digest, part_hash: Digest, }, StoredItemSerializationFailure(Error), UnexpectedFinalizedApprovals { deploy_hash: DeployHash, }, UnexpectedSerializationFailure(Error), UnexpectedDeserializationFailure(Error), ApprovalsHashesLengthMismatch { block_hash: BlockHash, expected: usize, actual: usize, }, Prometheus(Error),
}
Expand description

A fatal storage component error.

An error of this kinds indicates that storage is corrupted or otherwise irrecoverably broken, at least for the moment. It should usually be followed by swift termination of the node.

Variants§

§

CreateDatabaseDirectory(PathBuf, Error)

Failure to create the root database directory.

§

DuplicateBlockIndex

Fields

§height: u64

Height at which duplicate was found.

§first: BlockHash

First block hash encountered at height.

§second: BlockHash

Second block hash encountered at height.

Found a duplicate block-at-height index entry.

§

DuplicateEraIdIndex

Fields

§era_id: EraId

Era ID at which duplicate was found.

§first: BlockHash

First block hash encountered at era_id.

§second: BlockHash

Second block hash encountered at era_id.

Found a duplicate switch-block-at-era-id index entry.

§

DuplicateDeployIndex

Fields

§deploy_hash: DeployHash

Deploy hash at which duplicate was found.

§first: BlockHashAndHeight

First block hash encountered at deploy_hash.

§second: BlockHashAndHeight

Second block hash encountered at deploy_hash.

Found a duplicate switch-block-at-era-id index entry.

§

InternalStorage(LmdbExtError)

LMDB error while operating.

§

FailedToOverwriteBlock

An internal DB error - blocks should be overwritten.

§

UnableToMoveFile

Fields

§source_path: PathBuf

The path to the file that should have been moved.

§dest_path: PathBuf

The path where the file should have been moved to.

§original_error: Error

The original io::Error from fs::rename.

Filesystem error while trying to move file.

§

MissingStorageFiles

Fields

§missing_files: Vec<PathBuf>

The files that were not be found in the storage directory.

Mix of missing and found storage files.

§

BlockValidation(BlockValidationError)

Error when validating a block.

§

BlockHeaderNotStoredUnderItsHash

Fields

§queried_block_hash_bytes: Vec<u8>

The queried block hash.

§found_block_header_hash: BlockHash

The actual header of the block hash.

§block_header: Box<BlockHeader>

The block header found in storage.

A block header was not stored under its hash.

§

NoBlockHeaderForBlockBody

Fields

§block_body_hash: Digest

The block body hash.

§block_body: Box<BlockBody>

The block body.

Block body did not have a block header.

§

SignatureVerification(Error)

Could not verify finality signatures for block.

§

CorruptedBlockSignatureIndex

Fields

§raw_key: Vec<u8>

The key in the block signature index.

§block_hash_bytes: Vec<u8>

The block hash of the signatures found in the index.

Corrupted block signature index.

§

InvalidSwitchBlock(Box<BlockHeader>)

Switch block does not contain era end.

§

UnexpectedBlockBodyPart

Fields

§block_body_hash: Digest

The block body with the issue.

§part_hash: Digest

The hash of the superfluous body part.

A block body was found to have more parts than expected.

§

StoredItemSerializationFailure(Error)

Failed to serialize an item that was found in local storage.

§

UnexpectedFinalizedApprovals

Fields

§deploy_hash: DeployHash

The missing deploy hash.

We tried to store finalized approvals for a nonexistent deploy.

§

UnexpectedSerializationFailure(Error)

ToBytes serialization failure of an item that should never fail to serialize.

§

UnexpectedDeserializationFailure(Error)

ToBytes deserialization failure of an item that should never fail to serialize.

§

ApprovalsHashesLengthMismatch

Fields

§block_hash: BlockHash

The block hash.

§expected: usize

The number of deploys in the block.

§actual: usize

The number of approvals hashes.

Stored finalized approvals hashes count doesn’t match number of deploys.

§

Prometheus(Error)

Error initializing metrics.

Trait Implementations§

source§

impl Debug for FatalStorageError

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for FatalStorageError

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for FatalStorageError

source§

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

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

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

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

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. Read more
source§

impl From<BlockValidationError> for FatalStorageError

source§

fn from(source: BlockValidationError) -> Self

Converts to this type from the input type.
source§

impl From<Box<BlockValidationError>> for FatalStorageError

source§

fn from(err: Box<BlockValidationError>) -> Self

Converts to this type from the input type.
source§

impl From<Error> for FatalStorageError

source§

fn from(source: Error) -> Self

Converts to this type from the input type.
source§

impl From<Error> for FatalStorageError

source§

fn from(err: Error) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Downcast for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more