Struct DidJwk 

pub struct DidJwk;

Available on crate feature did-jwk and (crate features did-jwk or did-key or did-web) only.

The did:jwk method: a DidResolver that expands the DID and a DidProducer that encodes one public key.

Examples

use identity_kit::did::{Did, VerificationRelationship};
use identity_kit::jose::Jwk;
use identity_kit::methods::DidJwk;

let jwk: Jwk = serde_json::from_str(
    r#"{"kty":"OKP","crv":"Ed25519","x":"11qYAYKxCrfVS_7TyWQHOg7hcvPapiMlrwIaaPcHURo"}"#,
)?;
let did = DidJwk::did(&jwk)?;
assert!(did.as_str().starts_with("did:jwk:eyJ"));

let document = DidJwk::document(&did)?;
let key = did.join("#0")?;
let method = document.resolve_verification_method(&key, Some(VerificationRelationship::Authentication))?;
assert_eq!(method.public_key_jwk(), Some(&jwk));

Implementations

impl DidJwk

pub const METHOD: &'static str = "jwk"

The method name, jwk.

pub const FRAGMENT: &'static str = "0"

The fragment of the one verification method, 0.

pub const MAX_DID_LEN: usize

The longest did:jwk whose document this method can represent: the verification method id did#0 must fit DEFAULT_MAX_LEN bytes.

pub const CONTEXT: [&'static str; 2]

The @context of every did:jwk document.

pub fn did(jwk: &Jwk) -> Result<Did, DidError>

The did:jwk of the public part of jwk: base64url of its JSON Canonicalization Scheme form (RFC 8785), so members are sorted, and extension members too, recursively. Private parameters never reach the DID.

Any other serialization of the same key is another valid DID, which document resolves but this function never produces; see the module documentation.

Errors

• DidError::TooLong when the encoded key exceeds MAX_DID_LEN bytes, as a JWK carrying an x5c chain or large extension members may; base64url is otherwise valid DID syntax.
• DidError::UnsupportedNumber when an extension member holds a number with no finite double value, which only serde_json’s arbitrary_precision feature keeps.

Examples

use identity_kit::jose::Jwk;
use identity_kit::methods::DidJwk;

// The key of the did:jwk specification's P-256 example, members in any order: its DID
// is the specification's, which is in JCS order.
let jwk: Jwk = serde_json::from_str(
    r#"{
      "kty": "EC",
      "crv": "P-256",
      "x": "acbIQiuMs3i8_uszEjJ2tpTtRM4EU3yz91PH6CdH2V0",
      "y": "_KcyLj9vWMptnmKtm46GqDz8wf74I5LKgrl2GzH3nSE"
    }"#,
)?;
assert_eq!(
    DidJwk::did(&jwk)?.as_str(),
    "did:jwk:eyJjcnYiOiJQLTI1NiIsImt0eSI6IkVDIiwieCI6ImFjYklRaXVNczNpOF91c3pFakoydHBUdFJNNEVVM3l6OTFQSDZDZEgyVjAiLCJ5IjoiX0tjeUxqOXZXTXB0bm1LdG00NkdxRHo4d2Y3NEk1TEtncmwyR3pIM25TRSJ9"
);

Panics

Never: a Jwk always serializes to JSON.

pub fn document(did: &Did) -> Result<DidDocument, ResolutionError>

The DID document did expands to (the method’s Read operation).

Errors

A ResolutionError whose kind is:

• MethodNotSupported when did is not a did:jwk.
• InvalidDid when the method-specific id is not base64url of a JSON Web Key, the key carries private parameters, or the DID is longer than MAX_DID_LEN. The detail says which, and the base64url or JSON error is the source.

Trait Implementations

impl Clone for DidJwk

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DidJwk

impl Debug for DidJwk

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

Formats the value using the given formatter.

impl Default for DidJwk

fn default() -> Self

Returns the “default value” for a type.

impl DidProducer for DidJwk

fn capabilities(&self) -> MethodCapabilities

Embedded, one key, never updated, verification method #0.

fn produce<'life0, 'life1, 'async_trait>( &'life0 self, keys: &'life1 [Jwk], __arg2: (), ) -> Pin<Box<dyn Future<Output = Result<DidDocument, ProduceError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

The document DidJwk::did of the one key in keys resolves to, which holds the key in its canonical form.

type Params = ()

Method-specific parameters.

fn method(&self) -> &'static str

The method name: web for did:web.

impl DidResolver for DidJwk

fn resolve<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, did: &'life1 Did, options: &'life2 ResolutionOptions, ) -> Pin<Box<dyn Future<Output = Result<ResolutionResult, ResolutionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Expands did with DidJwk::document; options may only ask for a JSON representation.

fn method(&self) -> &'static str

The method name this resolver handles: web for did:web.

impl Eq for DidJwk

impl PartialEq for DidJwk

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DidJwk