Enum SystemInstruction

pub enum SystemInstruction {
    CreateAccount {
        lamports: u64,
        space: u64,
        owner: Pubkey,
    },
    Assign {
        owner: Pubkey,
    },
    Transfer {
        lamports: u64,
    },
    CreateAccountWithSeed {
        base: Pubkey,
        seed: String,
        lamports: u64,
        space: u64,
        owner: Pubkey,
    },
    AdvanceNonceAccount,
    WithdrawNonceAccount(u64),
    InitializeNonceAccount(Pubkey),
    AuthorizeNonceAccount(Pubkey),
    Allocate {
        space: u64,
    },
    AllocateWithSeed {
        base: Pubkey,
        seed: String,
        space: u64,
        owner: Pubkey,
    },
    AssignWithSeed {
        base: Pubkey,
        seed: String,
        owner: Pubkey,
    },
    TransferWithSeed {
        lamports: u64,
        from_seed: String,
        from_owner: Pubkey,
    },
    UpgradeNonceAccount,
}

An instruction to the system program.

Variants

CreateAccount

Create a new account

Account references

0. [WRITE, SIGNER] Funding account
1. [WRITE, SIGNER] New account

Fields

lamports: u64

Number of lamports to transfer to the new account

space: u64

Number of bytes of memory to allocate

owner: Pubkey

Address of program that will own the new account

Assign

Assign account to a program

Account references

0. [WRITE, SIGNER] Assigned account public key

Fields

owner: Pubkey

Owner program account

Transfer

Transfer lamports

Account references

0. [WRITE, SIGNER] Funding account
1. [WRITE] Recipient account

Fields

lamports: u64

CreateAccountWithSeed

Create a new account at an address derived from a base pubkey and a seed

Account references

0. [WRITE, SIGNER] Funding account
1. [WRITE] Created account
2. [SIGNER] (optional) Base account; the account matching the base Pubkey below must be provided as a signer, but may be the same as the funding account and provided as account 0

Fields

base: Pubkey

Base public key

seed: String

String of ASCII chars, no longer than Pubkey::MAX_SEED_LEN

lamports: u64

Number of lamports to transfer to the new account

space: u64

Number of bytes of memory to allocate

owner: Pubkey

Owner program account address

AdvanceNonceAccount

Consumes a stored nonce, replacing it with a successor

Account references

0. [WRITE] Nonce account
1. [] RecentBlockhashes sysvar
2. [SIGNER] Nonce authority

WithdrawNonceAccount(u64)

Withdraw funds from a nonce account

Account references

0. [WRITE] Nonce account
1. [WRITE] Recipient account
2. [] RecentBlockhashes sysvar
3. [] Rent sysvar
4. [SIGNER] Nonce authority

The u64 parameter is the lamports to withdraw, which must leave the account balance above the rent exempt reserve or at zero.

InitializeNonceAccount(Pubkey)

Drive state of Uninitialized nonce account to Initialized, setting the nonce value

Account references

0. [WRITE] Nonce account
1. [] RecentBlockhashes sysvar
2. [] Rent sysvar

The Pubkey parameter specifies the entity authorized to execute nonce instruction on the account

No signatures are required to execute this instruction, enabling derived nonce account addresses

AuthorizeNonceAccount(Pubkey)

Change the entity authorized to execute nonce instructions on the account

Account references

0. [WRITE] Nonce account
1. [SIGNER] Nonce authority

The Pubkey parameter identifies the entity to authorize

Allocate

Allocate space in a (possibly new) account without funding

Account references

0. [WRITE, SIGNER] New account

Fields

space: u64

Number of bytes of memory to allocate

AllocateWithSeed

Allocate space for and assign an account at an address derived from a base public key and a seed

Account references

0. [WRITE] Allocated account
1. [SIGNER] Base account

Fields

base: Pubkey

Base public key

seed: String

String of ASCII chars, no longer than pubkey::MAX_SEED_LEN

space: u64

Number of bytes of memory to allocate

owner: Pubkey

Owner program account

AssignWithSeed

Assign account to a program based on a seed

Account references

0. [WRITE] Assigned account
1. [SIGNER] Base account

Fields

base: Pubkey

Base public key

seed: String

String of ASCII chars, no longer than pubkey::MAX_SEED_LEN

owner: Pubkey

Owner program account

TransferWithSeed

Transfer lamports from a derived address

Account references

0. [WRITE] Funding account
1. [SIGNER] Base for funding account
2. [WRITE] Recipient account

Fields

lamports: u64

Amount to transfer

from_seed: String

Seed to use to derive the funding account address

from_owner: Pubkey

Owner to use to derive the funding account address

UpgradeNonceAccount

One-time idempotent upgrade of legacy nonce versions in order to bump them out of chain blockhash domain.

Account references

0. [WRITE] Nonce account

Trait Implementations

impl Clone for SystemInstruction

fn clone(&self) -> SystemInstruction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SystemInstruction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SystemInstruction

fn deserialize<__D>( __deserializer: __D, ) -> Result<SystemInstruction, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SystemInstruction

fn eq(&self, other: &SystemInstruction) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SystemInstruction

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SystemInstruction

impl StructuralPartialEq for SystemInstruction