Schema

Source of Truth

All schema, JSON-LD context, and example files are governed in the ayra-governed-artifacts repository. That repository is the single source of truth for these artifacts. This concept repository contains documentation about the schema but does not host the schema files themselves.

The planned canonical domain for schema URIs is schema.ayra.forum. Until DNS and hosting are configured, the governed-artifacts repo uses raw.githubusercontent.com URLs as resolvable $id URIs.

Current Artifacts (v1.0)

Credential Schema

The main JSON Schema for an AyraBusinessCard Verifiable Credential.

• Repository path: schemas/v1.0/ayra-card-business-card-schema.json

• Current URL: ayra-card-business-card-schema.json

• JSON Schema draft: draft-07

• Credential type: AyraBusinessCard

JSON-LD Context

The JSON-LD @context file that provides semantic mappings for credential fields.

• Repository path: contexts/v1.0/AyraBusinessCardV1R0.jsonld

• Current URL: AyraBusinessCardV1R0.jsonld

Payload Schema (Unified)

Standalone JSON Schema for individual payload items, compatible with the embedded payloads array in the credential schema.

• Repository path: payload-schemas/v1.0/payload-schema-unified.json

• Current URL: payload-schema-unified.json

• JSON Schema draft: 2020-12

Example Credential

A complete AyraBusinessCard Verifiable Credential with 8 example payloads (phone, social, avatar, credential requests, designation, website, vLEI).

• Repository path: examples/v1.0/example-credential.json

• Current URL: example-credential.json

Example credentialSubject

Just the credentialSubject portion, useful as a quick reference.

• Repository path: examples/v1.0/example-credentialSubject.json

• Current URL: example-credentialSubject.json

Schema Documentation

For detailed field-by-field documentation of the credential schema, including:

• Required and optional fields

• Naming conventions (snake_case, ayra_ prefix)

• W3C VCDM 2.0 mapping

• TRQP integration fields

• Payload structure

See: Schema Concept

Alignment History

For a record of schema alignment decisions and changes, see: Schema Alignment Summary