Skip to main content
Version: Next

tx.txbuilder.addinput

Home > @blaze-cardano/tx > TxBuilder > addInput

TxBuilder.addInput() method

Adds an input to the transaction. This method is responsible for including a new input, which represents a reference to an unspent transaction output (UTxO) that will be consumed by the transaction. Optionally, a redeemer and an unhashed datum can be provided for script validation purposes.

Signature:

addInput(utxo: TransactionUnspentOutput, redeemer?: PlutusData, unhashDatum?: PlutusData): TxBuilder;

Parameters

Parameter

Type

Description

utxo

TransactionUnspentOutput

The UTxO to be consumed as an input.

redeemer

PlutusData

(Optional) Optional. The redeemer data for script validation, required for spending Plutus script-locked UTxOs.

unhashDatum

PlutusData

(Optional) Optional. The unhashed datum, required if the UTxO being spent includes a datum hash instead of inline datum.

Returns:

TxBuilder

{TxBuilder} The same transaction builder

Exceptions

{Error} If attempting to add a duplicate input, if the UTxO payment key is missing, if attempting to spend with a redeemer for a KeyHash credential, if attempting to spend without a datum when required, or if providing both an inline datum and an unhashed datum.