Struct SdJwtBuilder 

pub struct SdJwtBuilder<H> { /* private fields */ }

Builder structure to create an issuable SD-JWT.

Implementations

impl SdJwtBuilder<Sha256Hasher>

pub fn new<T: Serialize>(object: T) -> Result<Self>

Creates a new SdJwtBuilder with sha-256 hash function.

Error

Returns Error::DataTypeMismatch if object is not a valid JSON object.

impl<H: Hasher> SdJwtBuilder<H>

pub fn new_with_hasher<T: Serialize>(object: T, hasher: H) -> Result<Self>

Creates a new SdJwtBuilder with custom hash function to create digests.

pub fn new_with_hasher_and_salt_size<T: Serialize>( object: T, hasher: H, salt_size: usize, ) -> Result<Self>

Creates a new SdJwtBuilder with custom hash function to create digests, and custom salt size.

pub fn make_concealable(self, path: &str) -> Result<Self>

Substitutes a value with the digest of its disclosure.

Notes

• path indicates the pointer to the value that will be concealed using the syntax of JSON pointer.

Example

use sd_jwt_payload::SdJwtBuilder;
use sd_jwt_payload::json;

let obj = json!({
 "id": "did:value",
 "claim1": {
    "abc": true
 },
 "claim2": ["val_1", "val_2"]
});
let builder = SdJwtBuilder::new(obj)
 .unwrap()
 .make_concealable("/id").unwrap() //conceals "id": "did:value"
 .make_concealable("/claim1/abc").unwrap() //"abc": true
 .make_concealable("/claim2/0").unwrap(); //conceals "val_1"

Error

• Error::InvalidPath if pointer is invalid.
• Error::DataTypeMismatch if existing SD format is invalid.

pub fn header(self, header: JsonObject) -> Self

Sets the JWT header.

Notes

• if SdJwtBuilder::header is not called, the default header is used: json { "typ": "sd-jwt", "alg": "<algorithm used in SdJwtBuilder::finish>" }
• alg is always replaced with the value passed to SdJwtBuilder::finish.

pub fn insert_claim<'a, K, V>(self, key: K, value: V) -> Result<Self>

where K: Into<Cow<'a, str>>, V: Serialize,

Adds a new claim to the underlying object.

pub fn add_decoys(self, path: &str, number_of_decoys: usize) -> Result<Self>

Adds a decoy digest to the specified path.

path indicates the pointer to the value that will be concealed using the syntax of JSON pointer.

Use path = “” to add decoys to the top level.

pub fn require_key_binding(self, key_bind: RequiredKeyBinding) -> Self

Require a proof of possession of a given key from the holder.

This operation adds a JWT confirmation (cnf) claim as specified in RFC8300.

pub async fn finish<S>(self, signer: &S, alg: &str) -> Result<SdJwt>

where S: JwsSigner,

Creates an SD-JWT with the provided data.

Trait Implementations

impl<H: Debug> Debug for SdJwtBuilder<H>

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

Formats the value using the given formatter.