DID Linter REST API
Validate a DID or a posted DID document; every path is described in Swagger.
curl https://didlint.ownyourdata.eu/api/validate/did:oyd:zQmZZbVygmbsxWXhP2BH5nW2RMNXSQA3eRqnzfkFXzH3fg1DID Linter
DID Linter resolves a decentralized identifier, or takes a DID document, and checks it against Decentralized Identifiers (DIDs) v1.0.
How DID Linter checks
- Structure. The document is validated with SHACL against the SOyA structure for DID documents: required members, identifier syntax, verification methods and their key material, verification relationships and services.
- Context. For a JSON-LD document, the
@contextis checked against the verification method types the structure lists, with the contexts the DID Specification Registries name for them. - Result. Each problem is listed with the member of the document it concerns, for example
verificationMethod. Notes that do not change the result, such as a suggestion to add a JSON-LD context, are shown separately.
Results come from automated checks only. They are not a certification, and the structure does not yet cover every requirement of DID Core.
Use it elsewhere
Command line
The same checks with soya-cli and two scripts from the repository.
cat did.json | script/prep.sh | soya validate zGHDEn5jshXVk8haXx4BxQFX6zVyrFMP6WzeAJGVwwZvU
cat did.json | script/verify_context.rbYour own instance
Run the Docker image yourself, online or fully offline with a local copy of the structure.
Building blocks
SOyA
Semantic Overlay Architecture: data models in YAML with overlays for validation and
transformation. The rules of DID Linter are a SOyA structure, published from
soya/Did.yml.
OYDID
The did:oyd method of OwnYourData: identifiers derived from the hash of the DID
document, with a hash-linked log of all changes.