Struct HolderKey 

pub struct HolderKey { /* private fields */ }

Re-exported so a caller can name the holder key without also depending on vta-sdk directly. A VTC client that has to reach past this crate for the type its own method takes is a client with a seam in it. The key a Trust Task proof is made with: the verification method the proof will name, and the private key behind it.

Any DID that can name a key may sign. The verifier resolves the verification method and checks the signature; the DID method is not the authorization. did:key:z6Mk…#z6Mk…, did:webvh:<scid>:example.com:glenn#key-0 and did:web:example.com#key-1 are all ordinary holders.

This type exists because the two cases differ in one way that a bare (did, key) pair cannot express: a did:key contains its verification method, and nothing else does. Deriving #key-0 from a did:webvh is not possible — the document says what the keys are called — so the caller has to name it, and a signer that takes only a DID silently cannot serve any method but one. That is the shape the restriction had before this type: not a policy anyone chose, but a helper that only knew how to build one kind of identifier.

Implementations

impl HolderKey

pub fn new( verification_method: impl Into<String>, private_key_multibase: impl Into<String>, ) -> Result<HolderKey, TrustTaskSignError>

A holder that names its own verification method — the general case.

verification_method must be a DID with a #fragment, e.g. did:webvh:<scid>:example.com:glenn#key-0. Whether the key is in that DID document, and whether the DID document is reachable, is the verifier’s business; this only refuses what cannot identify a key at all.

pub fn from_did_key( did: &str, private_key_multibase: impl Into<String>, ) -> Result<HolderKey, TrustTaskSignError>

A did:key holder, whose verification method is <did>#<multibase> and so needs no naming.

pub fn verification_method(&self) -> &str

The verification method the proof will name.

pub fn holder_did(&self) -> &str

The holder DID — the verification method without its fragment. This is the DID a verifier recovers as the proven signer.

Trait Implementations

impl Clone for HolderKey

fn clone(&self) -> HolderKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HolderKey

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

Formats the value using the given formatter.

impl Eq for HolderKey

impl PartialEq for HolderKey

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HolderKey