Struct JsonlReceiptLog 

pub struct JsonlReceiptLog { /* private fields */ }

JSON-Lines, append-only ReceiptLog backed by a single rotating file under data_dir.

One File handle is held open for the process lifetime behind a Mutex so concurrent delivery streams cannot interleave partial lines. The handle is opened in append mode (O_APPEND), so even across the (already serialized) writes each write_all lands at the current end of file. Rotation (issue #802) swaps that handle under the same lock; see the module-level rotation note.

Implementations

impl JsonlReceiptLog

pub fn open(data_dir: &Path, policy: RotationPolicy) -> Result<Self>

Open (or create) the receipt log under data_dir with rotation policy.

The file is opened in append mode and, on Unix, created with mode 0o600; an existing file’s mode is tightened to 0o600 as defense-in-depth (idempotent — skipped when already correct, so a read-only mount with the right mode does not brick startup). The in-memory rotation counter is seeded from the existing file length so a log that is already near the cap rotates on the next append rather than only after a full cap’s worth of fresh writes.

Unlike crate::channel_store::PersistentPoolStateStore::open, a failure here is not required to abort node bring-up: the receipt log is an audit artifact, not the #527 replay guard. The runtime decides the fatality (it currently logs and continues without the audit log).

Errors

Returns a std::io::Error if the file cannot be opened/created, its mode cannot be tightened, or its current length cannot be read.

pub fn path(&self) -> &Path

Filesystem path of the underlying (live) log file. Useful for operator log lines and runbooks.

Trait Implementations

impl Debug for JsonlReceiptLog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ReceiptLog for JsonlReceiptLog

fn append(&self, receipt: &DownloadReceipt) -> Result<()>

Durably-enough append one receipt (write + flush, no fsync).