@solana/web3.js 1.63.0 → 1.64.0

package/lib/index.d.ts

@@ -1562,10 +1562,10 @@ declare module '@solana/web3.js' {
   };
   export type GetAccountKeysArgs =
     | {
-        accountKeysFromLookups: AccountKeysFromLookups;
+        accountKeysFromLookups?: AccountKeysFromLookups | null;
       }
     | {
-        addressLookupTableAccounts: AddressLookupTableAccount[];
+        addressLookupTableAccounts?: AddressLookupTableAccount[] | null;
       };
   export class MessageV0 {
     header: MessageHeader;
@@ -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

@@ -976,13 +976,13 @@ class MessageV0 {
   getAccountKeys(args) {
     let accountKeysFromLookups;
 
-    if (args && 'accountKeysFromLookups' in args) {
+    if (args && 'accountKeysFromLookups' in args && args.accountKeysFromLookups) {
       if (this.numAccountKeysFromLookups != args.accountKeysFromLookups.writable.length + args.accountKeysFromLookups.readonly.length) {
         throw new Error('Failed to get account keys because of a mismatch in the number of account keys from lookups');
       }
 
       accountKeysFromLookups = args.accountKeysFromLookups;
-    } else if (args && 'addressLookupTableAccounts' in args) {
+    } else if (args && 'addressLookupTableAccounts' in args && args.addressLookupTableAccounts) {
       accountKeysFromLookups = this.resolveAddressTableLookups(args.addressLookupTableAccounts);
     } else if (this.addressTableLookups.length > 0) {
       throw new Error('Failed to get account keys because address table lookups were not resolved');
@@ -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
    */