Validate objects against the schemas

loquitur-schemas carries the seven JSON Schemas of the public protocol objects and a command, loquitur-schema-validate, that checks a document against one of them. Install the package as Install from source says.

List the bundled schemas

loquitur-schema-validate list

The output names the seven bundled schemas:

• verification_summary.schema.json, verification_receipt.schema.json, change_summary.schema.json, lineage_summary.schema.json and coverage_summary.schema.json, the canonical protocol objects;
• registry_entry.schema.json and trust_registry.schema.json, the registry commitment objects.

The registry entry schema is minimal on purpose. It describes a public commitment, not a disclosure of evidence: it holds no raw evidence, canonical inputs, asset addresses, valuation or NAV amounts, financial metrics, tenant or investor data, or other business-sensitive fields.

Included from loquitur-schemas/README.md, “List bundled schemas”. MIT OR Apache-2.0.

Validate a document

The examples validate the fixtures in the repository’s tests/fixtures/, so run them from the checkout:

cd loquitur-schemas

Validate by schema filename:

loquitur-schema-validate validate verification_summary.schema.json tests/fixtures/verification_summary.valid.json
loquitur-schema-validate validate registry_entry.schema.json tests/fixtures/registry_entry.valid.json
loquitur-schema-validate validate trust_registry.schema.json tests/fixtures/trust_registry.valid.json

Validate by object_type alias:

loquitur-schema-validate validate verification_summary tests/fixtures/verification_summary.valid.json
loquitur-schema-validate validate registry_entry tests/fixtures/registry_entry.valid.json
loquitur-schema-validate validate trust_registry tests/fixtures/trust_registry.valid.json

Machine-readable output:

loquitur-schema-validate validate registry_entry tests/fixtures/registry_entry.valid.json --json

Exit codes:

• 0: the document validates against the selected bundled schema;
• 1: the document is valid JSON but violates the schema, or holds an instant that names no calendar second, such as 2026-02-30T00:00:00Z;
• 64: a usage or setup error, such as an unknown option or subcommand, a missing argument, no subcommand, a missing or unreadable file, invalid JSON, an unknown schema or an unsupported object type. The message is on stderr.

--help and --version exit 0.

Included from loquitur-schemas/README.md, “Validate a JSON document”. MIT OR Apache-2.0.

Each schema is described field by field in the schema reference. A document that validates has the shape the schema defines; whether a bundle verifies is a separate question, which the verifier answers.