Struct AugmentedMetadata 

pub struct AugmentedMetadata {
    pub identity: PluginIdentity,
    pub negotiated_functions: BTreeMap<String, u32>,
    pub negotiated_capabilities: BTreeSet<String>,
    pub handshake_completed_at: i64,
    pub self_check_passed: bool,
    pub self_check_completed_at: i64,
    pub expires_at: i64,
}

Augmented metadata combining plugin identity with negotiated capabilities.

This is the single source of truth for negotiated plugin capabilities and versions. It encapsulates the result of a successful handshake and self-check.

Fields

identity: PluginIdentity

The plugin’s identity metadata (magic, abi_envelope, name, version).

negotiated_functions: BTreeMap<String, u32>

Negotiated wire function versions: function_name -> negotiated_version. Ordered via BTreeMap for deterministic serialization.

negotiated_capabilities: BTreeSet<String>

Negotiated capabilities offered by the plugin. Ordered via BTreeSet for deterministic serialization.

handshake_completed_at: i64

Unix timestamp (seconds) when handshake was completed.

self_check_passed: bool

Whether the self-check passed successfully.

self_check_completed_at: i64

Unix timestamp (seconds) when self-check was completed.

expires_at: i64

Unix timestamp (seconds) when this metadata expires and re-handshake is needed.

Implementations

impl AugmentedMetadata

pub fn validate(&self) -> Result<(), AugmentedMetadataError>

Validate this augmented metadata.

pub fn check_size_limit(&self) -> Result<(), AugmentedMetadataError>

Check that serialized size does not exceed AUGMENTED_METADATA_MAX_BYTES.

pub fn from_handshake_and_self_check( identity: PluginIdentity, negotiated_functions: BTreeMap<String, u32>, negotiated_capabilities: BTreeSet<String>, handshake_completed_at: i64, self_check_passed: bool, self_check_completed_at: i64, ttl_seconds: u64, ) -> Result<Self, AugmentedMetadataError>

Create AugmentedMetadata from handshake and self-check responses.

Combines:

• Plugin identity from handshake
• Negotiated functions and capabilities from handshake
• Self-check result

Arguments

• identity - The plugin’s identity metadata
• negotiated_functions - BTreeMap of function_name -> negotiated_version
• negotiated_capabilities - BTreeSet of negotiated capability names
• handshake_completed_at - Timestamp when handshake completed
• self_check_passed - Whether self-check passed
• self_check_completed_at - Timestamp when self-check completed
• ttl_seconds - TTL for this metadata in seconds

pub fn is_expired(&self, now_timestamp: i64) -> bool

Check if this metadata has expired.

pub fn ttl_seconds(&self, now_timestamp: i64) -> i64

Get the TTL remaining in seconds.

Trait Implementations

impl Clone for AugmentedMetadata

fn clone(&self) -> AugmentedMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AugmentedMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AugmentedMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AugmentedMetadata

impl PartialEq for AugmentedMetadata

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AugmentedMetadata