@solana/web3.js 1.63.1 → 1.64.0

package/lib/index.d.ts

@@ -2544,6 +2544,41 @@ declare module '@solana/web3.js' {
     /** The unix timestamp of when the block was processed */
     blockTime: number | null;
   };
+  /**
+   * A block with parsed transactions
+   */
+  export type ParsedBlockResponse = {
+    /** Blockhash of this block */
+    blockhash: Blockhash;
+    /** Blockhash of this block's parent */
+    previousBlockhash: Blockhash;
+    /** Slot index of this block's parent */
+    parentSlot: number;
+    /** Vector of transactions with status meta and original message */
+    transactions: Array<{
+      /** The details of the transaction */
+      transaction: ParsedTransaction;
+      /** Metadata produced from the transaction */
+      meta: ParsedTransactionMeta | null;
+      /** The transaction version */
+      version?: TransactionVersion;
+    }>;
+    /** Vector of block rewards */
+    rewards?: Array<{
+      /** Public key of reward recipient */
+      pubkey: string;
+      /** Reward value in lamports */
+      lamports: number;
+      /** Account balance after reward is applied */
+      postBalance: number | null;
+      /** Type of reward received */
+      rewardType: string | null;
+    }>;
+    /** The unix timestamp of when the block was processed */
+    blockTime: number | null;
+    /** The number of blocks beneath this block */
+    blockHeight: number | null;
+  };
   /**
    * A processed block fetched from the RPC API
    */
@@ -3455,6 +3490,13 @@ declare module '@solana/web3.js' {
       slot: number,
       rawConfig?: GetVersionedBlockConfig,
     ): Promise<VersionedBlockResponse | null>;
+    /**
+     * Fetch parsed transaction details for a confirmed or finalized block
+     */
+    getParsedBlock(
+      slot: number,
+      rawConfig?: GetVersionedBlockConfig,
+    ): Promise<ParsedBlockResponse | null>;
     getBlockHeight(
       commitmentOrConfig?: Commitment | GetBlockHeightConfig,
     ): Promise<number>;

package/lib/index.esm.js

@@ -4460,6 +4460,28 @@ const GetBlockRpcResult = jsonRpcResult(nullable(type({
   blockTime: nullable(number()),
   blockHeight: nullable(number())
 })));
+/**
+ * Expected parsed JSON RPC response for the "getBlock" message
+ */
+
+const GetParsedBlockRpcResult = jsonRpcResult(nullable(type({
+  blockhash: string(),
+  previousBlockhash: string(),
+  parentSlot: number(),
+  transactions: array(type({
+    transaction: ParsedConfirmedTransactionResult,
+    meta: nullable(ParsedConfirmedTransactionMetaResult),
+    version: optional(TransactionVersionStruct)
+  })),
+  rewards: optional(array(type({
+    pubkey: string(),
+    lamports: number(),
+    postBalance: nullable(number()),
+    rewardType: nullable(string())
+  }))),
+  blockTime: nullable(number()),
+  blockHeight: nullable(number())
+})));
 /**
  * Expected JSON RPC response for the "getConfirmedBlock" message
  *
@@ -5799,6 +5821,28 @@ class Connection {
       }))
     };
   }
+  /**
+   * Fetch parsed transaction details for a confirmed or finalized block
+   */
+
+
+  async getParsedBlock(slot, rawConfig) {
+    const {
+      commitment,
+      config
+    } = extractCommitmentFromConfig(rawConfig);
+
+    const args = this._buildArgsAtLeastConfirmed([slot], commitment, 'jsonParsed', config);
+
+    const unsafeRes = await this._rpcRequest('getBlock', args);
+    const res = create(unsafeRes, GetParsedBlockRpcResult);
+
+    if ('error' in res) {
+      throw new SolanaJSONRPCError(res.error, 'failed to get block');
+    }
+
+    return res.result;
+  }
   /*
    * Returns the current block height of the node
    */