mandate_window: The mandate is outside its time window
The request arrived before the mandate's validFrom, or at or after its validUntil.
The same code refuses opening a stream or delegating while any governing mandate is outside its window. That refusal is HTTP 409 with error type mandate_error (error: "mandate", param mandate), and nothing is opened.
What to do
- Wait for
validFrom, or open a new budget with a current window. - Times are unix seconds on the core's clock.
On the wire
HTTP 409, error type halted.
On spending, a client that does not send Dynamo-Error-Detail: 1 to a route that predates 1.4.0 sees the legacy reason cap, so its response shape is unchanged. Opted-in clients, and the routes that always answer in detail, see mandate_window.
On a stream open or delegation or a human payment, a client that does not send Dynamo-Error-Detail: 1 gets {"error": "mandate", "reason": "mandate_window", "detail": "…"}: the precise reason, without errorDetail. The child adoption preparation (POST /owner/v1/streams/{id}/children/adopt-prepare) sends errorDetail to every client. The plugin wire's child open (POST /plugin/v1/streams/{id}/children) answers HTTP 409 {"error": "child open refused (fail closed)", "reason": "mandate_window"}, with no detail and no errorDetail.
With Dynamo-Error-Detail: 1:
{
"error": "halted",
"reason": "mandate_window",
"streamId": "stm_…",
"detail": "…",
"errorDetail": {
"type": "halted",
"code": "mandate_window",
"message": "…",
"param": null,
"doc_url": "…/errors/mandate_window.md",
"fix": "the mandate is outside its validFrom/validUntil window; wait for the window or amend"
}
}
See all error codes.