Struct SignedChain 

pub struct SignedChain {
    pub version: u8,
    pub principal_pk: String,
    pub principal_scope: String,
    pub certs: Vec<DelegationCert>,
}

Available on crate feature wire only.

A portable, serializable representation of a DyoloChain.

All ed25519-dalek types are encoded as hex strings so the wire format is language-agnostic. Any service that can deserialize JSON and call the a1 library (or a compatible implementation) can verify the chain.

The format is intentionally minimal: principal_pk, principal_scope, and certs. The chain fingerprint is recomputed on deserialization.

Interoperability

Non-Rust services can verify a SignedChain by:

1. Deserializing the JSON into native types.
2. Re-running the Ed25519 batch verification over the cert chain.
3. Re-checking scope narrowing and temporal constraints.

A formal JSON Schema is published at https://docs.rs/a1/latest/a1/wire/index.html.

Fields

version: u8

Wire format version. Currently 1.

principal_pk: String

Hex-encoded 32-byte Ed25519 verifying key of the root authority.

principal_scope: String

Hex-encoded 32-byte Merkle root of the principal’s intent set.

certs: Vec<DelegationCert>

Ordered delegation certificates from principal to terminal agent.

Implementations

impl SignedChain

pub fn from_chain(chain: &DyoloChain) -> Self

Serialize a DyoloChain into a portable wire document.

pub fn from_json(json: &str) -> Result<Self, A1Error>

Deserialize a JSON wire document.

pub fn from_cbor(cbor: &[u8]) -> Result<Self, A1Error>

Available on crate feature cbor only.

pub fn to_cbor(&self) -> Result<Vec<u8>, A1Error>

Available on crate feature cbor only.

pub fn into_chain_with_drift( self, drift_tolerance_secs: u64, ) -> Result<DyoloChain, A1Error>

Convert this wire document back into a live DyoloChain.

The receiver must specify the clock drift tolerance for the reconstructed chain. This prevents malicious intermediaries from widening the temporal window.

pub fn into_chain(self) -> Result<DyoloChain, A1Error>

👎Deprecated since 2.0.0:

Use into_chain_with_drift instead.

pub fn to_json(&self) -> Result<String, A1Error>

Serialize to a compact JSON string.

pub fn to_json_pretty(&self) -> Result<String, A1Error>

Serialize to a pretty-printed JSON string (useful for audit logs).

Trait Implementations

impl Clone for SignedChain

fn clone(&self) -> SignedChain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SignedChain

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SignedChain

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SignedChain

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

where __S: Serializer,

Serialize this value into the given Serde serializer.