Beltic logo
Examples

Examples and fixtures

Where to find working samples for Beltic spec, CLI, and SDK

Use these examples to exercise the spec, CLI, and SDK without exposing schemas on the site.

Spec examples (beltic-spec/)

  • Human-readable: examples/developer-example-v1.md, examples/agent-example-v1.md
  • JSON fixtures for tests:
    • Developer: examples/developer/v1/tests/valid-individual-*, valid-organization-*, plus invalid cases
    • Agent: examples/agent/v1/tests/valid-* and invalid variants
  • Quickstart guidance and templates: docs/quickstart.md points directly to starter files and validation commands.
  • Validation scripts: scripts/validate_all.py, npm run validate:all, npm run validate:developer, npm run validate:agent.

CLI example (beltic-cli/)

  • test-agent/: TypeScript customer support agent showing the full loop (init, fingerprint, keygen, sign, verify).
  • README workflows cover standalone and serverless patterns; align your .beltic.yaml with the templates under beltic-spec/examples/* before signing.

SDK usage (beltic-sdk/)

  • Use the same fixtures from beltic-spec/examples/* with validateAgentCredential / validateDeveloperCredential to mirror CLI behavior.
  • Trust chain and status list helpers in the SDK make it easy to validate the example credentials without re-hosting schemas.

Example documents in this site