Skip to content

FeeSettings

[Source]

The FeeSettings entry contains the current base transaction cost and reserve amounts as determined by fee voting. Each ledger version contains at most one FeeSettings entry.

Example FeeSettings JSON

This ledger entry has two formats, depending on whether the XRPFees amendment was enabled at the time fees were last updated:

{
  "BaseFeeDrops": "10",
  "BytecodeSizeLimit": 100000,
  "Flags": 0,
  "GasLimit": 1000000,
  "GasPrice": 1000000,
  "LedgerEntryType": "FeeSettings",
  "PreviousTxnID": "FC0F9EF5D2C0D4DC75BCB71B69D6C7864E040C923D7016AF668024225DB00867",
  "PreviousTxnLgrSeq": 107588353,
  "ReserveBaseDrops": "1000000",
  "ReserveIncrementDrops": "200000",
  "index": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651"
}

FeeSettings Fields

The fields of the FeeSettings ledger entry depend on whether the XRPFees amendment was enabled the last time it was modified. If the last update was before the amendment became enabled, the entry uses the legacy format. If it has been updated after the amendment, it uses the current format. The fields it can have, in addition to the common fields, are as follows:

NameJSON TypeInternal TypeRequired?Description
BaseFeeDropsStringAmountYesThe transaction cost of the "reference transaction" in drops of XRP.
BytecodeSizeLimitNumberUInt32NoThe maximum size, in bytes, of a WASM smart function, such as the Bytecode field of a smart escrow.

(Requires the SmartEscrow amendment. Loading: ...)

GasLimitNumberUInt32NoThe maximum amount of gas that can be consumed by smart functions in a single transaction. Gas is a measure of the resources (including CPU and memory) used by smart function code, defined by the WASM engine.

(Requires the SmartEscrow amendment. Loading: ...)

GasPriceNumberUInt32NoThe cost of gas, in millionths of a drop of XRP per 1 gas. In other words, a value of 1000000 (1 million) means that 1 gas costs 0.000001 decimal XRP.

(Requires the SmartEscrow amendment. Loading: ...)

ReserveBaseDropsStringAmountYesThe base reserve for an account in the XRP Ledger, as drops of XRP.
ReserveIncrementDropsStringAmountYesThe incremental owner reserve for owning objects, as drops of XRP.
PreviousTxnIDStringUInt256NoThe identifying hash of the transaction that most recently modified this entry.

(Requires the fixPreviousTxnID amendment. Loading: ...)

PreviousTxnLgrSeqNumberUInt32NoThe index of the ledger that contains the transaction that most recently modified this entry.

(Requires the fixPreviousTxnID amendment. Loading: ...)

The following fields are added the first time [fee voting][] occurs after the relevant amendment is enabled, and are always present thereafter: BytecodeSizeLimit, GasLimit, GasPrice, PreviousTxnID, PreviousTxnLgrSeq.

FeeSettings Flags

There are no flags defined for the FeeSettings entry.

FeeSettings ID Format

The ID of the FeeSettings entry is the hash of the FeeSettings space key (0x0065) only. This means that the ID is always:

4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651