Struct RootsFile 

pub struct RootsFile {
    pub version: u32,
    pub roots: Vec<RootEntry>,
}

A roots.json file containing trusted identity roots.

This file is checked into repositories at .auths/roots.json to define which identities are trusted for verification in CI environments.

Format

{
  "version": 1,
  "roots": [
    {
      "did": "did:keri:EXq5YqaL...",
      "public_key_hex": "7a3bc2...",
      "kel_tip_said": "ERotSaid...",
      "note": "Primary maintainer"
    }
  ]
}

Fields

version: u32

Version of the roots file format. Currently must be 1.

roots: Vec<RootEntry>

List of trusted identity roots.

Implementations

impl RootsFile

pub fn load(path: &Path) -> Result<Self, TrustError>

Load and validate a roots.json file.

Errors

Returns an error if:

• The file cannot be read
• The JSON is malformed
• The version is not 1
• Any public_key_hex is invalid (not valid hex, wrong length)

pub fn find(&self, did: &str) -> Option<&RootEntry>

Find a root entry by DID.

pub fn dids(&self) -> Vec<&str>

Get all DIDs in this roots file.

Trait Implementations

impl Debug for RootsFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RootsFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.