Skip to content

Commit

Permalink
doc update
Browse files Browse the repository at this point in the history
  • Loading branch information
Ellenn-A committed Feb 5, 2024
1 parent d112e7e commit 6468be8
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 3 deletions.
18 changes: 18 additions & 0 deletions README_VERITABLE.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,28 @@ The Aries Framework JavaScript REST API is the most convenient way for self-sove
- 💻 **CLI** that makes it super easy to start an instance of the REST API.
- 🌐 **Interoperable** with all major Aries implementations.

## Description

The project aims to enable supply chains to share insights and data across multiple data platforms, enhancing the efficiency of the supply chain network. Specifically it facilitates the onboarding of new actors into a network, facilitationg connections between those and allows for interaction between the actors. Interactions include issuance of credentials, acceptance of issued credentials, requesting proofs of credentials from other actors and those being able to verify those requests.

## Quick start

The REST API provides an OpenAPI schema that can easily be viewed using the SwaggerUI that is provided with the server. The docs can be viewed on the `/docs` endpoint (e.g. http://localhost:3000/docs).

Bellow you will find commands for starting up the containers in docker (see the [Using Docker](#using-docker-easiest) section) or via cli (see [Via Cli] (#via-cli)).

> The OpenAPI spec is generated from the model classes used by Aries Framework JavaScript. Due to limitations in the inspection of these classes, the generated schema does not always exactly match the expected format. Keep this in mind when using this package. If you encounter any issues, feel free to open an issue.
### Rest Client Args

The CLI args are defined under `src > cli.ts ` They are used to start up a service.
| Argument added | Required | Default | Description |
| :------------- | :------: | :------ | :------- |
| ipfs-origin | Y | http://ipfs0:5001 | IPFS endpoint |
|opa-origin |Y |http://opa:8181 |OPA endpoint |
|persona-title | N |"Veritable Cloudagent"|Tab name which you can see in your browser |
|persona-color |N |"white" |Defines the background colour of swagger documentation|

### Using Docker (easiest)

[Docker](https://docs.docker.com/get-docker/) is the easiest way to get started with the REST API.
Expand Down Expand Up @@ -86,6 +102,8 @@ Network name: `testnet`

### Via CLI

<a id="via-cli"></a>

To run AFJ REST API directly on your computer you need to have the ipfs client installed. Follow the IPFS [installation steps](https://docs.ipfs.tech/install/command-line/#system-requirements) for your platform and verify IPFS is installed.

Once you have installed IPFS, you can start the REST server using the following command:
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@digicatapult/veritable-cloudagent",
"version": "0.4.16",
"version": "0.4.17",
"main": "build/index",
"types": "build/index",
"files": [
Expand Down

0 comments on commit 6468be8

Please sign in to comment.