Skip to main content

Module identity

Module identity 

Source
Expand description

Per-agent Ed25519 identity keypair.

Loaded from <agent_home>/identity.key (private, 0600) and <agent_home>/identity.pub (public, multibase-encoded text).

Structs§

AgentIdentity
ChainOptions
Per-call options for verify_chain.
ChainOutcome
Outcome of a successful chain verification.
RotationAttestation
Cryptographic proof of an identity-key rotation.

Enums§

ChainError
Errors from verify_chain.
IdentityError
RotationReason
Why a rotation happened. Free-form audit hint; does not affect verification rules other than Emergency, which permits an empty signature.

Functions§

decode_pubkey
Decode a multibase-encoded pubkey. Accepts any multibase variant.
default_dir
Default location: <agent_home>/identity.{key,pub}.
encode_pubkey
Encode an Ed25519 public key to multibase base58btc (z prefix).
verify_chain
Walk the chain top-to-bottom and verify it forms a valid history. Returns the head pubkey + version on success.