From 9f6eb205b0ef93886bc273e063003f72b7adb481 Mon Sep 17 00:00:00 2001 From: Luke Parker Date: Fri, 22 Jul 2022 00:28:58 -0400 Subject: [PATCH] Address review comments from #53 --- docs/protocol/Constants.md | 16 ++++++++-------- docs/protocol/Validator Sets.md | 14 ++++++++------ 2 files changed, 16 insertions(+), 14 deletions(-) diff --git a/docs/protocol/Constants.md b/docs/protocol/Constants.md index 60e7dab9..2cbe45b9 100644 --- a/docs/protocol/Constants.md +++ b/docs/protocol/Constants.md @@ -5,14 +5,14 @@ These are the list of types used to represent various properties within the protocol. -| Alias | Shorthand | Type | -|-------------------------|-----------|---------| -| Amount | Amount | u64 | -| Curve | Curve | u16 | -| Coin | Coin | u32 | -| Global Validator Set ID | GVSID | u32 | -| Validator Set Index | VS | u8 | -| Key | Key | Vec | +| Alias | Shorthand | Type | +|-------------------------|-----------|----------| +| Amount | Amount | u64 | +| Curve | Curve | u16 | +| Coin | Coin | u32 | +| Global Validator Set ID | GVSID | u32 | +| Validator Set Index | VS | u8 | +| Key | Key | Vec\ | ### Curves diff --git a/docs/protocol/Validator Sets.md b/docs/protocol/Validator Sets.md index 4d060420..d89510cd 100644 --- a/docs/protocol/Validator Sets.md +++ b/docs/protocol/Validator Sets.md @@ -2,19 +2,21 @@ Validator Sets are defined at the protocol level, with the following parameters: - - `index` (VS): Validator set index, a global key atomically increasing + - `index` (VS): Validator set index, a global key atomically increasing from 0. - - `bond` (Amount): Amount of bond per key-share of this validator set. - - `coins` (Vec): Coins managed by this validator set. + - `bond` (Amount): Amount of bond per key-share of this validator set. + - `coins` (Vec\): Coins managed by this validator set. At launch, there will solely be validator set 0, managing Bitcoin, Ethereum, USDC, DAI, and Monero. ### Multisig Management -Every validator set is expected to form a multisig per curve required by its -coins. This multisig is secure to hold funds up to 67% of the validator set's -bond value. +Every validator set is expected to form a t-of-n multisig, where n is the amount +of key shares in the validator set and t is `n / 3 * 2 + 1`, per curve required +by its coins. This multisig is secure to hold funds up to 67% of the validator +set's bond value. If funds exceed that threshold, there's more value in the +multisig than in the supermajority of bond that must be put forth to control it. ### Participation in the BFT process