mirror of
https://github.com/status-im/nimbus-eth1.git
synced 2025-02-03 07:45:18 +00:00
61bbf40014
* Tighten `CoreDb` API for accounts why: Apart from cruft, the way to fetch the accounts state root via a `CoreDbColRef` record was unnecessarily complicated. * Extend `CoreDb` API for accounts to cover storage tries why: In future, this will make the notion of column objects obsolete. Storage trees will then be indexed by the account address rather than the vertex ID equivalent like a `CoreDbColRef`. * Apply new/extended accounts API to ledger and tests details: This makes the `distinct_ledger` module obsolete * Remove column object constructors why: They were needed as an abstraction of MPT sub-trees including storage trees. Now, storage trees are handled by the account (e.g. via address) they belong to and all other trees can be identified by a constant well known vertex ID. So there is no need for column objects anymore. Still there are some left-over column object methods wnich will be removed next. * Remove `serialise()` and `PayloadRef` from default Aristo API why: Not needed. `PayloadRef` was used for unstructured/unknown payload formats (account or blob) and `serialise()` was used for decodng `PayloadRef`. Now it is known in advance what the payload looks like. * Added query function `hasStorageData()` whether a storage area exists why: Useful for supporting `slotStateEmpty()` of the `CoreDb` API * In the `Ledger` replace `storage.stateEmpty()` by `slotStateEmpty()` * On Aristo, hide the storage root/vertex ID in the `PayloadRef` why: The storage vertex ID is fully controlled by Aristo while the `AristoAccount` object is controlled by the application. With the storage root part of the `AristoAccount` object, there was a useless administrative burden to keep that storage root field up to date. * Remove cruft, update comments etc. * Update changed MPT access paradigms why: Fixes verified proxy tests * Fluffy cosmetics
309 lines
7.0 KiB
Nim
309 lines
7.0 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
|
|
|
|
# Miscelaneous/unclassified handy helpers
|
|
GenericError
|
|
|
|
AccRootUnacceptable
|
|
MptRootUnacceptable
|
|
MptRootMissing
|
|
NotImplemented
|
|
TrieInvalid
|
|
|
|
|
|
# Data record transcoders, `deblobify()` and `blobify()`
|
|
BlobifyBranchMissingRefs
|
|
BlobifyExtMissingRefs
|
|
BlobifyExtPathOverflow
|
|
BlobifyLeafPathOverflow
|
|
BlobifyNilFilter
|
|
BlobifyNilVertex
|
|
BlobifyStateSrcLenGarbled
|
|
BlobifyStateTrgLenGarbled
|
|
|
|
|
|
# Cache checker `checkCache()`
|
|
CheckAnyVidDeadStorageRoot
|
|
CheckAnyVidSharedStorageRoot
|
|
CheckAnyVtxEmptyKeyMissing
|
|
CheckAnyVtxEmptyKeyExpected
|
|
CheckAnyVtxEmptyKeyMismatch
|
|
CheckAnyVtxBranchLinksMissing
|
|
CheckAnyVtxExtPfxMissing
|
|
CheckAnyVtxLockWithoutKey
|
|
CheckAnyVTopUnset
|
|
|
|
CheckBeCacheGarbledVTop
|
|
CheckBeCacheIsDirty
|
|
CheckBeCacheKeyCantCompile
|
|
CheckBeCacheKeyDangling
|
|
CheckBeCacheKeyMismatch
|
|
CheckBeCacheKeyMissing
|
|
CheckBeCacheKeyNonEmpty
|
|
CheckBeCacheVidUnsynced
|
|
CheckBeCacheVtxDangling
|
|
CheckBeFifoSrcTrgMismatch
|
|
CheckBeFifoTrgNotStateRoot
|
|
CheckBeGarbledVTop
|
|
CheckBeKeyCantCompile
|
|
CheckBeKeyInvalid
|
|
CheckBeKeyMismatch
|
|
CheckBeKeyMissing
|
|
CheckBeVtxBranchLinksMissing
|
|
CheckBeVtxExtPfxMissing
|
|
CheckBeVtxInvalid
|
|
CheckBeVtxMissing
|
|
|
|
CheckStkKeyStrayZeroEntry
|
|
CheckStkVtxIncomplete
|
|
CheckStkVtxKeyMismatch
|
|
CheckStkVtxKeyMissing
|
|
|
|
CheckRlxVidVtxMismatch
|
|
CheckRlxVtxIncomplete
|
|
CheckRlxVtxKeyMissing
|
|
CheckRlxVtxKeyMismatch
|
|
|
|
|
|
# De-serialiser from `blobify.nim`
|
|
DeblobNilArgument
|
|
DeblobUnknown
|
|
DeblobVtxTooShort
|
|
DeblobHashKeyExpected
|
|
DeblobBranchTooShort
|
|
DeblobBranchSizeGarbled
|
|
DeblobBranchInxOutOfRange
|
|
DeblobExtTooShort
|
|
DeblobExtSizeGarbled
|
|
DeblobExtGotLeafPrefix
|
|
DeblobLeafSizeGarbled
|
|
DeblobLeafGotExtPrefix
|
|
DeblobSizeGarbled
|
|
DeblobWrongType
|
|
DeblobWrongSize
|
|
DeblobPayloadTooShortInt64
|
|
DeblobPayloadTooShortInt256
|
|
DeblobNonceLenUnsupported
|
|
DeblobBalanceLenUnsupported
|
|
DeblobStorageLenUnsupported
|
|
DeblobCodeLenUnsupported
|
|
DeblobFilterTooShort
|
|
DeblobFilterGenTooShort
|
|
DeblobFilterTrpTooShort
|
|
DeblobFilterTrpVtxSizeGarbled
|
|
DeblobFilterSizeGarbled
|
|
|
|
|
|
# Deletion of vertex paths, `deleteXxx()`
|
|
DelAccRootNotAccepted
|
|
DelBranchExpexted
|
|
DelBranchLocked
|
|
DelBranchWithoutRefs
|
|
DelDanglingStoTrie
|
|
DelExtLocked
|
|
DelLeafExpexted
|
|
DelLeafLocked
|
|
DelLeafUnexpected
|
|
DelPathNotFound
|
|
DelPathTagError
|
|
DelRootVidMissing
|
|
DelStoAccMissing
|
|
DelStoRootMissing
|
|
DelStoRootNotAccepted
|
|
DelSubTreeAccRoot
|
|
DelSubTreeVoidRoot
|
|
DelVidStaleVtx
|
|
|
|
|
|
# Functions from `aristo_desc.nim`
|
|
DescMustBeOnCentre
|
|
DescNotAllowedOnCentre
|
|
DescStaleDescriptor
|
|
|
|
|
|
# Functions from `aristo_filter.nim`
|
|
FilBackendMissing
|
|
FilBackendRoMode
|
|
FilNilFilterRejected
|
|
FilSiblingsCommitUnfinshed
|
|
FilSrcTrgInconsistent
|
|
FilStateRootMismatch
|
|
FilTrgSrcMismatch
|
|
|
|
|
|
# Fetch functions from `aristo_fetch.nim`
|
|
FetchAccInaccessible
|
|
FetchAccPathWithoutLeaf
|
|
FetchAccRootNotAccepted
|
|
FetchLeafKeyInvalid
|
|
FetchPathInvalid
|
|
FetchPathNotFound
|
|
FetchRootVidMissing
|
|
FetchStoRootNotAccepted
|
|
|
|
|
|
# Get functions from `aristo_get.nim`
|
|
GetFilNotFound
|
|
GetFqsNotFound
|
|
GetKeyNotFound
|
|
GetKeyUpdateNeeded
|
|
GetLstNotFound
|
|
GetTuvNotFound
|
|
GetVtxNotFound
|
|
|
|
|
|
# Update `Merkle` hashes `hashify()`
|
|
HashifyVtxUnresolved
|
|
HashifyRootVtxUnresolved
|
|
HashifyProofHashMismatch
|
|
|
|
|
|
# Path function `hikeUp()`
|
|
HikeBranchMissingEdge
|
|
HikeBranchTailEmpty
|
|
HikeDanglingEdge
|
|
HikeEmptyPath
|
|
HikeExtMissingEdge
|
|
HikeExtTailEmpty
|
|
HikeExtTailMismatch
|
|
HikeLeafUnexpected
|
|
HikeNoLegs
|
|
HikeRootMissing
|
|
|
|
|
|
# Merge leaf `merge()`
|
|
MergeAssemblyFailed # Ooops, internal error
|
|
MergeAccRootNotAccepted
|
|
MergeStoRootNotAccepted
|
|
MergeBranchGarbledNibble
|
|
MergeBranchGarbledTail
|
|
MergeBranchLinkLeafGarbled
|
|
MergeBranchLinkVtxPfxTooShort
|
|
MergeBranchProofModeLock
|
|
MergeBranchRootExpected
|
|
MergeHashKeyDiffersFromCached
|
|
MergeHashKeyInvalid
|
|
MergeLeafGarbledHike
|
|
MergeLeafPathCachedAlready
|
|
MergeLeafPathOnBackendAlready
|
|
MergeLeafProofModeLock
|
|
MergeLeafTypeAccountRequired
|
|
MergeLeafTypeRawDataRequired
|
|
MergeNodeAccountPayloadError
|
|
MergeNodeVidMissing
|
|
MergeNodeVtxDiffersFromExisting
|
|
MergeNonBranchProofModeLock
|
|
MergeProofInitMissing
|
|
MergeRevVidMustHaveBeenCached
|
|
MergeRootArgsIncomplete
|
|
MergeRootBranchLinkBusy
|
|
MergeRootKeyDiffersForVid
|
|
MergeRootKeyInvalid
|
|
MergeRootKeyMissing
|
|
MergeRootKeyNotInProof
|
|
MergeRootKeysMissing
|
|
MergeRootKeysOverflow
|
|
MergeRootVidMissing
|
|
MergeStoAccMissing
|
|
|
|
|
|
# Neighbour vertex, tree traversal `nearbyRight()` and `nearbyLeft()`
|
|
NearbyBeyondRange
|
|
NearbyBranchError
|
|
NearbyDanglingLink
|
|
NearbyEmptyHike
|
|
NearbyExtensionError
|
|
NearbyFailed
|
|
NearbyBranchExpected
|
|
NearbyLeafExpected
|
|
NearbyNestingTooDeep
|
|
NearbyPathTailUnexpected
|
|
NearbyUnexpectedVtx
|
|
NearbyVidInvalid
|
|
|
|
|
|
# Path/nibble/key conversions in `aisto_path.nim`
|
|
PathExpected64Nibbles
|
|
PathAtMost64Nibbles
|
|
PathExpectedLeaf
|
|
|
|
|
|
# RocksDB backend
|
|
RdbBeCantCreateDataDir
|
|
RdbBeCantCreateTmpDir
|
|
RdbBeDriverDelAdmError
|
|
RdbBeDriverDelKeyError
|
|
RdbBeDriverDelVtxError
|
|
RdbBeDriverGetAdmError
|
|
RdbBeDriverGetKeyError
|
|
RdbBeDriverGetVtxError
|
|
RdbBeDriverGuestError
|
|
RdbBeDriverPutAdmError
|
|
RdbBeDriverPutKeyError
|
|
RdbBeDriverPutVtxError
|
|
RdbBeDriverWriteError
|
|
RdbBeTypeUnsupported
|
|
RdbBeWrSessionUnfinished
|
|
RdbBeWrTriggerActiveAlready
|
|
RdbBeWrTriggerNilFn
|
|
RdbGuestInstanceAborted
|
|
RdbGuestInstanceUnsupported
|
|
RdbHashKeyExpected
|
|
|
|
|
|
# Rlp decoder, `read()`
|
|
Rlp2Or17ListEntries
|
|
RlpBlobExpected
|
|
RlpBranchHashKeyExpected
|
|
RlpEmptyBlobExpected
|
|
RlpExtHashKeyExpected
|
|
RlpHashKeyExpected
|
|
RlpNonEmptyBlobExpected
|
|
RlpOtherException
|
|
RlpRlpException
|
|
|
|
|
|
# Serialise decoder
|
|
SerCantResolveStorageRoot
|
|
|
|
|
|
# Transaction wrappers
|
|
TxAccRootMissing
|
|
TxArgStaleTx
|
|
TxArgsUseless
|
|
TxBackendNotWritable
|
|
TxLevelTooDeep
|
|
TxLevelUseless
|
|
TxNoPendingTx
|
|
TxNotFound
|
|
TxNotTopTx
|
|
TxPendingTx
|
|
TxPrettyPointlessLayer
|
|
TxStackGarbled
|
|
TxStackUnderflow
|
|
TxStateRootMismatch
|
|
|
|
|
|
# Functions from `aristo_utils.nim`
|
|
UtilsAccLeafPayloadExpected
|
|
UtilsAccNodeUnsupported
|
|
UtilsAccPathMissing
|
|
UtilsAccStorageKeyMissing
|
|
UtilsAccVtxUnsupported
|
|
UtilsAccWrongStorageRoot
|
|
UtilsPayloadTypeUnsupported
|
|
UtilsStoRootMissing
|
|
|
|
# End
|