@solana/web3.js 1.74.0 → 1.75.0

package/lib/index.d.ts

@@ -2101,6 +2101,22 @@ type InflationReward = {
     /** vote account commission when the reward was credited */
     commission?: number | null;
 };
+type RecentPrioritizationFees = {
+    /** slot in which the fee was observed */
+    slot: number;
+    /** the per-compute-unit fee paid by at least one successfully landed transaction, specified in increments of 0.000001 lamports*/
+    prioritizationFee: number;
+};
+/**
+ * Configuration object for changing `getRecentPrioritizationFees` query behavior
+ */
+type GetRecentPrioritizationFeesConfig = {
+    /**
+     * If this parameter is provided, the response will reflect a fee to land a transaction locking
+     * all of the provided accounts as writable.
+     */
+    lockedWritableAccounts?: PublicKey[];
+};
 type InflationRate = {
     /** total inflation */
     total: number;
@@ -3286,6 +3302,10 @@ export class Connection {
      * Fetch the fee for a message from the cluster, return with context
      */
     getFeeForMessage(message: VersionedMessage, commitment?: Commitment): Promise<RpcResponseAndContext<number | null>>;
+    /**
+     * Fetch a list of prioritization fees from recent blocks.
+     */
+    getRecentPrioritizationFees(config?: GetRecentPrioritizationFeesConfig): Promise<RecentPrioritizationFees[]>;
     /**
      * Fetch a recent blockhash from the cluster
      * @return {Promise<{blockhash: Blockhash, feeCalculator: FeeCalculator}>}

package/lib/index.esm.js

@@ -5998,6 +5998,13 @@ const GetInflationRewardResult = jsonRpcResult(array(nullable(type({
   postBalance: number(),
   commission: optional(nullable(number()))
 }))));
+/**
+ * Expected JSON RPC response for the "getRecentPrioritizationFees" message
+ */
+const GetRecentPrioritizationFeesResult = array(type({
+  slot: number(),
+  prioritizationFee: number()
+}));
 /**
  * Expected JSON RPC response for the "getInflationRate" message
  */
@@ -6222,6 +6229,11 @@ const GetInflationGovernorRpcResult = jsonRpcResult(GetInflationGovernorResult);
  */
 const GetInflationRateRpcResult = jsonRpcResult(GetInflationRateResult);
 
+/**
+ * Expected JSON RPC response for the "getRecentPrioritizationFees" message
+ */
+const GetRecentPrioritizationFeesRpcResult = jsonRpcResult(GetRecentPrioritizationFeesResult);
+
 /**
  * Expected JSON RPC response for the "getEpochInfo" message
  */
@@ -8119,6 +8131,19 @@ class Connection {
     return res.result;
   }
 
+  /**
+   * Fetch a list of prioritization fees from recent blocks.
+   */
+  async getRecentPrioritizationFees(config) {
+    const accounts = config?.lockedWritableAccounts?.map(key => key.toBase58());
+    const args = this._buildArgs(accounts?.length ? [accounts] : []);
+    const unsafeRes = await this._rpcRequest('getRecentPrioritizationFees', args);
+    const res = create(unsafeRes, GetRecentPrioritizationFeesRpcResult);
+    if ('error' in res) {
+      throw new SolanaJSONRPCError(res.error, 'failed to get recent prioritization fees');
+    }
+    return res.result;
+  }
   /**
    * Fetch a recent blockhash from the cluster
    * @return {Promise<{blockhash: Blockhash, feeCalculator: FeeCalculator}>}