@solana/web3.js 1.73.4 → 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}>}
@@ -3355,7 +3375,7 @@ export class Connection {
     getParsedBlock(slot: number, rawConfig: GetVersionedBlockConfig & {
         transactionDetails: 'none';
     }): Promise<ParsedNoneModeBlockResponse>;
-    getBlockHeight(commitmentOrConfig?: Commitment | GetBlockHeightConfig): Promise<number>;
+    getBlockHeight: (commitmentOrConfig?: Commitment | GetBlockHeightConfig) => Promise<number>;
     getBlockProduction(configOrCommitment?: GetBlockProductionConfig | Commitment): Promise<RpcResponseAndContext<BlockProduction>>;
     /**
      * Fetch a confirmed or finalized transaction from the cluster.

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
  */
@@ -6977,7 +6989,7 @@ class Connection {
    * @param endpoint URL to the fullnode JSON RPC endpoint
    * @param commitmentOrConfig optional default commitment level or optional ConnectionConfig configuration object
    */
-  constructor(endpoint, commitmentOrConfig) {
+  constructor(endpoint, _commitmentOrConfig) {
     this._commitment = void 0;
     this._confirmTransactionInitialTimeout = void 0;
     this._rpcEndpoint = void 0;
@@ -7005,23 +7017,47 @@ class Connection {
     this._subscriptionCallbacksByServerSubscriptionId = {};
     this._subscriptionsByHash = {};
     this._subscriptionsAutoDisposedByRpc = new Set();
+    this.getBlockHeight = (() => {
+      const requestPromises = {};
+      return async commitmentOrConfig => {
+        const {
+          commitment,
+          config
+        } = extractCommitmentFromConfig(commitmentOrConfig);
+        const args = this._buildArgs([], commitment, undefined /* encoding */, config);
+        const requestHash = fastStableStringify$1(args);
+        requestPromises[requestHash] = requestPromises[requestHash] ?? (async () => {
+          try {
+            const unsafeRes = await this._rpcRequest('getBlockHeight', args);
+            const res = create(unsafeRes, jsonRpcResult(number()));
+            if ('error' in res) {
+              throw new SolanaJSONRPCError(res.error, 'failed to get block height information');
+            }
+            return res.result;
+          } finally {
+            delete requestPromises[requestHash];
+          }
+        })();
+        return await requestPromises[requestHash];
+      };
+    })();
     let wsEndpoint;
     let httpHeaders;
     let fetch;
     let fetchMiddleware;
     let disableRetryOnRateLimit;
     let httpAgent;
-    if (commitmentOrConfig && typeof commitmentOrConfig === 'string') {
-      this._commitment = commitmentOrConfig;
-    } else if (commitmentOrConfig) {
-      this._commitment = commitmentOrConfig.commitment;
-      this._confirmTransactionInitialTimeout = commitmentOrConfig.confirmTransactionInitialTimeout;
-      wsEndpoint = commitmentOrConfig.wsEndpoint;
-      httpHeaders = commitmentOrConfig.httpHeaders;
-      fetch = commitmentOrConfig.fetch;
-      fetchMiddleware = commitmentOrConfig.fetchMiddleware;
-      disableRetryOnRateLimit = commitmentOrConfig.disableRetryOnRateLimit;
-      httpAgent = commitmentOrConfig.httpAgent;
+    if (_commitmentOrConfig && typeof _commitmentOrConfig === 'string') {
+      this._commitment = _commitmentOrConfig;
+    } else if (_commitmentOrConfig) {
+      this._commitment = _commitmentOrConfig.commitment;
+      this._confirmTransactionInitialTimeout = _commitmentOrConfig.confirmTransactionInitialTimeout;
+      wsEndpoint = _commitmentOrConfig.wsEndpoint;
+      httpHeaders = _commitmentOrConfig.httpHeaders;
+      fetch = _commitmentOrConfig.fetch;
+      fetchMiddleware = _commitmentOrConfig.fetchMiddleware;
+      disableRetryOnRateLimit = _commitmentOrConfig.disableRetryOnRateLimit;
+      httpAgent = _commitmentOrConfig.httpAgent;
     }
     this._rpcEndpoint = assertEndpointUrl(endpoint);
     this._rpcWsEndpoint = wsEndpoint || makeWebsocketUrl(endpoint);
@@ -8095,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}>}
@@ -8279,19 +8328,6 @@ class Connection {
   /*
    * Returns the current block height of the node
    */
-  async getBlockHeight(commitmentOrConfig) {
-    const {
-      commitment,
-      config
-    } = extractCommitmentFromConfig(commitmentOrConfig);
-    const args = this._buildArgs([], commitment, undefined /* encoding */, config);
-    const unsafeRes = await this._rpcRequest('getBlockHeight', args);
-    const res = create(unsafeRes, jsonRpcResult(number()));
-    if ('error' in res) {
-      throw new SolanaJSONRPCError(res.error, 'failed to get block height information');
-    }
-    return res.result;
-  }
 
   /*
    * Returns recent block production information from the current or previous epoch