1.6.1rc0

swcurran · swcurran · commit 17f3e2ef99d8 · 2026-07-21T11:28:24.000-07:00
Signed-off-by: Stephen Curran &lt;swcurran@gmail.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,52 @@
 # ACA-Py Changelog
 
+## 1.6.1rc0
+
+### July 21, 2026
+
+ACA-Py 1.6.1rc0 includes fixes found from continued production use of the `askar-anoncreds` wallet migration and revocation processes, and a fix to bound the memory usage of record queries and maintenance/upgrade scans, improving stability for larger deployments. The multitenancy subwallet removal endpoint has been updated to use `DELETE` for REST consistency, with the previous `POST .../remove` endpoint now deprecated. Many `dependabot` PRs are included to keep dependencies current and secure.
+
+Several PRs in this release complete the work to make ACA-Py 1.6 an official LTS release, with several fixes to the LTS CI/CD image tagging and publishing process
+
+New governance documentation, including a Technical Charter and an OWF Project Mapping Document, are included.
+
+### 1.6.1 Breaking Changes
+
+There are no breaking changes in this release.
+
+### 1.6.1 Deprecation Notices
+
+The `acapy_agent.revocation_anoncreds` package has been deprecated and relocated to `acapy_agent.anoncreds.revocation` for improved consistency across the codebase. The change should only affect [ACA-Py Plugins] that implement AnonCreds, but other developers should also take note.
+
+The `wallet-type` configuration value `askar` is now deprecated and all deployments still using that wallet type should migrate to either the `askar-anoncreds` or (ideally) `kanon-anoncreds` wallet types.
+
+For REST consistency the `POST /multitenancy/wallet/{wallet_id}/remove` endpoint is deprecated, replaced with the `DELETE /multitenancy/wallet/{wallet_id}` endpoint. Implementers should update plugins and their own code to use the new endpoint. The old endpoint will be removed in a future release.
+
+### 1.6.1 Categorized PR List
+
+- **Core Platform and Multitenancy**
+  - feat: use DELETE for multitenancy subwallet removal [\#4172](https://github.com/openwallet-foundation/acapy/pull/4172) [esune](https://github.com/esune)
+  - fix: bound memory usage of record queries and maintenance/upgrade scans [\#4171](https://github.com/openwallet-foundation/acapy/pull/4171) [esune](https://github.com/esune)
+- **AnonCreds Revocation and Wallet Migration**
+  - fix: Check RECORD_TYPE_ACAPY_UPGRADING type for clustered upgrade check [\#4167](https://github.com/openwallet-foundation/acapy/pull/4167) [jamshale](https://github.com/jamshale)
+  - fix: complete stalled setup when activating a posted revocation registry [\#4164](https://github.com/openwallet-foundation/acapy/pull/4164) [kukgini](https://github.com/kukgini)
+  - Fix anoncreds upgrade failure in-memory in-progress check [\#4163](https://github.com/openwallet-foundation/acapy/pull/4163) [jamshale](https://github.com/jamshale)
+- **Documentation and Governance**
+  - docs: warn that the subwallet token endpoint invalidates previous tokens [\#4166](https://github.com/openwallet-foundation/acapy/pull/4166) [kukgini](https://github.com/kukgini)
+  - Update README.md [\#4158](https://github.com/openwallet-foundation/acapy/pull/4158) [SeanBohan](https://github.com/SeanBohan)
+  - Add ACA-Py OWF Project Mapping Document [\#4147](https://github.com/openwallet-foundation/acapy/pull/4147) [swcurran](https://github.com/swcurran)
+  - Add Technical Charter plus minor updates to the Readme for the new Adaptive Cloud Agent-Python name [\#4143](https://github.com/openwallet-foundation/acapy/pull/4143) [swcurran](https://github.com/swcurran)
+- **LTS Release CI/CD**
+  - Update LTS Docker image tag to py3.13-1.6-lts [\#4151](https://github.com/openwallet-foundation/acapy/pull/4151) [swcurran](https://github.com/swcurran)
+  - fix(ci): use correct python version per LTS release when tagging images [\#4150](https://github.com/openwallet-foundation/acapy/pull/4150) [esune](https://github.com/esune)
+  - Fix/lts release cicd [\#4149](https://github.com/openwallet-foundation/acapy/pull/4149) [esune](https://github.com/esune)
+  - fix(ci): update python version in LTS image tagging to match publish workflow [\#4142](https://github.com/openwallet-foundation/acapy/pull/4142) [esune](https://github.com/esune)
+  - Make ACA-Py 1.6 an LTS release [\#4127](https://github.com/openwallet-foundation/acapy/pull/4127) [swcurran](https://github.com/swcurran)
+- **Dependabot PRs**
+  - [Link to list of Dependabot PRs in this release](https://github.com/openwallet-foundation/acapy/pulls?q=is%3Apr+is%3Amerged+merged%3A2026-04-01..2026-07-21+author%3Aapp%2Fdependabot+)
+- **Release management pull requests**:
+  - 1.6.1rc0 [\#4178](https://github.com/openwallet-foundation/acapy/pull/4178) [swcurran](https://github.com/swcurran)
+
 ## 1.6.0
 
 ### April 1, 2026
diff --git a/Managing-ACA-Py-Doc-Site.md b/Managing-ACA-Py-Doc-Site.md
@@ -20,7 +20,7 @@ and mkdocs configuration.
 
 When the GitHub Action fires, it runs a container that carries out the following steps:
 
-- Checks out the triggering branch, either `main` or `docs-v<version>` (e.g `docs-v1.6.0`).
+- Checks out the triggering branch, either `main` or `docs-v<version>` (e.g `docs-v1.6.1`).
 - Runs the script [scripts/prepmkdocs.sh], which moves and updates some of the
   markdown files so that they fit into the generated site. See the comments in
   the scripts for details about the copying and editing done via the script. In
@@ -97,7 +97,7 @@ To delete the documentation version, do the following:
 - Check your `git status` and make sure there are no changes in the branch --
   e.g., new files that shouldn't be added to the `gh-pages` branch. If there are
   any -- delete the files so they are not added.
-- Remove the folder for the RC.  For example `rm -rf 1.6.0rc0`
+- Remove the folder for the RC.  For example `rm -rf 1.6.1rc0`
 - Edit the `versions.json` file and remove the reference to the RC release in
   the file.
 - Push the changes via a PR to the ACA-Py `gh-pages` branch (don't PR them into
diff --git a/PUBLISHING.md b/PUBLISHING.md
@@ -6,7 +6,7 @@ a major, minor or patch release, per [semver](https://semver.org/) rules.
 
 Once ready to do a release, create a local branch that includes the following updates:
 
-1. Create a local PR branch from an updated `main` branch, e.g. "1.6.0".
+1. Create a local PR branch from an updated `main` branch, e.g. "1.6.1".
 
 2. See if there are any Document Site `mkdocs` changes needed. Run the script
    `./scripts/prepmkdocs.sh; mkdocs`. Watch the log, noting particularly if
@@ -120,7 +120,9 @@ For the build test, the RTD Sphinx theme needs to be added to the docker image,
 
    Command: `cd acapy_agent;../scripts/generate-open-api-spec;cd ..`
 
-   Folders may not be cleaned up by the script, so the following can be run, likely with `sudo` -- `rm -rf open-api/.build`. The folder is `.gitignore`d, so there is not a danger they will be pushed, even if they are not deleted.
+   Folders may not be cleaned up by the script, so the following can be run,
+   likely with `sudo` -- `rm -rf open-api/.build`. The folder is `.gitignore`d,
+   so there is not a danger they will be pushed, even if they are not deleted.
 
 9. Double check all of these steps above, and then submit a PR from the branch.
    Add this new PR to CHANGELOG.md so that all the PRs are included.
@@ -154,15 +156,15 @@ For the build test, the RTD Sphinx theme needs to be added to the docker image,
    
    Published images are automatically tagged with multiple tags for flexibility:
    
-   - **Regular Releases** (e.g., `1.6.0`):
-     - `py3.12-1.6.0` - Python version specific tag
-     - `1.6.0` - Semantic version tag
+   - **Regular Releases** (e.g., `1.6.1`):
+     - `py3.12-1.6.1` - Python version specific tag
+     - `1.6.1` - Semantic version tag
      - `1.6` - Major.minor tag (moves to latest patch release)
      - `latest` - Only assigned if this is the highest semantic version
    
-   - **Release Candidates** (e.g., `1.6.0rc0`):
-     - `py3.12-1.6.0rc0` - Python version specific RC tag
-     - `1.6.0rc0` - Semantic version RC tag
+   - **Release Candidates** (e.g., `1.6.1rc0`):
+     - `py3.12-1.6.1rc0` - Python version specific RC tag
+     - `1.6.1rc0` - Semantic version RC tag
      - **Note**: RC releases do NOT receive major.minor (`1.6`) or `latest` tags
    
    The `latest` tag is explicitly managed by comparing semantic versions across all
@@ -172,7 +174,7 @@ For the build test, the RTD Sphinx theme needs to be added to the docker image,
    
    **LTS (Long Term Support) Releases:**
    
-   LTS versions receive additional tags (e.g., `py3.12-0.12-lts`) that move to the
+   LTS versions receive additional tags (e.g., `py3.12-1.6-lts`) that move to the
    latest patch release in that LTS line. LTS versions are configured in
    `.github/lts-versions.txt`. See `.github/LTS-README.md` for more details.
 
@@ -187,7 +189,7 @@ For the build test, the RTD Sphinx theme needs to be added to the docker image,
 [publish.yml]: https://github.com/openwallet-foundation/acapy/blob/main/.github/workflows/publish.yml
 
 13. When a new release is tagged, create a new branch at the same commit with
-    the branch name in the format `docs-v<version>`, for example, `docs-v1.6.0rc0`.
+    the branch name in the format `docs-v<version>`, for example, `docs-v1.6.1rc0`.
     The creation of the branch triggers the execution of the [publish-docs]
     GitHub Action which generates the documentation for the new release,
     publishing it at [https://aca-py.org]. The GitHub Action also executes when
diff --git a/docs/deploying/ContainerImagesAndGithubActions.md b/docs/deploying/ContainerImagesAndGithubActions.md
@@ -42,24 +42,24 @@ Click [here](https://github.com/openwallet-foundation/acapy/pkgs/container/acapy
 
 The following is the ACA-Py container images tagging format:
 
-**Regular Releases** (e.g., `1.6.0`):
- - `py3.12-1.6.0` - Python version specific tag
- - `1.6.0` - Semantic version tag
+**Regular Releases** (e.g., `1.6.1`):
+ - `py3.12-1.6.1` - Python version specific tag
+ - `1.6.1` - Semantic version tag
  - `1.6` - Major.minor tag (moves to latest patch release)
  - `latest` - Only assigned if this is the highest semantic version
 
-**Release Candidates** (e.g., `1.6.0rc0`):
- - `py3.12-1.6.0rc0` - Python version specific RC tag
- - `1.6.0rc0` - Semantic version RC tag
+**Release Candidates** (e.g., `1.6.1rc0`):
+ - `py3.12-1.6.1rc0` - Python version specific RC tag
+ - `1.6.1rc0` - Semantic version RC tag
  - **Note**: RC releases do NOT receive major.minor (`1.6`) or `latest` tags
 
 **Nightly Builds**:
 - `pyV.vv-nightly-YYYY-MM-DD` - Date-stamped nightly build
 - `pyV.vv-nightly` - Latest nightly build
 
 **LTS ([Long Term Support](../../LTS-Strategy.md)) Releases**:
-- `pyV.vv-X.Y-lts` - LTS tag (e.g., `py3.12-0.12-lts`)
-- This tag automatically moves to the latest patch release in the LTS line (e.g., from `0.12.4` to `0.12.5`)
+- `pyV.vv-X.Y-lts` - LTS tag (e.g., `py3.12-1.6-lts`)
+- This tag automatically moves to the latest patch release in the LTS line (e.g., from `1.6.0` to `1.6.1`)
 - LTS versions are managed via the `.github/lts-versions.txt` configuration file
 - See `.github/LTS-README.md` for details on configuring LTS versions
 
diff --git a/docs/features/PlugIns.md b/docs/features/PlugIns.md
@@ -107,9 +107,9 @@ When plugins are installed, ACA-Py logs detailed information including:
 
 Example log output:
 ```
-INFO: Auto-installing plugins from acapy-plugins repository: webvh, connection_update (current ACA-Py version (1.6.0))
-INFO: Installing plugin: webvh (version: 1.6.0)
-INFO: Successfully installed plugin: webvh (version: 1.6.0)
+INFO: Auto-installing plugins from acapy-plugins repository: webvh, connection_update (current ACA-Py version (1.6.1))
+INFO: Installing plugin: webvh (version: 1.6.1)
+INFO: Successfully installed plugin: webvh (version: 1.6.1)
 ```
 
 ### Checking Installed Plugin Versions
diff --git a/docs/features/SupportedRFCs.md b/docs/features/SupportedRFCs.md
@@ -8,7 +8,7 @@ ACA-Py or the repository `main` branch. Reminders (and PRs!) to update this page
 welcome! If you have any questions, please contact us on the #aries channel on
 [OpenWallet Foundation Discord](https://discord.gg/openwallet-foundation) or through an issue in this repo.
 
-**Last Update**: 2026-04-01, Release 1.6.0
+**Last Update**: 2026-07-21, Release 1.6.1rc0
 
 > The checklist version of this document was created as a joint effort
 > between [Northern Block](https://northernblock.io/), [Animo Solutions](https://animo.id/) and the Ontario government, on behalf of the Ontario government.
diff --git a/open-api/openapi.json b/open-api/openapi.json
@@ -2,7 +2,7 @@
   "openapi" : "3.0.1",
   "info" : {
     "title" : "Aries Cloud Agent",
-    "version" : "v1.6.0"
+    "version" : "v1.6.1rc0"
   },
   "servers" : [ {
     "url" : "/"
@@ -3470,6 +3470,42 @@
           "schema" : {
             "type" : "string"
           }
+        }, {
+          "description" : "Order results in descending order if true",
+          "in" : "query",
+          "name" : "descending",
+          "schema" : {
+            "default" : false,
+            "type" : "boolean"
+          }
+        }, {
+          "description" : "Number of results to return",
+          "in" : "query",
+          "name" : "limit",
+          "schema" : {
+            "default" : 100,
+            "maximum" : 10000,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Offset for pagination",
+          "in" : "query",
+          "name" : "offset",
+          "schema" : {
+            "default" : 0,
+            "minimum" : 0,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "The column to order results by. Only \"id\" is currently supported.",
+          "in" : "query",
+          "name" : "order_by",
+          "schema" : {
+            "default" : "id",
+            "enum" : [ "id" ],
+            "type" : "string"
+          }
         }, {
           "description" : "Filer on role, 'client' for keys mediated by other agents, 'server' for keys mediated by this agent",
           "in" : "query",
@@ -3872,7 +3908,7 @@
       }
     },
     "/multitenancy/wallet/{wallet_id}" : {
-      "get" : {
+      "delete" : {
         "parameters" : [ {
           "description" : "Subwallet identifier",
           "in" : "path",
@@ -3882,22 +3918,33 @@
             "type" : "string"
           }
         } ],
+        "requestBody" : {
+          "content" : {
+            "*/*" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/RemoveWalletRequest"
+              }
+            }
+          },
+          "required" : false
+        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/WalletRecord"
+                  "$ref" : "#/components/schemas/MultitenantModuleResponse"
                 }
               }
             },
             "description" : ""
           }
         },
-        "summary" : "Get a single subwallet",
-        "tags" : [ "multitenancy" ]
+        "summary" : "Remove a subwallet",
+        "tags" : [ "multitenancy" ],
+        "x-codegen-request-body-name" : "body"
       },
-      "put" : {
+      "get" : {
         "parameters" : [ {
           "description" : "Subwallet identifier",
           "in" : "path",
@@ -3907,16 +3954,6 @@
             "type" : "string"
           }
         } ],
-        "requestBody" : {
-          "content" : {
-            "*/*" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/UpdateWalletRequest"
-              }
-            }
-          },
-          "required" : false
-        },
         "responses" : {
           "200" : {
             "content" : {
@@ -3929,11 +3966,10 @@
             "description" : ""
           }
         },
-        "summary" : "Update a subwallet",
-        "tags" : [ "multitenancy" ],
-        "x-codegen-request-body-name" : "body"
+        "summary" : "Get a single subwallet",
+        "tags" : [ "multitenancy" ]
       },
-      "delete" : {
+      "put" : {
         "parameters" : [ {
           "description" : "Subwallet identifier",
           "in" : "path",
@@ -3947,7 +3983,7 @@
           "content" : {
             "*/*" : {
               "schema" : {
-                "$ref" : "#/components/schemas/RemoveWalletRequest"
+                "$ref" : "#/components/schemas/UpdateWalletRequest"
               }
             }
           },
@@ -3958,14 +3994,14 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/MultitenantModuleResponse"
+                  "$ref" : "#/components/schemas/WalletRecord"
                 }
               }
             },
             "description" : ""
           }
         },
-        "summary" : "Remove a subwallet",
+        "summary" : "Update a subwallet",
         "tags" : [ "multitenancy" ],
         "x-codegen-request-body-name" : "body"
       }
@@ -4011,6 +4047,7 @@
     },
     "/multitenancy/wallet/{wallet_id}/token" : {
       "post" : {
+        "description" : "Issue a new auth token for a subwallet. Issuing a new token invalidates any token previously issued for the wallet: only the most recently issued token is valid. Do not call this endpoint if another client may still be using a previously issued token for the wallet.",
         "parameters" : [ {
           "in" : "path",
           "name" : "wallet_id",
@@ -5070,6 +5107,42 @@
             "pattern" : "^([123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{21,22}):3:CL:(([1-9][0-9]*)|([123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{21,22}:2:.+:[0-9.]+)):(.+)?$",
             "type" : "string"
           }
+        }, {
+          "description" : "Order results in descending order if true",
+          "in" : "query",
+          "name" : "descending",
+          "schema" : {
+            "default" : false,
+            "type" : "boolean"
+          }
+        }, {
+          "description" : "Number of results to return",
+          "in" : "query",
+          "name" : "limit",
+          "schema" : {
+            "default" : 100,
+            "maximum" : 10000,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Offset for pagination",
+          "in" : "query",
+          "name" : "offset",
+          "schema" : {
+            "default" : 0,
+            "minimum" : 0,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "The column to order results by. Only \"id\" is currently supported.",
+          "in" : "query",
+          "name" : "order_by",
+          "schema" : {
+            "default" : "id",
+            "enum" : [ "id" ],
+            "type" : "string"
+          }
         }, {
           "description" : "Revocation registry state",
           "in" : "query",
diff --git a/open-api/swagger.json b/open-api/swagger.json
diff --git a/pyproject.toml b/pyproject.toml
