Struct Nomt 

pub struct Nomt<T> { /* private fields */ }

An instance of the Nearly-Optimal Merkle Trie Database.

Implementations

impl<T: HashAlgorithm> Nomt<T>

pub fn open(o: Options) -> Result<Self>

Open the database with the given options.

It is recommended to check io_uring permissions before calling this function by calling check_iou_permissions

pub fn root(&self) -> Root

Returns a recent root of the trie.

pub fn is_empty(&self) -> bool

Returns true if the trie has no items in it.

pub fn is_poisoned(&self) -> bool

Whether the database is poisoned.

A database becomes poisoned when an error occurred during a commit operation.

From this point on, the database is in an inconsistent state and should be considered read-only. Any further modifying operations will return an error.

In order to recover from a poisoned database, the application should discard this instance and create a new one.

pub fn begin_session(&self, params: SessionParams) -> Session<T>

Create a new Session object with the given parameters.

This will block if there are any ongoing commits or rollbacks. Multiple sessions may coexist.

The Session is a read-only handle on the database and is used to create a changeset to be applied to the database. Sessions provide read interfaces and additionally coordinate work such as proving and rollback preimages which make committing more efficient.

There may be multiple sessions live, though the existence of an outstanding session will prevent writes to the database. Sessions are the main way of reading to the database, and permit a changeset to be committed either directly to the database or into an in-memory Overlay.

pub fn rollback(&self, n: usize) -> Result<()>

Perform a rollback of the last n commits.

This function will block until all ongoing commits or Sessions are finished.

Fails if the DB is not configured for rollback or doesn’t have enough commits logged to rollback.

pub fn hash_table_utilization(&self) -> HashTableUtilization

Get the hash-table space utilization.