@solana/web3.js 1.63.0 → 1.64.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/web3.js",
-  "version": "1.63.0",
+  "version": "1.64.0",
   "description": "Solana Javascript API",
   "keywords": [
     "api",

package/src/connection.ts

@@ -1143,6 +1143,42 @@ export type BlockResponse = {
   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
  */
@@ -2081,6 +2117,38 @@ const GetBlockRpcResult = jsonRpcResult(
   ),
 );
 
+/**
+ * Expected parsed JSON RPC response for the "getBlock" message
+ */
+const GetParsedBlockRpcResult = jsonRpcResult(
+  nullable(
+    pick({
+      blockhash: string(),
+      previousBlockhash: string(),
+      parentSlot: number(),
+      transactions: array(
+        pick({
+          transaction: ParsedConfirmedTransactionResult,
+          meta: nullable(ParsedConfirmedTransactionMetaResult),
+          version: optional(TransactionVersionStruct),
+        }),
+      ),
+      rewards: optional(
+        array(
+          pick({
+            pubkey: string(),
+            lamports: number(),
+            postBalance: nullable(number()),
+            rewardType: nullable(string()),
+          }),
+        ),
+      ),
+      blockTime: nullable(number()),
+      blockHeight: nullable(number()),
+    }),
+  ),
+);
+
 /**
  * Expected JSON RPC response for the "getConfirmedBlock" message
  *
@@ -3878,6 +3946,28 @@ export class Connection {
     };
   }
 
+  /**
+   * Fetch parsed transaction details for a confirmed or finalized block
+   */
+  async getParsedBlock(
+    slot: number,
+    rawConfig?: GetVersionedBlockConfig,
+  ): Promise<ParsedBlockResponse | null> {
+    const {commitment, config} = extractCommitmentFromConfig(rawConfig);
+    const args = this._buildArgsAtLeastConfirmed(
+      [slot],
+      commitment as Finality,
+      '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
    */

package/src/message/v0.ts

@@ -42,10 +42,10 @@ export type CompileV0Args = {
 
 export type GetAccountKeysArgs =
   | {
-      accountKeysFromLookups: AccountKeysFromLookups;
+      accountKeysFromLookups?: AccountKeysFromLookups | null;
     }
   | {
-      addressLookupTableAccounts: AddressLookupTableAccount[];
+      addressLookupTableAccounts?: AddressLookupTableAccount[] | null;
     };
 
 export class MessageV0 {
@@ -77,7 +77,11 @@ export class MessageV0 {
 
   getAccountKeys(args?: GetAccountKeysArgs): MessageAccountKeys {
     let accountKeysFromLookups: AccountKeysFromLookups | undefined;
-    if (args && 'accountKeysFromLookups' in args) {
+    if (
+      args &&
+      'accountKeysFromLookups' in args &&
+      args.accountKeysFromLookups
+    ) {
       if (
         this.numAccountKeysFromLookups !=
         args.accountKeysFromLookups.writable.length +
@@ -88,7 +92,11 @@ export class MessageV0 {
         );
       }
       accountKeysFromLookups = args.accountKeysFromLookups;
-    } else if (args && 'addressLookupTableAccounts' in args) {
+    } else if (
+      args &&
+      'addressLookupTableAccounts' in args &&
+      args.addressLookupTableAccounts
+    ) {
       accountKeysFromLookups = this.resolveAddressTableLookups(
         args.addressLookupTableAccounts,
       );