hop_signature: The hop signature does not cover this open
The delegation signature does not recover to the address it names over this exact open (budget, parent stream, depth, payee, cap, category and nonce), or it is malformed, or a typed (EIP-712) hop is not bound to this budget's chain and vault (an off-chain budget's typed hop carries no chain binding). The open is refused and nothing is allocated.
A delegation whose address, nonce or signature is not well formed never reaches this check: the owner routes answer 400 invalid_request first, and the plugin wire a plain HTTP 400. On a human payment, a signature that does not recover to its named address answers 409 pay_wrong_signer first.
What to do
- Sign the hop intent built from the exact fields of the open you send, then open again.
- A signed hop must name its payee (
serviceNode).
On the wire
HTTP 409, error type state_error.
A stream open (POST /owner/v1/budgets/{id}/streams) or a human payment adds errorDetail only for a client that sends Dynamo-Error-Detail: 1; other clients get {"error": "state", "reason": "hop_signature", "detail": "…"}. The child adoption preparation (POST /owner/v1/streams/{id}/children/adopt-prepare) sends it 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": "hop_signature"}, with no detail and no errorDetail.
The detailed body:
{
"error": "state",
"reason": "hop_signature",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "hop_signature",
"message": "…",
"param": "delegation",
"doc_url": "…/errors/hop_signature.md",
"fix": "the hop signature does not cover this open (budget, parent, depth, payee, cap, category, nonce); sign the exact hop"
}
}
See all error codes.