# 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.

## Definition 1 (full)

Registered in: Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; External BRC-100 wallet; Local Vault + sponsor.

Lock BSV until a specific block height

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

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "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"
}
```

[All tools](https://bsvmcp.com/docs/tools)