4 releases

0.0.2 May 24, 2024
0.0.1 May 20, 2024
0.0.0 May 8, 2024

#1125 in Cryptography


Used in did-chain

MIT OR BSD-2-Clause-Patent OR Apache-2.0

42KB
963 lines

did-simple

Dead simple DIDs (Decentralized Identifiers).

This crate provides the ability to:

  • Parse did urls.
  • (optional feature) Perform cryptographic operations on the public keys resolved from DIDs.

We intentionally do not perform IO, such as what would be required to resolve a did:web. It is your responsibility to do IO, and then use this crate to validate that data and get back something that you can do cryptographic operations with. This ensures that this crate stays small, and that did-simple can be used with any backend or client and in both sync and async paradigms.

Supported DID methods:

  • did:key
  • (coming soon) did:web

Security

This crate enforces #![forbid(unsafe_code)] unless the allow-unsafe feature is enabled. Since features in rust are additive across a dependency graph, don't enable this feature unless you are writing an application!

This crate has a very high bar for the addition of new dependencies, because dependencies are places where the software supply chain can be attacked. Right now, we have zero non-rust dependencies, and passing no-default-features gives you dependencies on only the following crates:

  • thiserror (proc macro)
  • bytes (no transitive deps)
  • bs58 (no transitive deps)

We also test effectively every possible bit pattern when encoding and decoding varints, a necessary part of did:key resolution.

Breaking Changes

This crate is v0.0.X, and may introduce breaking changes at any time, with any frequency.

Dependencies

~0.4–2MB
~41K SLoC