terms_unavailable: Terms are not offered on this deployment

The deployment runs without a terms catalogue (it needs CORE_VERIFIED=1 and CORE_TERMS_CATALOGUE_FILE), so it cannot accept terms at open or take breach reports. Nothing is opened. A stream open whose terms name an offerId this deployment does not hold answers terms_offer_invalid first.

The same code answers the routes that need the catalogue or the verified runtime: the catalogue (GET /owner/v1/terms/catalogue), a stream's terms (GET /owner/v1/streams/{id}/terms), a budget's terms evidence (GET /owner/v1/budgets/{id}/terms-evidence), and the payee terms routes (GET /payee/v1/terms/catalogue, POST /payee/v1/terms/offers, GET /payee/v1/terms/offers/{id}). The payee routes answer {"error": "state", "reason": "terms_unavailable", "detail": "…"} with no errorDetail.

What to do

On the wire

HTTP 409, error type state_error.

On the owner catalogue, stream terms and terms evidence routes every client gets errorDetail; on a stream open only when the request sends Dynamo-Error-Detail: 1. The detailed body:

{
  "error": "state",
  "reason": "terms_unavailable",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "terms_unavailable",
    "message": "…",
    "param": "terms",
    "doc_url": "…/errors/terms_unavailable.md",
    "fix": "this deployment has no terms catalogue (CORE_VERIFIED=1 with CORE_TERMS_CATALOGUE_FILE); open without terms or use a deployment that offers them"
  }
}

See all error codes.