BRC-222 JSON-LD Schema

Schema URL: https://brc222.org/schema

This document defines the JSON-LD schema for BRC-222 bridges, a decentralized format for linking digital content across platforms and blockchains with semantic relationships.

@context

"@context": "https://brc222.org/schema"

Defines the schema namespace for BRC-222 compliant objects. Machine-readable context: /schema.json.

Root Object

{
  "@type": "OrdinalBridge",
  "@id": "bitcoin:inscription:[inscriptionId]",
  "from": { ... },
  "to": { ... },
  "direction": "from-to",
  "relationship": "cites",
  "explanation": "...",
  "validation": [ ... ]
}

Fields:

@type (string): Fixed value "OrdinalBridge"
@id (string): Unique identifier using blockchain-inscription format (e.g., bitcoin:inscription:abc123). This is dynamically assigned at the time of inscription.
from (object): Describes the source artifact
to (object): Describes the target artifact
direction (string): Direction of relationship. Values: from-to, to-from
relationship (string): Semantic link type. Values include: cites, supports, contradicts, refutes, amplifies, contextualizes
explanation (string): Human-readable explanation
validation (array): List of third-party attestations

from / to Object Structure

{
  "@type": "WebPage" | "Video" | "Image" | "Audio" | "DigitalArtifact" | "Inscription" | "Sat" | "Claim",
  "@id": "https://example.com" | "bitcoin:inscription:xyz",
  "blockchain": "bitcoin" | "ethereum" | "polygon" | "dogecoin",
  "content": {
    "@type": "TextQuoteSelector",
    "exact": "The quoted content",
    "prefix": "text before",
    "suffix": "text after"
  },
  "metadata": {
    "title": "Optional title",
    "author": "Author or creator",
    "datePublished": "ISO 8601 date"
  }
}

Notes:

@type defines content type
@id is the unique URL or blockchain reference
blockchain identifies the chain the content resides on
content supports sub-targeting within a resource
metadata provides optional contextual descriptors

TextQuoteSelector

{
  "@type": "TextQuoteSelector",
  "exact": "Selected text",
  "prefix": "Before text",
  "suffix": "After text"
}

Supports precise text selection and resilience to minor text changes.

Validation Entry

{
  "@type": "ValidationEntry",
  "validator": "https://organization.org/profile.json",
  "timestamp": "2025-05-25T12:34:56Z",
  "signature": "..."
}

Optional entries signed by third-party validators to affirm the bridge.

Licensing

Content and schema are open under CC0.

Maintainers

Bridgit DAO / Overweb Team – info@bridgit.io