mirror of
https://github.com/Xahau/xahaud.git
synced 2026-09-28 07:58:05 +00:00
d04fa60d87
HookFeeV2 keeps the flat model (100 units per API call, 10 units per drop, rounded up). HookFeeV3 layers on top of it: - features.macro: add HookFeeV3 (Supported::yes, DefaultNo) - getImportWhitelist: every API defaults to hook_api::api_call_cost; HOOK_API_COST overrides only when HookFeeV3 is enabled, and uses find() so a cost line can never whitelist an API whose definition is gated off - hookCostToFee: flat V2 pricing unless HookFeeV3 is enabled, then the ledger's HookGasPrice applies - sfHookGasPrice on FeeSettings / SetFee / validations, fee voting, genesis FeeSettings and server_info / ledger stream output are gated on HookFeeV3 instead of HookFeeV2 - tests that only avoid the amendment because genesis FeeSettings changes now subtract HookFeeV3; SetHook cost expectations remain the V3 values
protocol
Classes and functions for handling data and values associated with the XRP Ledger protocol.
Serialized Objects
Objects transmitted over the network must be serialized into a canonical format. The prefix "ST" refers to classes that deal with the serialized format.
The term "Tx" or "tx" is an abbreviation for "Transaction", a commonly occurring object type.
Optional Fields
Our serialized fields have some "type magic" to make optional fields easier to read:
- The operation
x[sfFoo]means "return the value of 'Foo' if it exists, or the default value if it doesn't." - The operation
x[~sfFoo]means "return the value of 'Foo' if it exists, or nothing if it doesn't." This usage of the tilde/bitwise NOT operator is not standard outside of therippledcodebase.- As a consequence of this,
x[~sfFoo] = y[~sfFoo]assigns the value of Foo from y to x, including omitting Foo from x if it doesn't exist in y.
- As a consequence of this,
Typically, for things that are guaranteed to exist, you use
x[sfFoo] and avoid having to deal with a container that may
or may not hold a value. For things not guaranteed to exist,
you use x[~sfFoo] because you want such a container. It
avoids having to look something up twice, once just to see if
it exists and a second time to get/set its value.
(Real example)
The source of this "type magic" is in SField.h.