Struct ActionEnvelope 

pub struct ActionEnvelope {
    pub version: String,
    pub action_type: String,
    pub identity: String,
    pub payload: Value,
    pub timestamp: String,
    pub signature: String,
    pub attestation_chain: Option<Value>,
    pub environment: Option<Value>,
}

Typed action envelope for signed actions.

Compatible with the existing Python SDK wire format (version “1.0”). The signature field is excluded from the canonical signing data.

Args:

• version: Protocol version string (currently “1.0”).
• action_type: The type of action being performed.
• identity: DID of the signing identity.
• payload: Arbitrary JSON payload.
• timestamp: RFC3339 timestamp string.
• signature: Hex-encoded Ed25519 signature over the canonical signing data.
• attestation_chain: Optional chain of attestations for verification.
• environment: Optional environment claim for gateway verification.

Usage:

let envelope = ActionEnvelope {
    version: "1.0".into(),
    action_type: "sign_commit".into(),
    identity: "did:keri:Eabc123".into(),
    payload: serde_json::json!({"hash": "abc123"}),
    timestamp: "2024-01-01T00:00:00Z".into(),
    signature: "deadbeef...".into(),
    attestation_chain: None,
    environment: None,
};

Fields

version: String

Protocol version string.

action_type: String

The type of action being performed.

identity: String

DID of the signing identity.

payload: Value

Arbitrary JSON payload.

timestamp: String

RFC3339 timestamp string.

signature: String

Hex-encoded Ed25519 signature over the canonical signing data.

attestation_chain: Option<Value>

Optional chain of attestations for verification.

environment: Option<Value>

Optional environment claim for gateway verification.

Implementations

impl ActionEnvelope

pub fn signing_data(&self) -> ActionSigningData<'_>

Extracts the signing data from this envelope.

pub fn canonical_bytes(&self) -> Result<Vec<u8>, String>

Produces the canonical JSON bytes for signature verification.

Trait Implementations

impl Clone for ActionEnvelope

fn clone(&self) -> ActionEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActionEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ActionEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ActionEnvelope

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

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 ActionEnvelope