Struct WriteTxn 

pub struct WriteTxn<'g> { /* private fields */ }

RAII owner of the single graph write lock.

Since v1.2 (BRIEF 1) the transaction no longer holds the snapshot cell, schema-version, or provider handles — those moved to the single committer thread, which the transaction reaches via the cheap Committer submit handle. The transaction still owns the write lock + allocator guards for the duration of execution and releases them when seal consumes it.

Implementations

impl<'g> WriteTxn<'g>

pub fn mutator(&mut self) -> Mutator<'_, 'g>

Borrow a mutator tied to this transaction.

pub fn read(&self) -> &SeleneGraph

Borrow the transaction-local working graph.

pub fn commit(self) -> GraphResult<CommitOutcome>

Commit without caller principal bytes.

pub fn commit_with_principal( self, principal: Option<Arc<[u8]>>, ) -> GraphResult<CommitOutcome>

Commit with optional caller-owned principal bytes for D12 audit replay.

Since v1.2 (BRIEF 1) commit is seal-and-handover: this method runs seal on the calling thread (generation/meta bump + GG02 validation under the write lock, then lock release), then submits the resulting SealedCommit to the per-graph single committer thread and blocks until it is durable + visible. The public contract is unchanged — “commit() returns ⇒ durable + visible” — only the internal threading model differs.

GG02 closed-graph violations still abort here, on the calling thread, before any handoff, so error timing is identical to v1.0/v1.1.

Registered index providers are notified by the committer after the new snapshot is published; the same-thread re-entrancy guard now protects the committer thread (one committer ⇒ still sound). Same-thread re-entrant provider calls into SharedGraph::begin_write() are detected via the thread-local fanout counter and panic with a clear message; the committer’s fan-out boundary catches those panics (along with callback-internal panics and returned errors) so a single misbehaving provider can never crash the committer thread.

Errors

Returns the GG02 / validation error from seal, or a GraphError::Durable if the WAL append failed or the committer thread is no longer running.

pub fn rollback(self)

Roll back graph changes via Drop and release the write lock.

pub fn change_count(&self) -> usize

Number of changes accumulated since this transaction opened.

pub fn has_schema_changes(&self) -> bool

Whether this transaction has accumulated schema-changing work.

Trait Implementations

impl Drop for WriteTxn<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.