Add [validator_list_threshold] to validators.txt to improve UNL secur…

…ity (#5112)
XRPLF · Jan 23, 2025 · 5fbee8c · 5fbee8c
1 parent 3868c04
commit 5fbee8c
Show file tree

Hide file tree

Showing 11 changed files with 2,125 additions and 45 deletions.
diff --git a/API-CHANGELOG.md b/API-CHANGELOG.md
@@ -87,9 +87,10 @@ The `network_id` field was added in the `server_info` response in version 1.5.0
 
 As of 2025-01-23, version 2.4.0 is in development. You can use a pre-release version by building from source or [using the `nightly` package](https://xrpl.org/docs/infrastructure/installation/install-rippled-on-ubuntu).
 
-### Addition in 2.4
+### Additions and bugfixes in 2.4.0
 
 - `ledger_entry`: `state` is added an alias for `ripple_state`.
+- `validators`: Added new field `validator_list_threshold` in response.
 
 ## XRP Ledger server version 2.3.0
 

diff --git a/cfg/validators-example.txt b/cfg/validators-example.txt
@@ -70,3 +70,21 @@ ED45D1840EE724BE327ABE9146503D5848EFD5F38B6D5FEDE71E80ACCE5E6E738B
 #
 # [validator_list_keys]
 # ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860
+
+
+# [validator_list_threshold]
+#
+#   Minimum number of validator lists on which a validator must be listed in
+#   order to be used.
+#
+#   This can be set explicitly to any positive integer number not greater than
+#   the size of [validator_list_keys]. If it is not set, or set to 0, the
+#   value will be calculated at startup from the size of [validator_list_keys],
+#   where the calculation is:
+#
+#     threshold = size(validator_list_keys) < 3
+#       ? 1
+#       : floor(size(validator_list_keys) / 2) + 1
+
+[validator_list_threshold]
+0
diff --git a/include/xrpl/protocol/jss.h b/include/xrpl/protocol/jss.h
@@ -664,27 +664,28 @@ JSS(validated);               // out: NetworkOPs, RPCHelpers, AccountTx*
 JSS(validator_list_expires);  // out: NetworkOps, ValidatorList
 JSS(validator_list);          // out: NetworkOps, ValidatorList
 JSS(validators);
-JSS(validated_hash);          // out: NetworkOPs
-JSS(validated_ledger);        // out: NetworkOPs
-JSS(validated_ledger_index);  // out: SubmitTransaction
-JSS(validated_ledgers);       // out: NetworkOPs
-JSS(validation_key);          // out: ValidationCreate, ValidationSeed
-JSS(validation_private_key);  // out: ValidationCreate
-JSS(validation_public_key);   // out: ValidationCreate, ValidationSeed
-JSS(validation_quorum);       // out: NetworkOPs
-JSS(validation_seed);         // out: ValidationCreate, ValidationSeed
-JSS(validations);             // out: AmendmentTableImpl
-JSS(validator_sites);         // out: ValidatorSites
-JSS(value);                   // out: STAmount
-JSS(version);                 // out: RPCVersion
-JSS(vetoed);                  // out: AmendmentTableImpl
-JSS(volume_a);                // out: BookChanges
-JSS(volume_b);                // out: BookChanges
-JSS(vote);                    // in: Feature
-JSS(vote_slots);              // out: amm_info
-JSS(vote_weight);             // out: amm_info
-JSS(warning);                 // rpc:
-JSS(warnings);                // out: server_info, server_state
+JSS(validated_hash);            // out: NetworkOPs
+JSS(validated_ledger);          // out: NetworkOPs
+JSS(validated_ledger_index);    // out: SubmitTransaction
+JSS(validated_ledgers);         // out: NetworkOPs
+JSS(validation_key);            // out: ValidationCreate, ValidationSeed
+JSS(validation_private_key);    // out: ValidationCreate
+JSS(validation_public_key);     // out: ValidationCreate, ValidationSeed
+JSS(validation_quorum);         // out: NetworkOPs
+JSS(validation_seed);           // out: ValidationCreate, ValidationSeed
+JSS(validations);               // out: AmendmentTableImpl
+JSS(validator_list_threshold);  // out: ValidatorList
+JSS(validator_sites);           // out: ValidatorSites
+JSS(value);                     // out: STAmount
+JSS(version);                   // out: RPCVersion
+JSS(vetoed);                    // out: AmendmentTableImpl
+JSS(volume_a);                  // out: BookChanges
+JSS(volume_b);                  // out: BookChanges
+JSS(vote);                      // in: Feature
+JSS(vote_slots);                // out: amm_info
+JSS(vote_weight);               // out: amm_info
+JSS(warning);                   // rpc:
+JSS(warnings);                  // out: server_info, server_state
 JSS(workers);
 JSS(write_load);              // out: GetCounts
 // clang-format on