DID Test Suite

This test suite performs interoperability tests on the W3C Decentralized Identifier specification and is maintained by the W3C DID Working Group.

Adding Your DID Implementation

There are three types of implementations that this test suite tests: DID Methods, DID Resolvers, and DID URL Dereferencers. In order to add your implementation to this test suite:

1. Add your input file(s) to the implementations directory. For an example, see the example DID Method implementation (or any other file that looks closest to your implementation in the directory).
2. Add your input file to all relevant default.js test suite configurations. For example, DID Methods should add themselves to the did-identifier, did-core-properties, did-production, and did-consumption suites. Resolver implementations should only be added to the did-resolution test suite. See the current list of implementations listed for did-core-properties for more information. Implementers might want to peruse the list of all the test suites for more detail.
3. Run the test suite and make sure your implementation passes.
4. Submit a pull request on this repository to add your implementation.

Adding and Modifying Tests

Use the standard fork, branch, and pull request workflow to propose changes to the test suite. Please make branch names informative—by including the issue or bug number for example.

Editorial changes that improve the readability of the spec or correct spelling or grammatical mistakes are welcome.

Please read CONTRIBUTING.md, about licensing contributions.

Code of Conduct

W3C functions under a code of conduct.

Getting Started

See the Test Server.

To generate a report, run:

npm i
npm run test-and-generate-report

If tests are failing

• Every time after updating any code, run npm i.
• Please refer to When you observe errors section in packages/did-core-test-server/README.md

DID Working Group Repositories

• W3C Decentralized Identifier Specification v1.0
• Home page of the Decentralized Identifier Working Group
• Specs and documentation for all DID-related /.well-known resources
• W3C Decentralized Characteristics Rubric v1.0
• Decentralized Identifier Use Cases v1.0
• W3C DID Test Suite and Implementation Report