revenue_channel_locked: The revenue channel is locked
The channel is read-only, or switched off on this deployment.
What to do
- Only the credit card platform fee can be switched over the API.
- The protocol fee (
contract_fee) is read from the vault and changed only by the vault owner on chain; the operator then sets the same rate inCORE_REVENUE_SWITCHES. - The other channels are off and cannot be switched on.
On the wire
HTTP 409, error type state_error.
POST /owner/v1/revenue/{channel} was added in owner-api 1.4.0, so every client receives errorDetail, with or without Dynamo-Error-Detail: 1:
{
"error": "state",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "revenue_channel_locked",
"message": "…",
"param": "channel",
"doc_url": "…/errors/revenue_channel_locked.md",
"fix": "this channel is read-only or off on this deployment"
}
}
Only a single-tenant core answers this code. On the multi-tenant hosted tier the front door refuses every change to a revenue switch from a tenant credential before it reaches the core, with 403 key_scope ("revenue switches are set by the deployment operator; tenant credentials may only read them").
See all error codes.