Struct SendFungibleFaucetNotesTransactionScript 

pub struct SendFungibleFaucetNotesTransactionScript(/* private fields */);

The canonical send_notes TransactionScript for accounts exposing the FungibleFaucet procedures, which sends notes holding assets the faucet mints as part of note creation.

Every note must carry exactly one fungible asset, issued by this faucet.

Faucets that delegate minting to an authority (those exposing Ownable2Step or RoleBasedAccessControl) are network faucets that mint exclusively via MINT notes, so they are rejected at script build time to avoid runtime failures under their OwnerOnly mint policy.

The payload and the attachment contents the script reads from the advice provider are embedded in the script’s MAST forest, so they are loaded with the script. Callers only have to set the script (Self::tx_script) and the payload commitment it reads its parameters from (Self::tx_script_args).

Implementations

impl SendFungibleFaucetNotesTransactionScript

pub fn new( interface: &AccountCodeInterface, output_notes: &[PartialNote], ) -> Result<Self, SendNotesTransactionScriptError>

Builds the script for the faucet described by interface, without an expiration delta.

Errors

See Self::with_expiration_delta.

pub fn with_expiration_delta( interface: &AccountCodeInterface, output_notes: &[PartialNote], expiration_delta: NonZeroU16, ) -> Result<Self, SendNotesTransactionScriptError>

Builds the script for the faucet described by interface, with the given non-zero expiration delta.

Errors

Returns an error if:

• The interface does not expose the FungibleFaucet procedure the script calls.
• The faucet delegates minting to an authority.
• Any note is not sent by the faucet.
• Any note does not carry exactly one fungible asset issued by the faucet.

pub fn tx_script(&self) -> &TransactionScript

The underlying TransactionScript, to be set as the transaction’s script.

pub fn tx_script_args(&self) -> Word

The transaction script argument the script reads its payload commitment from.

pub fn script_root() -> TransactionScriptRoot

The TransactionScriptRoot of the canonical fungible faucet script.

Trait Implementations

impl Clone for SendFungibleFaucetNotesTransactionScript

fn clone(&self) -> SendFungibleFaucetNotesTransactionScript

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SendFungibleFaucetNotesTransactionScript

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.