Enum StakeInstruction

pub enum StakeInstruction {
    Initialize(Authorized, Lockup),
    Authorize(Pubkey, StakeAuthorize),
    DelegateStake,
    Split(u64),
    Withdraw(u64),
    Deactivate,
    SetLockup(LockupArgs),
    Merge,
    AuthorizeWithSeed(AuthorizeWithSeedArgs),
    InitializeChecked,
    AuthorizeChecked(StakeAuthorize),
    AuthorizeCheckedWithSeed(AuthorizeCheckedWithSeedArgs),
    SetLockupChecked(LockupCheckedArgs),
    GetMinimumDelegation,
    DeactivateDelinquent,
    Redelegate,
}

Variants

Initialize(Authorized, Lockup)

Initialize a stake with lockup and authorization information

Account references

0. [WRITE] Uninitialized stake account
1. [] Rent sysvar

Authorized carries pubkeys that must sign staker transactions and withdrawer transactions. Lockup carries information about withdrawal restrictions

Authorize(Pubkey, StakeAuthorize)

Authorize a key to manage stake or withdrawal

Account references

0. [WRITE] Stake account to be updated
1. [] Clock sysvar
2. [SIGNER] The stake or withdraw authority
3. Optional: [SIGNER] Lockup authority, if updating StakeAuthorize::Withdrawer before lockup expiration

DelegateStake

Delegate a stake to a particular vote account

Account references

0. [WRITE] Initialized stake account to be delegated
1. [] Vote account to which this stake will be delegated
2. [] Clock sysvar
3. [] Stake history sysvar that carries stake warmup/cooldown history
4. [] Address of config account that carries stake config
5. [SIGNER] Stake authority

The entire balance of the staking account is staked. DelegateStake can be called multiple times, but re-delegation is delayed by one epoch

Split(u64)

Split u64 tokens and stake off a stake account into another stake account.

Account references

0. [WRITE] Stake account to be split; must be in the Initialized or Stake state
1. [WRITE] Uninitialized stake account that will take the split-off amount
2. [SIGNER] Stake authority

Withdraw(u64)

Withdraw unstaked lamports from the stake account

Account references

0. [WRITE] Stake account from which to withdraw
1. [WRITE] Recipient account
2. [] Clock sysvar
3. [] Stake history sysvar that carries stake warmup/cooldown history
4. [SIGNER] Withdraw authority
5. Optional: [SIGNER] Lockup authority, if before lockup expiration

The u64 is the portion of the stake account balance to be withdrawn, must be <= StakeAccount.lamports - staked_lamports.

Deactivate

Deactivates the stake in the account

Account references

0. [WRITE] Delegated stake account
1. [] Clock sysvar
2. [SIGNER] Stake authority

SetLockup(LockupArgs)

Set stake lockup

If a lockup is not active, the withdraw authority may set a new lockup If a lockup is active, the lockup custodian may update the lockup parameters

Account references

0. [WRITE] Initialized stake account
1. [SIGNER] Lockup authority or withdraw authority

Merge

Merge two stake accounts.

Both accounts must have identical lockup and authority keys. A merge is possible between two stakes in the following states with no additional conditions:

• two deactivated stakes
• an inactive stake into an activating stake during its activation epoch

For the following cases, the voter pubkey and vote credits observed must match:

• two activated stakes
• two activating accounts that share an activation epoch, during the activation epoch

All other combinations of stake states will fail to merge, including all “transient” states, where a stake is activating or deactivating with a non-zero effective stake.

Account references

0. [WRITE] Destination stake account for the merge
1. [WRITE] Source stake account for to merge. This account will be drained
2. [] Clock sysvar
3. [] Stake history sysvar that carries stake warmup/cooldown history
4. [SIGNER] Stake authority

AuthorizeWithSeed(AuthorizeWithSeedArgs)

Authorize a key to manage stake or withdrawal with a derived key

Account references

0. [WRITE] Stake account to be updated
1. [SIGNER] Base key of stake or withdraw authority
2. [] Clock sysvar
3. Optional: [SIGNER] Lockup authority, if updating StakeAuthorize::Withdrawer before lockup expiration

InitializeChecked

Initialize a stake with authorization information

This instruction is similar to Initialize except that the withdraw authority must be a signer, and no lockup is applied to the account.

Account references

0. [WRITE] Uninitialized stake account
1. [] Rent sysvar
2. [] The stake authority
3. [SIGNER] The withdraw authority

AuthorizeChecked(StakeAuthorize)

Authorize a key to manage stake or withdrawal

This instruction behaves like Authorize with the additional requirement that the new stake or withdraw authority must also be a signer.

Account references

0. [WRITE] Stake account to be updated
1. [] Clock sysvar
2. [SIGNER] The stake or withdraw authority
3. [SIGNER] The new stake or withdraw authority
4. Optional: [SIGNER] Lockup authority, if updating StakeAuthorize::Withdrawer before lockup expiration

AuthorizeCheckedWithSeed(AuthorizeCheckedWithSeedArgs)

Authorize a key to manage stake or withdrawal with a derived key

This instruction behaves like AuthorizeWithSeed with the additional requirement that the new stake or withdraw authority must also be a signer.

Account references

0. [WRITE] Stake account to be updated
1. [SIGNER] Base key of stake or withdraw authority
2. [] Clock sysvar
3. [SIGNER] The new stake or withdraw authority
4. Optional: [SIGNER] Lockup authority, if updating StakeAuthorize::Withdrawer before lockup expiration

SetLockupChecked(LockupCheckedArgs)

Set stake lockup

This instruction behaves like SetLockup with the additional requirement that the new lockup authority also be a signer.

If a lockup is not active, the withdraw authority may set a new lockup If a lockup is active, the lockup custodian may update the lockup parameters

Account references

0. [WRITE] Initialized stake account
1. [SIGNER] Lockup authority or withdraw authority
2. Optional: [SIGNER] New lockup authority

GetMinimumDelegation

Get the minimum stake delegation, in lamports

Account references

None

Returns the minimum delegation as a little-endian encoded u64 value. Programs can use the get_minimum_delegation() helper function to invoke and retrieve the return value for this instruction.

DeactivateDelinquent

Deactivate stake delegated to a vote account that has been delinquent for at least MINIMUM_DELINQUENT_EPOCHS_FOR_DEACTIVATION epochs.

No signer is required for this instruction as it is a common good to deactivate abandoned stake.

Account references

0. [WRITE] Delegated stake account
1. [] Delinquent vote account for the delegated stake account
2. [] Reference vote account that has voted at least once in the last MINIMUM_DELINQUENT_EPOCHS_FOR_DEACTIVATION epochs

Redelegate

Redelegate activated stake to another vote account.

Upon success:

• the balance of the delegated stake account will be reduced to the undelegated amount in the account (rent exempt minimum and any additional lamports not part of the delegation), and scheduled for deactivation.
• the provided uninitialized stake account will receive the original balance of the delegated stake account, minus the rent exempt minimum, and scheduled for activation to the provided vote account. Any existing lamports in the uninitialized stake account will also be included in the re-delegation.

Account references

0. [WRITE] Delegated stake account to be redelegated. The account must be fully activated and carry a balance greater than or equal to the minimum delegation amount plus rent exempt minimum
1. [WRITE] Uninitialized stake account that will hold the redelegated stake
2. [] Vote account to which this stake will be re-delegated
3. [] Address of config account that carries stake config
4. [SIGNER] Stake authority

Trait Implementations

impl Clone for StakeInstruction

fn clone(&self) -> StakeInstruction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StakeInstruction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StakeInstruction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for StakeInstruction

fn eq(&self, other: &StakeInstruction) -> 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 StakeInstruction

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 StakeInstruction

impl StructuralPartialEq for StakeInstruction