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 MarkdownResult
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
| Field | Type / required | Description |
|---|---|---|
| sweepType | "bsv" | "ordinals" | "bsv21" Required | See schema for details. |
| inputs | array of object Required | See schema for details. minItems: 1; maxItems: 100 |
| inputs[].outpoint | string Required | See schema for details. pattern: "^[0-9a-f]{64}_[0-9]+$" |
| inputs[].satoshis | integer Required | See schema for details. minimum: -9007199254740991; maximum: 9007199254740991 |
| inputs[].lockingScript | string 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"
}