discovery

Discovery schema JSON

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://msp-1.org/schema/discovery.json",
  "title": "MSP-1 Discovery Schema",
  "description": "Schema for the MSP-1 discovery object, which declares the canonical well-known endpoint used for deterministic protocol discovery.",
  "$comment": "MSP-1 v1.0.2 uses object form as canonical for discovery. wellKnown is required and constrained to /.well-known/msp.json. canonical is required and constrained to true. discovery.canonical is a boolean endpoint-designation field and is distinct from the separate canonical term, which identifies a preferred URL representation of a resource. Discovery identifies where MSP-1 metadata is located; it does not itself establish correctness, authority, trust, or verification.",
  "type": "object",
  "properties": {
    "wellKnown": {
      "type": "string",
      "const": "/.well-known/msp.json",
      "description": "The canonical root-relative path to the site's MSP-1 well-known declaration."
    },
    "canonical": {
      "type": "boolean",
      "const": true,
      "description": "Boolean confirmation that the declared wellKnown path is the canonical MSP-1 discovery endpoint for this declaration."
    }
  },
  "required": [
    "wellKnown",
    "canonical"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "wellKnown": "/.well-known/msp.json",
      "canonical": true
    }
  ]
}