status-im
/
nimbus-eth1
mirror of https://github.com/status-im/nimbus-eth1.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
nimbus-eth1/nimbus/db/kvt/kvt_desc/desc_error.nim

56 lines
1.2 KiB
Nim
Raw Normal View History

Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
# nimbus-eth1
Added support for namespaces to RocksDb kvstore. (#2066) * Add new RocksNamespaceRef type and remove backups and readonly support from RocksDb KvStore. * Bump nim-rocksdb to fc2ba4a836b6b47ae1b17d1c45801c7e06585e19 * Fix tests. * Fix copyright notice.
2024-03-12 03:04:46 +00:00
# Copyright (c) 2023-2024 Status Research & Development GmbH
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
# 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
KvtError* = enum
NothingSerious = 0
GenericError
GetNotFound
KeyInvalid
DataInvalid
# RocksDB backend
RdbBeCantCreateDataDir
Triggered write event for kvt (#2351) * bump rockdb * Rename `KVT` objects related to filters according to `Aristo` naming details: filter* => delta* roFilter => balancer * Compulsory error handling if `persistent()` fails * Add return code to `reCentre()` why: Might eventually fail if re-centring is blocked. Some logic will be added in subsequent patch sets. * Add column families from earlier session to rocksdb in opening procedure why: All previously used CFs must be declared when re-opening an existing database. * Update `init()` and add rocksdb `reinit()` methods for changing parameters why: Opening a set column families (with different open options) must span at least the ones that are already on disk. * Provide write-trigger-event interface into `Aristo` backend why: This allows to save data from a guest application (think `KVT`) to get synced with the write cycle so the guest and `Aristo` save all atomically. * Use `KVT` with new column family interface from `Aristo` * Remove obsolete guest interface * Implement `KVT` piggyback on `Aristo` backend * CoreDb: Add separate `KVT`/`Aristo` backend mode for debugging * Remove `rocks_db` import from `persist()` function why: Some systems (i.p `fluffy` and friends) use the `Aristo` memory backend emulation and do not link against rocksdb when building the application. So this should fix that problem.
2024-06-13 18:15:11 +00:00
RdbBeDelayedAlreadyRegistered
RdbBeDelayedLocked
RdbBeDelayedNotReady
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
RdbBeDriverDelError
Aristo update rocksdb backend drivers (#2135) * Aristo+RocksDB: Update backend drivers why: RocksDB update allows use some of the newly provided methods which were previously implemented by using the very C backend (for the lack of NIM methods.) * Aristo+RocksDB: Simplify drivers wrapper * Kvt: Update backend drivers and wrappers similar to `Aristo` * Aristo+Kvm: Use column families for RocksDB * Aristo+MemoryDB: Code cosmetics * Aristo: Provide guest column family for export why: So `Kvt` can piggyback on `Aristo` so there avoiding to run a second DBMS system in parallel. * Kvt: Provide import mechanism for RoksDB guest column family why: So `Kvt` can piggyback on `Aristo` so there avoiding to run a second DBMS system in parallel. * CoreDb+Aristo: Run persistent `Kvt` DB piggybacked on `Aristo` why: Avoiding to run two DBMS systems in parallel. * Fix copyright year * Ditto
2024-04-16 20:39:11 +00:00
RdbBeDriverGetError
RdbBeDriverInitError
RdbBeDriverPutError
RdbBeDriverWriteError
Triggered write event for kvt (#2351) * bump rockdb * Rename `KVT` objects related to filters according to `Aristo` naming details: filter* => delta* roFilter => balancer * Compulsory error handling if `persistent()` fails * Add return code to `reCentre()` why: Might eventually fail if re-centring is blocked. Some logic will be added in subsequent patch sets. * Add column families from earlier session to rocksdb in opening procedure why: All previously used CFs must be declared when re-opening an existing database. * Update `init()` and add rocksdb `reinit()` methods for changing parameters why: Opening a set column families (with different open options) must span at least the ones that are already on disk. * Provide write-trigger-event interface into `Aristo` backend why: This allows to save data from a guest application (think `KVT`) to get synced with the write cycle so the guest and `Aristo` save all atomically. * Use `KVT` with new column family interface from `Aristo` * Remove obsolete guest interface * Implement `KVT` piggyback on `Aristo` backend * CoreDb: Add separate `KVT`/`Aristo` backend mode for debugging * Remove `rocks_db` import from `persist()` function why: Some systems (i.p `fluffy` and friends) use the `Aristo` memory backend emulation and do not link against rocksdb when building the application. So this should fix that problem.
2024-06-13 18:15:11 +00:00
RdbBeHostError
RdbBeHostNotApplicable
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
# Transaction wrappers
TxArgStaleTx
TxBackendNotWritable
Kvt remodel tx and forked descriptors (#2168) * Aristo: Generalise alien/guest interface for piggiback on database * Aristo: Code cosmetics * CoreDb+Kvt: Update transaction API why: Use single addressable function `forkTx(backLevel: int)` as used in `Aristo`. So `Kvt` can be synced simultaneously to `Aristo`. also: Refactored `kvt_tx.nim` in a similar fashion to `Aristo`. * Kvt: Replace `LayerDelta` object by reference why: Will be needed when introducing filters * Kvt: Remodel backend filter facility similar to `Aristo` why: This allows to operate on several KVT instances simultaneously. * CoreDb+Kvt: Fix on-disk storage why: Overlooked name change: `stow()` => `persist()` for permanent storage * Fix copyright headers
2024-05-07 19:59:27 +00:00
TxLevelTooDeep
TxLevelUseless
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
TxNoPendingTx
TxNotTopTx
Kvt remodel tx and forked descriptors (#2168) * Aristo: Generalise alien/guest interface for piggiback on database * Aristo: Code cosmetics * CoreDb+Kvt: Update transaction API why: Use single addressable function `forkTx(backLevel: int)` as used in `Aristo`. So `Kvt` can be synced simultaneously to `Aristo`. also: Refactored `kvt_tx.nim` in a similar fashion to `Aristo`. * Kvt: Replace `LayerDelta` object by reference why: Will be needed when introducing filters * Kvt: Remodel backend filter facility similar to `Aristo` why: This allows to operate on several KVT instances simultaneously. * CoreDb+Kvt: Fix on-disk storage why: Overlooked name change: `stow()` => `persist()` for permanent storage * Fix copyright headers
2024-05-07 19:59:27 +00:00
TxPendingTx
Triggered write event for kvt (#2351) * bump rockdb * Rename `KVT` objects related to filters according to `Aristo` naming details: filter* => delta* roFilter => balancer * Compulsory error handling if `persistent()` fails * Add return code to `reCentre()` why: Might eventually fail if re-centring is blocked. Some logic will be added in subsequent patch sets. * Add column families from earlier session to rocksdb in opening procedure why: All previously used CFs must be declared when re-opening an existing database. * Update `init()` and add rocksdb `reinit()` methods for changing parameters why: Opening a set column families (with different open options) must span at least the ones that are already on disk. * Provide write-trigger-event interface into `Aristo` backend why: This allows to save data from a guest application (think `KVT`) to get synced with the write cycle so the guest and `Aristo` save all atomically. * Use `KVT` with new column family interface from `Aristo` * Remove obsolete guest interface * Implement `KVT` piggyback on `Aristo` backend * CoreDb: Add separate `KVT`/`Aristo` backend mode for debugging * Remove `rocks_db` import from `persist()` function why: Some systems (i.p `fluffy` and friends) use the `Aristo` memory backend emulation and do not link against rocksdb when building the application. So this should fix that problem.
2024-06-13 18:15:11 +00:00
TxPersistDelayed
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
TxStackGarbled
TxStackUnderflow
Kvt remodel tx and forked descriptors (#2168) * Aristo: Generalise alien/guest interface for piggiback on database * Aristo: Code cosmetics * CoreDb+Kvt: Update transaction API why: Use single addressable function `forkTx(backLevel: int)` as used in `Aristo`. So `Kvt` can be synced simultaneously to `Aristo`. also: Refactored `kvt_tx.nim` in a similar fashion to `Aristo`. * Kvt: Replace `LayerDelta` object by reference why: Will be needed when introducing filters * Kvt: Remodel backend filter facility similar to `Aristo` why: This allows to operate on several KVT instances simultaneously. * CoreDb+Kvt: Fix on-disk storage why: Overlooked name change: `stow()` => `persist()` for permanent storage * Fix copyright headers
2024-05-07 19:59:27 +00:00
# Filter management
FilBackendMissing
FilBackendRoMode
FilSiblingsCommitUnfinshed
Core db aristo and kvt updates preparing for integration (#1760) * Kvt: Implemented multi-descriptor access on the same backend why: This behaviour mirrors the one of Aristo and can be used for simultaneous transactions on Aristo + Kvt * Kvt: Update database iterators why: Forgot to run on the top layer first * Kvt: Misc fixes * Aristo, use `openArray[byte]` rather than `Blob` in prototype * Aristo, by default hashify right after cloning descriptor why: Typically, a completed descriptor is expected after cloning. Hashing can be suppressed by argument flag. * Aristo provides `replicate()` iterator, similar to legacy `replicate()` * Aristo API fixes and updates * CoreDB: Rename `legacy_persistent` => `legacy_rocksdb` why: More systematic, will be in line with Aristo DB which might have more than one persistent backends * CoreDB: Prettify API sources why: Better to read and maintain details: Annotating with custom pragmas which cleans up the prototypes * CoreDB: Update MPT/put() prototype allowing `CatchableError` why: Will be needed for Aristo API (legacy is OK with `RlpError`)
2023-09-18 20:20:28 +00:00
# Functions from `kvt_desc`
MustBeOnCentre
NotAllowedOnCentre
Core db simplify new api storage modes (#2075) * Aristo+Kvt: Fix backend `dup()` function in api setup why: Backend object is subject to an inheritance cascade which was not taken care of, before. Only the base object was duplicated. * Kvt: Simplify DB clone/peers management * Aristo: Simplify DB clone/peers management * Aristo: Adjust unit test for working with memory DB only why: This currently causes some memory corruption persumably in the `libc` background layer. * CoredDb+Kvt: Simplify API for KVT why: Simplified storage models (was over engineered) for better performance and code maintenance. * CoredDb+Aristo: Simplify API for `Aristo` why: Only single database state needed here. Accessing a similar state will be implemented from outside this module using a context layer. This gives better performance and improves code maintenance. * Fix Copyright headers * CoreDb: Turn off API tracking why: CI would ot go through. Was accidentally turned on.
2024-03-14 22:17:43 +00:00
StaleDescriptor
Core db aristo and kvt updates preparing for integration (#1760) * Kvt: Implemented multi-descriptor access on the same backend why: This behaviour mirrors the one of Aristo and can be used for simultaneous transactions on Aristo + Kvt * Kvt: Update database iterators why: Forgot to run on the top layer first * Kvt: Misc fixes * Aristo, use `openArray[byte]` rather than `Blob` in prototype * Aristo, by default hashify right after cloning descriptor why: Typically, a completed descriptor is expected after cloning. Hashing can be suppressed by argument flag. * Aristo provides `replicate()` iterator, similar to legacy `replicate()` * Aristo API fixes and updates * CoreDB: Rename `legacy_persistent` => `legacy_rocksdb` why: More systematic, will be in line with Aristo DB which might have more than one persistent backends * CoreDB: Prettify API sources why: Better to read and maintain details: Annotating with custom pragmas which cleans up the prototypes * CoreDB: Update MPT/put() prototype allowing `CatchableError` why: Will be needed for Aristo API (legacy is OK with `RlpError`)
2023-09-18 20:20:28 +00:00
Simple stupid key-value table companion for Aristo DB (#1746) why: Additional tables needed for the `CoreDB` object with separate key-value table and MPT. details: + Stripped down copy of Aristo DB to have a similar look'n feel. Otherwise it is just a posh way for accessing `Table` objects or `RocksDB` data. + No unit tests yet, will be tested on the go.
2023-09-12 18:44:45 +00:00
# End