Skip to content

Commit

Permalink
Add info about how the tags are used by different test suites.
Browse files Browse the repository at this point in the history
  • Loading branch information
JSAssassin committed Dec 11, 2023
1 parent e250dcb commit 475574b
Showing 1 changed file with 20 additions and 7 deletions.
27 changes: 20 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@
- [NPM](#npm)
- [Development](#development)
- [Usage](#usage)
- [Adding a new implementation](#adding-a-new-implementation)
- [Testing locally](#testing-locally)
- [Adding a new implementation](#adding-a-new-implementation)
- [Testing locally](#testing-locally)
- [Opting into a Test Suite](#opting-into-a-test-suite)
- [Contribute](#contribute)
- [License](#license)
Expand Down Expand Up @@ -55,7 +55,7 @@ npm install
## Usage


#### Adding a new implementation
### Adding a new implementation
Please add implementations to the `./implementations` directory.
Implementation configuration files are expressed in JSON and use roughly the
following form:
Expand Down Expand Up @@ -96,7 +96,7 @@ both.
Implementations may also contain no security (do not add a OAUTH2 or ZCAP
section in that case).

#### Testing locally
### Testing locally

If you need to add implementations for endpoints running locally you may add a
config file in the root dir of your test project:
Expand Down Expand Up @@ -127,7 +127,20 @@ module.exports = [{

### Opting into a Test Suite

Tags determine which test suites are executed on your issuers and verifiers.
Tags are required to determine which test suites are executed on your issuers
and verifiers.

#### VC API Issuer and Verifier Test Suites

Note: Only the first issuer/verifier with the tag found from your implementations
list will be selected to run against the test suites, while subsequent issuers
and verifiers that contain the same tag won't be tested.
This is true for most of the test suites except ECDSA test suite since, the
ECDSA test suite will select all the issuers and verifiers with the tag
from your implementations list and run them against the tests, in other words,
an implementer can have multiple issuer and verifiers with the tags depending
on the key types they support. Other test suites find and use the first match
containing the tag.

* `vc-api` - This tag will run the [vc-api-issuer tests](https://github.com/w3c-ccg/vc-api-issuer-test-suite)
on your issuer and the [vc-api-verifier tests](https://github.com/w3c-ccg/vc-api-verifier-test-suite)
Expand All @@ -144,8 +157,8 @@ on your issuer and/or verifier.
* Adding the `Suspension` tag alongside `StatusList2021` runs tests for
issuers or verifiers issuing/verifying VCs with the suspension status purpose.
* Note: To update the status of VCs and publish the updated status, additional
endpoints `setStatusLists` - `/credentials/status` and `publishStatusLists`
- `/credentials/publish` might also need to be specified.
endpoints `setStatusLists` - `/credentials/status` and `publishStatusLists`
- `/credentials/publish` might also need to be specified.

* `did-key` - This tag will run the [DID Key Test Suite](https://github.com/w3c-ccg/did-key-test-suite)
on your DID resolver endpoint.
Expand Down

0 comments on commit 475574b

Please sign in to comment.