Enum spl_token::instruction::TokenInstruction[][src]

[]
#[repr(C)]pub enum TokenInstruction {
    InitializeMint {
        decimals: u8,
        mint_authority: Pubkey,
        freeze_authority: COption<Pubkey>,
    },
    InitializeAccount,
    InitializeMultisig {
        m: u8,
    },
    Transfer {
        amount: u64,
    },
    Approve {
        amount: u64,
    },
    Revoke,
    SetAuthority {
        authority_type: AuthorityType,
        new_authority: COption<Pubkey>,
    },
    MintTo {
        amount: u64,
    },
    Burn {
        amount: u64,
    },
    CloseAccount,
    FreezeAccount,
    ThawAccount,
    TransferChecked {
        amount: u64,
        decimals: u8,
    },
    ApproveChecked {
        amount: u64,
        decimals: u8,
    },
    MintToChecked {
        amount: u64,
        decimals: u8,
    },
    BurnChecked {
        amount: u64,
        decimals: u8,
    },
    InitializeAccount2 {
        owner: Pubkey,
    },
}
[]

Instructions supported by the token program.

Variants

InitializeMint
[]

Initializes a new mint and optionally deposits all the newly minted tokens in an account.

The InitializeMint instruction requires no signers and MUST be included within the same Transaction as the system program’s CreateAccount instruction that creates the account being initialized. Otherwise another party can acquire ownership of the uninitialized account.

Accounts expected by this instruction:

  1. [writable] The mint to initialize.
  2. [] Rent sysvar
[]

Fields of InitializeMint

decimals: u8

Number of base 10 digits to the right of the decimal place.

mint_authority: Pubkey

The authority/multisignature to mint tokens.

freeze_authority: COption<Pubkey>

The freeze authority/multisignature of the mint.

InitializeAccount
[]

Initializes a new account to hold tokens. If this account is associated with the native mint then the token balance of the initialized account will be equal to the amount of SOL in the account. If this account is associated with another mint, that mint must be initialized before this command can succeed.

The InitializeAccount instruction requires no signers and MUST be included within the same Transaction as the system program’s CreateAccount instruction that creates the account being initialized. Otherwise another party can acquire ownership of the uninitialized account.

Accounts expected by this instruction:

  1. [writable] The account to initialize.
  2. [] The mint this account will be associated with.
  3. [] The new account’s owner/multisignature.
  4. [] Rent sysvar
InitializeMultisig
[]

Initializes a multisignature account with N provided signers.

Multisignature accounts can used in place of any single owner/delegate accounts in any token instruction that require an owner/delegate to be present. The variant field represents the number of signers (M) required to validate this multisignature account.

The InitializeMultisig instruction requires no signers and MUST be included within the same Transaction as the system program’s CreateAccount instruction that creates the account being initialized. Otherwise another party can acquire ownership of the uninitialized account.

Accounts expected by this instruction:

  1. [writable] The multisignature account to initialize.
  2. [] Rent sysvar
  3. ..2+N. [] The signer accounts, must equal to N where 1 <= N <=
[]

Fields of InitializeMultisig

m: u8

The number of signers (M) required to validate this multisignature account.

Transfer
[]

Transfers tokens from one account to another either directly or via a delegate. If this account is associated with the native mint then equal amounts of SOL and Tokens will be transferred to the destination account.

Accounts expected by this instruction:

  1. [writable] The source account.
  2. [writable] The destination account.
  3. [signer] The source account’s owner/delegate.
  1. [writable] The source account.
  2. [writable] The destination account.
  3. [] The source account’s multisignature owner/delegate.
  4. ..3+M [signer] M signer accounts.
[]

Fields of Transfer

amount: u64

The amount of tokens to transfer.

Approve
[]

Approves a delegate. A delegate is given the authority over tokens on behalf of the source account’s owner.

Accounts expected by this instruction:

  1. [writable] The source account.
  2. [] The delegate.
  3. [signer] The source account owner.
  1. [writable] The source account.
  2. [] The delegate.
  3. [] The source account’s multisignature owner.
  4. ..3+M [signer] M signer accounts
[]

Fields of Approve

amount: u64

The amount of tokens the delegate is approved for.

Revoke
[]

Revokes the delegate’s authority.

Accounts expected by this instruction:

  1. [writable] The source account.
  2. [signer] The source account owner.
  1. [writable] The source account.
  2. [] The source account’s multisignature owner.
  3. ..2+M [signer] M signer accounts
SetAuthority
[]

Sets a new authority of a mint or account.

Accounts expected by this instruction:

  1. [writable] The mint or account to change the authority of.
  2. [signer] The current authority of the mint or account.
  1. [writable] The mint or account to change the authority of.
  2. [] The mint’s or account’s current multisignature authority.
  3. ..2+M [signer] M signer accounts
[]

Fields of SetAuthority

authority_type: AuthorityType

The type of authority to update.

new_authority: COption<Pubkey>

The new authority

MintTo
[]

Mints new tokens to an account. The native mint does not support minting.

Accounts expected by this instruction:

  1. [writable] The mint.
  2. [writable] The account to mint tokens to.
  3. [signer] The mint’s minting authority.
  1. [writable] The mint.
  2. [writable] The account to mint tokens to.
  3. [] The mint’s multisignature mint-tokens authority.
  4. ..3+M [signer] M signer accounts.
[]

Fields of MintTo

amount: u64

The amount of new tokens to mint.

Burn
[]

Burns tokens by removing them from an account. Burn does not support accounts associated with the native mint, use CloseAccount instead.

Accounts expected by this instruction:

  1. [writable] The account to burn from.
  2. [writable] The token mint.
  3. [signer] The account’s owner/delegate.
  1. [writable] The account to burn from.
  2. [writable] The token mint.
  3. [] The account’s multisignature owner/delegate.
  4. ..3+M [signer] M signer accounts.
[]

Fields of Burn

amount: u64

The amount of tokens to burn.

CloseAccount
[]

Close an account by transferring all its SOL to the destination account. Non-native accounts may only be closed if its token amount is zero.

Accounts expected by this instruction:

  1. [writable] The account to close.
  2. [writable] The destination account.
  3. [signer] The account’s owner.
  1. [writable] The account to close.
  2. [writable] The destination account.
  3. [] The account’s multisignature owner.
  4. ..3+M [signer] M signer accounts.
FreezeAccount
[]

Freeze an Initialized account using the Mint’s freeze_authority (if set).

Accounts expected by this instruction:

  1. [writable] The account to freeze.
  2. [] The token mint.
  3. [signer] The mint freeze authority.
  1. [writable] The account to freeze.
  2. [] The token mint.
  3. [] The mint’s multisignature freeze authority.
  4. ..3+M [signer] M signer accounts.
ThawAccount
[]

Thaw a Frozen account using the Mint’s freeze_authority (if set).

Accounts expected by this instruction:

  1. [writable] The account to freeze.
  2. [] The token mint.
  3. [signer] The mint freeze authority.
  1. [writable] The account to freeze.
  2. [] The token mint.
  3. [] The mint’s multisignature freeze authority.
  4. ..3+M [signer] M signer accounts.
TransferChecked
[]

Transfers tokens from one account to another either directly or via a delegate. If this account is associated with the native mint then equal amounts of SOL and Tokens will be transferred to the destination account.

This instruction differs from Transfer in that the token mint and decimals value is checked by the caller. This may be useful when creating transactions offline or within a hardware wallet.

Accounts expected by this instruction:

  1. [writable] The source account.
  2. [] The token mint.
  3. [writable] The destination account.
  4. [signer] The source account’s owner/delegate.
  1. [writable] The source account.
  2. [] The token mint.
  3. [writable] The destination account.
  4. [] The source account’s multisignature owner/delegate.
  5. ..4+M [signer] M signer accounts.
[]

Fields of TransferChecked

amount: u64

The amount of tokens to transfer.

decimals: u8

Expected number of base 10 digits to the right of the decimal place.

ApproveChecked
[]

Approves a delegate. A delegate is given the authority over tokens on behalf of the source account’s owner.

This instruction differs from Approve in that the token mint and decimals value is checked by the caller. This may be useful when creating transactions offline or within a hardware wallet.

Accounts expected by this instruction:

  1. [writable] The source account.
  2. [] The token mint.
  3. [] The delegate.
  4. [signer] The source account owner.
  1. [writable] The source account.
  2. [] The token mint.
  3. [] The delegate.
  4. [] The source account’s multisignature owner.
  5. ..4+M [signer] M signer accounts
[]

Fields of ApproveChecked

amount: u64

The amount of tokens the delegate is approved for.

decimals: u8

Expected number of base 10 digits to the right of the decimal place.

MintToChecked
[]

Mints new tokens to an account. The native mint does not support minting.

This instruction differs from MintTo in that the decimals value is checked by the caller. This may be useful when creating transactions offline or within a hardware wallet.

Accounts expected by this instruction:

  1. [writable] The mint.
  2. [writable] The account to mint tokens to.
  3. [signer] The mint’s minting authority.
  1. [writable] The mint.
  2. [writable] The account to mint tokens to.
  3. [] The mint’s multisignature mint-tokens authority.
  4. ..3+M [signer] M signer accounts.
[]

Fields of MintToChecked

amount: u64

The amount of new tokens to mint.

decimals: u8

Expected number of base 10 digits to the right of the decimal place.

BurnChecked
[]

Burns tokens by removing them from an account. BurnChecked does not support accounts associated with the native mint, use CloseAccount instead.

This instruction differs from Burn in that the decimals value is checked by the caller. This may be useful when creating transactions offline or within a hardware wallet.

Accounts expected by this instruction:

  1. [writable] The account to burn from.
  2. [writable] The token mint.
  3. [signer] The account’s owner/delegate.
  1. [writable] The account to burn from.
  2. [writable] The token mint.
  3. [] The account’s multisignature owner/delegate.
  4. ..3+M [signer] M signer accounts.
[]

Fields of BurnChecked

amount: u64

The amount of tokens to burn.

decimals: u8

Expected number of base 10 digits to the right of the decimal place.

InitializeAccount2
[]

Like InitializeAccount, but the owner pubkey is passed via instruction data rather than the accounts list. This variant may be preferable when using Cross Program Invocation from an instruction that does not need the owner’s AccountInfo otherwise.

Accounts expected by this instruction:

  1. [writable] The account to initialize.
  2. [] The mint this account will be associated with.
  3. [] Rent sysvar
[]

Fields of InitializeAccount2

owner: Pubkey

The new account’s owner/multisignature.

Implementations

impl TokenInstruction[src][]

pub fn unpack(input: &[u8]) -> Result<Self, ProgramError>[src][]

Unpacks a byte buffer into a TokenInstruction.

pub fn pack(&self) -> Vec<u8>[src][]

Packs a TokenInstruction into a byte buffer.

Trait Implementations

impl Clone for TokenInstruction[src][+]

impl Debug for TokenInstruction[src][+]

impl PartialEq<TokenInstruction> for TokenInstruction[src][+]

impl StructuralPartialEq for TokenInstruction[src]

Auto Trait Implementations

impl RefUnwindSafe for TokenInstruction

impl Send for TokenInstruction

impl Sync for TokenInstruction

impl Unpin for TokenInstruction

impl UnwindSafe for TokenInstruction

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src][+]

impl<T> Borrow<T> for T where
    T: ?Sized
[src][+]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src][+]

impl<T> From<T> for T[src][+]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src][+]

impl<T> Same<T> for T[src]

type Output = T

Should always be Self

impl<T> ToOwned for T where
    T: Clone
[src][+]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src][+]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src][+]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
[src][+]