mandate_depth: The delegation is too deep
The delegation would sit deeper than the delegator's maxDepth allows, or deeper than the backend allows: 16 hops, or 8 on a contract version 1 stablecoin budget. Nothing was opened. (A budget opened before mandates existed keeps a limit of 8 hops; deeper opens there answer state_conflict.)
What to do
- Delegate from a node higher in the tree, or flatten the work.
On the wire
HTTP 409, error type mandate_error.
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_depth", "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_depth"}, with no detail and no errorDetail.
The detailed body:
{
"error": "mandate",
"reason": "mandate_depth",
"detail": "…",
"errorDetail": {
"type": "mandate_error",
"code": "mandate_depth",
"message": "…",
"param": "mandate",
"doc_url": "…/errors/mandate_depth.md",
"fix": "the delegation is deeper than the mandate (or the backend) allows"
}
}
See all error codes.