Struct BlockWriter 

pub struct BlockWriter {
    pub log: Arc<CommutativeLog>,
    pub height: u64,
}

Re-export so callers can use BlockWriter without importing dual_buffer. A write handle scoped to one thread and one block.

Obtained via crate::DonaDbX::writer. Holds a direct Arc to the shard’s current log — no ArcSwap guard is re-acquired on each write, so the hot put() path touches zero shared state beyond the shard’s own write_offset atomic.

Create one BlockWriter per thread at the start of each block and drop it before calling crate::DonaDbX::commit.

Fields

log: Arc<CommutativeLog>

Direct reference to the active shard log for this block.

height: u64

Block height recorded in every record written through this handle.

Implementations

impl BlockWriter

pub fn put(&self, key: [u8; 32], value: &[u8]) -> DbResult<u64>

Append a key-value record to the shard log.

Delegates to CommutativeLog::put_versioned with prev_off = 0; the MVCC chain pointer is patched in during commit_fold_until once the index is consulted.