Struct StoreShareRequestMessage 

pub struct StoreShareRequestMessage {
    pub share: Vec<u8>,
    pub share_algorithm: i32,
    pub version: i32,
    pub keep_list: Vec<i32>,
    pub version_description: String,
    pub timestamp: Option<Timestamp>,
}

StoreShareRequestMessage instructs a Helper to store a share for a given secret and manage the set of retained share versions.

Context

This message is used in the sharing flow when:

• a new secret is created
• an existing secret is updated
• the helper set or recovery threshold changes

The Owner sends this message to each Helper to:

• store (or replace) a specific share version
• update the set of versions that must be retained (keepList)

Semantics

This message may carry two independent instructions:

1. Share storage/update:

   • If share is present, the Helper MUST store this share under the specified version
   • If the version already exists, the Helper MUST replace it

2. Retention policy update:

   • If keepList is present, it defines the complete set of versions that MUST be retained
   • Any stored version not in keepList SHOULD be deleted

If keepList is absent:

• The Helper MUST preserve the existing keepList
• The Helper MUST add the new version to the retained set

Consistency Requirements

The Owner MUST ensure that for a given (secretId, version):

• all Helpers receive identical share contents

It is an error for different shares to be associated with the same version and secretId.

Replay Protection

To prevent replay attacks:

• If version is less than the latest stored version, the Helper MUST ignore the keepList field

This ensures that stale messages cannot cause deletion of newer shares.

Share Opacity

The Helper MUST treat the share field as opaque data. It is not required to understand or validate the share contents.

Idempotency

This message is idempotent:

• Re-sending the same (version, share) pair SHOULD result in the same state
• Re-applying the same keepList SHOULD not change state after the first time

Fields

share: Vec<u8>

Share bytes to be stored by the Helper.

This is an opaque byte array produced by the share distribution algorithm. The Helper MUST store it without interpretation.

share_algorithm: i32

Identifier of the algorithm used to produce the share.

This allows the Owner and Helper to coordinate on how the share should be interpreted during recovery.

Algorithm 0 defines the share as a serialized CommittedDeRecShare protobuf message (see DeRec cryptography repository).

Implementations SHOULD support algorithm 0 for interoperability.

version: i32

Version number of the share.

Each resharing event increments this value. The secretId is provided in the enclosing DeRecMessage.

keep_list: Vec<i32>

List of share versions that MUST be retained by the Helper.

Any stored version not included in this list SHOULD be deleted.

If absent, the Helper MUST:

• retain the existing keepList
• add the current version to the retained set

This field MUST be ignored if version is older than the latest version already stored, to prevent replay attacks.

version_description: String

Optional human-readable description of this share version.

This field is visible to the Helper and is not intended to carry sensitive information. It may be used for debugging, labeling, or user-facing display.

timestamp: Option<Timestamp>

Timestamp indicating when this message was created.

Used for observability, replay detection, and timeout handling.

Trait Implementations

impl Clone for StoreShareRequestMessage

fn clone(&self) -> StoreShareRequestMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoreShareRequestMessage

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

Formats the value using the given formatter.

impl Default for StoreShareRequestMessage

fn default() -> Self

Returns the “default value” for a type.

impl Hash for StoreShareRequestMessage

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 StoreShareRequestMessage

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 StoreShareRequestMessage

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

impl StructuralPartialEq for StoreShareRequestMessage