Struct GetShareRequestMessage 

pub struct GetShareRequestMessage {
    pub secret_id: Vec<u8>,
    pub share_version: i32,
    pub timestamp: Option<Timestamp>,
}

GetShareRequestMessage requests a previously stored share from a Helper.

Context

This message is used during the recovery flow, after pairing has been established (typically in recovery mode). Once a Helper has indicated which secret IDs and versions it holds, the Owner sends this request to retrieve specific shares.

Semantics

The request identifies a share by:

• secretId: the identifier of the protected secret
• shareVersion: the version of the share distribution

The Helper is expected to locate the corresponding share and return it in a GetShareResponseMessage.

Authorization Rules

The Helper MUST only process this request if it is received through a valid communication channel that is authorized to access the requested share. Specifically:

• the request MUST originate from the same secretId channel, OR
• the request MUST originate from a channel established in recovery mode and associated with the same user

Otherwise, the Helper MUST reject the request.

Idempotency

This request is idempotent. Repeated requests for the same (secretId, shareVersion) pair SHOULD return the same result.

Fields

secret_id: Vec<u8>

Identifier of the secret for which the share is requested.

This is an opaque byte array (1 to 16 bytes) generated by the Owner when the secret is created. It uniquely identifies the secret within the context of the Owner and its Helpers.

share_version: i32

Version of the share being requested.

Each time a secret is reshared (e.g., due to updates or changes in helper set), a new version is created. This field specifies which version of the share should be returned.

timestamp: Option<Timestamp>

Timestamp indicating when this message was created.

This value is expressed in UTC and can be used for:

• observability and logging
• replay detection (in combination with sequence numbers)
• timeout handling

Trait Implementations

impl Clone for GetShareRequestMessage

fn clone(&self) -> GetShareRequestMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GetShareRequestMessage

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

Formats the value using the given formatter.

impl Default for GetShareRequestMessage

fn default() -> Self

Returns the “default value” for a type.

impl Hash for GetShareRequestMessage

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for GetShareRequestMessage

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for GetShareRequestMessage

fn eq(&self, other: &GetShareRequestMessage) -> 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 Eq for GetShareRequestMessage

impl StructuralPartialEq for GetShareRequestMessage