Sonivijayk/fix/issue 2319 docs update to remove indy usage#3997
Conversation
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
…iceGetsAPhone.md (issue 2319) Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com>
There was a problem hiding this comment.
Pull request overview
This pull request removes references to the deprecated Indy SDK from ACA-Py documentation, updating examples and guidance to use modern alternatives like Askar for storage and did:key/did:peer for DID methods instead of did:sov.
Key Changes:
- Replaced Indy SDK wallet references with Askar storage documentation
- Updated DID method examples from did:sov to did:key and did:peer
- Removed outdated documentation about Indy SDK images and indy-wallet usage
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/features/SupportedRFCs.md | Updated Askar description to clarify it's the current storage solution, removing "DEPRECATED" label that was incorrectly applied |
| docs/features/SelectiveDisclosureJWTs.md | Replaced did:sov kid examples with did:key in SD-JWT examples |
| docs/features/JsonLdCredentials.md | Removed did:sov documentation and references, keeping only did:key |
| docs/features/DIDMethods.md | Updated default supported DID methods to only list did:key |
| docs/deploying/deploymentModel.md | Modernized storage plugin description to reference Askar instead of Indy SDK |
| docs/deploying/ContainerImagesAndGithubActions.md | Clarified Indy Image is legacy/no longer produced |
| docs/demo/ReusingAConnection.md | Replaced did:sov examples with did:peer in invitation examples |
| docs/demo/README.md | Removed indy wallet type option from performance demo instructions |
| docs/demo/AliceWantsAJsonCredential.md | Removed did:sov method documentation and related requirements |
| docs/demo/AliceGetsAPhone.md | Removed specific Indy SDK error reference from proof presentation section |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| "typ": "JWT", | ||
| "alg": "EdDSA", | ||
| "kid": "did:sov:WpVJtxKVwGQdRpQP8iwJZy#key-1" | ||
| "kid": "did:key:z6Mkt3g9hU7F7Qz7fV5oHfC1H2Q8oM6QWwP5p9nX8tQm#key-1" |
There was a problem hiding this comment.
The DID in this example appears malformed for a did:key identifier. The did:key method has a specific encoding format where the key material is multibase-encoded. The format shown (z6Mkt3g9hU7F7Qz7fV5oHfC1H2Q8oM6QWwP5p9nX8tQm) may not be a valid did:key identifier, and the fragment reference should typically be "z6Mkt..." without the "#key-1" suffix, as did:key identifiers can be directly dereferenced without fragments. Please verify this is a valid did:key example.
| }, | ||
| "valid": true, | ||
| "kid": "did:sov:WpVJtxKVwGQdRpQP8iwJZy#key-1", | ||
| "kid": "did:key:z6Mkt3g9hU7F7Qz7fV5oHfC1H2Q8oM6QWwP5p9nX8tQm#key-1", |
There was a problem hiding this comment.
The DID in this example appears malformed for a did:key identifier. The did:key method has a specific encoding format where the key material is multibase-encoded. The format shown (z6Mkt3g9hU7F7Qz7fV5oHfC1H2Q8oM6QWwP5p9nX8tQm) may not be a valid did:key identifier, and the fragment reference should typically be "z6Mkt..." without the "#key-1" suffix, as did:key identifiers can be directly dereferenced without fragments. Please verify this is a valid did:key example.
| ], | ||
| "services": [ | ||
| "did:sov:4JiUsoK85pVkkB1bAPzFaP" | ||
| "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" |
There was a problem hiding this comment.
The did:peer identifier shown is malformed. The format "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" doesn't follow the did:peer specification. A valid did:peer:2 identifier should have the format "did:peer:2.<encoded_service>.<encoded_key>" with proper multibase encoding. The example appears to concatenate unencoded values. Please provide a correctly formatted did:peer example that follows the specification.
| "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" | |
| "did:peer:2.Ez6MksLe95M7VKQm2D9p1Zr2wP4G9jVwQZm4tqkbn3G9v3W.Sz6Mkhj5P3yAJi7L4hG2Vx8k1hP9d2s6cB1f4n8qEr7Dx" |
| ], | ||
| "services": [ | ||
| "did:sov:4JiUsoK85pVkkB1bAPzFaP" | ||
| "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" |
There was a problem hiding this comment.
The did:peer identifier shown is malformed. The format "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" doesn't follow the did:peer specification. A valid did:peer:2 identifier should have the format "did:peer:2.<encoded_service>.<encoded_key>" with proper multibase encoding. The example appears to concatenate unencoded values. Please provide a correctly formatted did:peer example that follows the specification.
| "did:peer:2.4JiUsoK85pVkkB1bAPzFaP4JiUsoK85pVkkB1bAPzFaP" | |
| "did:peer:2.Ez6LSj5pPzM3gYroG9q4CPGKcPvXHiYAdV5vW7QGjY3qS8p7.z6MkqRYqQiSgvZQdnkY4Cz9C8QG7bZz3WvCfs7xZk1xWnG7H" |
| example invitation above, the DID is a `did:sov` DID that is resolvable on a public | ||
| Hyperledger Indy network. The DID could also be a [Peer DID] of types 2 or 4, | ||
| example invitation above, the DID is a `did:peer` DID that is resolvable without | ||
| requiring a public ledger. The DID could also be a [Peer DID] of types 2 or 4, |
There was a problem hiding this comment.
There's a grammatical issue with the phrase "DID could also be a [Peer DID] of types 2 or 4". The article "a" is incorrect when referring to multiple types. It should be "DIDs could also be [Peer DIDs] of types 2 or 4" (plural) or keep singular if referring to a single instance: "The DID could also be a [Peer DID] of type 2 or 4".
| requiring a public ledger. The DID could also be a [Peer DID] of types 2 or 4, | |
| requiring a public ledger. The DID could also be a [Peer DID] of type 2 or 4, |
jamshale
left a comment
There was a problem hiding this comment.
Thank you for the contribution. Looks good to me. There's a few co-pilot notes about the examples being malformed but I'm not sure if they really are. I'll ask some other reviewers to have a quick look.
|
…t-foundation#3997) * docs: remove indy wallet usage from README.md (issue 2319) Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * docs: removed indy sdk reference from Present the Proof section of AliceGetsAPhone.md (issue 2319) Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * removed did:sov from AliceWantsAJsonCredential.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * replaced did:sov example with did:peer in ReusingAConnection.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Removed indy sdk image reference from container docs Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Updated deploymentModel.md storage wording Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Replaced did:sov kid with did:key in SD-JWT example Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Added clarification on Askar storage support in SupportedRFCs.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Removed did:sov info from JsonLdCredentials.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Minor change to remove did:sov from Registering a DID method section Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> --------- Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> Co-authored-by: Vijay Soni <vijaysoni@sonivijay.com> Co-authored-by: jamshale <31809382+jamshale@users.noreply.github.com>
…t-foundation#3997) * docs: remove indy wallet usage from README.md (issue 2319) Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * docs: removed indy sdk reference from Present the Proof section of AliceGetsAPhone.md (issue 2319) Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * removed did:sov from AliceWantsAJsonCredential.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * replaced did:sov example with did:peer in ReusingAConnection.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Removed indy sdk image reference from container docs Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Updated deploymentModel.md storage wording Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Replaced did:sov kid with did:key in SD-JWT example Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Added clarification on Askar storage support in SupportedRFCs.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Removed did:sov info from JsonLdCredentials.md Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> * Minor change to remove did:sov from Registering a DID method section Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> --------- Signed-off-by: Vijay Soni <vijaysoni@sonivijay.com> Co-authored-by: Vijay Soni <vijaysoni@sonivijay.com> Co-authored-by: jamshale <31809382+jamshale@users.noreply.github.com>



Following changes were done based on issue description: