UNL Report

(Added by the Hooks amendment.)

A UNLReport object describes a report of the Unique Node List (UNL) which is a list of validator nodes that are trusted by the network to validate transactions.

Example JSON

{
  "LedgerEntryType": "UNLReport",
  "PreviousTxnID": "5463C6E08862A1FAE5EDAC12D70ADB16546A1F674930521295BC082494B62924",
  "PreviousTxnLgrSeq": 6,
  "ImportVLKeys": [
    {
      "PublicKey": "n9LigbVAi4pQc6pU2KJvQZV5wqJ8C3sVvZvBZUopchH8vqa6PEKy",
      "Account": "rUn84CUYbNjRoTQ6mSW7BVJPSVJNLb1QLo"
    }
  ],
  "ActiveValidators": [
    {
      "PublicKey": "n9LigbVAi4pQc6pU2KJvQZV5wqJ8C3sVvZvBZUopchH8vqa6PEKy",
      "Account": "rUn84CUYbNjRoTQ6mSW7BVJPSVJNLb1QLo"
    }
  ],
  "index": "49647F0D748DC3FE26BDACBC57F251AADEFFF391403EC9BF87C97F67E9977FB0"
}

Fields

A UNLReport object has the following fields:

Field	JSON Type	Internal Type	Required?	Description
LedgerEntryType	String	UInt16	Yes	The value 0x0073, mapped to the string UNLReport, indicates that this object is a UNLReport object.
PreviousTxnID	String	Hash256	Yes	The identifying hash of the transaction that most recently modified this object.
PreviousTxnLgrSeq	Number	UInt32	Yes	The index of the ledger that contains the transaction that most recently modified this object.
ImportVLKeys	Array	Array	No	An array of objects, each representing a validator key that has been imported. Each object has a PublicKey field and an optional Account field.
ActiveValidators	Array	Array	No	An array of objects, each representing an active validator. Each object has a PublicKey field and an optional Account field.

ImportVLKey Fields

Field	JSON Type	Internal Type	Required?	Description
PublicKey	String	VL	Yes	The public key of the imported validator.
Account	String	Account	No	The account associated with the imported validator key. This field is optional.

ActiveValidator Fields

Field	JSON Type	Internal Type	Required?	Description
PublicKey	String	VL	Yes	The public key of the active validator.
Account	String	Account	No	The account associated with the active validator. This field is optional.

Use by Export

An account-owned ExportCommittee stores a canonical list of validator master public keys. When an Export intent is admitted, every committee member must appear in the exact parent ledger’s pre-NegativeUNL ActiveValidators set. If any member is absent, the intent returns tecEXPORT_COMMITTEE_UNAVAILABLE.

The UNLReport does not store Export committees or current validator signing keys. It anchors validator master identities; during live share processing, xahaud resolves each selected master to its current signing key through the manifest system.

UNLReport ID Format

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

61E32E7A24A238F1C619D5F9DDCC41A94B33B66C0163F7EFCC8A19C9FD6F28DC