BitcoinKernel
ScriptVerifyStatus

Enumeration

ScriptVerifyStatus

Status codes returned alongside the valid boolean from verify(amount:transaction:precomputedData:inputIndex:flags:).

enum ScriptVerifyStatus

Overview

Distinguishes usage errors (bad flag combinations, missing spent outputs) from script-execution failures. A return of (valid: false, status: .ok) means the script evaluated cleanly but the spend didn’t satisfy its locking conditions — a genuine verification failure. A non-.ok status means the verification request itself was malformed.

Maps to btck_ScriptVerifyStatus constants in the kernel C API.

Topics

Enumeration Cases

case errorInvalidFlagsCombination
The flag set passed to verify is not internally consistent — e.g., taproot was set without witness. Fix the caller; the verification did not run.
case errorSpentOutputsRequired
Taproot or witness verification was requested but the PrecomputedTransactionData argument lacked spent-outputs data. Reconstruct the precomputed data with the spent outputs and retry.
case ok
Verification completed without a usage error. The accompanying valid boolean decides whether the script actually succeeded.

Initializers

init?(rawValue: UInt8)

Instance Properties

var description: String
A short lowercase label suitable for error messages.