Implement threshold for the intersection of lists of validators

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
 

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

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