Skip to main content

Crate pallas_txbuilder

Crate pallas_txbuilder 

Source
Expand description

Ergonomic builder for constructing and signing Cardano transactions.

The crate is organised around StagingTransaction, a fluent builder that collects inputs, outputs, mint, scripts, datums, and redeemers, and finalises into a BuiltTransaction ready to be signed and submitted.

Currently the only era supported for building is Conway (via the BuildConway trait). Earlier-era builders are intentionally not maintained.

§Usage

use pallas_txbuilder::{BuildConway, Input, Output, StagingTransaction};

let tx = StagingTransaction::new()
    .input(Input::new(prev_tx_hash, 0))
    .output(Output::new(recipient_address, 2_000_000))
    .fee(170_000)
    .build_conway_raw()?;

let signed = tx.sign(&signing_key)?;
let cbor = signed.tx_bytes;

§Overview

§Usage as part of pallas

When depending on the umbrella pallas crate, this crate is re-exported as pallas::txbuilder.

Structs§

BuiltTransaction
A fully built (and possibly signed) transaction ready to submit.
Bytes
Owned variable-length byte buffer used for asset names, datum payloads, etc.
Bytes32
Fixed-length 32-byte buffer (transaction hashes, datum hashes, public keys).
ExUnits
Plutus script execution budget.
Input
Reference to a single transaction output (consumed or referenced).
Output
Transaction output being produced.
StagingTransaction
In-progress transaction that converts to a BuiltTransaction via an era-specific build trait.

Enums§

ScriptKind
Discriminator selecting a script language.
TxBuilderError
Errors produced while staging, building, or signing a transaction.

Traits§

BuildConway
Conway-era build step: converts a StagingTransaction into a BuiltTransaction with no automatic fee/ex-units calculation.