(Added by the [NegativeUNL amendment][].)
The NegativeUNL
object type contains the current status of the Negative UNL, a list of trusted validators currently believed to be offline.
Each ledger version contains at most one NegativeUNL
object. If no validators are currently disabled or scheduled to be disabled, there is no NegativeUNL
object in the ledger.
A NegativeUNL
object has the following fields:
DisabledValidators
Array
Array
No
A list of DisabledValidator
objects (see below), each representing a trusted validator that is currently disabled.
Flags
Number
UInt32
Yes
A bit-map of boolean flags. No flags are defined for the NegativeUNL object type, so this value is always 0
.
LedgerEntryType
String
UInt16
Yes
The value 0x004E
, mapped to the string NegativeUNL
, indicates that this object is the Negative UNL.
ValidatorToDisable
String
Blob
No
The public key of a trusted validator that is scheduled to be disabled in the next flag ledger.
ValidatorToReEnable
String
Blob
No
The public key of a trusted validator in the Negative UNL that is scheduled to be re-enabled in the next flag ledger.
Each DisabledValidator
object represents one disabled validator. In JSON, a DisabledValidator
object has one field, DisabledValidator
, which in turn contains another object with the following fields:
FirstLedgerSequence
Number
UInt32
The [ledger index][] when the validator was added to the Negative UNL.
PublicKey
String
Blob
The master public key of the validator, in hexadecimal.
The NegativeUNL
object ID is the hash of the NegativeUNL
space key (0x004E
) only. This means that the ID of the NegativeUNL
object in a ledger is always: