Struct Signature 

pub struct Signature {
    pub scheme: u8,
    pub key_id: Vec<u8>,
    pub bytes: Vec<u8>,
    pub context: Option<SignatureContext>,
}

A detached envelope signature: designed but dormant.

The type exists so the future opt-in (per-agent keys, consumer-side verification against a key registry) is an additive signature: Option<Signature> envelope field, not a redesign. No crypto dependency enters this crate. Signing and verification live SDK-side.

Field sizes are scheme-discriminated, so the scheme byte exists precisely to keep the type from welding to one algorithm. The wire fields are bounded bytes, validate enforces the registered per-scheme lengths, and unknown schemes pass through.

Fields

scheme: u8

The signing scheme code (SIGNATURE_SCHEME_ED25519 = 1). Codes are permanent, and unknown codes pass through like every open dictionary.

key_id: Vec<u8>

Which of the agent’s registered keys signed (8 bytes for Ed25519).

bytes: Vec<u8>

The signature over the canonical envelope encoding (signature field absent), domain-separated (64 bytes for Ed25519).

context: Option<SignatureContext>

Out-of-band interpretation attributes the signature also covers, so an intermediary cannot flip the codec (agdx.ct) or wire version (agdx.av) on a signed record without invalidating it. Folded into the signed preimage when present. Skip-none, so a context-less signature stays byte-identical to a pre-context one (an older signer, or a body whose interpretation is fixed).

Implementations

impl Signature

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

Check a signature capsule against its scheme’s registered lengths.

Unknown scheme codes validate, so future schemes flow through old consumers. Verification itself is SDK-side and scheme-aware.

Trait Implementations

impl Clone for Signature

fn clone(&self) -> Signature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Signature

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Signature

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Signature

impl PartialEq for Signature

fn eq(&self, other: &Signature) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Signature

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 Signature