Expand description
§ma-did
DID and message primitives for the did:ma: method.
This crate provides everything needed to create, sign, and verify DID documents and encrypted actor-to-actor messages.
§Quick Start — Identity
use ma_did::{generate_identity, Did};
// Generate a complete identity (keys + signed document)
let ipns = "k51qzi5uqu5dj9807pbuod1pplf0vxh8m4lfy3ewl9qbm2s8dsf9ugdf9gedhr";
let identity = generate_identity(ipns).unwrap();
// The document is already signed and valid
identity.document.verify().unwrap();
identity.document.validate().unwrap();
// Serialize to JSON or CBOR
let json = identity.document.marshal().unwrap();
let cbor = identity.document.to_cbor().unwrap();§Quick Start — Messages
use ma_did::{generate_identity, Message, SigningKey, Did};
let alice = generate_identity("k51qzi5uqu5dj9807pbuod1pplf0vxh8m4lfy3ewl9qbm2s8dsf9ugdf9gedhr").unwrap();
let bob = generate_identity("k51qzi5uqu5dl96qbq93mwl5drvk2z83fk4s6h4n7xgqnwrxlscs11i1bja7uk").unwrap();
// Reconstruct signing key from stored private key bytes
let alice_sign_url = Did::new_url(&alice.subject_url.ipns, None::<String>).unwrap();
let alice_signing_key = SigningKey::from_private_key_bytes(
alice_sign_url,
hex::decode(&alice.signing_private_key_hex).unwrap().try_into().unwrap(),
).unwrap();
// Create a signed message
let msg = Message::new(
alice.document.id.clone(),
bob.document.id.clone(),
"text/plain",
b"hello".to_vec(),
&alice_signing_key,
).unwrap();
// Verify message signature against sender's document
msg.verify_with_document(&alice.document).unwrap();
// Encrypt for recipient as an Envelope
let envelope = msg.enclose_for(&bob.document).unwrap();Re-exports§
pub use did::DID_PREFIX;pub use did::Did;pub use doc::DEFAULT_DID_CONTEXT;pub use doc::DEFAULT_PROOF_PURPOSE;pub use doc::DEFAULT_PROOF_TYPE;pub use doc::Document;pub use doc::Proof;pub use doc::VerificationMethod;pub use doc::now_iso_utc;pub use error::MaError;pub use error::Result;pub use identity::GeneratedIdentity;pub use identity::generate_identity;pub use key::ASSERTION_METHOD_KEY_TYPE;pub use key::ED25519_PUB_CODEC;pub use key::EDDSA_SIG_CODEC;pub use key::EncryptionKey;pub use key::KEY_AGREEMENT_KEY_TYPE;pub use key::SigningKey;pub use key::X25519_PUB_CODEC;pub use msg::DEFAULT_MAX_CLOCK_SKEW_SECS;pub use msg::DEFAULT_MESSAGE_TTL_SECS;pub use msg::DEFAULT_REPLAY_WINDOW_SECS;pub use msg::Envelope;pub use msg::Headers;pub use msg::MESSAGE_PREFIX;pub use msg::Message;pub use msg::ReplayGuard;
Modules§
Enums§
- Ipld
- Ipld