Struct PendingAck 

pub struct PendingAck<const FRAME: usize = MAX_RESEND_FRAME_LEN> {
    pub ack_tag: [u8; 8],
    pub peer: PublicKey,
    pub resend: ResendRecord<FRAME>,
    pub sent_ms: u64,
    pub ack_deadline_ms: u64,
    pub retries: u8,
    pub state: AckState,
}

Complete tracking state for one in-flight ACK-requested transmission.

The coordinator’s IdentitySlot maintains a LinearMap of PendingAck records keyed by SendReceipt, one per active ACK-requested send. The record holds everything needed to detect completion, detect timeout, and retransmit:

• ack_tag — the 8-byte CMAC-derived value that will appear in the destination’s MAC ACK packet. Only a node that received and successfully decrypted the original frame can produce the correct tag, so a matching ack_tag is cryptographic proof of delivery.
• peer — the destination’s full public key, used to look up the correct pending entry when matching an inbound MAC ACK against the pending table.
• resend — a verbatim copy of the sealed frame for retransmission. See ResendRecord.
• sent_ms — the monotonic millisecond timestamp at which the frame was first transmitted; useful for latency measurement.
• ack_deadline_ms — absolute deadline for the final ACK. Expiry means failure and the entry is removed.
• retries — the number of retransmissions already attempted; capped at MAX_FORWARD_RETRIES.
• state — current position in the AckState lifecycle (forwarding confirmation wait or final-ACK wait).

Use PendingAck::direct for sends to nodes in direct radio range, or PendingAck::forwarded when routing through a repeater.

Fields

ack_tag: [u8; 8]

Internal ACK tag used for inbound matching.

peer: PublicKey

Final destination peer.

resend: ResendRecord<FRAME>

Retransmission data.

sent_ms: u64

Initial send timestamp in milliseconds.

ack_deadline_ms: u64

Absolute deadline for the final ACK.

retries: u8

Number of retries already attempted.

state: AckState

Current state in the ACK lifecycle.

Implementations

impl<const FRAME: usize> PendingAck<FRAME>

pub fn direct( ack_tag: [u8; 8], peer: PublicKey, resend: ResendRecord<FRAME>, ) -> Self

Create pending-ACK state for a direct send.

pub fn forwarded( ack_tag: [u8; 8], peer: PublicKey, resend: ResendRecord<FRAME>, ) -> Self

Create pending-ACK state for a forwarded send.

Trait Implementations

impl<const FRAME: usize> Clone for PendingAck<FRAME>

fn clone(&self) -> PendingAck<FRAME>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const FRAME: usize> Debug for PendingAck<FRAME>

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

Formats the value using the given formatter.

impl<const FRAME: usize> PartialEq for PendingAck<FRAME>

fn eq(&self, other: &PendingAck<FRAME>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const FRAME: usize> Eq for PendingAck<FRAME>

impl<const FRAME: usize> StructuralPartialEq for PendingAck<FRAME>