Struct Aid 

pub struct Aid(/* private fields */);

A validated AITP Agent Identifier.

Construct via Aid::parse or Aid::from_ed25519. Holding an Aid is proof that the value passed format validation: the string starts with aid:pubkey: and the identifier component is the expected length and alphabet for its algorithm.

Implementations

impl Aid

pub fn parse(s: &str) -> Result<Self, AidParseError>

Parse and validate an AID string. Accepts:

• Legacy v0.1 (untagged): aid:pubkey:<43-char-b64url> — interpreted as Ed25519.
• v0.2 tagged Ed25519: aid:pubkey:ed25519:<43-char-b64url>.
• v0.2 tagged P-256: aid:pubkey:p256:<44-char-b64url> (SEC1 compressed point).

pub fn from_ed25519(pubkey: &[u8; 32]) -> Self

Construct a legacy (untagged) Ed25519 AID from a raw 32-byte public key. Kept for backward-compat; new code should prefer Aid::from_ed25519_tagged which emits the v0.2 algorithm-tagged form.

pub fn from_ed25519_tagged(pubkey: &[u8; 32]) -> Self

Construct an algorithm-tagged Ed25519 AID (v0.2 form).

pub fn from_p256(compressed_point: &[u8; 33]) -> Self

Construct a P-256 AID from a 33-byte SEC1 compressed point.

pub fn algorithm(&self) -> AidAlgorithm

Algorithm bound to this AID, derived from the prefix.

pub fn identifier(&self) -> &str

Return the identifier component (everything after the algorithm prefix). For legacy AIDs this is everything after aid:pubkey: (43 chars); for tagged AIDs it’s everything after aid:pubkey:<alg>:.

pub fn try_to_ed25519_bytes(&self) -> Option<[u8; 32]>

Decode the identifier back to the raw 32-byte Ed25519 public key, or None if this AID is not an Ed25519 AID. This is the only accessor — there is no panicking form; callers on paths that may receive an AID of attacker-controlled algorithm (e.g. handshake verification) handle the None case explicitly.

pub fn try_to_p256_bytes(&self) -> Option<[u8; 33]>

Decode the identifier back to the 33-byte SEC1 compressed P-256 public key, or None if this AID is not a P-256 AID.

pub fn pubkey_compressed_bytes(&self) -> Vec<u8>

Decode the identifier back to the AID’s algorithm-agile compressed public-key bytes — 32 bytes for Ed25519 (raw pubkey) or 33 bytes for P-256 (SEC1-compressed). This is the canonical encoding embedded in TctBinding.cnf / DelegationBinding.cnf for algorithm-agile signing-key bindings; callers verifying a cnf against an AID should byte-compare against this value rather than the legacy Ed25519-only Self::try_to_ed25519_bytes.

pub fn as_str(&self) -> &str

Return the full AID string verbatim.

Trait Implementations

impl Clone for Aid

fn clone(&self) -> Aid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Aid

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Aid

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Aid

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

Formats the value using the given formatter.

impl Eq for Aid

impl From<Aid> for String

fn from(a: Aid) -> String

Converts to this type from the input type.

impl Hash for Aid

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Aid

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Aid

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 Aid

impl TryFrom<String> for Aid

type Error = AidParseError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.