Fee Settings

[Source]

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

Example JSON

Example FeeSettings object:

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

Fields

The FeeSettings object has the following fields:

Name	JSON Type	[Internal Type][]	Required?	Description
BaseFee	String	UInt64	Yes	The transaction cost of the "reference transaction" in drops of XAH as hexadecimal.
Flags	Number	UInt32	Yes	A bit-map of boolean flags enabled for this object. Currently, the protocol defines no flags for FeeSettings objects. The value is always 0.
LedgerEntryType	String	UInt16	Yes	The value 0x0073, mapped to the string FeeSettings, indicates that this object contains the ledger's fee settings.
ReferenceFeeUnits	Number	UInt32	Yes	The BaseFee translated into "fee units".
ReserveBase	Number	UInt32	Yes	The base reserve for an account in Xahau, as drops of XAH.
ReserveIncrement	Number	UInt32	Yes	The incremental owner reserve for owning objects, as drops of XAH.
XahauActivationLgrSeq	Number	UInt32	No	The ledger index where Xahau genesis was activated.
AccountCount	Number	UInt32	No	The number of accounts created on the Xahau network.
NetworkID	Number	UInt32	No	The ID of the network

Warning: The JSON format for this ledger object type is unusual. The BaseFee, ReserveBase, and ReserveIncrement indicate drops of XAH but not in the usual format for [specifying XAH][Currency Amount].

If the [XAHFees amendment][] is enabled, the FeeSettings object has these fields instead:

Name	JSON Type	[Internal Type][]	Required?	Description
BaseFeeDrops	String	Amount	Yes	The transaction cost of the "reference transaction" in drops of XAH.
Flags	Number	UInt32	Yes	A bitmap of boolean flags enabled for this object. Currently, the protocol defines no flags for FeeSettings objects. The value is always 0.
LedgerEntryType	String	UInt16	Yes	The value 0x0073, mapped to the string FeeSettings, indicates that this object contains the ledger's fee settings.
ReserveBaseDrops	String	Amount	Yes	The base reserve for an account in the XAH Ledger, as drops of XAH.
ReserveIncrementDrops	String	Amount	Yes	The incremental owner reserve for owning objects, as drops of XAH.
XahauActivationLgrSeq	Number	UInt32	No	The ledger index where Xahau genesis was activated.
AccountCount	Number	UInt32	No	The number of accounts created on the Xahau network.
NetworkID	Number	UInt32	No

FeeSettings ID Format

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

4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651