Struct ProgrammableTransactionBuilder

pub struct ProgrammableTransactionBuilder { /* private fields */ }

Builder for a ProgrammableTransaction.

Implementations

impl ProgrammableTransactionBuilder

Base API.

pub fn new() -> Self

pub fn finish(self) -> ProgrammableTransaction

pub fn pure<T: Serialize + ?Sized>(&mut self, value: &T) -> Result<Argument>

Potentially adds a pure argument to the PTB.

May not create a new PTB input if a previous one already has the same contents.

pub fn force_separate_pure<T: Serialize>( &mut self, value: T, ) -> Result<Argument>

Like Self::pure but forces a separate input entry

pub fn pure_bytes(&mut self, bytes: Vec<u8>, force_separate: bool) -> Argument

Adds a pure argument to the PTB.

Arguments

• bytes: the BCS-serialized contents of the argument
• force_separate: whether to force a separate input argument to the PTB, else the builder re-uses a previously declared input argument if it has the same contents.

pub fn obj(&mut self, obj_arg: ObjectArg) -> Result<Argument>

Adds an object input to the PTB, returning the corresponding argument which can be used in the body.

May fail if overriding a previously declared input.

pub fn command(&mut self, command: impl Into<Command>) -> Argument

Add a command to the PTB.

This will come after any commands that were previously declared.

impl ProgrammableTransactionBuilder

Extensions to the base API.

pub fn split_coins_into_vec( &mut self, coin: Argument, amounts: Vec<Argument>, ) -> Vec<Argument>

Like .command(Command::SplitCoins(coin_arg, balances)), but also takes care of unpacking each entry in the returned vector as its own Argument.

Panics

Panics if the balances input vector has a length that exceeds u16::MAX.

Trait Implementations

impl Clone for ProgrammableTransactionBuilder

fn clone(&self) -> ProgrammableTransactionBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProgrammableTransactionBuilder

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

Formats the value using the given formatter.

impl Default for ProgrammableTransactionBuilder

fn default() -> ProgrammableTransactionBuilder

Returns the “default value” for a type.

impl From<ProgrammableTransactionBuilder> for ProgrammableTransaction

fn from(value: ProgrammableTransactionBuilder) -> Self

Converts to this type from the input type.

impl TryFrom<ProgrammableTransaction> for ProgrammableTransactionBuilder

type Error = Error

The type returned in the event of a conversion error.

fn try_from(_: ProgrammableTransaction) -> Result<Self>

Performs the conversion.