Enum LoaderV4Instruction

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

Variants

Write

Write ELF data into an undeployed program account.

Account references

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

Fields

offset: u32

Offset at which to write the given bytes.

bytes: Vec<u8>

Serialized program data

Truncate

Changes the size of an undeployed program account.

A program account is automatically initialized when its size is first increased. In this initial truncate, the program account needs to be a signer and it also sets the authority needed for subsequent operations. Decreasing to size zero closes the program account and resets it into an uninitialized state. Providing additional lamports upfront might be necessary to reach rent exemption. Superflous funds are transferred to the recipient account.

Account references

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

Fields

new_size: u32

The new size after the operation.

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 maintenance. 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.

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.

Finalize

Finalizes the program account, rendering it immutable.

Account references

0. [writable] The program account to change the authority of.
1. [signer] The current authority of the program.
2. [] The next version of the program (can be itself).

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LoaderV4Instruction

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for LoaderV4Instruction

impl StructuralPartialEq for LoaderV4Instruction