Skip to main content

Module pair

Module pair 

Source
Expand description

Durable pairing of network operation, graph/artifact effect, and receipt.

One owner binds three things under one SHA-384 operation_id: the CORE-03 IntentTable intent, the exact effect bytes, and the ReceiptClass. Transport ACK is never a durable receipt.

§Crash / finality (CORE-03 IntentTable contract)

Pairing is the in-memory CORE-03 intent contract. It does not claim OS process-kill disk durability. crate::net::peer::replication::crash::disk_backend_crash_injected is false.

  • Identity-only after crash before effect: restart exposes a bound operation identity. Receipt class is ReceiptClass::Identity, not durable.
  • Effect without commit: local effect may be recorded. Receipt class stays ReceiptClass::Effect. Not durable.
  • Commit without durable ACK: recover as durable only if a commit marker is present in the recovered stream. This module does not invent a durable receipt from a live ACK. A commit marker is the durability evidence recover_pair re-applies.
  • Aborted or incomplete markers: not durable.

Restart that replays a commit marker plus a matching effect digest can re-apply DeliveryStage::DurableApplied. Transport ACK after any of these stages remains Identity or Effect.

Structs§

DurablePairing
Network operation + exact effect + receipt class under one operation id.

Functions§

commit_pair
Commit the staged intent, then ACK DeliveryStage::DurableApplied.
recover_pair
Rebuild receipt class from a CORE-03 marker stream.
stage_paired
Stage intent + identity + local effect. Does not mark ReceiptClass::DurableReceipt.