Links

Getting Started with Adapters

Adapters are a way of automatically integrating to other platforms, importing or exporting data from the Verifiable Data Platform.

Initialize the Github Adapter

This section will cover getting up and running with the Github adapter, which allows you to issue a credential from a Github workflow.
In the platform navigate to https://platform.transmute.industries/marketplace/adapters, and click on the card for the Github adapter. If you do not have an account you will be prompted to create one, and then redirected to this page.
Adapter list page
This will take you to the details page for the adapter. Click on the the Install button. Your browser will automatically download a Github Adapter.zip file.
Adapter detail page
You will be shown a modal indicating the application has been created on the Verifiable Data Platform. Clicking on Uh, Okay? will close the modal. Clicking on Let's Go! will bring you to this documentation.
Adapter install confirmation modal
The next steps will require running commands on the command line. In Windows this means moving the downloaded Github Adapter.zip file to the Ubuntu file-system. You will also nee do the Github CLI tool gh installed. You can find instructions for how to install here: https://cli.github.com/manual/installation. You will also need to be logged in with the gh tool, instructions for how to do that can be found here: https://docs.github.com/en/github-cli/github-cli/quickstart.
Once these steps are complete, you can run the following commands to create a repository that holds the adapter. Note the $ character is to show a command and not the be included in the line to execute.
$ unzip Github\ Adapter.zip
This will extract a script.sh and .env file from the zip.
$ chmod +x script.sh
$ ./script.sh
This will create a new private repository under you Github account named my-project, which is pre-populated with the settings to be able to run a workflow to issue a credential calling the Verifiable Data Platform API. The script will end with opening the browser to the location of this repository.
Adapter repository
To run the action to issue a credential, click on the Actions tab on the top of the repository.
Dispatch action
On the actions page, click on the Issue Credential list item, then click the Run workflow dropdown. And click on the Run workflow button to trigger the action to issue the credential.
Issue credential action in progress
This will initialize a new action that will have a yellow spinning icon to indicate the workflow is running. Once the action is complete you should see the spinning yellow icon turn into a green check-mark.
Issue credential action complete
Click on the Issue Credential text to see the details about the action that was run.
Issue Credential artifact
You can click on the issued-verifiable-credential artifact in order to download the credential that you issued. And example of what this should look like is displayed below.
{
"@context": "https://www.w3.org/2018/credentials/v1",
"type": [
"VerifiableCredential"
],
"issuer": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7",
"issuanceDate": "2023-01-10T14:49:39Z",
"credentialSubject": {
"id": "did:example:456"
},
"proof": {
"type": "Ed25519Signature2018",
"created": "2023-01-10T14:49:40Z",
"verificationMethod": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7#z6MkfJwuJniojSD6XmeQ3V9xkkaw6EZp53BnnMMUrQNxAGRM",
"proofPurpose": "assertionMethod",
"jws": "eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..IOyALSto5FQwa8HUxM2e8dYrT8rQG__v0rT4hxCnPTaXMRSFL8DGWbo0q3kcemP20US9e4V80zlXqsttl9ezBg"
}
}
If you want to verify that your credential was issued, you can navigate to your list of credentials in the application to see the credential populated there.
Issued credential in application
Congratulations on issuing your first credential with a workflow. See what other functionality we can help you unlock with Github workflows.