diff --git a/content/references/rippled-api/validator-list.md b/content/references/rippled-api/validator-list.md index 8164c4a48d..7915edee6d 100644 --- a/content/references/rippled-api/validator-list.md +++ b/content/references/rippled-api/validator-list.md @@ -1,6 +1,6 @@ # Validator List Method -The validator list method is a special API endpoint for reporting a current trusted validator list a `rippled` server is using. This often represents the exact list of validators a server trusts. +The validator list method is a special API endpoint for fetching the latest version of a current trusted validator list a `rippled` server is using. This often represents the exact list of validators a server trusts. Like the [Peer Crawler](peer-crawler.html), the validator list method is available by default on a non-privileged basis through the [Peer Protocol](peer-protocol.html) port, which is also used for `rippled` servers' peer-to-peer communications. @@ -50,12 +50,14 @@ The data encoded in a manifest is as follows: | Field | Internal Type | Description | |:------------------|:--------------|:-----------------------------------------| | sfPublicKey | Blob | The master public key that uniquely identifies this person or organization. This can be a 33-byte secp256k1 public key, or a 32-byte Ed25519 public key prefixed with the byte `0xED`. | -| sfMasterSignature | Blob | A signature of the data in this manifest (***TODO: which data specifically?***) from the master key pair. This proves the authenticity of the manifest. | +| sfMasterSignature | Blob | A signature of this manifest data from the master key pair. This proves the authenticity of the manifest. | | sfSequence | UInt32 | A sequence number for this manifest. A higher number indicates a newer manifest that invalidates all older manifests from the same master public key. | | sfVersion | UInt16 | A version number indicating the manifest format used. A higher number indicates a newer manifest format, including breaking changes compared to the previous manifest format. | | sfDomain | Blob | _(Optional)_ A domain name owned by this person or organization, ASCII-encoded. | | sfSigningPubKey | Blob | _(Optional)_ The ephemeral public key of the key pair that this person or organization is currently using. This must be a 33-byte secp256k1 public key. | -| sfSignature | Blob | _(Optional)_ A signature (**TODO: of what?**) from the ephemeral key pair. | +| sfSignature | Blob | _(Optional)_ A signature of this manifest data from the ephemeral key pair. | + +The `sfMasterSignature` and `sfSignature` signatures are created from signing the [serialized](serialization.html) binary data of the manifest, excluding the signature fields (`sfMasterSignature` and `sfSignature`) themselves. ### Blob Data