Struct RetainedKeyPackageMaterial 

pub struct RetainedKeyPackageMaterial {
    pub epoch_id: EpochId,
    pub leaf_index: LeafNodeIndex,
    pub generation: u32,
    pub key_package_ciphersuite: Ciphersuite,
    pub key_package_index: u32,
    pub key_package_seed_secret: KeyPackageSeedSecret,
    pub key_package_extensions: Extensions<KeyPackage>,
}

Available on crate feature extensions-draft and crate feature virtual-clients-draft and (32-bit or 64-bit) only.

Per-KeyPackageRef material a sibling retains when it processes a KeyPackageUpload. It captures what the Welcome path needs to later rederive the KeyPackage’s init and leaf-encryption keys without touching the operation tree: the per-KeyPackage seed secret, plus the derivation epoch, leaf index, generation, and batch index used to validate the leaf found in the ratchet tree. The sibling also keeps the KeyPackage’s extensions, s.t. it can apply the corresponding semantics when processing a Welcome.

The seed is pinned here at upload-processing time so the Welcome path stays independent of the operation tree’s bounded out-of-order tolerance: a batch can hold more KeyPackages than that tolerance, and Welcomes can arrive in any order, yet every seed remains available because the single batch generation is consumed once and each seed is stored alongside its index.

The uploader stores the same material when it finalizes the batch, next to its KeyPackages. It joins through the KeyPackage itself, so for the uploader the material only keeps the derivation epoch alive, as it does for the sibling (see StorageProvider::delete_unreferenced_vc_derivation_epoch_states).

Fields

epoch_id: EpochId

Derivation epoch the KeyPackage belongs to.

leaf_index: LeafNodeIndex

Uploader’s emulation-group leaf index, identifying the operation ratchet the batch generation was allocated from.

generation: u32

Operation-ratchet generation consumed for the whole batch.

key_package_ciphersuite: Ciphersuite

Ciphersuite of the KeyPackage.

key_package_index: u32

Position of this KeyPackage within the batch.

key_package_seed_secret: KeyPackageSeedSecret

Per-KeyPackage seed secret from which the init and leaf-encryption keys are derived at Welcome time.

key_package_extensions: Extensions<KeyPackage>

The KeyPackage’s extensions, as listed in the upload. Records stored before uploads carried extensions read back with only a last resort extension.

Trait Implementations

impl Debug for RetainedKeyPackageMaterial

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RetainedKeyPackageMaterial

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Entity<CURRENT_VERSION> for RetainedKeyPackageMaterial

impl RetainedKeyPackageMaterial<CURRENT_VERSION> for RetainedKeyPackageMaterial

impl Serialize for RetainedKeyPackageMaterial

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.