aries-vcx

The repository contains Rust crates to build

• Aries based applications (mobile, server, anything, ...),
• DIDComm related components.

Aries implementation

• aries_vcx - Library implementing DIDComm protocols, with focus on verifiable credential issuance and verification.
• messages - Library for building and parsing Aries (DIDComm v1) messages.
• aries_vcx_anoncreds - Interfaces for interaction with credentials.
• aries_vcx_ledger - Interfaces for interaction with ledgers.
• aries_vcx_wallet - Interfaces for interaction with wallets.
• agents - Aries agents built on top of aries_vcx.

Did document implementation

• did_doc - Building and parsing DID Documents

Did methods implementation

• did_parser - Building and parsing DIDs
• did_peer - https://identity.foundation/peer-did-method-spec/
• did_sov - https://sovrin-foundation.github.io/sovrin/spec/did-method-spec-template.html
• did_cheqd - https://docs.cheqd.io/product/architecture/adr-list/adr-001-cheqd-did-method
• did_web - https://w3c-ccg.github.io/did-method-web/
• did_key - https://w3c-ccg.github.io/did-method-key/
• did_jwk - https://github.com/quartzjer/did-jwk/blob/main/spec.md

Contact

Do you have a question ❓Are you considering using our components? 🚀 We'll be excited to hear from you. 👋

There's 2 best way to reach us:

• Leave us message on aries-vcx discord channel.
• Join our Zoom community calls. Biweekly Tuesdays @ 11:00 pm UTC via Zoom, find more details on wiki

Versioning & releases

• Crates are not yet published on crates.io. You can consume crates as github-type Cargo dependency.
• All releases have currently major version 0
  • We bump minor version on releases containing new features, significant refactors or breaking changes.
  • We bump patch version if release only contains fixes or smaller refactoring.
• See releases page.
• MSRV 1.81 - Crates are known to be stable with atleast Rust version 1.81

Contributions

Contributions are very welcome! If you have questions or issues, please let us know on Discord or at our bi-weekly community call.

Install

Install Rust: https://www.rust-lang.org/tools/install

We recommend using rustup, as VCX is currently targeting Rust v1.84.1 (this maintains consistency between local and CI environments).

Anoncreds and Indy require the use of openssl and zmq. These may be vendored by consuming applications, but for development installation is required.

[!NOTE] For those familiar with the Indy SDK dependencies (which is no longer in use as it has been replaced by anoncreds-rs, indy-vdr, and aries-askar) note that:

• Openssl requirements are no longer restricted to the out of support 1.1 version.
• Libsodium is no longer required (as it's been replaced by anoncreds-clsignatures)

Linux / MacOS:

• ZMQ: https://zeromq.org/download/
• Openssl: https://docs.rs/openssl/latest/openssl/#automatic

Windows

If you get a VCX development environment running in Windows, we'd love a contribution documenting that process here!

Formatting / Linting

For contributions, please run clippy and format prior to creating a PR. This can be done via just:

cargo install just
just clippy
just fmt

Signed Commits

We enforce developer certificate of origin (DCO) commit signing — guidance on this is available.

See this guide for signing previously unsigned commits.