Struct PadPool 

pub struct PadPool { /* private fields */ }

A shared, pre-provisioned pool of true random bytes for one pad epoch, split into two directional halves. Both peers build an identical pool from the same out-of-band material and split it the same way, so each direction is a private, agreed pad both sides index into.

Implementations

impl PadPool

pub fn shared(pad: Vec<u8>) -> Result<PadPool, PadError>

Build a pool from shared true-random material, refusing it (fail-closed) if it is too small to split or if the logicaffeine_proof::ait classifier finds it compressible — i.e. it is not actually random. This is the pad-quality gate: a weak pad is never silently accepted.

pub fn shared_unchecked(pad: Vec<u8>) -> PadPool

Build a pool without the incompressibility gate — for trusted provisioning that has already validated the material, and for tests that craft pad contents directly.

pub fn with_epoch(self, epoch: u32) -> PadPool

Label this pool with a pad epoch (the id peers agree on for this pad in the rollover sequence).

pub fn epoch(&self) -> u32

The pad epoch of this pool.

pub fn commitment(&self) -> [u8; 32]

A binding commitment to this pad — SHA3-256(epoch ‖ pad). Both peers compute it from their loaded material to confirm, over the authenticated PnpSuite::seal_roll handoff, that they hold the identical next pad. Preimage-resistant, so it is safe to exchange; it reveals nothing about the pad bytes.

pub fn direction_len(&self) -> usize

Bytes available in each directional half.

pub fn send_suite(&self, role: Role) -> PnpSuite

The suite this peer seals outbound covers with (its send half).

pub fn recv_suite(&self, role: Role) -> PnpSuite

The suite this peer opens inbound covers with (its receive half — the peer’s send half).

pub fn session(&self, role: Role) -> PnpSession

A live PnpSession for role — seals with this peer’s send half, opens with its receive half — ready to install on the channel’s active-session seam so the interpreter’s Send/receive path is one-time-pad protected end-to-end.