0.12.0rc3
Pre-releaseRelease 0.12.0 is a relatively large release with many new capabilities, feature improvements, upgrades and bug fixes. Importantly, this release completes the ACA-Py implementation of Aries Interop Profile v2.0, and enables the elimination of unqualified DIDs. While only deprecated for now, all deployments of ACA-Py to move to using only fully qualified DIDs.
Much progress has been made on did:peer
support in this release, with the handling of inbound DID Peer 1 added, and inbound and outbound support for DID Peer 2 and 4. Much attention was also paid to making sure that the Peer DID and DID Exchange capabilities match those of Credo-TS (formerly Aries Framework JavaScript). The completion of that work eliminates the remaining places where "unqualified" DIDs are being used, and to enable the "connection reuse" in the Out of Band protocol when using DID Peer 2 and 4 DIDs. See the document Qualified DIDs for details about how to control the use of DID Peer 2 or 4 in an ACA-Py deployment, and how to eliminate the use of unqualified DIDs. Support for DID Exchange v1.1 has been added to ACA-Py, with support for DID Exchange v1.0 retained, and we've added support for DID Rotation.
Work continues towards supporting ledger agnostic AnonCreds, and the new Hyperledger AnonCreds Rust library. Some of that work is in this release, the rest will be in the next release.
Attention was given in the release to simplifying the handling of JSON-LD Data Integrity Verifiable Credentials.
An important change in this release is the re-organization of the ACA-Py documentation, moving the vast majority of the documents to the folders within the docs
folder -- a long overdue change that will allow us to soon publish the documents on https://aca-py.org directly from the ACA-Py repository, rather than from the separate aries-acapy-docs currently being used.
A big developer improvement is a revamping of the test handling to eliminate ~2500 warnings that were previously generated in the test suite. Nice job @ff137!
0.12.0rc3 Breaking Changes
A deployment of this release that proactively uses DID Peer 2 and 4 will encounter problems interacting with agents deployed using older Aries protocols. Led by the Aries Working Group, the Aries community is encouraging the upgrade of all ecosystem deployments to accept all commonly used qualified DIDs, including DID Peer 2 and 4. See the document Qualified DIDs for more details about the transition to using only qualified DIDs.
New deprecation notices were added to ACA-Py on startup and in the OpenAPI/Swagger interface. Those added are listed below. As well, we anticipate 0.12.0 being the last ACA-Py release to include support for the previously deprecated Indy SDK.
- RFC 0036 Issue Credential v1
- Migrate to use RFC 0453 Issue Credential v2
- RFC 0037 Present Proof v2
- Migrate to use RFC 0454 Present Proof v2
- RFC 0169 Connections
- Migrate to use RFC 0023 DID Exchange and 0434 Out-of-Band
- The use of
did:sov:...
as a Protocol Doc URI- Migrate to use
https://didcomm.org/
.
- Migrate to use
What's Changed
- Initial code migration from anoncreds-rs branch by @ianco in #2596
- Bump aiohttp from 3.8.6 to 3.9.0 by @dependabot in #2635
- Feature Suggestion: Include a Reason When Constraints Cannot Be Applied by @Ennovate-com in #2630
- Fix: RevRegEntry Transaction Endorsement by @shaangill025 in #2558
- fix: update broken demo dependency by @mrkaurelius in #2638
- Bump cryptography from 41.0.5 to 41.0.6 by @dependabot in #2636
- Integrate Anoncreds rs into credential and presentation endpoints by @ianco in #2632
- Initial migration of anoncreds revocation code by @ianco in #2643
- feat: add did:jwk resolver by @dbluhm in #2645
- Feat: DIDX Implicit Request auto-accept and Delete OOB Invitation related records by @shaangill025 in #2642
- Add ConnectionProblemReport handler by @usingtechnology in #2600
- Update integration tests for anoncreds-rs by @ianco in #2651
- Connection and DIDX Problem Reports by @usingtechnology in #2653
- feat: support resolving did:peer:1 received in did exchange by @dbluhm in #2611
- Slight improvement to credx proof validation error message by @ianco in #2655
- Update snyk workflow to execute on Pull Request by @usingtechnology in #2658
- refactor: make ldp_vc logic reusable by @dbluhm in #2533
- Additional anoncreds integration tests by @ianco in #2660
- Tweak scope of GHA integration tests by @ianco in #2662
- fix: link to raw content change from master to main by @Ennovate-com in #2663
- Ensure "preserve_exchange_records" flags are set. by @usingtechnology in #2664
- fix: open-api generator script by @dbluhm in #2661
- Anoncreds - Add unit testing by @jamshale in #2672
- Fix: Change To Use Timezone Aware UTC datetime by @Ennovate-com in #2679
- Cache TAA by wallet name by @jamshale in #2676
- Improve Per Tenant Logging: Fix issues around default log file path by @shaangill025 in #2659
- Return 404 when schema not found by @jamshale in #2683
- Update dependencies by @andrewwhitehead in #2686
- Add unit tests for anoncreds revocation by @jamshale in #2688
- chore(deps): Bump jwcrypto from 1.5.0 to 1.5.1 by @dependabot in #2689
- Emit did:peer:2 for didexchange by @Jsyro in #2687
- did peer 4 resolution by @Jsyro in #2692
- Remove if condition which checks if the
credential.type
array is equal to 1 by @PatStLouis in #2670 - Improve api documentation and error handling by @jamshale in #2690
- Add did web method type as a default option by @PatStLouis in #2684
- fix: update constants in TransactionRecord by @amanji in #2698
- Remove tiny-vim from being added to the container image to reduce reported vulnerabilities from scanning by @swcurran in #2699
- fix: save multi_use to the DB for OOB invitations by @frostyfrog in #2694
- Update legacy bcgovimages references. by @WadeBarnes in #2700
- Feature/emit did peer 4 by @Jsyro in #2696
- feat: inject profile by @dbluhm in #2705
- chore(deps): Bump jinja2 from 3.1.2 to 3.1.3 by @dependabot in #2707
- feat: make VcLdpManager pluggable by @dbluhm in #2706
- Update RTD requirements after security vulnerability recorded by @swcurran in #2712
- fix: minor type hint corrections for VcLdpManager by @dbluhm in #2704
- Integration test for did:peer by @ianco in #2713
- Fix subwallet record removal by @andrewwhitehead in #2721
- Remove exception on connectionless presentation problem report handler by @loneil in #2723
- Fix incorrect Sphinx search library version reference by @swcurran in #2716
- Update the SupportedRFCs Document to be up to date by @swcurran in #2722
- Upgrade anoncreds to 0.2.0.dev7 by @jamshale in #2719
- Update devcontainer documentation by @jamshale in #2729
- 0.12.0rc0 by @swcurran in #2732
- docs: create design doc for adding W3C VC format support by @tra371 in #2674
- Upgrade anoncred-rs to version 0.2.0-dev8 by @jamshale in #2734
- bump pydid to v 0.4.3 by @PatStLouis in #2737
- Enable presentation issuance/verification through vc-api endpoints by @PatStLouis in #2710
- Upgrade anoncreds to 0.2.0-dev9 by @jamshale in #2741
- Relax validation of holder DID when submitting a credential request by @ianco in #2731
- chore(deps): Bump aiohttp from 3.9.1 to 3.9.2 by @dependabot in #2745
- chore: pin black version by @dbluhm in #2747
- Breaking - remove endorser capability to write ledger transactions by @ianco in #2720
- Update BBS+ context to bypass redirections by @swcurran in #2739
- Anoncreds schema endorsement by @jamshale in #2715
- Fix pytest collection errors when anoncreds package is not installed by @andrewwhitehead in #2750
- Add cached copy of BBS v1 context by @andrewwhitehead in #2749
- Remove asynctest dependency and fix "coroutine not awaited" warnings by @ff137 in #2755
- Update anoncreds to 0.2.0-dev10 by @jamshale in #2758
- Upgrade anoncreds to version 0.2.0-dev11 by @jamshale in #2763
- Move emit events to profile and delay sending until after commit by @ianco in #2760
- ⬆️ Update pytest-asyncio to 0.23.4 by @ff137 in #2764
- Reorganize the ACA-Py Documentation Files by @swcurran in #2765
- Anoncreds - Cred Def and Revocation Endorsement by @jamshale in #2752
- Tweaks to MD files to enable aca-py.org publishing by @swcurran in #2771
- Implement B006 rule by @jamshale in #2775
- ⬆️ Upgrade pytest to 8.0 by @ff137 in #2773
- fix: partial revert of ConnRecord schema change by @dbluhm in #2746
- Add Dependabot configuration by @WadeBarnes in #2783
- chore(deps): Bump the all-actions group with 10 updates by @dependabot in #2784
- Anoncreds revoke and publish-revocations endorsement by @jamshale in #2782
- Demo description of reuse in establishing a connection by @swcurran in #2787
- Revert profile inject by @jamshale in #2789
- Revert profile injection for VcLdpManager on vc-api endpoints by @PatStLouis in #2794
- feature/per tenant settings by @amanji in #2790
- Add known issues section to Multiledger.md documentation by @esune in #2788
- Bump pyld version to 2.0.4 by @PatStLouis in #2795
- Fix deprecation warnings by @ff137 in #2756
- Change middleware registration order by @PatStLouis in #2796
- 0.12.0rc1 by @swcurran in #2799
- 0.12.0rc1-tweak by @swcurran in #2800
- Author subwallet setup automation by @jamshale in #2791
- Add anoncreds multitenant endorsement integration tests by @jamshale in #2801
- Get and create anoncreds profile when using anoncreds subwallet by @jamshale in #2803
- Update publish-docs to operate on main and on branches prefixed with docs-v by @swcurran in #2804
- Publish docs GHActions tweak by @swcurran in #2806
- More updates to get docs publishing by @swcurran in #2810
- Eliminate the double workflow event by @swcurran in #2811
- Create revocation notification after list entry written to ledger by @jamshale in #2812
- Fix anoncreds non-endorsement revocation by @jamshale in #2814
- chore(deps): Bump the all-actions group with 3 updates by @dependabot in #2815
- Allow for crids in event payload to be integers by @jamshale in #2819
- FIX: GHA update for doc publishing, fix doc file that was blanked by @swcurran in #2820
- Send revocation list instead of rev_list object - Anoncreds by @jamshale in #2821
- chore(deps): Bump cryptography from 42.0.3 to 42.0.4 by @dependabot in #2805
- 0.12.0rc2 by @swcurran in #2825
- Integration tests - Add retry to did registration by @jamshale in #2827
- Create AnonCredsMethods.md by @swcurran in #2832
- Cleanup of docs, generator label fix by @swcurran in #2831
- chore(deps): Bump jwcrypto from 1.5.4 to 1.5.6 by @dependabot in #2833
- patch for #2781: User Agent header in doc loader by @gmulhearn-anonyome in #2824
- feat: did-rotate by @amanji in #2816
- Remove requirement for write ledger in read-only mode. by @esune in #2836
- chore(deps): Bump the all-actions group with 1 update by @dependabot in #2844
- Support connection re-use for did:peer:2/4 by @ianco in #2823
- Add functionality for building and running agents seprately by @sarthakvijayvergiya in #2845
- Update to run_demo script to support Apple M1 CPUs by @swcurran in #2843
- chore(deps-dev): Bump black from 24.1.1 to 24.3.0 by @dependabot in #2847
- Anoncreds - support for anoncreds and askar wallets concurrently by @jamshale in #2822
- Minor updates to the documentation - links, navigation and markdown by @swcurran in #2848
- fix: did exchange multiuse invites respond in kind by @dbluhm in #2850
- Prevent revocable cred def being created without tails server by @jamshale in #2849
- Update GHA so that broken image links work on docs site - without breaking them on GitHub by @swcurran in #2852
- Increase promote did retries by @jamshale in #2854
- Change did <--> verkey logging on connections by @jamshale in #2853
- feat: external signature suite provider interface by @dbluhm in #2835
- chore: propose official deprecations of a couple of features by @dbluhm in #2856
- fix(credo-interop): various didexchange and did:peer related fixes by @dbluhm in #2748
- fix: states for discovery record to emit webhook by @dbluhm in #2858
- Fix run_tests script by @ianco in #2866
- Add missing VC-DI/LD-Proof verification method option by @PatStLouis in #2867
- chore(deps): Bump pillow from 10.2.0 to 10.3.0 by @dependabot in #2869
- Emit the OOB done event even for multi-use invites by @ianco in #2872
- refactor: introduce use_did and use_did_method by @dbluhm in #2862
- 0.12.0rc3 by @swcurran in #2878
New Contributors
- @mrkaurelius made their first contribution in #2638
- @jamshale made their first contribution in #2672
- @PatStLouis made their first contribution in #2670
- @tra371 made their first contribution in #2674
- @gmulhearn-anonyome made their first contribution in #2824
- @sarthakvijayvergiya made their first contribution in #2845
Full Changelog: 0.11.0...0.12.0.rc3