Struct StatePublisher 

pub struct StatePublisher<const STATE_MAX: usize> { /* private fields */ }

Publisher handle for a state layout.

Contract

• Intended for a single writer.
• Each call to StatePublisher::publish overwrites the entire state value.
• Publication uses the v1 parity protocol: readers should only accept snapshots observed at an even seq before and after the read.

Implementations

impl<const STATE_MAX: usize> StatePublisher<STATE_MAX>

pub fn new(inner: &StateLayoutCell<STATE_MAX>) -> Self

Create a publisher over a mapped layout without validating it.

Prefer try_new when constructing from an untrusted mapping.

pub fn try_new(inner: &StateLayoutCell<STATE_MAX>) -> Result<Self, Error>

Create a publisher after validating the mapped layout.

pub fn publish(&self, bytes: &[u8]) -> Result<u64, usize>

Overwrite the current state and return the new stable sequence number.

On success, the returned seq is even and can be used by readers as a monotonic marker.

Errors

Returns Err(required_len) when bytes.len() > STATE_MAX. No bytes are published in this case.

Trait Implementations

impl<const STATE_MAX: usize> Send for StatePublisher<STATE_MAX>