feat: Add ScheduleCommitFinalize to program-api only

Author: snawaz

magicblock-magic-program-api/src/args.rs

@@ -85,12 +85,16 @@ pub enum MagicBaseIntentArgs {
     BaseActions(Vec<BaseActionArgs>),
     Commit(CommitTypeArgs),
     CommitAndUndelegate(CommitAndUndelegateArgs),
+    CommitFinalize(CommitTypeArgs),
+    CommitFinalizeAndUndelegate(CommitAndUndelegateArgs),
 }
 
 #[derive(Clone, Default, Serialize, Deserialize, Debug, PartialEq, Eq)]
 pub struct MagicIntentBundleArgs {
     pub commit: Option<CommitTypeArgs>,
     pub commit_and_undelegate: Option<CommitAndUndelegateArgs>,
+    pub commit_finalize: Option<CommitTypeArgs>,
+    pub commit_finalize_and_undelegate: Option<CommitAndUndelegateArgs>,
     pub standalone_actions: Vec<BaseActionArgs>,
 }
 
@@ -105,6 +109,12 @@ impl From<MagicBaseIntentArgs> for MagicIntentBundleArgs {
             MagicBaseIntentArgs::CommitAndUndelegate(value) => {
                 this.commit_and_undelegate = Some(value)
             }
+            MagicBaseIntentArgs::CommitFinalize(value) => {
+                this.commit_finalize = Some(value)
+            }
+            MagicBaseIntentArgs::CommitFinalizeAndUndelegate(value) => {
+                this.commit_finalize_and_undelegate = Some(value)
+            }
         }
 
         this

magicblock-magic-program-api/src/instruction.rs

@@ -178,6 +178,22 @@ pub enum MagicBlockInstruction {
     /// - **1.** `[WRITE]` Ephemeral account to close
     /// - **2.** `[WRITE]` Vault account (source of rent refund)
     CloseEphemeralAccount,
+
+    /// Schedules the accounts provided at end of accounts Vec to be committed and finalized in a
+    /// single DLP instruction.
+    /// 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
+    ScheduleCommitFinalize { request_undelegation: bool },
 }
 
 impl MagicBlockInstruction {