Specification

Overview of the Beltic specification repository and how to use schemas for validation.

The Beltic specification repository defines credential schemas, validation rules, and evaluation methodologies.

Beltic-Spec Repository

The official specification lives in the beltic-spec repository (currently private). Request early access to get started.

beltic-spec/
├── docs/                    # Specification documents
│   ├── overview.md
│   ├── developer-credential-v1.md
│   ├── agent-credential-v1.md
│   ├── evaluation-metrics-v1.md
│   └── nist-mapping-v1.md
├── schemas/                 # JSON Schema files
│   ├── developer/v1/
│   └── agent/v1/
├── examples/                # Test fixtures
│   ├── developer/v1/tests/
│   └── agent/v1/tests/
└── scripts/                 # Validation scripts
    ├── validate_all.py
    └── test_conditional_rules.js

Using Schemas Locally

Get Repository Access

# Repository is currently private
# See /docs/early-access for access requests

Once you have access:

cd beltic-spec

Validate with AJV

npm install -g ajv-cli ajv-formats

ajv validate \
  -s schemas/developer/v1/developer-credential-v1.schema.json \
  -d my-credential.json

Validate with Python

pip install jsonschema

python3 scripts/validate_all.py

Using npm Scripts

npm run validate:developer  # Validate all developer examples
npm run validate:agent      # Validate all agent examples
npm run test:conditional-rules  # Test 27 conditional rules