json-canon-fuzz v0.1.0

json-canon-fuzz

Fuzzer to test whether your JSON serialization is canonical.

Install

npm install -g json-canon-fuzz

Usage

Usage
  $ json-canon-fuzz {type} {count} {path}

Arguments
  - type: either `json` or `numbers`
  - count: how many lines to generate (default: Infinity)
  - path: where to output the generated lines (default: stdout)

Examples
  $ json-canon-fuzz json 100000

Numbers

The test output consists of lines

hex-ieee,expected\n

where hex-ieee holds 1-16 ASCII hexadecimal characters representing an IEEE-754 double precision value while expected holds the expected serialized value.

Each line is terminated by a single new-line character.

Sample lines:

4340000000000001,9007199254740994
4340000000000002,9007199254740996
444b1ae4d6e2ef50,1e+21
3eb0c6f7a0b5ed8d,0.000001
3eb0c6f7a0b5ed8c,9.999999999999997e-7
8000000000000000,0
0,0

The generation is deterministic. After generating a file, the program will output the hash of the file.

The following table records the expected hashes:

JSON

The test output consists of lines

json\n

where json is a valid JSON object serialized according to RFC8785: JSON Canonicalization Scheme (JCS).

Each line is terminated by a single new-line character.

Sample lines:

false
{"J���\toR�B\u001d":false,"]E�\u001e\u001d\u0019":4206124647,"�":"�Ĉ/�\u000e\b������5ɵ3\u0014","�\u0001Ƨ�\u0002ŵ":4.633184220509346,"�h\u0002\u000b�u��\\�":"�7� ���xB�K���!\u0019�ujҡ\u0019�Nx�D<��m\u0010*�\u0016p�\u001b�^ aLNt����P�","��X|Av[^E":-1306679260}
0.7290520820698927
null
"����Z\u0000��/�Bc_+�m�\u0002�\u0006�u�������RṚ�H\u000f�K\u0019��8\"�^ռI�\u0011ו\u001c�:D��n\u0005�s�m\u0013H��\t\b� H̑�\u001a}����\u0005 y&BO"
{}

The generation is not deterministic.

References

• json-canonicalization/test-data