mirror of
https://github.com/status-im/nimbus-eth1.git
synced 2025-02-11 11:37:01 +00:00
c47f021596
* Disable `TransactionID` related functions from `state_db.nim` why: Functions `getCommittedStorage()` and `updateOriginalRoot()` from the `state_db` module are nowhere used. The emulation of a legacy `TransactionID` type functionality is administratively expensive to provide by `Aristo` (the legacy DB version is only partially implemented, anyway). As there is no other place where `TransactionID`s are used, they will not be provided by the `Aristo` variant of the `CoreDb`. For the legacy DB API, nothing will change. * Fix copyright headers in source code * Get rid of compiler warning * Update Aristo code, remove unused `merge()` variant, export `hashify()` why: Adapt to upcoming `CoreDb` wrapper * Remove synced tx feature from `Aristo` why: + This feature allowed to synchronise transaction methods like begin, commit, and rollback for a group of descriptors. + The feature is over engineered and not needed for `CoreDb`, neither is it complete (some convergence features missing.) * Add debugging helpers to `Kvt` also: Update database iterator, add count variable yield argument similar to `Aristo`. * Provide optional destructors for `CoreDb` API why; For the upcoming Aristo wrapper, this allows to control when certain smart destruction and update can take place. The auto destructor works fine in general when the storage/cache strategy is known and acceptable when creating descriptors. * Add update option for `CoreDb` API function `hash()` why; The hash function is typically used to get the state root of the MPT. Due to lazy hashing, this might be not available on the `Aristo` DB. So the `update` function asks for re-hashing the gurrent state changes if needed. * Update API tracking log mode: `info` => `debug * Use shared `Kvt` descriptor in new Ledger API why: No need to create a new descriptor all the time
115 lines
3.3 KiB
Nim
115 lines
3.3 KiB
Nim
# nimbus-eth1
|
|
# Copyright (c) 2021 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.
|
|
|
|
## Kvt DB -- Common functions
|
|
## ==========================
|
|
##
|
|
{.push raises: [].}
|
|
|
|
import
|
|
eth/common,
|
|
results,
|
|
./kvt_desc/desc_backend,
|
|
./kvt_desc
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# Private helpers
|
|
# ------------------------------------------------------------------------------
|
|
|
|
proc getBE*(
|
|
db: KvtDbRef; # Database
|
|
key: openArray[byte]; # Key of database record
|
|
): Result[Blob,KvtError] =
|
|
## For the argument `key` return the associated value from the backend
|
|
## database if available.
|
|
##
|
|
let be = db.backend
|
|
if not be.isNil:
|
|
return be.getKvpFn key
|
|
err(GetNotFound)
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# Public functions, converters
|
|
# ------------------------------------------------------------------------------
|
|
|
|
proc put*(
|
|
db: KvtDbRef; # Database
|
|
key: openArray[byte]; # Key of database record to store
|
|
data: openArray[byte]; # Value of database record to store
|
|
): Result[void,KvtError] =
|
|
## For the argument `key` associated the argument `data` as value (which
|
|
## will be marked in the top layer cache.)
|
|
if key.len == 0:
|
|
return err(KeyInvalid)
|
|
if data.len == 0:
|
|
return err(DataInvalid)
|
|
|
|
db.top.tab[@key] = @data
|
|
ok()
|
|
|
|
|
|
proc del*(
|
|
db: KvtDbRef; # Database
|
|
key: openArray[byte]; # Key of database record to delete
|
|
): Result[void,KvtError] =
|
|
## For the argument `key` delete the associated value (which will be marked
|
|
## in the top layer cache.)
|
|
if key.len == 0:
|
|
return err(KeyInvalid)
|
|
|
|
let rc = db.getBE(key)
|
|
if rc.isOk:
|
|
db.top.tab[@key] = EmptyBlob
|
|
elif rc.error == GetNotFound:
|
|
db.top.tab.del @key
|
|
else:
|
|
return err(rc.error)
|
|
|
|
ok()
|
|
|
|
# ------------
|
|
|
|
proc get*(
|
|
db: KvtDbRef; # Database
|
|
key: openArray[byte]; # Key of database record
|
|
): Result[Blob,KvtError] =
|
|
## For the argument `key` return the associated value preferably from the
|
|
## top layer, or the database otherwise.
|
|
##
|
|
if key.len == 0:
|
|
return err(KeyInvalid)
|
|
let data = db.top.tab.getOrVoid @key
|
|
if data.isValid:
|
|
return ok(data)
|
|
db.getBE key
|
|
|
|
proc hasKey*(
|
|
db: KvtDbRef; # Database
|
|
key: openArray[byte]; # Key of database record
|
|
): Result[bool,KvtError] =
|
|
## For the argument `key` return the associated value preferably from the
|
|
## top layer, or the database otherwise.
|
|
##
|
|
if key.len == 0:
|
|
return err(KeyInvalid)
|
|
let data = db.top.tab.getOrVoid @key
|
|
if data.isValid:
|
|
return ok(true)
|
|
let rc = db.getBE key
|
|
if rc.isOk:
|
|
return ok(true)
|
|
if rc.error == GetNotFound:
|
|
return ok(false)
|
|
err(rc.error)
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# End
|
|
# ------------------------------------------------------------------------------
|