Enum MagicBlockInstruction 

pub enum MagicBlockInstruction {
    ModifyAccounts(HashMap<Pubkey, AccountModificationForInstruction>),
    ScheduleCommit,
    ScheduleCommitAndUndelegate,
    AcceptScheduleCommits,
    ScheduledCommitSent((u64, u64)),
    ScheduleBaseIntent(MagicBaseIntentArgs),
    ScheduleTask(ScheduleTaskArgs),
    CancelTask {
        task_id: u64,
    },
    ProcessTasks,
    DisableExecutableCheck,
    EnableExecutableCheck,
}

Variants

ModifyAccounts(HashMap<Pubkey, AccountModificationForInstruction>)

Modify one or more accounts

Account references

• 0. [WRITE, SIGNER] Validator Authority
• 1..n. [WRITE] Accounts to modify
• n+1 [SIGNER] (Implicit NativeLoader)

ScheduleCommit

Schedules the accounts provided at end of accounts Vec to be committed. It should be invoked from the program whose PDA accounts are to be committed.

This is the first part of scheduling a commit. A second transaction MagicBlockInstruction::AcceptScheduleCommits has to run in order to finish scheduling the commit.

Account references

• 0. [WRITE, SIGNER] Payer requesting the commit to be scheduled
• 1. [WRITE] Magic Context Account containing to which we store the scheduled commits
• 2..n [] Accounts to be committed

ScheduleCommitAndUndelegate

This is the exact same instruction as MagicBlockInstruction::ScheduleCommit except that the [ScheduledCommit] is flagged such that when accounts are committed, a request to undelegate them is included with the same transaction. Additionally the validator will refuse anymore transactions for the specific account since they are no longer considered delegated to it.

This is the first part of scheduling a commit. A second transaction MagicBlockInstruction::AcceptScheduleCommits has to run in order to finish scheduling the commit.

Account references

• 0. [WRITE, SIGNER] Payer requesting the commit to be scheduled
• 1. [WRITE] Magic Context Account containing to which we store the scheduled commits
• 2..n [] Accounts to be committed and undelegated

AcceptScheduleCommits

Moves the scheduled commit from the MagicContext to the global scheduled commits map. This is the second part of scheduling a commit.

It is run at the start of the slot to update the global scheduled commits map just in time for the validator to realize the commits right after.

Account references

• 0. [SIGNER] Validator Authority
• 1. [WRITE] Magic Context Account containing the initially scheduled commits

ScheduledCommitSent((u64, u64))

Records the attempt to realize a scheduled commit on chain.

The signature of this transaction can be pre-calculated since we pass the ID of the scheduled commit and retrieve the signature from a globally stored hashmap.

We implement it this way so we can log the signature of this transaction as part of the MagicBlockInstruction::ScheduleCommit instruction. Args: (intent_id, bump) - bump is needed in order to guarantee unique transactions

ScheduleBaseIntent(MagicBaseIntentArgs)

ScheduleTask(ScheduleTaskArgs)

Schedule a new task for execution

Account references

• 0. [WRITE, SIGNER] Payer (payer)
• 1. [WRITE] Task context account
• 2..n [] Accounts included in the task

CancelTask

Cancel a task

Account references

• 0. [WRITE, SIGNER] Task authority
• 1. [WRITE] Task context account

Fields

task_id: u64

ProcessTasks

Process all tasks

Account references

• 0. [SIGNER] Validator authority
• 1. [WRITE] Task context account

DisableExecutableCheck

Disables the executable check, needed to modify the data of a program in preparation to deploying it via LoaderV4 and to modify its authority.

Account references

• 0. [SIGNER] Validator authority

EnableExecutableCheck

Enables the executable check, and should run after a program is deployed with the LoaderV4 and we modified its authority

Account references

• 0. [SIGNER] Validator authority

Implementations

impl MagicBlockInstruction

pub fn try_to_vec(&self) -> Result<Vec<u8>, Error>

Trait Implementations

impl Clone for MagicBlockInstruction

fn clone(&self) -> MagicBlockInstruction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MagicBlockInstruction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MagicBlockInstruction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MagicBlockInstruction

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

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 MagicBlockInstruction

impl StructuralPartialEq for MagicBlockInstruction