mirror of
https://github.com/status-im/nimbus-eth1.git
synced 2025-01-10 04:15:54 +00:00
6d132811ba
* Split `core_db/base.nim` into several sources * Rename `core_db/legacy.nim` => `core_db/legacy_db.nim` * Update `CoreDb` API, dual methods returning `Result[]` or plain value detail: Plain value methods implemet the legacy API, they defect on error results * Redesign `CoreDB` direct backend access why: Made the `backend` directive integral part of the API * Discontinue providing unused or otherwise available functions details: + setTransactionID() removed, not used and not easily replicable in Aristo + maybeGet() removed, available via direct backend access + newPhk() removed, never used & was experimental anyway * Update/reorg backend API why: + Added error print function `$$()` + General descriptor completion (and optional validation) via `bless()` * Update `Aristo`/`Kvt` exception handling why: Avoid `CatchableError` exceptions, rather pass them as error code where appropriate. * More `CoreDB` compliant `Aristo` and `Kvt` methods details: + Providing functions like `contains()`, `getVtxRc()` (returns `Result[]`). + Additional error code: `NotImplemented` * Rewrite/reorg of Aristo DB constructor why: Previously used global object `DefaultQidLayoutRef` as default initialiser. This object was created at compile time which lead to non-gc safe functions. * Update nimbus/db/core_db/legacy_db.nim Co-authored-by: Kim De Mey <kim.demey@gmail.com> * Update nimbus/db/aristo/aristo_transcode.nim Co-authored-by: Kim De Mey <kim.demey@gmail.com> * Update nimbus/db/core_db/legacy_db.nim Co-authored-by: Kim De Mey <kim.demey@gmail.com> --------- Co-authored-by: Kim De Mey <kim.demey@gmail.com>
83 lines
2.6 KiB
Nim
83 lines
2.6 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.
|
|
|
|
## Aristo DB -- Obects Retrival Via Traversal Path
|
|
## ===============================================
|
|
##
|
|
{.push raises: [].}
|
|
|
|
import
|
|
eth/trie/nibbles,
|
|
results,
|
|
"."/[aristo_desc, aristo_hike]
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# Private functions
|
|
# ------------------------------------------------------------------------------
|
|
|
|
proc fetchPayloadImpl(
|
|
rc: Result[Hike,(Hike,AristoError)];
|
|
): Result[PayloadRef,(VertexID,AristoError)] =
|
|
if rc.isErr:
|
|
let vid =
|
|
if rc.error[0].legs.len == 0: VertexID(0)
|
|
else: rc.error[0].legs[^1].wp.vid
|
|
return err((vid, rc.error[1]))
|
|
ok rc.value.legs[^1].wp.vtx.lData
|
|
|
|
proc fetchPayloadImpl(
|
|
db: AristoDbRef;
|
|
root: VertexID;
|
|
path: openArray[byte];
|
|
): Result[PayloadRef,(VertexID,AristoError)] =
|
|
path.initNibbleRange.hikeUp(root, db).fetchPayloadImpl
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# Public functions
|
|
# ------------------------------------------------------------------------------
|
|
|
|
proc fetchPayload*(
|
|
db: AristoDbRef;
|
|
key: LeafTie;
|
|
): Result[PayloadRef,(VertexID,AristoError)] =
|
|
## Cascaded attempt to traverse the `Aristo Trie` and fetch the value of a
|
|
## leaf vertex. This function is complementary to `merge()`.
|
|
##
|
|
key.hikeUp(db).fetchPayloadImpl
|
|
|
|
proc fetchPayload*(
|
|
db: AristoDbRef;
|
|
root: VertexID;
|
|
path: openArray[byte];
|
|
): Result[PayloadRef,(VertexID,AristoError)] =
|
|
## Variant of `fetchPayload()`
|
|
##
|
|
if path.len == 0:
|
|
return err((VertexID(0),LeafKeyInvalid))
|
|
db.fetchPayloadImpl(root, path)
|
|
|
|
proc contains*(
|
|
db: AristoDbRef; # Database
|
|
root: VertexID;
|
|
path: openArray[byte]; # Key of database record
|
|
): Result[bool,(VertexID,AristoError)] =
|
|
## Variant of `fetchPayload()`
|
|
##
|
|
if path.len == 0:
|
|
return err((VertexID(0),LeafKeyInvalid))
|
|
let rc = db.fetchPayloadImpl(root, path)
|
|
if rc.isOk:
|
|
return ok(true)
|
|
return ok(false)
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# End
|
|
# ------------------------------------------------------------------------------
|