hop_unsigned: The hop carries no signature by its delegator
The deployment requires own hops (CORE_OWN_HOPS=required, the default in the money modes), and the stream open carries no delegation. Every hop is signed by its own delegator: the root funder for a first hop, the parent stream's payee below it. The open is refused and nothing is allocated (fail closed).
A human payment on a stablecoin or credit card budget that carries neither a delegation nor a console consent never reaches this check: it answers 409 pay_signature_required first.
The evidence export answers the same code: under required own hops, a client at Dynamo-Version 1.8.0 that asks for evidence 1.3.1 or 1.4.0 of an adopted budget whose root hop was adopted without its owner's signed hop intent (by a client before 1.8.0) is refused, because that evidence cannot verify. Nothing is exported. A client pinned earlier (on a single-tenant core, also one that names no version) gets HTTP 500 internal for the same request instead; on the multi-tenant hosted tier a request that names no version is served the account's default (1.8.0 for new accounts).
What to do
- Have the delegator sign the hop with
signHopIntent(@dynamoprotocol/sdk3.2.0) and send it asdelegationon the open. - Have the payee sign its offer with
signPayeeOfferand send it aspayeeOffer. - For the evidence refusal: adopt budgets at
Dynamo-Version1.8.0 with the owner's signed hop intent; a budget already adopted without it cannot export those evidence versions.
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_unsigned", "detail": "…"}. The child adoption preparation (POST /owner/v1/streams/{id}/children/adopt-prepare) sends it to every client. So does the evidence export (GET /owner/v1/budgets/{id}/evidence). The plugin wire's child open (POST /plugin/v1/streams/{id}/children) answers HTTP 409 {"error": "child open refused (fail closed)", "reason": "hop_unsigned"}, with no detail and no errorDetail.
The detailed body:
{
"error": "state",
"reason": "hop_unsigned",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "hop_unsigned",
"message": "…",
"param": "delegation",
"doc_url": "…/errors/hop_unsigned.md",
"fix": "this deployment requires own hops: the delegator signs its hop (signHopIntent) and the payee signs its offer (signPayeeOffer)"
}
}
See all error codes.