update docs

Author: haxjump

README.md

@@ -1,6 +1,6 @@
 ![GitHub top language](https://img.shields.io/github/languages/top/rust-util-collections/vsdb)
 [![Rust](https://github.com/rust-util-collections/vsdb/actions/workflows/rust.yml/badge.svg)](https://github.com/rust-util-collections/vsdb/actions/workflows/rust.yml)
-[![Minimum rustc version](https://img.shields.io/badge/rustc-1.89+-lightgray.svg)](https://github.com/rust-random/rand#rust-version-requirements)
+[![Minimum rustc version](https://img.shields.io/badge/rustc-1.85+-lightgray.svg)](https://github.com/rust-random/rand#rust-version-requirements)
 
 # vsdb
 

core/README.md

@@ -20,7 +20,7 @@ Add this to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-vsdb_core = "5.0.1"
+vsdb_core = "6.0.0"
 ```
 
 ## Features

utils/slot_db/README.md

@@ -15,7 +15,7 @@ Add this to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-vsdb_slot_db = "5.0.1"
+vsdb_slot_db = "6.0.0"
 ```
 
 ## Usage

utils/trie_db/README.md

@@ -15,7 +15,7 @@ Add this to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-vsdb_trie_db = "5.0.1"
+vsdb_trie_db = "6.0.1"
 ```
 
 ## Usage
@@ -28,26 +28,33 @@ For more detailed API examples, see [API Examples](docs/api.md).
 use vsdb_trie_db::MptStore;
 
 // Create a new MptStore
-let mut store = MptStore::new();
+let store = MptStore::new();
 
-// Initialize a new trie with a unique backend key
-let mut trie = store.trie_init(b"my_app_state").unwrap();
+// Initialize a new trie (starts with an empty root)
+let mut trie = store.trie_init();
 
-// Insert a key-value pair
+// Insert key-value pairs (automatically commits)
 trie.insert(b"key1", b"value1").unwrap();
+trie.insert(b"key2", b"value2").unwrap();
 
-// Commit the changes to persist them and get a new state root
-let mut trie = trie.commit().unwrap();
+// Get the current root hash
 let root = trie.root();
 
-// Retrieve the value using the latest trie instance
+// Retrieve values
 let value = trie.get(b"key1").unwrap().unwrap();
 assert_eq!(value, b"value1");
 
-// Create a read-only handle to the trie at a specific root
-let ro_trie = trie.ro_handle(root).unwrap();
-let value = ro_trie.get(b"key1").unwrap().unwrap();
+// Load an existing trie from a root hash
+let loaded_trie = store.trie_load(&root);
+let value = loaded_trie.get(b"key1").unwrap().unwrap();
 assert_eq!(value, b"value1");
+
+// Batch update operations
+let ops = vec![
+    (b"key3".as_ref(), Some(b"value3".as_ref())),
+    (b"key1".as_ref(), None), // Remove key1
+];
+trie.batch_update(&ops).unwrap();
 ```
 
 ## License

utils/trie_db/docs/api.md

@@ -4,30 +4,45 @@ This document provides examples for the public APIs in the `vsdb_trie_db` crate.
 
 ## MptStore
 
-`MptStore` provides an out-of-the-box wrapper for the `trie-db` crate, backed by `vsdb`.
+`MptStore` provides a high-level wrapper for managing Merkle Patricia Tries with persistent storage.
 
 ```rust
 use vsdb_trie_db::MptStore;
 
 // Create a new MptStore
-let mut store = MptStore::new();
+let store = MptStore::new();
 
-// Initialize a new trie with a backend key
-let mut trie = store.trie_init(b"my_trie").unwrap();
+// Initialize a new trie (starts with an empty root)
+let mut trie = store.trie_init();
 
-// Insert a key-value pair
+// Insert key-value pairs (automatically commits)
 trie.insert(b"key1", b"value1").unwrap();
+trie.insert(b"key2", b"value2").unwrap();
 
-// Commit the changes to the trie
-let mut trie = trie.commit().unwrap();
+// Get the current root hash
 let root = trie.root();
 
-// Retrieve the value
+// Retrieve values
 let value = trie.get(b"key1").unwrap().unwrap();
 assert_eq!(value, b"value1");
 
-// Create a read-only handle to the trie at a specific root
-let ro_trie = trie.ro_handle(root).unwrap();
-let value = ro_trie.get(b"key1").unwrap().unwrap();
+// Load an existing trie from a root hash
+let loaded_trie = store.trie_load(&root);
+let value = loaded_trie.get(b"key1").unwrap().unwrap();
 assert_eq!(value, b"value1");
+
+// Remove a key
+trie.remove(b"key2").unwrap();
+assert!(trie.get(b"key2").unwrap().is_none());
+
+// Batch update operations
+let ops = vec![
+    (b"key3".as_ref(), Some(b"value3".as_ref())), // Insert
+    (b"key1".as_ref(), None),                       // Remove
+];
+trie.batch_update(&ops).unwrap();
+
+// Verify changes
+assert!(trie.get(b"key1").unwrap().is_none());
+assert_eq!(trie.get(b"key3").unwrap().unwrap(), b"value3");
 ```

wrappers/README.md

@@ -17,7 +17,7 @@ Add this to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-vsdb = "5.0.1"
+vsdb = "6.0.0"
 ```
 
 ## Highlights