Class VtxoScript

constructor

• new VtxoScript(scripts: Bytes[]): VtxoScript

  Create a virtual output script from its tapleaf scripts.

  The Taproot script tree is assembled using btcd's algorithm (txscript.AssembleTaprootScriptTree) so the derived taproot output key agrees with arkd for any leaf count. @scure/btc-signer's default taprootListToTree is a Huffman builder that only agrees with arkd for power-of-2 leaf counts.

  Parameters

  • scripts: Bytes[]

    Raw tapscript bytes for each leaf

  Returns VtxoScript

  Throws

  Error if the provided leaves cannot produce a valid Taproot tree

Readonlyleaves

Readonlyscripts

ReadonlytweakedPublicKey

pkScript

• get pkScript(): Bytes

  Returns Bytes

address

• address(prefix?: string, serverPubKey: Bytes): ArkAddress

  Build the Arkade address corresponding to this virtual output script.

  Parameters

  • prefix: string = DEFAULT_NETWORK.hrp

    Bech32 human-readable prefix

  • serverPubKey: Bytes

    32-byte Arkade server public key

  Returns ArkAddress

  Arkade address for this script

  See

  ArkAddress

encode

• encode(): Bytes

  Encode the virtual output script to a TapTree byte representation.

  Returns Bytes

  Encoded TapTree bytes

  See

  decode

exitPaths

• exitPaths(): (ConditionCSVMultisigTapscript.Type | CSVMultisigTapscript.Type)[]

  Return all unilateral exit paths embedded in the virtual output script.

  Returns (ConditionCSVMultisigTapscript.Type | CSVMultisigTapscript.Type)[]

  CSV-based exit paths found in the leaves

  See

  getSequence

findLeaf

• findLeaf(scriptHex: string): TapLeafScript

  Look up a tapleaf script by its hex-encoded tapscript body.

  Parameters

  • scriptHex: string

    Hex-encoded tapscript body without the leaf version byte

  Returns TapLeafScript

  Matching tapleaf script

  Throws

  Error if no matching leaf exists

onchainAddress

• onchainAddress(network?: BTC_NETWORK): string

  Build the Taproot onchain address corresponding to this virtual output script.

  Parameters

  • network: BTC_NETWORK = DEFAULT_NETWORK

    Bitcoin network descriptor

  Returns string

  Taproot onchain address

  See

  address

Staticdecode

• decode(tapTree: Bytes): VtxoScript

  Decode a virtual output script from an encoded TapTree.

  Parameters

  • tapTree: Bytes

    Encoded TapTree bytes

  Returns VtxoScript

  Decoded virtual output script

  Throws

  Error if the TapTree cannot be decoded into a valid script set

  See

  encode