mirror of
https://github.com/status-im/nimbus-eth1.git
synced 2025-01-24 11:11:59 +00:00
2c35390bdf
* Aristo: Update error return code why: Failing of `Aristo` function `delete()` might fail because there is no such data item on the db. This must return a single error code as is done with `fetch()`. * Ledger: Better error handling why: The `expect()` clauses have been replaced by raising asserts indicating the error from the database backend. Also, `delete()` failures are legitimate if the item to delete does not exist. * Aristo: Delete function must always leave a label on DB for `hashify()` why: The `hashify()` uses the labels left bu `merge()` and `delete()` to compile (and optimise) a scheduler for subsequent hashing. Originally, the labels were not used for deleted entries and `delete()` still had some edge case where the deletion label was not properly handled. * Aristo: Update `hashify()` scheduler, remove buggy optimisation why: Was left over from version without virtual state roots which did not know about account payload leaf vertices referring to storage roots. * Aristo: Label storage trie account in `delete()` similar to `merge()` details; The `delete()` function applied to a non-static state root (assumed to be a storage root) will check the payload of an accounts leaf and mark its Merkle keys to be re-checked when runninh `hashify()` * Aristo: Clean up and re-org recycled vertex IDs in `hashify()` why: Re-organising the recycled vertex IDs list intends to reduce the size of the list. This list is organised as a LIFO (or stack.) By reorganising it in a way so that the least vertex ID numbers are on top, the list will be kept smaller as observed on some examples (less than 30%.) * CoreDb: Accept storage trie deletion requests in non-initialised state why: Due to lazy initialisation, the root vertex ID might not yet exist. So the `Aristo` database handlers would reject this call with an error and this condition needs to be handled by the API (which realises the lazy feature.) * Cosmetics & code massage, prettify logging * fix missing import
287 lines
6.7 KiB
Nim
287 lines
6.7 KiB
Nim
# nimbus-eth1
|
|
# Copyright (c) 2023-2024 Status Research & Development GmbH
|
|
# Licensed under either of
|
|
# * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
|
|
# http://www.apache.org/licenses/LICENSE-2.0)
|
|
# * MIT license ([LICENSE-MIT](LICENSE-MIT) or
|
|
# http://opensource.org/licenses/MIT)
|
|
# at your option. This file may not be copied, modified, or distributed
|
|
# except according to those terms.
|
|
|
|
type
|
|
AristoError* = enum
|
|
NothingSerious = 0
|
|
GenericError
|
|
|
|
# Rlp decoder, `read()`
|
|
Rlp2Or17ListEntries
|
|
RlpBlobExpected
|
|
RlpBranchHashKeyExpected
|
|
RlpEmptyBlobExpected
|
|
RlpExtHashKeyExpected
|
|
RlpHashKeyExpected
|
|
RlpNonEmptyBlobExpected
|
|
RlpOtherException
|
|
RlpRlpException
|
|
|
|
# Serialise decoder
|
|
SerCantResolveStorageRoot
|
|
|
|
# Data record transcoders, `deblobify()` and `blobify()`
|
|
BlobifyNilFilter
|
|
BlobifyNilVertex
|
|
BlobifyBranchMissingRefs
|
|
BlobifyExtMissingRefs
|
|
BlobifyExtPathOverflow
|
|
BlobifyLeafPathOverflow
|
|
BlobifyFilterRecordOverflow
|
|
|
|
DeblobNilArgument
|
|
DeblobUnknown
|
|
DeblobVtxTooShort
|
|
DeblobHashKeyExpected
|
|
DeblobBranchTooShort
|
|
DeblobBranchSizeGarbled
|
|
DeblobBranchInxOutOfRange
|
|
DeblobExtTooShort
|
|
DeblobExtSizeGarbled
|
|
DeblobExtGotLeafPrefix
|
|
DeblobLeafSizeGarbled
|
|
DeblobLeafGotExtPrefix
|
|
DeblobSizeGarbled
|
|
DeblobWrongType
|
|
DeblobPayloadTooShortInt64
|
|
DeblobPayloadTooShortInt256
|
|
DeblobNonceLenUnsupported
|
|
DeblobBalanceLenUnsupported
|
|
DeblobStorageLenUnsupported
|
|
DeblobCodeLenUnsupported
|
|
DeblobFilterTooShort
|
|
DeblobFilterGenTooShort
|
|
DeblobFilterTrpTooShort
|
|
DeblobFilterTrpVtxSizeGarbled
|
|
DeblobFilterSizeGarbled
|
|
|
|
# Converter `asNode()`, currenly for unit tests only
|
|
CacheMissingNodekeys
|
|
|
|
# Path function `hikeUp()`
|
|
HikeBranchMissingEdge
|
|
HikeBranchTailEmpty
|
|
HikeEmptyPath
|
|
HikeExtTailEmpty
|
|
HikeExtTailMismatch
|
|
HikeLeafUnexpected
|
|
HikeNoLegs
|
|
HikeRootMissing
|
|
|
|
# Path/nibble/key conversions in `aisto_path.nim`
|
|
PathExpected64Nibbles
|
|
PathAtMost64Nibbles
|
|
PathExpectedLeaf
|
|
|
|
# Merge leaf `merge()`
|
|
MergeBranchLinkLeafGarbled
|
|
MergeBranchLinkVtxPfxTooShort
|
|
MergeBranchGarbledNibble
|
|
MergeBranchGarbledTail
|
|
MergeBranchLinkLockedKey
|
|
MergeBranchLinkProofModeLock
|
|
MergeBranchProofModeLock
|
|
MergeBranchRootExpected
|
|
MergeLeafGarbledHike
|
|
MergeLeafPathCachedAlready
|
|
MergeLeafPathOnBackendAlready
|
|
MergeNonBranchProofModeLock
|
|
MergeRootBranchLinkBusy
|
|
MergeRootMissing
|
|
MergeAssemblyFailed # Ooops, internal error
|
|
|
|
MergeHashKeyInvalid
|
|
MergeHashKeyCachedAlready
|
|
MergeHashKeyDiffersFromCached
|
|
MergeHashKeyRevLookUpGarbled
|
|
MergeRootVidInvalid
|
|
MergeRootKeyInvalid
|
|
MergeRevVidMustHaveBeenCached
|
|
MergeNodeVtxDiffersFromExisting
|
|
MergeRootKeyDiffersForVid
|
|
MergeNodeVtxDuplicates
|
|
|
|
# Utils
|
|
UtilsAccPathMissing
|
|
UtilsAccPathWithoutLeaf
|
|
UtilsAccUnaccessible
|
|
UtilsAccWrongStorageRoot
|
|
UtilsStoRootMissing
|
|
|
|
# Update `Merkle` hashes `hashify()`
|
|
HashifyExistingHashMismatch
|
|
HashifyNodeUnresolved
|
|
HashifyRootHashMismatch
|
|
HashifyRootNodeUnresolved
|
|
|
|
# Cache checker `checkCache()`
|
|
CheckStkKeyStrayZeroEntry
|
|
CheckStkRevKeyMismatch
|
|
CheckStkRevKeyMissing
|
|
CheckStkVtxCountMismatch
|
|
CheckStkVtxIncomplete
|
|
CheckStkVtxKeyMismatch
|
|
CheckStkVtxKeyMissing
|
|
|
|
CheckRlxVidVtxMismatch
|
|
CheckRlxVtxIncomplete
|
|
CheckRlxVtxKeyMissing
|
|
CheckRlxVtxKeyMismatch
|
|
CheckRlxRevKeyMissing
|
|
CheckRlxRevKeyMismatch
|
|
|
|
CheckAnyVtxEmptyKeyMissing
|
|
CheckAnyVtxEmptyKeyExpected
|
|
CheckAnyVtxEmptyKeyMismatch
|
|
CheckAnyVtxBranchLinksMissing
|
|
CheckAnyVtxExtPfxMissing
|
|
CheckAnyVtxLockWithoutKey
|
|
CheckAnyRevVtxMissing
|
|
CheckAnyRevVtxDup
|
|
CheckAnyRevCountMismatch
|
|
|
|
# Backend structural check `checkBE()`
|
|
CheckBeVtxInvalid
|
|
CheckBeVtxMissing
|
|
CheckBeVtxBranchLinksMissing
|
|
CheckBeVtxExtPfxMissing
|
|
CheckBeKeyInvalid
|
|
CheckBeKeyMissing
|
|
CheckBeKeyCantCompile
|
|
CheckBeKeyMismatch
|
|
CheckBeGarbledVGen
|
|
|
|
CheckBeCacheIsDirty
|
|
CheckBeCacheKeyMissing
|
|
CheckBeCacheKeyNonEmpty
|
|
CheckBeCacheVidUnsynced
|
|
CheckBeCacheKeyDangling
|
|
CheckBeCacheVtxDangling
|
|
CheckBeCacheKeyCantCompile
|
|
CheckBeCacheKeyMismatch
|
|
CheckBeCacheGarbledVGen
|
|
|
|
CheckBeFifoSrcTrgMismatch
|
|
CheckBeFifoTrgNotStateRoot
|
|
|
|
# Neighbour vertex, tree traversal `nearbyRight()` and `nearbyLeft()`
|
|
NearbyBeyondRange
|
|
NearbyBranchError
|
|
NearbyDanglingLink
|
|
NearbyEmptyHike
|
|
NearbyExtensionError
|
|
NearbyFailed
|
|
NearbyBranchExpected
|
|
NearbyLeafExpected
|
|
NearbyNestingTooDeep
|
|
NearbyPathTailUnexpected
|
|
NearbyUnexpectedVtx
|
|
NearbyVidInvalid
|
|
|
|
# Deletion of vertices, `delete()`
|
|
DelPathTagError
|
|
DelLeafExpexted
|
|
DelLeafLocked
|
|
DelLeafUnexpected
|
|
DelBranchExpexted
|
|
DelBranchLocked
|
|
DelBranchWithoutRefs
|
|
DelExtLocked
|
|
DelVidStaleVtx
|
|
DelSubTreeTooBig
|
|
DelSubTreeVoidRoot
|
|
DelPathNotFound
|
|
|
|
# Functions from `aristo_filter.nim`
|
|
FilBackendMissing
|
|
FilBackendRoMode
|
|
FilBackStepsExpected
|
|
FilDudeFilterUpdateError
|
|
FilExecDublicateSave
|
|
FilExecHoldExpected
|
|
FilExecOops
|
|
FilExecSaveMissing
|
|
FilExecStackUnderflow
|
|
FilFilterInvalid
|
|
FilFilterNotFound
|
|
FilInxByQidFailed
|
|
FilNegativeEpisode
|
|
FilNilFilterRejected
|
|
FilNoMatchOnFifo
|
|
FilPrettyPointlessLayer
|
|
FilQidByLeFidFailed
|
|
FilQuSchedDisabled
|
|
FilStateRootMismatch
|
|
FilStateRootMissing
|
|
FilTrgSrcMismatch
|
|
FilTrgTopSrcMismatch
|
|
FilSiblingsCommitUnfinshed
|
|
FilSrcTrgInconsistent
|
|
|
|
# Get functions from `aristo_get.nim`
|
|
GetLeafMissing
|
|
GetKeyUpdateNeeded
|
|
|
|
GetLeafNotFound
|
|
GetVtxNotFound
|
|
GetKeyNotFound
|
|
GetFilNotFound
|
|
GetIdgNotFound
|
|
GetFqsNotFound
|
|
|
|
# Fetch functions from `aristo_fetch.nim`
|
|
FetchPathNotFound
|
|
LeafKeyInvalid
|
|
|
|
# RocksDB backend
|
|
RdbBeCantCreateDataDir
|
|
RdbBeCantCreateBackupDir
|
|
RdbBeCantCreateTmpDir
|
|
RdbBeDriverInitError
|
|
RdbBeDriverGetError
|
|
RdbBeDriverDelError
|
|
RdbBeCreateSstWriter
|
|
RdbBeOpenSstWriter
|
|
RdbBeAddSstWriter
|
|
RdbBeFinishSstWriter
|
|
RdbBeIngestSstWriter
|
|
RdbHashKeyExpected
|
|
|
|
# Transaction wrappers
|
|
TxArgStaleTx
|
|
TxBackendNotWritable
|
|
TxNoPendingTx
|
|
TxPendingTx
|
|
TxNotTopTx
|
|
TxStackGarbled
|
|
TxStackUnderflow
|
|
TxGarbledSpan
|
|
|
|
# Functions from `aristo_desc.nim`
|
|
MustBeOnCentre
|
|
NotAllowedOnCentre
|
|
|
|
# Functions from `aristo_utils.nim`
|
|
AccRlpDecodingError
|
|
AccStorageKeyMissing
|
|
AccVtxUnsupported
|
|
AccNodeUnsupported
|
|
PayloadTypeUnsupported
|
|
|
|
# Miscelaneous handy helpers
|
|
AccRootUnacceptable
|
|
MptContextMissing
|
|
MptRootUnacceptable
|
|
NotImplemented
|
|
VidContextLocked
|
|
VidRootMissing
|
|
|
|
# End
|