{
  "openapi": "3.1.0",
  "info": {
    "title": "Vaultfire V3 Source-Review API",
    "version": "3.0.0",
    "description": "V3-only source-review view derived from the canonical combined OpenAPI document. Released static routes are explicitly documented; all operational and payment-dependent routes remain fail-closed. Mock positive examples do not represent deployed V3 state.",
    "x-derived-from": {
      "artifact": "/schemas/v3/openapi-combined-3.0.0.json",
      "source": "pr7/generated/openapi.json",
      "filter": "paths beginning /api/v3/",
      "operationCount": 20
    }
  },
  "servers": [
    {
      "url": "https://theloopbreaker.com",
      "description": "Production source-review API; V3 operational and payment routes remain fail-closed."
    }
  ],
  "paths": {
    "/api/v3/contracts": {
      "get": {
        "operationId": "contracts",
        "summary": "Static V3 contract catalog with null addresses until independently verified.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/contract-catalog.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.contract-catalog.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "route": "/api/v3/contracts",
                  "generatedAt": "2026-08-28T00:00:00.000Z",
                  "deploymentState": "unconfigured",
                  "addressPolicy": "null-until-independently-verified",
                  "contracts": [],
                  "routeInventory": []
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        }
      }
    },
    "/api/v3/contracts/{name}": {
      "get": {
        "operationId": "contract",
        "summary": "Static V3 contract metadata by canonical name.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/contract-result.v1.schema.json"
                }
              }
            }
          },
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "404": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/contract-result.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9]{1,79}$",
              "minLength": 2,
              "maxLength": 80
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/contracts/:name",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/bonds": {
      "get": {
        "operationId": "bond-party",
        "summary": "Fail-closed bond lookup by the required party query parameter.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "party",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{40}$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/bonds",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/bonds/{bondId}": {
      "get": {
        "operationId": "bond",
        "summary": "Fail-closed V3 bond lookup by unsigned identifier.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "bondId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/bonds/:bondId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/disputes/{disputeId}": {
      "get": {
        "operationId": "dispute",
        "summary": "Fail-closed objective dispute lookup.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "disputeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/disputes/:disputeId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/evidence/{evidenceHash}": {
      "get": {
        "operationId": "evidence",
        "summary": "Deferred evidence lookup with no deployment claim.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "evidenceHash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{64}$",
              "minLength": 66,
              "maxLength": 66
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/evidence/:evidenceHash",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/tasks/{taskId}": {
      "get": {
        "operationId": "task",
        "summary": "Deferred task escrow read model.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/tasks/:taskId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/mandates/{mandateHash}": {
      "get": {
        "operationId": "mandate",
        "summary": "Canonical plural V3 mandate lookup.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "mandateHash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{64}$",
              "minLength": 66,
              "maxLength": 66
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/mandates/:mandateHash",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/mandate/{mandateHash}": {
      "get": {
        "operationId": "mandate-compat",
        "summary": "Singular V3 compatibility wrapper over the plural route; no V2 fallback.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "mandateHash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{64}$",
              "minLength": 66,
              "maxLength": 66
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/mandate/:mandateHash",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/governance/proposals/{proposalId}": {
      "get": {
        "operationId": "governance-proposal",
        "summary": "Fail-closed governance proposal status lookup.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "proposalId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/governance/proposals/:proposalId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/pull-credits": {
      "get": {
        "operationId": "pull-credit",
        "summary": "Fail-closed pull credit query by contract, asset, and holder.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "contract",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{40}$"
            }
          },
          {
            "name": "asset",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{40}$"
            }
          },
          {
            "name": "holder",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{40}$"
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/pull-credits",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/migration/dispositions": {
      "get": {
        "operationId": "migration",
        "summary": "Static migration capability and safety dispositions.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/migration-dispositions.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.migration-dispositions.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "route": "/api/v3/migration/dispositions",
                  "generatedAt": "2026-08-28T00:00:00.000Z",
                  "policy": {
                    "v3OptInOnly": true,
                    "v2PreservedUnchanged": true,
                    "v2Fallback": "forbidden",
                    "writesEnabled": false,
                    "paymentsEnabled": false,
                    "prohibitedDecisionInputs": [
                      "behavioral-scoring",
                      "reputation",
                      "loyalty",
                      "quality",
                      "belief",
                      "biometric",
                      "profiling",
                      "surveillance",
                      "subjective-flourishing",
                      "cross-chain"
                    ]
                  },
                  "canonicalSdk": {
                    "supported": [],
                    "degraded": [
                      "bonds",
                      "pullCredits",
                      "solvency",
                      "mandates",
                      "governance"
                    ],
                    "unavailable": [
                      "capabilities",
                      "x402.status",
                      "x402.discovery",
                      "x402.challenge",
                      "x402.receipt"
                    ],
                    "retired": [
                      "taskEscrow",
                      "latest",
                      "v2-fallback"
                    ]
                  },
                  "pilot": {
                    "deploymentState": "unconfigured",
                    "supportedContracts": [],
                    "deferredContracts": [],
                    "retiredContracts": []
                  },
                  "routes": [
                    {
                      "id": "contracts",
                      "method": "GET",
                      "path": "/api/v3/contracts",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/contract-catalog.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Static V3 contract catalog with null addresses until independently verified."
                    },
                    {
                      "id": "contract",
                      "method": "GET",
                      "path": "/api/v3/contracts/:name",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/contract-result.v1.schema.json",
                      "responseStatuses": [
                        200,
                        400,
                        404,
                        503
                      ],
                      "description": "Static V3 contract metadata by canonical name."
                    },
                    {
                      "id": "bond-party",
                      "method": "GET",
                      "path": "/api/v3/bonds",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed bond lookup by the required party query parameter."
                    },
                    {
                      "id": "bond",
                      "method": "GET",
                      "path": "/api/v3/bonds/:bondId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed V3 bond lookup by unsigned identifier."
                    },
                    {
                      "id": "dispute",
                      "method": "GET",
                      "path": "/api/v3/disputes/:disputeId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed objective dispute lookup."
                    },
                    {
                      "id": "evidence",
                      "method": "GET",
                      "path": "/api/v3/evidence/:evidenceHash",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Deferred evidence lookup with no deployment claim."
                    },
                    {
                      "id": "task",
                      "method": "GET",
                      "path": "/api/v3/tasks/:taskId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Deferred task escrow read model."
                    },
                    {
                      "id": "mandate",
                      "method": "GET",
                      "path": "/api/v3/mandates/:mandateHash",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Canonical plural V3 mandate lookup."
                    },
                    {
                      "id": "mandate-compat",
                      "method": "GET",
                      "path": "/api/v3/mandate/:mandateHash",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Singular V3 compatibility wrapper over the plural route; no V2 fallback."
                    },
                    {
                      "id": "governance-proposal",
                      "method": "GET",
                      "path": "/api/v3/governance/proposals/:proposalId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed governance proposal status lookup."
                    },
                    {
                      "id": "pull-credit",
                      "method": "GET",
                      "path": "/api/v3/pull-credits",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed pull credit query by contract, asset, and holder."
                    },
                    {
                      "id": "migration",
                      "method": "GET",
                      "path": "/api/v3/migration/dispositions",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/migration-dispositions.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Static migration capability and safety dispositions."
                    },
                    {
                      "id": "status",
                      "method": "GET",
                      "path": "/api/v3/protocol/status",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/status.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Static unconfigured protocol readiness response."
                    },
                    {
                      "id": "solvency",
                      "method": "GET",
                      "path": "/api/v3/protocol/solvency",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/solvency.v1.schema.json",
                      "responseStatuses": [
                        503
                      ],
                      "description": "Unconfigured solvency readiness response."
                    },
                    {
                      "id": "x402-discovery",
                      "method": "GET",
                      "path": "/api/v3/x402/discovery",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/discovery.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Fail-closed V3 x402 discovery with no payment candidates."
                    },
                    {
                      "id": "x402-challenge-status",
                      "method": "GET",
                      "path": "/api/v3/x402/challenge-status",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/challenge-status.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Static unavailable V3 payment-challenge capability status."
                    },
                    {
                      "id": "x402-challenge",
                      "method": "GET",
                      "path": "/api/v3/x402/challenges/:challengeId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/read-result.v1.schema.json",
                      "responseStatuses": [
                        400,
                        503
                      ],
                      "description": "Fail-closed V3 challenge lookup."
                    },
                    {
                      "id": "x402-receipt",
                      "method": "GET",
                      "path": "/api/v3/x402/receipts/:requestId",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/receipt-status.v1.schema.json",
                      "responseStatuses": [
                        200,
                        400,
                        404,
                        503
                      ],
                      "description": "Fail-closed durable receipt evidence lookup."
                    },
                    {
                      "id": "solana-health",
                      "method": "GET",
                      "path": "/api/v3/solana/health",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/solana-health.v1.schema.json",
                      "responseStatuses": [
                        200,
                        503
                      ],
                      "description": "Source-only Solana health without RPC or executable claims."
                    },
                    {
                      "id": "retired-partnership-write",
                      "method": "POST",
                      "path": "/api/v3/x402/actions/create-partnership-bond",
                      "canonicalSdkRoute": null,
                      "disposition": "unavailable",
                      "readOnly": true,
                      "deploymentRequired": false,
                      "responseSchema": "/schemas/v3-x402/retirement.v1.schema.json",
                      "responseStatuses": [
                        503
                      ],
                      "description": "Non-executing retired partnership-bond write tombstone."
                    }
                  ]
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        }
      }
    },
    "/api/v3/protocol/status": {
      "get": {
        "operationId": "status",
        "summary": "Static unconfigured protocol readiness response.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/status.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.protocol.status.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "route": "/api/v3/protocol/status",
                  "status": "not-ready",
                  "readiness": "data-source-unconfigured",
                  "observedAt": "2026-08-28T00:00:00.000Z",
                  "finality": null,
                  "data": null,
                  "dataSourceErrors": [
                    "live-status-reader-unconfigured"
                  ],
                  "claims": {
                    "liveV3DeploymentVerified": false,
                    "onchainEvidencePresent": false,
                    "paymentSettlementEnabled": false
                  }
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        }
      }
    },
    "/api/v3/protocol/solvency": {
      "get": {
        "operationId": "solvency",
        "summary": "Unconfigured solvency readiness response.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/solvency.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/protocol/solvency",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/x402/discovery": {
      "get": {
        "operationId": "x402-discovery",
        "summary": "Fail-closed V3 x402 discovery with no payment candidates.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/discovery.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/x402/discovery",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/x402/challenge-status": {
      "get": {
        "operationId": "x402-challenge-status",
        "summary": "Static unavailable V3 payment-challenge capability status.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/challenge-status.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/x402/challenge-status",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/x402/challenges/{challengeId}": {
      "get": {
        "operationId": "x402-challenge",
        "summary": "Fail-closed V3 challenge lookup.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/read-result.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "challengeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-f]{64}$",
              "minLength": 66,
              "maxLength": 66
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/x402/challenges/:challengeId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/x402/receipts/{requestId}": {
      "get": {
        "operationId": "x402-receipt",
        "summary": "Fail-closed durable receipt evidence lookup.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/receipt-status.v1.schema.json"
                }
              }
            }
          },
          "400": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/input-error.v1.schema.json"
                }
              }
            }
          },
          "404": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/receipt-error.v1.schema.json"
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "/schemas/v3-x402/receipt-error.v1.schema.json"
                    },
                    {
                      "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                    }
                  ]
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^v3r_(?=[0-9a-f]*([0-9a-f]))(?=[0-9a-f]*(?!\\1)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2|\\3)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2|\\3|\\4)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2|\\3|\\4|\\5)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2|\\3|\\4|\\5|\\6)([0-9a-f]))(?=[0-9a-f]*(?!\\1|\\2|\\3|\\4|\\5|\\6|\\7)([0-9a-f]))(?!([0-9a-f]{1})\\9{31}$)(?!([0-9a-f]{2})\\10{15}$)(?!([0-9a-f]{4})\\11{7}$)(?!([0-9a-f]{8})\\12{3}$)[0-9a-f]{32}$",
              "minLength": 36,
              "maxLength": 36
            }
          }
        ],
        "x-source-review-only-positive-example": {
          "label": "mock/source-review-only",
          "representsDeployedV3State": false,
          "httpStatus": 200,
          "body": {
            "schema": "vaultfire.v3.mock-positive-example.v1",
            "protocolVersion": "3.0.0",
            "route": "/api/v3/x402/receipts/:requestId",
            "mock": true,
            "data": {}
          }
        }
      }
    },
    "/api/v3/solana/health": {
      "get": {
        "operationId": "solana-health",
        "summary": "Source-only Solana health without RPC or executable claims.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "public",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "200": {
            "description": "Released static source-review metadata; this is not deployed V3 state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/solana-health.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.solana.health.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "route": "/api/v3/solana/health",
                  "operational": false,
                  "readiness": "source-only",
                  "source": {
                    "evidenceScope": "source-only",
                    "inventoryAvailable": true,
                    "canonicalDispositionManifestAvailable": true,
                    "supportedCandidateCount": 6,
                    "redesignRequiredCount": 4,
                    "retiredCount": 5
                  },
                  "executable": {
                    "evidenceAvailable": false,
                    "deploymentAuthorized": false,
                    "deploymentMapAvailable": false,
                    "programAddressVerified": false,
                    "mainnetReadVerified": false
                  },
                  "rpcContacted": false,
                  "indexerContacted": false,
                  "paymentSettlementEnabled": false,
                  "protectedDecisionUse": "prohibited",
                  "claims": {
                    "v3ProgramAddressVerified": false,
                    "mainnetReadVerified": false,
                    "bazaarIndexingVerified": false
                  }
                }
              }
            }
          },
          "503": {
            "description": "V3 release gate is closed; no deployment, payment, settlement, or write is attempted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/release-gate.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.release-gate.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "error": "Vaultfire V3 x402 routes are disabled pending explicit read-only release approval",
                  "code": "v3_x402_release_gate_closed",
                  "retryable": false,
                  "releaseMode": "disabled"
                }
              }
            }
          }
        }
      }
    },
    "/api/v3/x402/actions/create-partnership-bond": {
      "post": {
        "operationId": "retired-partnership-write",
        "summary": "Non-executing retired partnership-bond write tombstone.",
        "x-protocol-version": "v3",
        "x-contract-status": "read-only",
        "x-finality": "soft",
        "x-data-source": "computed",
        "x-privacy": "restricted",
        "x-idempotency": "none",
        "x-response-fixture-status": "not-applicable",
        "x-bazaar-eligibility": "not-priced",
        "x-solana-payment-status": "not-priced",
        "responses": {
          "503": {
            "description": "Permanent non-executing retirement tombstone; no request parsing, transaction preparation, payment, or state change.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/schemas/v3-x402/retirement.v1.schema.json"
                },
                "example": {
                  "schema": "vaultfire.v3.x402.retirement.v1",
                  "schemaVersion": "1.0.0",
                  "protocolVersion": "3.0.0",
                  "route": "/api/v3/x402/actions/create-partnership-bond",
                  "status": "retired",
                  "code": "v3_x402_route_permanently_retired",
                  "executable": false,
                  "paymentChallengeAvailable": false,
                  "requestInspected": false,
                  "bodyParsed": false,
                  "reason": "mission-sensitive-custody-surface-retired",
                  "safety": {
                    "v2FallbackUsed": false,
                    "paymentParsed": false,
                    "writeAttempted": false
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {}
            }
          }
        }
      }
    }
  }
}