Class EnhancedPSBTBuilder

Enhanced PSBT Builder with BIP-174 compliance and advanced features

Hierarchy (View Summary)

PSBTBuilder
- EnhancedPSBTBuilder

Constructors

constructor

new EnhancedPSBTBuilder(options?: EnhancedPSBTOptions): EnhancedPSBTBuilder
Parameters
- options: EnhancedPSBTOptions = {}
Returns EnhancedPSBTBuilder
Overrides PSBTBuilder.constructor
- Defined in core/enhanced-psbt-builder.ts:131

Properties

`Protected`psbt

psbt: Psbt

Methods

addDataOutput

addDataOutput(data: Buffer): this
Add OP_RETURN output
Parameters
- data: Buffer
Returns this
Inherited from PSBTBuilder.addDataOutput
- Defined in core/psbt-builder.ts:170

addEnhancedInput

addEnhancedInput(
    txid: string,
    vout: number,
    options?: {
        derivationPaths?: DerivationPath[];
        nonWitnessUtxo?: Buffer<ArrayBufferLike>;
        publicKeys?: Buffer<ArrayBufferLike>[];
        redeemScript?: Buffer<ArrayBufferLike>;
        sequence?: number;
        witnessScript?: Buffer<ArrayBufferLike>;
        witnessUtxo?: { script: Buffer; value: number };
    },
): this
Add input with enhanced validation and metadata
Parameters
- txid: string
- vout: number
- options: {
      derivationPaths?: DerivationPath[];
      nonWitnessUtxo?: Buffer<ArrayBufferLike>;
      publicKeys?: Buffer<ArrayBufferLike>[];
      redeemScript?: Buffer<ArrayBufferLike>;
      sequence?: number;
      witnessScript?: Buffer<ArrayBufferLike>;
      witnessUtxo?: { script: Buffer; value: number };
  } = {}
Returns this
- Defined in core/enhanced-psbt-builder.ts:150

addEnhancedOutput

addEnhancedOutput(
    addressOrScript: string | Buffer<ArrayBufferLike>,
    value: number,
    options?: {
        derivationPaths?: DerivationPath[];
        isChange?: boolean;
        publicKeys?: Buffer<ArrayBufferLike>[];
    },
): this
Add output with enhanced validation and metadata
Parameters
- addressOrScript: string | Buffer<ArrayBufferLike>
- value: number
- options: {
      derivationPaths?: DerivationPath[];
      isChange?: boolean;
      publicKeys?: Buffer<ArrayBufferLike>[];
  } = {}
Returns this
- Defined in core/enhanced-psbt-builder.ts:192

addInput

addInput(
    txid: string,
    vout: number,
    options?: {
        nonWitnessUtxo?: Buffer<ArrayBufferLike>;
        redeemScript?: Buffer<ArrayBufferLike>;
        sequence?: number;
        witnessScript?: Buffer<ArrayBufferLike>;
        witnessUtxo?: { script: Buffer; value: number };
    },
): this
Add standard input
Parameters
- txid: string
- vout: number
- options: {
      nonWitnessUtxo?: Buffer<ArrayBufferLike>;
      redeemScript?: Buffer<ArrayBufferLike>;
      sequence?: number;
      witnessScript?: Buffer<ArrayBufferLike>;
      witnessUtxo?: { script: Buffer; value: number };
  } = {}
Returns this
Inherited from PSBTBuilder.addInput
- Defined in core/psbt-builder.ts:98

addInputDerivation

addInputDerivation(
    inputIndex: number,
    derivation: DerivationPath,
    publicKey: Buffer,
): void
Add BIP32 derivation information to input
Parameters
- inputIndex: number
- derivation: DerivationPath
- publicKey: Buffer
Returns void
- Defined in core/enhanced-psbt-builder.ts:230

addInputRedeemScript

addInputRedeemScript(inputIndex: number, redeemScript: Buffer): void
Add redeem script for P2SH inputs
Parameters
- inputIndex: number
- redeemScript: Buffer
Returns void
- Defined in core/enhanced-psbt-builder.ts:311

addInputWitnessScript

addInputWitnessScript(inputIndex: number, witnessScript: Buffer): void
Add witness script for P2WSH inputs
Parameters
- inputIndex: number
- witnessScript: Buffer
Returns void
- Defined in core/enhanced-psbt-builder.ts:324

addOutput

addOutput(
addressOrScript: string | Buffer<ArrayBufferLike>,
value: number,
): this
Add standard output
Parameters
- addressOrScript: string | Buffer<ArrayBufferLike>
- value: number
Returns this
Inherited from PSBTBuilder.addOutput
- Defined in core/psbt-builder.ts:152

addOutputDerivation

addOutputDerivation(
    outputIndex: number,
    derivation: DerivationPath,
    publicKey: Buffer,
): void
Add BIP32 derivation information to output
Parameters
- outputIndex: number
- derivation: DerivationPath
- publicKey: Buffer
Returns void
- Defined in core/enhanced-psbt-builder.ts:256

clone

clone(): PSBTBuilder
Clone PSBT

Returns PSBTBuilder
Inherited from PSBTBuilder.clone
- Defined in core/psbt-builder.ts:234

combine

combine(...psbts: Psbt[]): this
Combine multiple PSBTs
Parameters
- ...psbts: Psbt[]
Returns this
Inherited from PSBTBuilder.combine
- Defined in core/psbt-builder.ts:181

enhancedClone

enhancedClone(): EnhancedPSBTBuilder
Create enhanced clone with metadata preservation

Returns EnhancedPSBTBuilder
- Defined in core/enhanced-psbt-builder.ts:424

extractTransaction

extractTransaction(skipFinalization?: boolean): null | Transaction
Extract transaction without finalizing
Parameters
- skipFinalization: boolean = false
Returns null | Transaction
Inherited from PSBTBuilder.extractTransaction
- Defined in core/psbt-builder.ts:220

getFee

getFee(): number
Get fee amount

Returns number
Inherited from PSBTBuilder.getFee
- Defined in core/psbt-builder.ts:206

getFeeRate

getFeeRate(): number
Get fee rate (sat/vB)

Returns number
Inherited from PSBTBuilder.getFeeRate
- Defined in core/psbt-builder.ts:213

getInputMetadata

getInputMetadata(inputIndex: number): InputMetadata
Get input metadata
Parameters
- inputIndex: number
Returns InputMetadata
- Defined in core/enhanced-psbt-builder.ts:357

getMetadata

getMetadata(): PSBTMetadata
Get comprehensive PSBT metadata

Returns PSBTMetadata
- Defined in core/enhanced-psbt-builder.ts:337

getOutputMetadata

getOutputMetadata(outputIndex: number): OutputMetadata
Get output metadata
Parameters
- outputIndex: number
Returns OutputMetadata
- Defined in core/enhanced-psbt-builder.ts:389

getPSBT

getPSBT(): Psbt & { outputCount: number }
Get underlying PSBT

Returns Psbt & { outputCount: number }
Inherited from PSBTBuilder.getPSBT
- Defined in core/psbt-builder.ts:265

getRbfStatus

getRbfStatus(): boolean
Check if Replace-by-Fee is enabled Note: RBF should be enabled when adding inputs, not after PSBT creation

Returns boolean
- Defined in core/enhanced-psbt-builder.ts:417

setInputNonWitnessUtxo

setInputNonWitnessUtxo(inputIndex: number, nonWitnessUtxo: Buffer): void
Set input non-witness UTXO for legacy inputs
Parameters
- inputIndex: number
- nonWitnessUtxo: Buffer
Returns void
- Defined in core/enhanced-psbt-builder.ts:298

setInputWitnessUtxo

setInputWitnessUtxo(
inputIndex: number,
witnessUtxo: { script: Buffer; value: number },
): void
Set input witness UTXO (required for segwit inputs)
Parameters
- inputIndex: number
- witnessUtxo: { script: Buffer; value: number }
Returns void
- Defined in core/enhanced-psbt-builder.ts:282

signWithHardwareWallet

signWithHardwareWallet(hardwareWallet: IHardwareWallet): Promise<void>
Sign PSBT with hardware wallet
Parameters
- hardwareWallet: IHardwareWallet
Returns Promise<void>
- Defined in core/enhanced-psbt-builder.ts:593

toBase64

toBase64(): string
Export to base64

Returns string
Inherited from PSBTBuilder.toBase64
- Defined in core/psbt-builder.ts:244

toBuffer

toBuffer(): Buffer
Export to buffer

Returns Buffer
Inherited from PSBTBuilder.toBuffer
- Defined in core/psbt-builder.ts:258

toHex

toHex(): string
Export to hex

Returns string
Inherited from PSBTBuilder.toHex
- Defined in core/psbt-builder.ts:251

validateForHardwareWallet

validateForHardwareWallet(
_walletType: "ledger" | "trezor" | "coldcard",
): { issues: string[]; valid: boolean }
Validate PSBT for hardware wallet compatibility
Parameters
- _walletType: "ledger" | "trezor" | "coldcard"
Returns { issues: string[]; valid: boolean }
- Defined in core/enhanced-psbt-builder.ts:560

validateSignatures

validateSignatures(): boolean
Validate all inputs have signatures

Returns boolean
Inherited from PSBTBuilder.validateSignatures
- Defined in core/psbt-builder.ts:189

`Static`fromBase64

fromBase64(base64: string, network?: Network): PSBTBuilder
Create PSBT from base64 string
Parameters
- base64: string
- Optionalnetwork: Network
Returns PSBTBuilder
Inherited from PSBTBuilder.fromBase64
- Defined in core/psbt-builder.ts:62

`Static`fromBuffer

fromBuffer(buffer: Buffer, network?: Network): PSBTBuilder
Create PSBT from buffer
Parameters
- buffer: Buffer
- Optionalnetwork: Network
Returns PSBTBuilder
Inherited from PSBTBuilder.fromBuffer
- Defined in core/psbt-builder.ts:86

`Static`fromHex

fromHex(hex: string, network?: Network): PSBTBuilder
Create PSBT from hex string
Parameters
- hex: string
- Optionalnetwork: Network
Returns PSBTBuilder
Inherited from PSBTBuilder.fromHex
- Defined in core/psbt-builder.ts:74

Class EnhancedPSBTBuilder

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns EnhancedPSBTBuilder

Properties

Protectedpsbt

Methods

addDataOutput

Parameters

Returns this

addEnhancedInput

Parameters

Returns this

addEnhancedOutput

Parameters

Returns this

addInput

Parameters

Returns this

addInputDerivation

Parameters

Returns void

addInputRedeemScript

Parameters

Returns void

addInputWitnessScript

Parameters

Returns void

addOutput

Parameters

Returns this

addOutputDerivation

Parameters

Returns void

clone

Returns PSBTBuilder

combine

Parameters

Returns this

enhancedClone

Returns EnhancedPSBTBuilder

extractTransaction

Parameters

Returns null | Transaction

getFee

Returns number

getFeeRate

Returns number

getInputMetadata

Parameters

Returns InputMetadata

getMetadata

Returns PSBTMetadata

getOutputMetadata

Parameters

Returns OutputMetadata

getPSBT

Returns Psbt & { outputCount: number }

getRbfStatus

Returns boolean

setInputNonWitnessUtxo

Parameters

Returns void

setInputWitnessUtxo

Parameters

Returns void

signWithHardwareWallet

Parameters

Returns Promise<void>

toBase64

Returns string

toBuffer

Returns Buffer

toHex

`Protected`psbt

`Static`fromBase64

`Static`fromBuffer

`Static`fromHex