Struct InvokeSender 

pub struct InvokeSender<'a> { /* private fields */ }

Cornerstone invoke transaction. See module docs for the pattern. Returned by ImClient::invoke_sender.

Public surface is intentionally narrow: a single async tx method that drives one round of the MRP loop. The TLV-serialization plumbing the codegen request builder uses to fill the request bytes lives in a separate InvokeSenderSlot type accessed via TLVBuilderParent::writer, so that u8 / start_struct / etc. don’t appear directly on InvokeSender and tempt users to drive the TX buffer by hand.

Implementations

impl<'a> InvokeSender<'a>

pub async fn tx( self, ) -> Result<TxOutcome<InvReqBuilder<InvokeSender<'a>>, InvokeRespChunk<'a>>, Error>

Drive one round of the MRP retransmit loop.

• Returns TxOutcome::BuildRequest(builder) when the framework needs the request bytes (re-)built into a fresh TX slot. The builder’s P parent is this InvokeSender; calling .end() on the message builder hands the InvokeSender back, ready for the next tx() call.
• Returns TxOutcome::GotResponse(chunk) once the framework has received the peer’s ACK; iterate the chunk loop via InvokeRespChunk::complete.

The first call after ImClient::invoke_sender is guaranteed to yield TxOutcome::BuildRequest(builder) because no message has been sent yet.

Trait Implementations

impl<'a> Debug for InvokeSender<'a>

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

Formats the value using the given formatter.

impl<'a> TLVBuilderParent for InvokeSender<'a>

type Write = InvokeSenderSlot<'a>

The type of the writer.

fn writer(&mut self) -> &mut <InvokeSender<'a> as TLVBuilderParent>::Write

Return a mutable reference to the writer.