vsdb_core

vsdb_core provides the low-level building blocks for vsdb.

This crate contains the foundational components of vsdb, including:

• Storage Abstractions: An Engine trait that abstracts over key-value storage backends.
• Raw Data Structures: Untyped, high-performance data structures like MapxRaw that operate on raw bytes.
• Utilities: Shared functions for environment management, such as setting the database directory.

Most users should use the vsdb crate instead, which provides high-level, typed APIs.

Installation

Add this to your Cargo.toml:

[dependencies]
vsdb_core = "5.0.1"

Features

For detailed API examples, see API Examples.

• parity_backend: (Default) Use parity-db as the backend database. Pure Rust implementation.
• rocks_backend: Use rocksdb as the backend database. C++ implementation.
• compress: Enable data compression in the backend database.

Known Issues

• The len() of a data structure is not always guaranteed to be absolutely reliable and should be treated as a hint. This is because some operations may not update the length atomically in real-time for performance reasons.

License

This project is licensed under the GPL-3.0 license.