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