@solana/web3.js 1.93.3 → 1.94.0

package/lib/index.d.ts

@@ -2245,6 +2245,8 @@ 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;
 };
 type SimulatedTransactionResponse = {
     err: TransactionError | string | null;
@@ -2252,6 +2254,7 @@ type SimulatedTransactionResponse = {
     accounts?: (SimulatedTransactionAccountInfo | null)[] | null;
     unitsConsumed?: number;
     returnData?: TransactionReturnData | null;
+    innerInstructions?: ParsedInnerInstruction[] | null;
 };
 type ParsedInnerInstruction = {
     index: number;
@@ -2266,7 +2269,7 @@ type TokenBalance = {
 /**
  * Metadata for a parsed confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionMeta} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link ParsedTransactionMeta} instead.
  */
 type ParsedConfirmedTransactionMeta = ParsedTransactionMeta;
 /**
@@ -2371,7 +2374,7 @@ type VersionedTransactionResponse = {
 /**
  * A confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0.
+ * @deprecated Deprecated since RPC v1.8.0.
  */
 type ConfirmedTransaction = {
     /** The slot during which the transaction was processed */
@@ -2454,7 +2457,7 @@ type ParsedTransaction = {
 /**
  * A parsed and confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionWithMeta} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link ParsedTransactionWithMeta} instead.
  */
 type ParsedConfirmedTransaction = ParsedTransactionWithMeta;
 /**
@@ -2628,7 +2631,7 @@ type VersionedNoneModeBlockResponse = Omit<VersionedBlockResponse, 'transactions
 /**
  * A confirmed block on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0.
+ * @deprecated Deprecated since RPC v1.8.0.
  */
 type ConfirmedBlock = {
     /** Blockhash of this block */
@@ -3274,6 +3277,8 @@ declare class Connection {
     getMultipleAccountsInfo(publicKeys: PublicKey[], commitmentOrConfig?: Commitment | GetMultipleAccountsConfig): Promise<(AccountInfo<Buffer> | null)[]>;
     /**
      * Returns epoch activation information for a stake account that has been delegated
+     *
+     * @deprecated Deprecated since RPC v1.18; will be removed in a future version.
      */
     getStakeActivation(publicKey: PublicKey, commitmentOrConfig?: Commitment | GetStakeActivationConfig, epoch?: number): Promise<StakeActivationData>;
     /**
@@ -3340,7 +3345,7 @@ declare class Connection {
     /**
      * Fetch the current total currency supply of the cluster in lamports
      *
-     * @deprecated Deprecated since v1.2.8. Please use {@link getSupply} instead.
+     * @deprecated Deprecated since RPC v1.2.8. Please use {@link getSupply} instead.
      */
     getTotalSupply(commitment?: Commitment): Promise<number>;
     /**
@@ -3377,7 +3382,7 @@ declare class Connection {
      * Fetch a recent blockhash from the cluster, return with context
      * @return {Promise<RpcResponseAndContext<{blockhash: Blockhash, feeCalculator: FeeCalculator}>>}
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
+     * @deprecated Deprecated since RPC v1.9.0. Please use {@link getLatestBlockhash} instead.
      */
     getRecentBlockhashAndContext(commitment?: Commitment): Promise<RpcResponseAndContext<{
         blockhash: Blockhash;
@@ -3391,7 +3396,7 @@ declare class Connection {
     /**
      * Fetch the fee calculator for a recent blockhash from the cluster, return with context
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getFeeForMessage} instead.
+     * @deprecated Deprecated since RPC v1.9.0. Please use {@link getFeeForMessage} instead.
      */
     getFeeCalculatorForBlockhash(blockhash: Blockhash, commitment?: Commitment): Promise<RpcResponseAndContext<FeeCalculator | null>>;
     /**
@@ -3406,7 +3411,7 @@ declare class Connection {
      * Fetch a recent blockhash from the cluster
      * @return {Promise<{blockhash: Blockhash, feeCalculator: FeeCalculator}>}
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
+     * @deprecated Deprecated since RPC v1.8.0. Please use {@link getLatestBlockhash} instead.
      */
     getRecentBlockhash(commitment?: Commitment): Promise<{
         blockhash: Blockhash;
@@ -3516,7 +3521,7 @@ declare class Connection {
      * Fetch a list of Transactions and transaction statuses from the cluster
      * for a confirmed block.
      *
-     * @deprecated Deprecated since v1.13.0. Please use {@link getBlock} instead.
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getBlock} instead.
      */
     getConfirmedBlock(slot: number, commitment?: Finality): Promise<ConfirmedBlock>;
     /**
@@ -3530,32 +3535,32 @@ declare class Connection {
     /**
      * Fetch a list of Signatures from the cluster for a confirmed block, excluding rewards
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getBlockSignatures} instead.
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getBlockSignatures} instead.
      */
     getConfirmedBlockSignatures(slot: number, commitment?: Finality): Promise<BlockSignatures>;
     /**
      * Fetch a transaction details for a confirmed transaction
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getTransaction} instead.
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getTransaction} instead.
      */
     getConfirmedTransaction(signature: TransactionSignature, commitment?: Finality): Promise<ConfirmedTransaction | null>;
     /**
      * Fetch parsed transaction details for a confirmed transaction
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransaction} instead.
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getParsedTransaction} instead.
      */
     getParsedConfirmedTransaction(signature: TransactionSignature, commitment?: Finality): Promise<ParsedConfirmedTransaction | null>;
     /**
      * Fetch parsed transaction details for a batch of confirmed transactions
      *
-     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransactions} instead.
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getParsedTransactions} instead.
      */
     getParsedConfirmedTransactions(signatures: TransactionSignature[], commitment?: Finality): Promise<(ParsedConfirmedTransaction | null)[]>;
     /**
      * Fetch a list of all the confirmed signatures for transactions involving an address
      * within a specified slot range. Max range allowed is 10,000 slots.
      *
-     * @deprecated Deprecated since v1.3. Please use {@link getConfirmedSignaturesForAddress2} instead.
+     * @deprecated Deprecated since RPC v1.3. Please use {@link getConfirmedSignaturesForAddress2} instead.
      *
      * @param address queried address
      * @param startSlot start slot, inclusive
@@ -3566,9 +3571,7 @@ declare class Connection {
      * Returns confirmed signatures for transactions involving an
      * address backwards in time from the provided signature or most recent confirmed block
      *
-     *
-     * @param address queried address
-     * @param options
+     * @deprecated Deprecated since RPC v1.7.0. Please use {@link getSignaturesForAddress} instead.
      */
     getConfirmedSignaturesForAddress2(address: PublicKey, options?: ConfirmedSignaturesForAddress2Options, commitment?: Finality): Promise<Array<ConfirmedSignatureInfo>>;
     /**

package/lib/index.esm.js

@@ -4737,6 +4737,16 @@ const VersionResult = type({
   'solana-core': string(),
   'feature-set': optional(number())
 });
+const ParsedInstructionStruct = type({
+  program: string(),
+  programId: PublicKeyFromString,
+  parsed: unknown()
+});
+const PartiallyDecodedInstructionStruct = type({
+  programId: PublicKeyFromString,
+  accounts: array(PublicKeyFromString),
+  data: string()
+});
 const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(type({
   err: nullable(union([type({}), string()])),
   logs: nullable(array(string())),
@@ -4751,13 +4761,17 @@ const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(type({
   returnData: optional(nullable(type({
     programId: string(),
     data: tuple([string(), literal('base64')])
-  })))
+  }))),
+  innerInstructions: optional(nullable(array(type({
+    index: number(),
+    instructions: array(union([ParsedInstructionStruct, PartiallyDecodedInstructionStruct]))
+  }))))
 }));
 
 /**
  * Metadata for a parsed confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionMeta} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link ParsedTransactionMeta} instead.
  */
 
 /**
@@ -4787,7 +4801,7 @@ const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(type({
 /**
  * A confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0.
+ * @deprecated Deprecated since RPC v1.8.0.
  */
 
 /**
@@ -4817,7 +4831,7 @@ const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(type({
 /**
  * A parsed and confirmed transaction on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionWithMeta} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link ParsedTransactionWithMeta} instead.
  */
 
 /**
@@ -4863,7 +4877,7 @@ const SimulatedTransactionResponseStruct = jsonRpcResultAndContext(type({
 /**
  * A confirmed block on the ledger
  *
- * @deprecated Deprecated since Solana v1.8.0.
+ * @deprecated Deprecated since RPC v1.8.0.
  */
 
 /**
@@ -5588,7 +5602,7 @@ const GetParsedNoneModeBlockRpcResult = jsonRpcResult(nullable(type({
 /**
  * Expected JSON RPC response for the "getConfirmedBlock" message
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link GetBlockRpcResult} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link GetBlockRpcResult} instead.
  */
 const GetConfirmedBlockRpcResult = jsonRpcResult(nullable(type({
   blockhash: string(),
@@ -5638,7 +5652,7 @@ const GetParsedTransactionRpcResult = jsonRpcResult(nullable(type({
 /**
  * Expected JSON RPC response for the "getRecentBlockhash" message
  *
- * @deprecated Deprecated since Solana v1.8.0. Please use {@link GetLatestBlockhashRpcResult} instead.
+ * @deprecated Deprecated since RPC v1.8.0. Please use {@link GetLatestBlockhashRpcResult} instead.
  */
 const GetRecentBlockhashAndContextRpcResult = jsonRpcResultAndContext(type({
   blockhash: string(),
@@ -6326,6 +6340,8 @@ class Connection {
 
   /**
    * Returns epoch activation information for a stake account that has been delegated
+   *
+   * @deprecated Deprecated since RPC v1.18; will be removed in a future version.
    */
   async getStakeActivation(publicKey, commitmentOrConfig, epoch) {
     const {
@@ -6897,7 +6913,7 @@ class Connection {
   /**
    * Fetch the current total currency supply of the cluster in lamports
    *
-   * @deprecated Deprecated since v1.2.8. Please use {@link getSupply} instead.
+   * @deprecated Deprecated since RPC v1.2.8. Please use {@link getSupply} instead.
    */
   async getTotalSupply(commitment) {
     const result = await this.getSupply({
@@ -7014,7 +7030,7 @@ class Connection {
    * Fetch a recent blockhash from the cluster, return with context
    * @return {Promise<RpcResponseAndContext<{blockhash: Blockhash, feeCalculator: FeeCalculator}>>}
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
+   * @deprecated Deprecated since RPC v1.9.0. Please use {@link getLatestBlockhash} instead.
    */
   async getRecentBlockhashAndContext(commitment) {
     const args = this._buildArgs([], commitment);
@@ -7042,7 +7058,7 @@ class Connection {
   /**
    * Fetch the fee calculator for a recent blockhash from the cluster, return with context
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getFeeForMessage} instead.
+   * @deprecated Deprecated since RPC v1.9.0. Please use {@link getFeeForMessage} instead.
    */
   async getFeeCalculatorForBlockhash(blockhash, commitment) {
     const args = this._buildArgs([blockhash], commitment);
@@ -7095,7 +7111,7 @@ class Connection {
    * Fetch a recent blockhash from the cluster
    * @return {Promise<{blockhash: Blockhash, feeCalculator: FeeCalculator}>}
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
+   * @deprecated Deprecated since RPC v1.8.0. Please use {@link getLatestBlockhash} instead.
    */
   async getRecentBlockhash(commitment) {
     try {
@@ -7477,7 +7493,7 @@ class Connection {
    * Fetch a list of Transactions and transaction statuses from the cluster
    * for a confirmed block.
    *
-   * @deprecated Deprecated since v1.13.0. Please use {@link getBlock} instead.
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getBlock} instead.
    */
   async getConfirmedBlock(slot, commitment) {
     const args = this._buildArgsAtLeastConfirmed([slot], commitment);
@@ -7556,7 +7572,7 @@ class Connection {
   /**
    * Fetch a list of Signatures from the cluster for a confirmed block, excluding rewards
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getBlockSignatures} instead.
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getBlockSignatures} instead.
    */
   async getConfirmedBlockSignatures(slot, commitment) {
     const args = this._buildArgsAtLeastConfirmed([slot], commitment, undefined, {
@@ -7578,7 +7594,7 @@ class Connection {
   /**
    * Fetch a transaction details for a confirmed transaction
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getTransaction} instead.
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getTransaction} instead.
    */
   async getConfirmedTransaction(signature, commitment) {
     const args = this._buildArgsAtLeastConfirmed([signature], commitment);
@@ -7600,7 +7616,7 @@ class Connection {
   /**
    * Fetch parsed transaction details for a confirmed transaction
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransaction} instead.
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getParsedTransaction} instead.
    */
   async getParsedConfirmedTransaction(signature, commitment) {
     const args = this._buildArgsAtLeastConfirmed([signature], commitment, 'jsonParsed');
@@ -7615,7 +7631,7 @@ class Connection {
   /**
    * Fetch parsed transaction details for a batch of confirmed transactions
    *
-   * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransactions} instead.
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getParsedTransactions} instead.
    */
   async getParsedConfirmedTransactions(signatures, commitment) {
     const batch = signatures.map(signature => {
@@ -7640,7 +7656,7 @@ class Connection {
    * Fetch a list of all the confirmed signatures for transactions involving an address
    * within a specified slot range. Max range allowed is 10,000 slots.
    *
-   * @deprecated Deprecated since v1.3. Please use {@link getConfirmedSignaturesForAddress2} instead.
+   * @deprecated Deprecated since RPC v1.3. Please use {@link getConfirmedSignaturesForAddress2} instead.
    *
    * @param address queried address
    * @param startSlot start slot, inclusive
@@ -7694,9 +7710,7 @@ class Connection {
    * Returns confirmed signatures for transactions involving an
    * address backwards in time from the provided signature or most recent confirmed block
    *
-   *
-   * @param address queried address
-   * @param options
+   * @deprecated Deprecated since RPC v1.7.0. Please use {@link getSignaturesForAddress} instead.
    */
   async getConfirmedSignaturesForAddress2(address, options, commitment) {
     const args = this._buildArgsAtLeastConfirmed([address.toBase58()], commitment, undefined, options);
@@ -7887,6 +7901,9 @@ class Connection {
       if (!('commitment' in config)) {
         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);
@@ -7958,6 +7975,9 @@ class Connection {
     if (signers) {
       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);