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
StagingTransaction— the in-progress, mutable transaction; the entry point for everything (new,input,output,mint,fee,network_id,valid_after, …).BuiltTransaction— the finalised, encoded body produced byBuildConway; exposessign(&signer)and the raw CBOR bytes.Input,Output,ExUnits,ScriptKind,Bytes,Bytes32— the value types that go into the builder.BuildConwaytrait — implemented forStagingTransaction; turns staging state into a Conway-encoded transaction.TxBuilderError— the unified error returned from build / sign.
§Usage as part of pallas
When depending on the umbrella pallas crate, this crate is re-exported
as pallas::txbuilder.
Structs§
- Built
Transaction - 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.
- Staging
Transaction - In-progress transaction that converts to a
BuiltTransactionvia an era-specific build trait.
Enums§
- Script
Kind - Discriminator selecting a script language.
- TxBuilder
Error - Errors produced while staging, building, or signing a transaction.
Traits§
- Build
Conway - Conway-era build step: converts a
StagingTransactioninto aBuiltTransactionwith no automatic fee/ex-units calculation.