Last updated

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

{
   "BaseFee": "000000000000000A",
   "Flags": 0,
   "LedgerEntryType": "FeeSettings",
   "ReferenceFeeUnits": 10,
   "ReserveBase": 20000000,
   "ReserveIncrement": 5000000,
   "index": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651"
}

FeeSettings Fields

In addition to the common fields, the FeeSettings ledger entry has the following fields:

NameJSON TypeInternal TypeRequired?Description
BaseFeeStringUInt64YesThe transaction cost of the "reference transaction" in drops of XRP as hexadecimal.
FlagsNumberUInt32YesA bit-map of boolean flags enabled for this object. Currently, the protocol defines no flags for FeeSettings objects. The value is always 0.
LedgerEntryTypeStringUInt16YesThe value 0x0073, mapped to the string FeeSettings, indicates that this object contains the ledger's fee settings.
ReferenceFeeUnitsNumberUInt32YesThe BaseFee translated into "fee units".
ReserveBaseNumberUInt32YesThe base reserve for an account in the XRP Ledger, as drops of XRP.
ReserveIncrementNumberUInt32YesThe incremental owner reserve for owning objects, as drops of XRP.

Warning: The JSON format for this ledger entry type is unusual. The BaseFee, ReserveBase, and ReserveIncrement indicate drops of XRP but not in the usual format for specifying XRP.

If the XRPFees amendment is enabled, the FeeSettings object has these fields instead:

NameJSON TypeInternal TypeRequired?Description
BaseFeeDropsStringAmountYesThe transaction cost of the "reference transaction" in drops of XRP.
FlagsNumberUInt32YesA bitmap of boolean flags enabled for this object. Currently, the protocol defines no flags for FeeSettings objects. The value is always 0.
LedgerEntryTypeStringUInt16YesThe value 0x0073, mapped to the string FeeSettings, indicates that this object contains the ledger's fee settings.
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.

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