Struct GetShareResponseMessage 

pub struct GetShareResponseMessage {
    pub result: Option<DeRecResult>,
    pub committed_de_rec_share: Vec<u8>,
    pub share_algorithm: i32,
    pub timestamp: Option<Timestamp>,
}

GetShareResponseMessage returns a share previously stored by the Helper.

Semantics

This message is sent in response to a GetShareRequestMessage. It either:

• returns the requested share (on success), or
• indicates failure via the result field

Authorization Enforcement

The Helper MUST ensure that the request satisfies the authorization rules described in GetShareRequestMessage before returning any share data.

Share Contents

The returned share is an opaque byte sequence that typically includes:

• the Shamir share (x, y)
• the encrypted secret payload (or a reference to it)
• the commitment (e.g., Merkle root)
• the opening proof for verification

The exact structure is defined by the share algorithm indicated in shareAlgorithm.

Security Considerations

• The share MUST only be returned over an authenticated and encrypted DeRec channel
• Incorrect or malicious shares may be detected by the Owner during recovery using commitment verification

Idempotency

For a given (secretId, shareVersion), repeated responses SHOULD return the same share data.

Fields

result: Option<DeRecResult>

Result of processing the request.

Indicates whether the share was successfully retrieved or if an error occurred (e.g., unauthorized request, unknown secretId, or missing version).

committed_de_rec_share: Vec<u8>

The committed DeRec share.

This is an opaque byte array containing the share data as produced by the share distribution algorithm. Its internal structure depends on shareAlgorithm.

share_algorithm: i32

Identifier of the share algorithm used to produce the share.

This allows the recipient to interpret and process the share correctly during verification and reconstruction.

timestamp: Option<Timestamp>

Timestamp indicating when this message was created.

This value is expressed in UTC and can be used for observability, replay detection, and timeout handling.

Trait Implementations

impl Clone for GetShareResponseMessage

fn clone(&self) -> GetShareResponseMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GetShareResponseMessage

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

Formats the value using the given formatter.

impl Default for GetShareResponseMessage

fn default() -> Self

Returns the “default value” for a type.

impl Hash for GetShareResponseMessage

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 GetShareResponseMessage

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 GetShareResponseMessage

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

impl StructuralPartialEq for GetShareResponseMessage