Enum solana_sdk::loader_v4_instruction::LoaderV4Instruction

#[repr(u8)]
pub enum LoaderV4Instruction {
    Write {
        offset: u32,
        bytes: Vec<u8>,
    },
    Truncate {
        offset: u32,
    },
    Deploy,
    Retract,
    TransferAuthority,
}

Variants

Write

Fields

offset: u32

Offset at which to write the given bytes.

bytes: Vec<u8>

Serialized program data

Write ELF data into an undeployed program account.

Writing at the end (offset is length) increases the size of the program account and providing additional lamports (via the payer account) is necessary to reach rent exemption. The first write (at offset zero when the account is empty) automatically initializes the program account and sets the authority needed for subsequent writes. Thus, the first write should be in the same transaction as the account creation.

Account references

0. [writable] The program account to write to.
1. [signer] The authority of the program.
2. [signer] Optional, the payer account.

Truncate

Fields

offset: u32

Offset at which to cut off the rest. This will be the size after the operation.

Decrease the size of an undeployed program account.

Decreasing to size zero closes the program account and resets it into an uninitialized state. Superflous lamports are transfered to the recipient account.

Account references

0. [writable] The program account to change the size of.
1. [signer] The authority of the program.
2. [writable] The recipient account.

Deploy

Verify the data of a program account to be a valid ELF.

If this succeeds the program becomes executable, and is ready to use. A source program account can be provided to overwrite the data before deployment in one step, instead retracting the program and writing to it and redeploying it. The source program is truncated to zero (thus closed) and lamports necessary for rent exemption are transferred, in case that the source was bigger than the program.

Account references

0. [writable] The program account to deploy.
1. [signer] The authority of the program.
2. [writable] Optional, an undeployed source program account to take data and lamports from.

Retract

Undo the deployment of a program account.

The program is no longer executable and goes into maintainance. Necessary for writing data and truncating.

Account references

0. [writable] The program account to retract.
1. [signer] The authority of the program.

TransferAuthority

Transfers the authority over a program account.

WARNING: Using this instruction without providing a new authority finalizes the program (it becomes immutable).

Account references

0. [writable] The program account to change the authority of.
1. [signer] The current authority of the program.
2. [signer] The new authority of the program. Optional if program is currently deployed.

Trait Implementations

impl Clone for LoaderV4Instruction

fn clone(&self) -> LoaderV4Instruction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LoaderV4Instruction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LoaderV4Instruction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LoaderV4Instruction

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for LoaderV4Instruction

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 LoaderV4Instruction

impl StructuralEq for LoaderV4Instruction

impl StructuralPartialEq for LoaderV4Instruction