Package: aries-cloudagent-vsw
Hyperledger Aries Cloud Agent - PythonAn easy to use Aries agent for building SSI services using any language that supports sending/receiving HTTP requests.Hyperledger Aries Cloud Agent Python (ACA-Py) is a foundation for building self-sovereign identity (SSI) / decentralized identity services running in non-mobile environments using DIDcomm messaging, the did:peer DID method, and verifiable credentials. With ACA-Py, SSI developers can focus on building services using familiar web development technologies instead of trying to learn the nuts and bolts of low-level SDKs.As we create ACA-Py, we're also building resources so that developers with a wide-range of backgrounds can get productive with ACA-Py in a hurry. Checkout theresourcessection below and jump in.The "cloud" in Aries Cloud Agent - Python doesNOTmean that ACA-Py cannot be used as an edge agent. ACA-Py is suitable for use in any non-mobile agent scenario, including as an enterprise edge agent for
issuing, verifying and holding verifiable credentials.Table of ContentsBackgroundInstallUsageSecurityAPIResourcesQuickstartArchitectural Deep DiveGetting Started GuideRead the DocsWhat to Focus On?CreditContributingLicenseBackgroundDeveloping an ACA-Py-based application is pretty straight forward for those familiar with web development. An ACA-Py instance is always deployed with a paired "controller" application that provides the business logic for that ACA-Py agent. The controller receives webhook event notifications from its instance of ACA-Py and uses an HTTP API exposed by the ACA-Py instance to provide direction on how to respond to those events. No ACA-Py/Python development is needed--just deploy an ACA-Py instance from PyPi (examples available). The source of the business logic is your imagination. An interface to a legacy system? A user interface for a person? Custom code to implement a new service? You can build your controller in any language that supports making and receiving HTTP requests. Wait...that's every language!ACA-Py currently supports "only" Hyperledger Indy's verifiable credentials scheme (which is pretty powerful). We are experimenting with adding support to ACA-Py for other DID Ledgers and verifiable credential schemes.ACA-Py is built on the Aries concepts and features defined in theAries RFCrepository.This documentcontains a (reasonably up to date) list of supported Aries RFCs by the current ACA-Py implementation.InstallACA-Py can be run with docker without installation, or can be installedfrom PyPi. Use the following command to install it locally:pipinstallaries-cloudagentUsageInstructions for running ACA-Py can befound here.SecurityThe administrative API exposed by the agent for the controller to use must be protected with an API key
(using the--admin-api-keycommand line arg) or deliberately left unsecured using the--admin-insecure-modecommand line arg. The latter should not be used other than in development if the API
is not otherwise secured.APIA deployed instance of an ACA-Py agent assembles an OpenAPI-documented REST interface from the protocols loaded with the agent. This is used by a controller application (written in any language) to manage the behaviour of the agent. The controller can initiate agent actions such as issuing a credential, and can respond to agent events, such
as sending a presentation request after a new pairwise DID Exchange connection has been accepted. Agent events are delivered to the controller as webhooks to a configured URL. More information on the administration API and webhooks can be foundhere.ResourcesQuickstartIf you are an experienced decentralized identity developer that knows Indy, are already familiar with the concepts behind Aries,  want to play with the code, and perhaps even start contributing to the project, an "install and go" page for developers can be foundhere.Architectural Deep DiveThe ACA-Py team presented an architectural deep dive webinar that can be viewedhere. Slides from the webinar can be foundhere.Getting Started GuideFor everyone those new to SSI, Indy and Aries, we've created aGetting Started Guidethat will take you from knowing next to nothing about decentralized identity to developing Aries-based business apps and services in a hurry. Along the way, you'll run some early Indy apps, apps built on ACA-Py and developer-oriented demos for interacting with ACA-Py. The guide has a good table of contents so that you can skip the parts you already know.Read the DocsThe ACA-Py Python docstrings are used as the source of aRead the Docscode overview site. Want to review the
modules that make up ACA-Py? This is the best place to go.What to Focus On?Not sure where your focus should be? Building apps? Aries? Indy? Indy's Blockchain? Ursa? Here is adocumentthat goes through the technical stack to show how the projects fit together, so you can decide where you want to focus your efforts.CreditThe initial implementation of ACA-Py was developed by the Verifiable Organizations Network (VON) team based at the Province of British Columbia. To learn more about VON and what's happening with decentralized identity in British Columbia, please go tohttps://vonx.io.ContributingPull requests are welcome! Please read ourcontributions guideand submit your PRs. We enforcedeveloper certificate of origin(DCO) commit signing. See guidancehere.We also welcome issues submitted about problems you encounter in using ACA-Py.LicenseApache License Version 2.0