Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions methods/http/getRecentPrioritizationFees.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# getRecentPrioritizationFees

Returns recent prioritization fees, optionally for transactions locking the supplied accounts.

## Semantics

Omit accounts to request the node general recent fees. When present, each key must be a valid public key and the list may contain at most MAX_TX_ACCOUNT_LOCKS, currently 128, keys. Each record reports a slot and its fee in micro-lamports.

## Implementation notes

- [**Agave**](../../implementations/agave.md): reference implementation. See the pinned [handler and input bound](https://github.com/anza-xyz/agave/blob/6dd9d38771e46103b9680357a855804165612602/rpc/src/rpc.rs#L4416-L4436).
37 changes: 37 additions & 0 deletions methods/http/getRecentPrioritizationFees.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
name: getRecentPrioritizationFees
status: standard
summary: Returns recent prioritization fees, optionally scoped to writable accounts.
params:
- name: accounts
required: false
summary: Up to 128 account public keys used to select fee records.
schema:
type: array
maxItems: 128
items: { $ref: '#/components/schemas/Pubkey' }
result:
name: fees
summary: Recent slot and prioritization-fee pairs.
schema:
type: array
items:
type: object
required: [slot, prioritizationFee]
properties:
slot: { $ref: '#/components/schemas/Slot' }
prioritizationFee: { $ref: '#/components/schemas/U64' }
errors: []
examples:
- name: account-fees
summary: Return records applicable to one writable account.
params:
- name: accounts
value: ["Vote111111111111111111111111111111111111111"]
result:
name: fees
value:
- { slot: 348125, prioritizationFee: 1000 }
implementations:
agave: { status: full }
cloudbreak: { status: none }
superbank: { status: none }
39 changes: 39 additions & 0 deletions proposals/0046-get-recent-prioritization-fees.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
number: 0046
title: Add getRecentPrioritizationFees method specification
authors: [rpcpool]
status: draft
created: 2026-09-14
reference-implementations:
- https://github.com/anza-xyz/agave/tree/6dd9d38771e46103b9680357a855804165612602
---

# Add getRecentPrioritizationFees method specification

## Summary

Add the public getRecentPrioritizationFees RPC method.

## Motivation

Clients need a portable contract for this public Agave RPC method.

## Specification

Add the paired HTTP method files. The optional account list is limited to Agave 128 transaction-account locks.

## Return-type impact

Adds the result shape defined by the paired method source.

## Compatibility

This is additive. Agave conforms. Cloudbreak and Superbank do not serve the method.

## Reference implementation

- [Agave implementation](https://github.com/anza-xyz/agave/blob/6dd9d38771e46103b9680357a855804165612602/rpc/src/rpc.rs#L4416-L4436)

## Security considerations

The account-list bound limits work and aligns with the transaction account-lock limit.
2 changes: 1 addition & 1 deletion spec-info.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
title: Solana JSON-RPC API
version: 0.1.0
version: 0.2.0
license:
name: MIT
url: https://opensource.org/license/mit/
Expand Down
Loading