jsonld-normalization-dotnet

The library implements JSON-LD normalization algorithm URDNA2015.

It is based on jsonld.js library, part of which has been ported to C#/.NET. Current version is based version 5.2.0 of jsonld.js.

Usage

Main entry point is JsonLdHandler class, which exposes Canonize and Normalize functions, which transform input JSON-LD document to a canonized/normalized form. This can later be used e.g. for hashing in order to have consistent and reproducible hash values regardless of insignificant differences like fields ordering. Both "Normalization" and "Canonization" names are used interchangeably in this context, so the two functions have the same effect. An optional ExpandOptions options parameter can be used to customize parts of the JSON-LD document process.

Example

await JsonLdHandler.Normalize(File.ReadAllText(fileName));

Contribute

Initialize the tests

The expected test data files are generated from input test files with jsonld.js-normalizer/normalize_documents.js. To reinitialize them run the following commands.

$ npm install
$ node code/jsonld.js-normalizer/normalize_documents.js code/JsonLd.Normalization.Test/Resources/jsonld-canonicalization

Run the tests

$ dotnet test .\code\JsonLd.Normalization.Test

Contact

Contact us at the Blockcerts community forum.