Struct Coin 

pub struct Coin { /* private fields */ }

Available on crate feature intents only.

An intent requesting a Coin<T> of a specific type and balance.

When resolved via TransactionBuilder::build, the resolver selects coins owned by the sender, merges them if necessary, and splits off the requested amount.

Examples

use sui_transaction_builder::intent::Coin;

// Request 1 SUI (uses gas coin by default)
let coin = Coin::sui(1_000_000_000);

// Request a custom coin type
use sui_sdk_types::StructTag;
let usdc = Coin::new(
    "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC"
        .parse()
        .unwrap(),
    1_000_000,
);

Implementations

impl Coin

pub fn new(coin_type: StructTag, balance: u64) -> Self

Create a new Coin intent for the given coin type and amount (in base units).

use sui_sdk_types::StructTag;
use sui_transaction_builder::intent::Coin;

let coin = Coin::new(StructTag::sui(), 1_000_000_000);

pub fn sui(balance: u64) -> Self

Shorthand for requesting a SUI coin with the given balance.

By default the resolver will draw from the gas coin. Call with_use_gas_coin(false) to opt out.

use sui_transaction_builder::intent::Coin;

let one_sui = Coin::sui(1_000_000_000);

pub fn with_use_gas_coin(self, use_gas_coin: bool) -> Self

Control whether the resolver should draw from the gas coin.

This is only meaningful when the coin type is SUI. Pass false to force the resolver to select non-gas SUI coins instead.

use sui_transaction_builder::intent::Coin;

// Don't touch the gas coin -- select other SUI coins instead
let coin = Coin::sui(1_000_000_000).with_use_gas_coin(false);