Core.TransactionBuilder | /mod.ts | lucid@0.8.4

class Core.TransactionBuilder

import { Core } from "https://deno.land/x/lucid@0.8.4/mod.ts";
const { TransactionBuilder } = Core;

Methods

__destroy_into_raw()

add_certificate(certificate, script_witness)

Add certificate via a Certificates object

add_collateral(utxo)

add_input(utxo, script_witness)

add_inputs_from(inputs, change_address)

This automatically selects and adds inputs from {inputs} consisting of just enough to cover the outputs that have already been added. This should be called after adding all certs/outputs/etc and will be an error otherwise. Adding a change output must be called after via TransactionBuilder::balance() inputs to cover the minimum fees. This does not, however, set the txbuilder's fee.

change_address is required here in order to determine the min ada requirement precisely

add_json_metadatum(key, val)

Add a single JSON metadatum using a TransactionMetadatumLabel and a String It will be securely added to existing or new metadata in this builder

add_json_metadatum_with_schema(

key,

val,

schema,

)

Add a single JSON metadatum using a TransactionMetadatumLabel, a String, and a MetadataJsonSchema object It will be securely added to existing or new metadata in this builder

add_metadatum(key, val)

Add a single metadatum using TransactionMetadatumLabel and TransactionMetadatum objects It will be securely added to existing or new metadata in this builder

add_mint(

policy_id,

mint_assets,

script_witness,

)

Add a mint entry to this builder using a PolicyID and MintAssets object It will be securely added to existing or new Mint in this builder It will securely add assets to an existing PolicyID But it will replace/overwrite any existing mint assets with the same PolicyID first redeemer applied to a PolicyID is taken for all further assets added to the same PolicyID

add_native_script(native_script)

Add native scripts via a NativeScripts object

add_output(output)

Add explicit output via a TransactionOutput object

add_plutus_data(plutus_data)

Add plutus data via a PlutusData object

add_plutus_script(plutus_script)

Add plutus scripts via a PlutusScripts object

add_plutus_v2_script(plutus_script)

Add plutus v2 scripts via a PlutusScripts object

add_reference_input(utxo)

add_required_signer(required_signer)

add_withdrawal(

reward_address,

coin,

script_witness,

)

auxiliary_data()

balance(change_address, datum)

Warning: this function will mutate the /fee/ field Make sure to call this function last after setting all other tx-body properties Editing inputs, outputs, mint, etc. after change been calculated might cause a mismatch in calculated fee versus the required fee

build_tx()

Returns full Transaction object with the body and the auxiliary data NOTE: witness_set will contain all mint_scripts if any been added or set NOTE: is_valid set to true

certificates()

construct(

collateral_utxos,

collateral_change_address,

native_uplc,

)

Returns full Transaction object with the body and the auxiliary data

NOTE: witness_set will contain all mint_scripts if any been added or set

takes fetched ex units into consideration

add collateral utxos and collateral change receiver in case you redeem from plutus script utxos

async call

NOTE: is_valid set to true

fee_for_input(

address,

input,

amount,

)

calculates how much the fee would increase if you added a given output

fee_for_output(output)

calculates how much the fee would increase if you added a given output

free()

does not include refunds or withdrawals

get_explicit_output()

does not include fee

get_fee_if_set()

get_implicit_input()

withdrawals and refunds

get_total_input()

Return explicit input plus implicit input plus mint

get_total_output()

Return explicit output plus implicit output plus burn (does not consider fee directly)

min_fee()

warning: sum of all parts of a transaction must equal 0. You cannot just set the fee to the min value and forget about it warning: min_fee may be slightly larger than the actual minimum fee (ex: a few lovelaces) this is done to simplify the library code, but can be fixed later

mint()

Returns a copy of the current mint state in the builder

native_scripts()

Returns a copy of the current witness native scripts in the builder

outputs()

set_auxiliary_data(auxiliary_data)

Set explicit auxiliary data via an AuxiliaryData object It might contain some metadata plus native or Plutus scripts