@solana/web3.js 1.63.1 → 1.65.0

package/lib/index.d.ts

@@ -50,7 +50,8 @@ declare module '@solana/web3.js' {
      */
     static unique(): PublicKey;
     /**
-     * Default public key value. (All zeros)
+     * Default public key value. The base58-encoded string representation is all ones (as seen below)
+     * The underlying BN number is 32 bytes that are all zeros
      */
     static default: PublicKey;
     /**
@@ -2025,6 +2026,8 @@ declare module '@solana/web3.js' {
     commitment?: Commitment;
     /** The minimum slot that the request can be evaluated at */
     minContextSlot?: number;
+    /** Optional data slice to limit the returned account data */
+    dataSlice?: DataSlice;
   };
   /**
    * Configuration object for changing `getBalance` query behavior
@@ -2544,6 +2547,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
    */
@@ -2871,6 +2909,8 @@ declare module '@solana/web3.js' {
     commitment?: Commitment;
     /** The minimum slot that the request can be evaluated at */
     minContextSlot?: number;
+    /** Optional data slice to limit the returned account data */
+    dataSlice?: DataSlice;
   };
   /**
    * Configuration object for `getStakeActivation`
@@ -3455,6 +3495,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

@@ -166,7 +166,8 @@ class PublicKey extends Struct {
     return new PublicKey(key.toBuffer());
   }
   /**
-   * Default public key value. (All zeros)
+   * Default public key value. The base58-encoded string representation is all ones (as seen below)
+   * The underlying BN number is 32 bytes that are all zeros
    */
 
 
@@ -4460,6 +4461,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 +5822,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
    */