← BSV MCPInstall
Wallet

app_sweep_prepare

App-only: verify source transactions and prepare a sweep that preserves ordinals and token amounts. Source private keys remain in the browser.

Read as Markdown

Result

A prepared sweep description; submission is a separate operation.

Permissions

Requires the configured wallet or identity context. Wallet read permissions apply; this handler does not request a payment.

Inputs and availability

Full catalog · Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; External BRC-100 wallet; Local Vault + sponsor

FieldType / requiredDescription
sweepType"bsv" | "ordinals" | "bsv21"
Required
See schema for details.
inputsarray of object
Required
See schema for details.

minItems: 1; maxItems: 100

inputs[].outpointstring
Required
See schema for details.

pattern: "^[0-9a-f]{64}_[0-9]+$"

inputs[].satoshisinteger
Required
See schema for details.

minimum: -9007199254740991; maximum: 9007199254740991

inputs[].lockingScriptstring
Required
See schema for details.

pattern: "^(?:[0-9a-f]{2})+$"

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

Full input schema
{
  "type": "object",
  "properties": {
    "sweepType": {
      "type": "string",
      "enum": [
        "bsv",
        "ordinals",
        "bsv21"
      ]
    },
    "inputs": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "outpoint": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}_[0-9]+$"
          },
          "satoshis": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "lockingScript": {
            "type": "string",
            "pattern": "^(?:[0-9a-f]{2})+$"
          }
        },
        "required": [
          "outpoint",
          "satoshis",
          "lockingScript"
        ]
      }
    }
  },
  "required": [
    "sweepType",
    "inputs"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}