{"id":37188799,"url":"https://github.com/ldej/go-acapy-client","last_synced_at":"2026-01-14T21:57:33.602Z","repository":{"id":49974471,"uuid":"295673613","full_name":"ldej/go-acapy-client","owner":"ldej","description":"A client library for interacting with ACA-py to build your own Hyperledger Aries controller in Golang","archived":false,"fork":false,"pushed_at":"2021-06-07T08:51:10.000Z","size":346,"stargazers_count":7,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-22T16:57:02.086Z","etag":null,"topics":["acapy-client","aries","aries-cloudagent-python","golang","hyperledger","hyperledger-aries-developer","indy-sdk","self-sovereign-identity"],"latest_commit_sha":null,"homepage":"https://ldej.nl/post/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ldej.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-15T09:08:17.000Z","updated_at":"2023-02-09T20:13:05.000Z","dependencies_parsed_at":"2022-07-29T23:49:25.458Z","dependency_job_id":null,"html_url":"https://github.com/ldej/go-acapy-client","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ldej/go-acapy-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldej%2Fgo-acapy-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldej%2Fgo-acapy-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldej%2Fgo-acapy-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldej%2Fgo-acapy-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ldej","download_url":"https://codeload.github.com/ldej/go-acapy-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldej%2Fgo-acapy-client/sbom","scorecard":{"id":581355,"data":{"date":"2025-08-11","repo":{"name":"github.com/ldej/go-acapy-client","commit":"82da231a9f74cb4d8e41f4a927be3a9c96ed16df"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 1/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T19:15:15.954Z","repository_id":49974471,"created_at":"2025-08-20T19:15:15.954Z","updated_at":"2025-08-20T19:15:15.954Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28436253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T21:32:52.117Z","status":"ssl_error","status_checked_at":"2026-01-14T21:32:33.442Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acapy-client","aries","aries-cloudagent-python","golang","hyperledger","hyperledger-aries-developer","indy-sdk","self-sovereign-identity"],"created_at":"2026-01-14T21:57:32.978Z","updated_at":"2026-01-14T21:57:33.574Z","avatar_url":"https://github.com/ldej.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-acapy-client\n\nA library for interacting with ACA-py in Go.\n\n## Context\n\nYou can create your own Self-Sovereign Identity solution using the Hyperledger Ursa, Indy, Aries stack. Learn more about the background by watching these videos: \n\n- [The Story of Open SSI Standards](https://www.youtube.com/watch?v=RllH91rcFdE)\n- [Decentralized Identifiers (DIDs) - The Fundamental Building Block of Self Sovereign Identity](https://www.youtube.com/watch?v=Jcfy9wd5bZI\u0026)\n\nTo become an Aries developer, attend these courses by the Linux Foundation on [edx.org](https://edx.org):\n\n- [Introduction to Hyperledger Sovereign Identity Blockchain Solutions: Indy, Aries \u0026 Ursa](https://courses.edx.org/courses/course-v1:LinuxFoundationX+LFS172x+3T2019/course/)\n- [Becoming a Hyperledger Aries Developer](https://courses.edx.org/courses/course-v1:LinuxFoundationX+LFS173x+1T2020/course/) \n\n## Installation\n\n```shell\n$ go get -u github.com/ldej/go-acapy-client\n```\n\n## Compatibility\n\nBoth [ACA-py](https://github.com/hyperledger/aries-cloudagent-python) and `go-acapy-client` are under active development and might be incompatible. Currently `go-acapy-client` supports v0.6.0-pre of ACA-py.\n\n## Development\n\nStart a local Indy ledger network VON-network. Make a checkout of [github.com/bcgov/von-network](https://github.com/bcgov/von-network). Then run:\n\n```shell script\n./manage start --logs\n```\n\nThis starts 4 Indy nodes and a von-webserver. The von-webserver has a web interface at [localhost:9000](http://localhost:9000) which allows you to browse the transactions in the blockchain.\n\nStart a Tails server for the revocation registry tails files: Make a checkout of [github.com/bcgov/indy-tails-server](https://github.com/bcgov/indy-tails-server). Then run:\n\n```shell script\n./docker/manage start\n```\n\nStart an Aries-Cloud-Agent-Python (ACA-py) instance and configure the right command line parameters. Read about ACA-py and the command line parameters on my blog:\n\n- [Becoming a Hyperledger Aries Developer - Part 1: Terminology](https://ldej.nl/post/becoming-aries-developer-part-1-terminology/)\n- [Becoming a Hyperledger Aries Developer - Part 2: Development Environment](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-2-development-environment/)\n- [Becoming a Hyperledger Aries Developer - Part 3: Connecting using Swagger](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-3-connecting-using-swagger/)\n- [Becoming a Hyperledger Aries Developer - Part 3: Connecting using DIDComm Exchange](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-3-connecting-using-didcomm-exchange/)\n- [Becoming a Hyperledger Aries Developer - Part 4: Connecting using go-acapy-client](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-4-connecting-using-go-acapy-client/)\n- [Becoming a Hyperledger Aries Developer - Part 5: Issue Credentials](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-5-issue-credentials/)\n- [Becoming a Hyperledger Aries Developer - Part 6: Revocation](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-6-revocation/)\n- [Becoming a Hyperledger Aries Developer - Part 7: Present Proof](https://ldej.nl/post/becoming-a-hyperledger-aries-developer-part-7-present-proof/)\n- [Connecting ACA-py to Development Ledgers](https://ldej.nl/post/connecting-acapy-to-development-ledgers/)\n- [Aries Cloud Agent Python (ACA-py) Webhooks](https://ldej.nl/post/aries-cloudagent-python-webhooks/)\n\n## Examples\n\nCreate a client, register a DID in the ledger and create an invitation.\n\n```go\npackage main\n\nimport \"github.com/ldej/go-acapy-client\"\n\nfunc main() {\n    var ledgerURL = \"http://localhost:9000\"\n    var acapyURL = \"http://localhost:8000\"\n    client := acapy.NewClient(acapyURL)\n    \n    didResponse, err := acapy.RegisterDID(ledgerURL, \"Alice\", \"000000000000000000000000MySeed01\", acapy.Endorser)\n    if err != nil {\n    \t// handle error\n    }\n\n    // Start aca-py with registered DID\n    \n    invitation, err := client.CreateInvitation(\"Bob\", false, false, false)\n    if err != nil {\n        // handle error\n    }\n}\n```\n\nExamples can be found in the [examples](./examples) folder.\n\n## Implemented Endpoints\n\n### Action Menu\n\n`{id}` = connection identifier\n\n| Function Name | Method | Endpoint                    | Implemented   |\n| ------------- | ------ | --------------------------- | ------------- |\n| -             | POST   | /action-menu/{id}/close     | :exclamation: |\n| -             | POST   | /action-menu/{id}/fetch     | :exclamation: |\n| -             | POST   | /action-menu/{id}/perform   | :exclamation: |\n| -             | POST   | /action-menu/{id}/request   | :exclamation: |\n| -             | POST   | /action-menu/{id}/send-menu | :exclamation: |\n\n### Basic Message\n\n`{id}` = connection identifier\n\n| Function Name    | Method | Endpoint                       | Implemented        |\n| ---------------- | ------ | ------------------------------ | ------------------ |\n| SendBasicMessage | POST   | /connections/{id}/send-message | :heavy_check_mark: |\n\n### Connection\n\n`{id}` = connection identifier\n\n`{ref_id}` = inbound connection identifier\n\n| Function Name     | Method | Endpoint                                     | Implemented        |\n| ----------------- | ------ | -------------------------------------------- | ------------------ |\n| QueryConnections  | GET    | /connections                                 | :heavy_check_mark: |\n| CreateInvitation  | POST   | /connections/create-invitation               | :heavy_check_mark: |\n| -                 | POST   | /connections/create-static                   | :exclamation:      |\n| ReceiveInvitation | POST   | /connections/receive-invitation              | :heavy_check_mark: |\n| GetConnection     | GET    | /connections/{id}                            | :heavy_check_mark: |\n| RemoveConnection  | DELETE | /connections/{id}                            | :heavy_check_mark: |\n| AcceptInvitation  | POST   | /connections/{id}/accept-invitation          | :heavy_check_mark: |\n| AcceptRequest     | POST   | /connections/{id}/accept-request             | :heavy_check_mark: |\n| -                 | POST   | /connections/{id}/establish-inbound/{ref_id} | :exclamation:      |\n| -                 | GET    | /connections/{id}/metadata                   | :exclamation:      |\n| -                 | POST   | /connections/{id}/metadata                   | :exclamation:      |\n\n### Credential Definitions\n\n`{id}` = credential definition identifier\n\n| Function Name               | Method | Endpoint                        | Implemented        |\n| --------------------------- | ------ | ------------------------------- | ------------------ |\n| CreateCredentialDefinitions | POST   | /credential-definitions         | :heavy_check_mark: |\n| QueryCredentialDefinitions  | GET    | /credential-definitions/created | :heavy_check_mark: |\n| GetCredentialDefinition     | GET    | /credential-definitions/{id}    | :heavy_check_mark: |\n\n### Credentials\n\n`{id}` = credential identifier, also known as referent\n\n| Function Name       | Method | Endpoint                    | Implemented        |\n| ------------------- | ------ | --------------------------- | ------------------ |\n| CredentialMimeTypes | GET    | /credential/mime-types/{id} | :heavy_check_mark: |\n| IsCredentialRevoked | GET    | /credential/revoked/{id}    | :heavy_check_mark: |\n| GetCredential       | GET    | /credential/{id}            | :heavy_check_mark: |\n| RemoveCredential    | DELETE | /credential/{id}            | :heavy_check_mark: |\n| GetCredentials      | GET    | /credentials                | :heavy_check_mark: |\n\n### DID Exchange\n\n`{id}` = connection identifier\n\n| Function Name               | Method | Endpoint                            | Implemented        |\n| --------------------------- | ------ | ----------------------------------- | ------------------ |\n| DIDExchangeAcceptInvitation | POST   | /didexchange/{id}/accept-invitation | :heavy_check_mark: |\n| DIDExchangeAcceptRequest    | POST   | /didexchange/{id}/accept-request    | :heavy_check_mark: |\n\n### Introduction\n\n`{id}` = connection identifier\n\n| Function Name | Method | Endpoint                             | Implemented   |\n| ------------- | ------ | ------------------------------------ | ------------- |\n| -             | POST   | /connections/{id}/start-introduction | :exclamation: |\n\n### Issue Credentials (Credential Exchange v1.0)\n\n`{id}` = credential exchange identifier\n\n| Function Name                   | Method | Endpoint                                      | Implemented        |\n| ------------------------------- | ------ | --------------------------------------------- | ------------------ |\n| CreateCredentialExchange        | POST   | /issue-credential/create                      | :heavy_check_mark: |\n| QueryCredentialExchange         | GET    | /issue-credential/records                     | :heavy_check_mark: |\n| GetCredentialExchange           | GET    | /issue-credential/records/{id}                | :heavy_check_mark: |\n| RemoveCredentialExchange        | DELETE | /issue-credential/records/{id}                | :heavy_check_mark: |\n| IssueCredentialByID             | POST   | /issue-credential/records/{id}/issue          | :heavy_check_mark: |\n| ReportCredentialExchangeProblem | POST   | /issue-credential/records/{id}/problem-report | :heavy_check_mark: |\n| SendCredentialOfferByID         | POST   | /issue-credential/records/{id}/send-offer     | :heavy_check_mark: |\n| SendCredentialRequestByID       | POST   | /issue-credential/records/{id}/send-request   | :heavy_check_mark: |\n| StoreReceivedCredential         | POST   | /issue-credential/records/{id}/store          | :heavy_check_mark: |\n| SendCredential                  | POST   | /issue-credential/send                        | :heavy_check_mark: |\n| SendCredentialOffer             | POST   | /issue-credential/send-offer                  | :heavy_check_mark: |\n| SendCredentialProposal          | POST   | /issue-credential/send-proposal               | :heavy_check_mark: |\n\n### Issue Credentials (Credential Exchange v2.0)\n\n`{id}` = credential exchange identifier\n\n| Function Name                     | Method | Endpoint                                          | Implemented        |\n| --------------------------------- | ------ | ------------------------------------------------- | ------------------ |\n| CreateCredentialExchangeV2        | POST   | /issue-credential-2.0/create                      | :heavy_check_mark: |\n| QueryCredentialExchangeV2         | GET    | /issue-credential-2.0/records                     | :heavy_check_mark: |\n| GetCredentialExchangeV2           | GET    | /issue-credential-2.0/records/{id}                | :heavy_check_mark: |\n| RemoveCredentialExchangeV2        | DELETE | /issue-credential-2.0/records/{id}                | :heavy_check_mark: |\n| IssueCredentialByIDV2             | POST   | /issue-credential-2.0/records/{id}/issue          | :heavy_check_mark: |\n| ReportCredentialExchangeProblemV2 | POST   | /issue-credential-2.0/records/{id}/problem-report | :heavy_check_mark: |\n| SendCredentialOfferByIDV2         | POST   | /issue-credential-2.0/records/{id}/send-offer     | :heavy_check_mark: |\n| SendCredentialRequestByIDV2       | POST   | /issue-credential-2.0/records/{id}/send-request   | :heavy_check_mark: |\n| StoreReceivedCredentialV2         | POST   | /issue-credential-2.0/records/{id}/store          | :heavy_check_mark: |\n| SendCredentialV2                  | POST   | /issue-credential-2.0/send                        | :heavy_check_mark: |\n| SendCredentialOfferV2             | POST   | /issue-credential-2.0/send-offer                  | :heavy_check_mark: |\n| SendCredentialProposalV2          | POST   | /issue-credential-2.0/send-proposal               | :heavy_check_mark: |\n\n\n### Ledger\n\n| Function Name            | Method | Endpoint                          | Implemented        |\n| ------------------------ | ------ | --------------------------------- | ------------------ |\n| GetDIDEndpointFromLedger | GET    | /ledger/did-endpoint              | :heavy_check_mark: |\n| GetDIDVerkeyFromLedger   | GET    | /ledger/did-verkey                | :heavy_check_mark: |\n| GetDIDRoleFromLedger     | GET    | /ledger/get-nym-role              | :heavy_check_mark: |\n| -                        | POST   | /ledger/register-nym              | :exclamation:      |\n| -                        | PATCH  | /ledger/rotate-public-did-keypair | :exclamation:      |\n| -                        | GET    | /ledger/taa                       | :exclamation:      |\n| -                        | POST   | /ledger/taa/accept                | :exclamation:      |\n\n### Mediation\n\n`{id}` = connection identifier\n\n`{mid}` = mediation identifier\n\n| Function Name | Method | Endpoint                                     | Implemented   |\n| ------------- | ------ | -------------------------------------------- | ------------- |\n| -             | GET    | /mediation/default-mediator                  | :exclamation: |\n| -             | DELETE | /mediation/default-mediator                  | :exclamation: |\n| -             | GET    | /mediation/keylists                          | :exclamation: |\n| -             | POST   | /mediation/keylists/{mid}/send-keylist-query | :exclamation: |\n| -             | POST   | /mediation/keylists{mid}/send-keylist-update | :exclamation: |\n| -             | POST   | /mediation/request/{id}                      | :exclamation: |\n| -             | GET    | /mediation/requests                          | :exclamation: |\n| -             | GET    | /mediation/requests/{mid}                    | :exclamation: |\n|               | DELETE | /mediation/requests/{mid}                    | :exclamation: |\n| -             | POST   | /mediation/requests/{mid}/deny               | :exclamation: |\n| -             | POST   | /mediation/requests/{mid}/grant              | :exclamation: |\n| -             | PUT    | /mediation/{mid}/default-mediator            | :exclamation: |\n\n### Out-of-Band\n\n| Function Name              | Method | Endpoint                        | Implemented        |\n| -------------------------- | ------ | ------------------------------- | ------------------ |\n| CreateOutOfBandInvitation  | POST   | /out-of-band/create-invitation  | :heavy_check_mark: |\n| ReceiveOutOfBandInvitation | POST   | /out-of-band/receive-invitation | :heavy_check_mark: |\n\n### Present Proof\n\n`{id}` = presentation exchange identifier\n\n| Function Name                  | Method | Endpoint                                        | Implemented        |\n| ------------------------------ | ------ | ----------------------------------------------- | ------------------ |\n| CreatePresentationRequest      | POST   | /present-proof/create-request                   | :heavy_check_mark: |\n| QueryPresentationExchange      | GET    | /present-proof/records                          | :heavy_check_mark: |\n| GetPresentationExchangeByID    | GET    | /present-proof/records/{id}                     | :heavy_check_mark: |\n| RemovePresentationExchangeByID | DELETE | /present-proof/records/{id}                     | :heavy_check_mark: |\n| GetPresentationCredentialsByID | GET    | /present-proof/records/{id}/credentials         | :heavy_check_mark: |\n| SendPresentationRequestByID    | POST   | /present-proof/records/{id}/send-request        | :heavy_check_mark: |\n| SendPresentationByID           | POST   | /present-proof/records/{id}/send-presentation   | :heavy_check_mark: |\n| VerifyPresentationByID         | POST   | /present-proof/records/{id}/verify-presentation | :heavy_check_mark: |\n| SendPresentationProposal       | POST   | /present-proof/send-proposal                    | :heavy_check_mark: |\n| SendPresentationRequest        | POST   | /present-proof/send-request                     | :heavy_check_mark: |\n\n### Revocation\n\n`{id}` = revocation registry identifier, `{cred_def_id}` = credential definition identifier\n\n| Function Name                       | Method | Endpoint                                  | Implemented        |\n| ----------------------------------- | ------ | ----------------------------------------- | ------------------ |\n| GetActiveRevocationRegistry         | GET    | /revocation/active-registry/{cred_def_id} | :heavy_check_mark: |\n| ClearPendingRevocations             | POST   | /revocation/clear-pending-revocations     | :heavy_check_mark: |\n| CreateRevocationRegistry            | POST   | /revocation/create-registry               | :heavy_check_mark: |\n| GetCredentialRevocationStatus       | GET    | /revocation/credential-record             | :heavy_check_mark: |\n| PublishRevocations                  | POST   | /revocation/publish-revocations           | :heavy_check_mark: |\n| QueryRevocationRegistries           | GET    | /revocation/registries/created            | :heavy_check_mark: |\n| GetRevocationRegistry               | GET    | /revocation/registry/{id}                 | :heavy_check_mark: |\n| UpdateRevocationRegistryTailsURI    | PATCH  | /revocation/registry/{id}                 | :heavy_check_mark: |\n| PublishRevocationRegistryDefinition | POST   | /revocation/registry/{id}/definition      | :heavy_check_mark: |\n| PublishRevocationRegistryEntry      | POST   | /revocation/registry/{id}/entry           | :heavy_check_mark: |\n| GetNumberOfIssuedCredentials        | GET    | /revocation/registry/{id}/issued          | :heavy_check_mark: |\n| SetRevocationRegistryState          | PATCH  | /revocation/registry/{id}/set-state       | :heavy_check_mark: |\n| UploadRegistryTailsFile             | PUT    | /revocation/registry/{id}/tails-file      | :heavy_check_mark: |\n| DownloadRegistryTailsFile           | GET    | /revocation/registry/{id}/tails-file      | :heavy_check_mark: |\n| RevokeIssuedCredential              | POST   | /revocation/revoke                        | :heavy_check_mark: |\n\n### Schema\n\n`{id}` = schema identifier\n\n| Function Name  | Method | Endpoint         | Implemented        |\n| -------------- | ------ | ---------------- | ------------------ |\n| RegisterSchema | POST   | /schemas         | :heavy_check_mark: |\n| QuerySchemas   | GET    | /schemas/created | :heavy_check_mark: |\n| GetSchema      | GET    | /schemas/{id}    | :heavy_check_mark: |\n\n### Server\n\n| Function Name   | Method | Endpoint      | Implemented        |\n| --------------- | ------ | ------------- | ------------------ |\n| Features        | GET    | /features     | :heavy_check_mark: |\n| Plugins         | GET    | /plugins      | :heavy_check_mark: |\n| Shutdown        | GET    | /shutdown     | :heavy_check_mark: |\n| Status          | GET    | /status       | :heavy_check_mark: |\n| IsAlive         | GET    | /status/live  | :heavy_check_mark: |\n| IsReady         | GET    | /status/ready | :heavy_check_mark: |\n| ResetStatistics | POST   | /status/reset | :heavy_check_mark: |\n\n### Trust ping\n\n| Function Name | Method | Endpoint                    | Implemented        |\n| ------------- | ------ | --------------------------- | ------------------ |\n| SendPing      | POST   | /connections/{id}/send-ping | :heavy_check_mark: |\n\n\n### Wallet\n\n| Function Name            | Method | Endpoint                         | Implemented        |\n| ------------------------ | ------ | -------------------------------- | ------------------ |\n| QueryDIDs                | GET    | /wallet/did                      | :heavy_check_mark: |\n| CreateLocalDID           | POST   | /wallet/did/create               | :heavy_check_mark: |\n| RotateKeypair            | PATCH  | /wallet/did/local/rotate-keypair | :heavy_check_mark: |\n| GetPublicDID             | GET    | /wallet/did/public               | :heavy_check_mark: |\n| SetPublicDID             | POST   | /wallet/did/public               | :heavy_check_mark: |\n| GetDIDEndpointFromWallet | GET    | /wallet/get-public-did           | :heavy_check_mark: |\n| SetDIDEndpointInWallet   | POST   | /wallet/set-public-did           | :heavy_check_mark: |\n\n### JSON-LD (unlisted in Swagger)\n\n| Function Name | Method | Endpoint       | Implemented   |\n| ------------- | ------ | -------------- | ------------- |\n| SignJSONLD    | GET    | /jsonld/sign   | :exclamation: |\n| VerifyJSONLD  | GET    | /jsonld/verify | :exclamation: |\n\n## Webhooks\n\nWhen an event occurs in ACA-py, for example a connection request has been received, a webhook is called on your controller on a certain topic. `go-acapy-client` provides a webhook handler where you can register your own functions to handle these events. Based on an event happening you can update your UI or inform the user about the event.\n\nRead more about [ACA-py webhooks](https://ldej.nl/post/aries-cloudagent-python-webhooks/) on my blog.\n\n```go\nfunc main() {\n    r := mux.NewRouter()\n\twebhookHandler := acapy.CreateWebhooksHandler(acapy.WebhookHandlers{\n\t\tConnectionsEventHandler:            ConnectionsEventHandler,\n\t\tBasicMessagesEventHandler:          BasicMessagesEventHandler,\n\t\tProblemReportEventHandler:          ProblemReportEventHandler,\n\t\tCredentialExchangeEventHandler:     CredentialExchangeEventHandler,\n\t\tCredentialExchangeV2EventHandler:   CredentialExchangeV2EventHandler,\n\t\tCredentialExchangeDIFEventHandler:  CredentialExchangeDIFEventHandler,\n\t\tCredentialExchangeIndyEventHandler: CredentialExchangeIndyEventHandler,\n\t\tRevocationRegistryEventHandler:     RevocationRegistryEventHandler,\n\t\tPresentationExchangeEventHandler:   PresentationExchangeEventHandler,\n\t\tCredentialRevocationEventHandler:   CredentialRevocationEventHandler,\n\t\tPingEventHandler:                   PingEventHandler,\n\t\tOutOfBandEventHandler:              OutOfBandEventHandler,\n\t})\n    \n    r.HandleFunc(\"/webhooks/topic/{topic}/\", webhookHandler).Methods(http.MethodPost)\n    \n    // and so on\n}\n\nfunc ConnectionsEventHandler(event acapy.ConnectionsEvent) {\n    fmt.Printf(\"\\n -\u003e Connection %q (%s), update to state %q rfc23 state %q\\n\", event.Alias, event.ConnectionID, event.State, event.RFC23State)\n}\n\nfunc BasicMessagesEventHandler(event acapy.BasicMessagesEvent) {\n    fmt.Printf(\"\\n -\u003e Received message on connection %s: %s\\n\", event.ConnectionID, event.Content)\n}\n\nfunc ProblemReportEventHandler(event acapy.ProblemReportEvent) {\n    fmt.Printf(\"\\n -\u003e Received problem report: %+v\\n\", event)\n}\n\nfunc CredentialExchangeEventHandler(event acapy.CredentialExchange) {\n    fmt.Printf(\"\\n -\u003e Credential Exchange update: %s - %s\\n\", event.CredentialExchangeID, event.State)\n}\n\nfunc CredentialExchangeV2EventHandler(event acapy.CredentialExchangeRecordV2) {\n\tfmt.Printf(\"\\n -\u003e Credential Exchange V2 update: %s - %s\\n\", event.CredentialExchangeID, event.State)\n}\n\nfunc CredentialExchangeDIFEventHandler(event acapy.CredentialExchangeDIF) {\n\tfmt.Printf(\"\\n -\u003e Credential Exchange DIF Event: %s - %s\", event.CredentialExchangeID, event.State)\n}\n\nfunc CredentialExchangeIndyEventHandler(event acapy.CredentialExchangeIndy) {\n\tfmt.Printf(\"\\n -\u003e Credential Exchange Indy Event: %s - %s\", event.CredentialExchangeID, event.CredentialExchangeIndyID)\n}\n\nfunc RevocationRegistryEventHandler(event acapy.RevocationRegistry) {\n    fmt.Printf(\"\\n -\u003e Revocation Registry update: %s - %s\\n\", event.RevocationRegistryID, event.State)\n}\n\nfunc PresentationExchangeEventHandler(event acapy.PresentationExchange) {\n    fmt.Printf(\"\\n -\u003e Presentation Exchange update: %s - %s\\n\", event.PresentationExchangeID, event.State)\n}\n\nfunc CredentialRevocationEventHandler(event acapy.IssuerCredentialRevocationEvent) {\n    fmt.Printf(\"\\n -\u003e Issuer Credential Revocation: %s - %s - %s\\n\", event.CredentialExchangeID, event.RecordID, event.State)\n}\n\nfunc PingEventHandler(event acapy.PingEvent) {\n    fmt.Printf(\"\\n -\u003e Ping Event: %q state: %q responded: %t\\n\", event.ConnectionID, event.State, event.Responded)\n}\n\nfunc OutOfBandEventHandler(event acapy.OutOfBandEvent) {\n    fmt.Printf(\"\\n -\u003e Out of Band Event: %q state %q\\n\", event.InvitationID, event.State)\n}\n```\n\nYou are free to choose the URL for your webhooks. Don't forget to set the command-line parameter for ACA-py: `--webhook-url http://localhost:{port}/webhooks`. The URL you provide to ACA-py is the base URL which will be extended with `/topic/{topic}` by default. So whatever URL you choose, make sure that:\n\n- if the `--webhook-url` is `http://myhost:{port}/webhooks` \n- then the webhooks handler should listen on `http://myhost:{port}/webhooks/topic/{topic}`\n\nThe `acapy.WebhookHandler` is web framework agnostic and reads the topic from the URL by itself. The handler returned by `acapy.WebhookHandler` has the standard handler signature `func (w http.ResponseWriter, r *http.Request) {}`.\n\n## TODO\n\n- [ ] godoc\n- [ ] Proper error handling\n- [x] Admin API Key\n- [x] Tracing via global config\n- [ ] Automation of steps via global config\n- [ ] Payment decorators https://github.com/hyperledger/aries-rfcs/tree/master/features/0075-payment-decorators\n- [ ] Constructors for JSON-LD types\n- [ ] Add types for roles, states, predicates\n- [ ] Allow for a connection-less credential exchange\n- [ ] Allow for a connection-less proof by making a QR code of a payload below. The base64 payload is the result of your call to  `/present-proof/create-request`.\n```json\n{\n    \"@id\": \"3b67c4bf-3953-4ace-94ef-28e0969288c5\",\n    \"@type\": \"did:sov:BzCbsNYhMrjHiqZDTUASHg;spec/present-proof/1.0/request-presentation\",\n    \"request_presentations~attach\": [\n        {\n            \"@id\": \"libindy-request-presentation-0\",\n            \"mime-type\": \"application/json\",\n            \"data\": {\n                \"base64\": \"eyJuYW1lIjoiQ29udGFjdCBBZGRyZXNzIiwidmVyc2lvbiI6IjEuMC4wIiwibm9uY2UiOiIzOTIyNTEwMjk1NjY5MzcxNDIxNTIzMDgiLCJyZXF1ZXN0ZWRfYXR0cmlidXRlcyI6eyJHaXZlbiBOYW1lcyI6eyJuYW1lIjoiZ2l2ZW5fbmFtZXMiLCJyZXN0cmljdGlvbnMiOlt7InNjaGVtYV9pc3N1ZXJfZGlkIjoiODU0NTlHeGpOeVNKOEh3VFRRNHZxNyIsInNjaGVtYV9uYW1lIjoidmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIxLjQuMCJ9LHsic2NoZW1hX25hbWUiOiJ1bnZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMC4xLjAiLCJpc3N1ZXJfZGlkIjoiOFlxN0VoS0JNdWpoMjVOa0xHR2IydCJ9XX0sIkZhbWlseSBOYW1lIjp7Im5hbWUiOiJmYW1pbHlfbmFtZSIsInJlc3RyaWN0aW9ucyI6W3sic2NoZW1hX2lzc3Vlcl9kaWQiOiI4NTQ1OUd4ak55U0o4SHdUVFE0dnE3Iiwic2NoZW1hX25hbWUiOiJ2ZXJpZmllZF9wZXJzb24iLCJzY2hlbWFfdmVyc2lvbiI6IjEuNC4wIn0seyJzY2hlbWFfbmFtZSI6InVudmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIwLjEuMCIsImlzc3Vlcl9kaWQiOiI4WXE3RWhLQk11amgyNU5rTEdHYjJ0In1dfSwiRGF0ZSBvZiBCaXJ0aCI6eyJuYW1lIjoiYmlydGhkYXRlIiwicmVzdHJpY3Rpb25zIjpbeyJzY2hlbWFfaXNzdWVyX2RpZCI6Ijg1NDU5R3hqTnlTSjhId1RUUTR2cTciLCJzY2hlbWFfbmFtZSI6InZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMS40LjAifSx7InNjaGVtYV9uYW1lIjoidW52ZXJpZmllZF9wZXJzb24iLCJzY2hlbWFfdmVyc2lvbiI6IjAuMS4wIiwiaXNzdWVyX2RpZCI6IjhZcTdFaEtCTXVqaDI1TmtMR0diMnQifV19LCJTdHJlZXQgQWRkcmVzcyI6eyJuYW1lIjoic3RyZWV0X2FkZHJlc3MiLCJyZXN0cmljdGlvbnMiOlt7InNjaGVtYV9pc3N1ZXJfZGlkIjoiODU0NTlHeGpOeVNKOEh3VFRRNHZxNyIsInNjaGVtYV9uYW1lIjoidmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIxLjQuMCJ9LHsic2NoZW1hX25hbWUiOiJ1bnZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMC4xLjAiLCJpc3N1ZXJfZGlkIjoiOFlxN0VoS0JNdWpoMjVOa0xHR2IydCJ9XX0sIlBvc3RhbCBDb2RlIjp7Im5hbWUiOiJwb3N0YWxfY29kZSIsInJlc3RyaWN0aW9ucyI6W3sic2NoZW1hX2lzc3Vlcl9kaWQiOiI4NTQ1OUd4ak55U0o4SHdUVFE0dnE3Iiwic2NoZW1hX25hbWUiOiJ2ZXJpZmllZF9wZXJzb24iLCJzY2hlbWFfdmVyc2lvbiI6IjEuNC4wIn0seyJzY2hlbWFfbmFtZSI6InVudmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIwLjEuMCIsImlzc3Vlcl9kaWQiOiI4WXE3RWhLQk11amgyNU5rTEdHYjJ0In1dfSwiQ2l0eSI6eyJuYW1lIjoibG9jYWxpdHkiLCJyZXN0cmljdGlvbnMiOlt7InNjaGVtYV9pc3N1ZXJfZGlkIjoiODU0NTlHeGpOeVNKOEh3VFRRNHZxNyIsInNjaGVtYV9uYW1lIjoidmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIxLjQuMCJ9LHsic2NoZW1hX25hbWUiOiJ1bnZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMC4xLjAiLCJpc3N1ZXJfZGlkIjoiOFlxN0VoS0JNdWpoMjVOa0xHR2IydCJ9XX0sIlByb3ZpbmNlIjp7Im5hbWUiOiJyZWdpb24iLCJyZXN0cmljdGlvbnMiOlt7InNjaGVtYV9pc3N1ZXJfZGlkIjoiODU0NTlHeGpOeVNKOEh3VFRRNHZxNyIsInNjaGVtYV9uYW1lIjoidmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIxLjQuMCJ9LHsic2NoZW1hX25hbWUiOiJ1bnZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMC4xLjAiLCJpc3N1ZXJfZGlkIjoiOFlxN0VoS0JNdWpoMjVOa0xHR2IydCJ9XX0sIkNvdW50cnkiOnsibmFtZSI6ImNvdW50cnkiLCJyZXN0cmljdGlvbnMiOlt7InNjaGVtYV9pc3N1ZXJfZGlkIjoiODU0NTlHeGpOeVNKOEh3VFRRNHZxNyIsInNjaGVtYV9uYW1lIjoidmVyaWZpZWRfcGVyc29uIiwic2NoZW1hX3ZlcnNpb24iOiIxLjQuMCJ9LHsic2NoZW1hX25hbWUiOiJ1bnZlcmlmaWVkX3BlcnNvbiIsInNjaGVtYV92ZXJzaW9uIjoiMC4xLjAiLCJpc3N1ZXJfZGlkIjoiOFlxN0VoS0JNdWpoMjVOa0xHR2IydCJ9XX19LCJyZXF1ZXN0ZWRfcHJlZGljYXRlcyI6e319\"\n            }\n        }\n    ],\n    \"comment\": null,\n    \"~service\": {\n        \"recipientKeys\": [\n            \"F2fFPEXABoPKt8mYjNAavBwbsmQKYqNTcv3HKqBgqpLw\"\n        ],\n        \"routingKeys\": null,\n        \"serviceEndpoint\": \"https://my-url.test.org\"\n    }\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fldej%2Fgo-acapy-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fldej%2Fgo-acapy-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fldej%2Fgo-acapy-client/lists"}