terms_holdback: The holdback is shorter than the term window

A breach can only be reported once its window closes, so a terms stream holds settlements back at least its longest term window. Nothing is opened.

What to do

On the wire

HTTP 409, error type state_error.

On a stream open (POST /owner/v1/budgets/{id}/streams) the body carries errorDetail only when the request sends Dynamo-Error-Detail: 1. With the header:

{
  "error": "state",
  "reason": "terms_holdback",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "terms_holdback",
    "message": "…",
    "param": "terms",
    "doc_url": "…/errors/terms_holdback.md",
    "fix": "holdbackSeconds must be at least the longest term window; omit it to take that window"
  }
}

See all error codes.