wallet_lockBsv

Lock BSV until a specific block height

Result

An MCP result containing the operation outcome as text, with structured content where supplied. Check isError before using it; an output schema is shown when registered.

Permissions

This operation can change wallet, account or service state. A connected wallet applies its own permissions. Guarded broadcasts also require broadcasting to be enabled; service authorization is separate from wallet approval.

Inputs and availability

Full catalog · Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; External BRC-100 wallet; Local Vault + sponsor

Field	Type / required	Description
requests	array of object Required	Array of lock requests
requests[].satoshis	integer Required	Amount in satoshis to lock; whole satoshis above zero maximum: 9007199254740991; exclusiveMinimum: 0
requests[].until	integer Required	Block height until which to lock maximum: 9007199254740991; exclusiveMinimum: 0

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "requests": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "satoshis": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Amount in satoshis to lock; whole satoshis above zero"
          },
          "until": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Block height until which to lock"
          }
        },
        "required": [
          "satoshis",
          "until"
        ]
      },
      "description": "Array of lock requests"
    }
  },
  "required": [
    "requests"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}