@rvagg/car-to-schema

Read a CAR file and describe its blocks using IPLD Schemas.

Usage

Install

$ npm install @rvagg/car-to-schema -g

Run

$ car-to-schema <path-to-CAR-file> --output=<output/dir> [--library=<schema/library/dir>]

Unqiue found schemas will be printed to stdout as well as written to files in the current working directory named schema_X.ipldsch (the human-readable text form) and schema_X.json (the JSON object descriptor form), where X is the unique schema number. A schema_summary.csv will also be written with a mapping of the schema to the number of blocks found matching that schema.

Library

If you have existing Schemas to match against, supply a directory path with --library and the Schemas found in that directory will be included in the matching process. Schema files should end with .ipldsch (or the object form can be .json).

The name of each Schema file in the library directory should be the name of the root type in the Schema. e.g. A Schema Schema describing the DAG-PB structure might be named PBNode.ipldsch and include a type PBNode. This type will be matched against the root found in the block.

Limitations

Currently only supports the following codecs for blocks:

• DAG-CBOR
• DAG-JSON
• DAG-PB
• raw
• json

See also the Limitations section of ipld-schema-describer for the limitations of Schema inference on objects.

License & Copyright

Copyright 2020 Rod Vagg

Licensed under Apache 2.0 (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)