feat(simulated_transaction): Add Inner Instructions (#2756)

* Add Inner Instructions to Simulated Transaction

* Formatting

* Nit: Change 'response' to 'simulation'

* Update Types and Structs

* Start Addressing Feedback

* Stop Overthinking and Reuse Types lol

* Format source code

* Don't widen the type of `parsed` to `any` when parsing the server response, because that makes it optional on the result

---------

Co-authored-by: steveluscher <[email protected]>

packages/library-legacy/src/connection.ts

@@ -952,6 +952,8 @@ export type SimulateTransactionConfig = {
   };
   /** Optional parameter used to specify the minimum block slot that can be used for simulation */
   minContextSlot?: number;
+  /** Optional parameter used to include inner instructions in the simulation */
+  innerInstructions?: boolean;
 };
 
 export type SimulatedTransactionResponse = {
@@ -960,7 +962,20 @@ export type SimulatedTransactionResponse = {
   accounts?: (SimulatedTransactionAccountInfo | null)[] | null;
   unitsConsumed?: number;
   returnData?: TransactionReturnData | null;
+  innerInstructions?: ParsedInnerInstruction[] | null;
 };
+const ParsedInstructionStruct = pick({
+  program: string(),
+  programId: PublicKeyFromString,
+  parsed: unknown(),
+});
+
+const PartiallyDecodedInstructionStruct = pick({
+  programId: PublicKeyFromString,
+  accounts: array(PublicKeyFromString),
+  data: string(),
+});
+
 const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(
   pick({
     err: nullable(union([pick({}), string()])),
@@ -989,6 +1004,21 @@ const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(
         }),
       ),
     ),
+    innerInstructions: optional(
+      nullable(
+        array(
+          pick({
+            index: number(),
+            instructions: array(
+              union([
+                ParsedInstructionStruct,
+                PartiallyDecodedInstructionStruct,
+              ]),
+            ),
+          }),
+        ),
+      ),
+    ),
   }),
 );
 
@@ -5712,6 +5742,14 @@ export class Connection {
         config.commitment = this.commitment;
       }
 
+      if (
+        configOrSigners &&
+        typeof configOrSigners === 'object' &&
+        'innerInstructions' in configOrSigners
+      ) {
+        config.innerInstructions = configOrSigners.innerInstructions;
+      }
+
       const args = [encodedTransaction, config];
       const unsafeRes = await this._rpcRequest('simulateTransaction', args);
       const res = create(unsafeRes, SimulatedTransactionResponseStruct);
@@ -5802,6 +5840,14 @@ export class Connection {
       config.sigVerify = true;
     }
 
+    if (
+      configOrSigners &&
+      typeof configOrSigners === 'object' &&
+      'innerInstructions' in configOrSigners
+    ) {
+      config.innerInstructions = configOrSigners.innerInstructions;
+    }
+
     const args = [encodedTransaction, config];
     const unsafeRes = await this._rpcRequest('simulateTransaction', args);
     const res = create(unsafeRes, SimulatedTransactionResponseStruct);