From 6c655490464218feb8ffdb9dc9336da5a7a7dc16 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Wed, 10 Jul 2024 19:10:58 -0300
Subject: [PATCH 01/16] shuffles validators with same bid value

---
 .../sources/ol_sources/proof_of_fee.move      | 234 +++++++++++++++---
 .../libra-framework/sources/randomness.move   |   2 +-
 2 files changed, 205 insertions(+), 31 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index 1dcb3e87a..f3159c711 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -14,14 +14,15 @@ module ol_framework::proof_of_fee {
   use std::vector;
   use std::fixed_point32;
   use diem_framework::validator_universe;
-  use ol_framework::jail;
-  use ol_framework::slow_wallet;
-  use ol_framework::vouch;
   use diem_framework::transaction_fee;
-  use ol_framework::epoch_helper;
+  use diem_framework::randomness;
   use diem_framework::account;
   use diem_framework::stake;
   use diem_framework::system_addresses;
+  use ol_framework::jail;
+  use ol_framework::slow_wallet;
+  use ol_framework::vouch;
+  use ol_framework::epoch_helper;
   use ol_framework::globals;
   // use diem_std::debug::print;
 
@@ -32,7 +33,6 @@ module ol_framework::proof_of_fee {
   #[test_only]
   friend ol_framework::mock;
 
-
   /// The nominal reward for each validator in each epoch.
   const GENESIS_BASELINE_REWARD: u64 = 1000000;
 
@@ -63,7 +63,6 @@ module ol_framework::proof_of_fee {
   /// not enough coin balance
   const ELOW_UNLOCKED_COIN_BALANCE: u64 = 17;
 
-
   // A struct on the validators account which indicates their
   // latest bid (and epoch)
   struct ProofOfFeeAuction has key {
@@ -249,40 +248,67 @@ module ol_framework::proof_of_fee {
       k = k + 1;
     };
 
-    // Sorting the accounts vector based on value (weights).
-    // Bubble sort algorithm
-    let len_filtered = vector::length<address>(&filtered_vals);
-    // if there's only one person (testing)
-    if (len_filtered < 2) return (filtered_vals, bids);
-    let i = 0;
-    while (i < len_filtered){
-      let j = 0;
-      while(j < len_filtered-i-1){
+    // Sorting the accounts vector based on value (weights)
+    bubble_sort_bids(&mut bids, &mut filtered_vals);
 
-        let value_j = *(vector::borrow<u64>(&bids, j));
+    // Reverse to have sorted order - high to low.
+    vector::reverse(&mut filtered_vals);
+    vector::reverse(&mut bids);
 
-        let value_jp1 = *(vector::borrow<u64>(&bids, j+1));
-        if(value_j > value_jp1){
+    // Shuffle duplicates to garantee randomness/fairness
+    shuffle_duplicates(&mut bids, &mut filtered_vals);
 
-          vector::swap<u64>(&mut bids, j, j+1);
+    return (filtered_vals, bids)
+  }
 
-          vector::swap<address>(&mut filtered_vals, j, j+1);
+  fun bubble_sort_bids(bids: &mut vector<u64>, addresses: &mut vector<address>) {
+    let len = vector::length<u64>(bids);
+    let i = 0;
+    while (i < len) {
+      let j = 0;
+      while (j < len - i - 1) {
+        let value_j = *vector::borrow<u64>(bids, j);
+        let value_jp1 = *vector::borrow<u64>(bids, j + 1);
+        if (value_j > value_jp1) {
+          vector::swap<u64>(bids, j, j + 1);
+          vector::swap<address>(addresses, j, j + 1);
         };
         j = j + 1;
-
       };
       i = i + 1;
-
     };
+  }
 
-
-    // Reverse to have sorted order - high to low.
-    vector::reverse(&mut filtered_vals);
-    vector::reverse(&mut bids);
-
-    return (filtered_vals, bids)
+  fun shuffle_duplicates(bids: &vector<u64>, addresses: &mut vector<address>) {
+    let len = vector::length(bids);
+    let i = 0;
+    while (i < len) {
+      let j = i + 1;
+      while (j < len && *vector::borrow(bids, i) == *vector::borrow(bids, j)) {
+        j = j + 1;
+      };
+      if (j > i + 1) {
+        let slice_len = j - i;
+        let perm = randomness::permutation(slice_len);
+        let temp_addresses = vector::empty<address>();
+        let k = 0;
+        while (k < slice_len) {
+          let pos = i + k;
+          vector::push_back(&mut temp_addresses, *vector::borrow(addresses, pos));
+          k = k + 1;
+        };
+        k = 0;
+        while (k < slice_len) {
+          let perm_pos = *vector::borrow(&perm, k);
+          *vector::borrow_mut(addresses, i + k) = *vector::borrow(&temp_addresses, perm_pos);
+          k = k + 1;
+        };
+      };
+      i = j;
+    };
   }
 
+
   #[view]
   /// checks if the validator has enough vouchers in the current set (prior to entry)
   /// @params incoming address to be evaluated
@@ -1003,7 +1029,7 @@ module ol_framework::proof_of_fee {
 
   }
 
-    // Scenario: The reward is too low during 5 days (short window). People are not bidding very high.
+  // Scenario: The reward is too low during 5 days (short window). People are not bidding very high.
   #[test(vm = @ol_framework)]
   fun thermostat_decrease_long(vm: signer) acquires ConsensusReward {
     use diem_framework::chain_id;
@@ -1024,7 +1050,6 @@ module ol_framework::proof_of_fee {
       i = i + 1;
     };
 
-
     test_mock_reward(
       &vm,
       100,
@@ -1063,4 +1088,153 @@ module ol_framework::proof_of_fee {
   //     validator_universe::is_in_universe(@0x123);
 
   // }
+
+  // Bubble Sort tests
+
+  #[test]
+  fun test_bubble_sort_empty_vectors() {
+    let bids: vector<u64> = vector::empty();
+    let addresses: vector<address> = vector::empty();
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[], 7357001);
+    assert!(addresses == vector[], 7357002);
+  }
+
+  #[test]
+  fun test_bubble_sort_single_element() {
+    let bids = vector[10];
+    let addresses = vector[@0x1];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[10], 7357003);
+    assert!(addresses == vector[@0x1], 7357004);
+  }
+
+  #[test]
+  fun test_bubble_sort_already_sorted() {
+    let bids = vector[1, 2, 3, 4, 5];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[1, 2, 3, 4, 5], 7357005);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357006);
+  }
+
+  #[test]
+  fun test_bubble_sort_reverse_order() {
+    let bids = vector[5, 4, 3, 2, 1];
+    let addresses = vector[@0x5, @0x4, @0x3, @0x2, @0x1];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[1, 2, 3, 4, 5], 7357007);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357008);
+  }
+
+  #[test]
+  fun test_bubble_sort_with_duplicates() {
+    let bids = vector[4, 2, 2, 3, 1];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[1, 2, 2, 3, 4], 7357009);
+    assert!(addresses == vector[@0x5, @0x2, @0x3, @0x4, @0x1], 7357010);
+  }
+
+  #[test]
+  fun test_bubble_sort_random_order() {
+    let bids = vector[3, 1, 4, 5, 2];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[1, 2, 3, 4, 5], 7357011);
+    assert!(addresses == vector[@0x2, @0x5, @0x1, @0x3, @0x4], 7357012);
+  }
+
+  #[test]
+  fun test_bubble_sort_all_elements_equal() {
+    let bids = vector[3, 3, 3, 3, 3];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    bubble_sort_bids(&mut bids, &mut addresses);
+    assert!(bids == vector[3, 3, 3, 3, 3], 7357013);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357014);
+  }
+
+  // Shuffle Tests
+
+  #[test]
+  fun test_shuffle_no_duplicates() {
+    // No duplicates in the bids vector
+    let bids = vector[1, 2, 3, 4, 5];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    shuffle_duplicates(&mut bids, &mut addresses);
+    assert!(bids == vector[1, 2, 3, 4, 5], 7357015);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357016);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_with_duplicates(root: &signer) {
+    // One group of duplicates in the bids vector
+    randomness::initialize(root);
+    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    let bids = vector[1, 2, 2, 3, 4];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut bids, &mut addresses);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(bids == vector[1, 2, 2, 3, 4], 7357017);
+    assert!(shuffled, 7357018);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_multiple_duplicate_groups(root: &signer) {
+    // Multiple groups of duplicates in the bids vector
+    randomness::initialize(root);
+    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    let bids = vector[1, 2, 2, 3, 3, 4];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut bids, &mut addresses);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(bids == vector[1, 2, 2, 3, 3, 4], 7357019);
+    assert!(shuffled, 7357020);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_all_elements_equal(root: &signer) {
+    // All elements in the bids vector are the same
+    randomness::initialize(root);
+    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    let bids = vector[2, 2, 2, 2];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut bids, &mut addresses);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(bids == vector[2, 2, 2, 2], 7357021);
+    assert!(shuffled, 7357022);
+  }
 }
diff --git a/framework/libra-framework/sources/randomness.move b/framework/libra-framework/sources/randomness.move
index 53061cce5..7fab83a78 100644
--- a/framework/libra-framework/sources/randomness.move
+++ b/framework/libra-framework/sources/randomness.move
@@ -342,7 +342,7 @@ module diem_framework::randomness {
 
     /// Generate a permutation of `[0, 1, ..., n-1]` uniformly at random.
     /// If n is 0, returns the empty vector.
-    fun permutation(n: u64): vector<u64> acquires PerBlockRandomness {
+    public fun permutation(n: u64): vector<u64> acquires PerBlockRandomness {
         let values = vector[];
 
         if(n == 0) {

From 6cf0e6f6c79f120e0241bbcc412bec4c45967284 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 12 Jul 2024 07:20:03 -0300
Subject: [PATCH 02/16] reduces val set for competition between qualified
 bidders having 21 or more compliant

---
 .../sources/ol_sources/proof_of_fee.move      | 340 +++++++++++++-----
 1 file changed, 249 insertions(+), 91 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index f3159c711..e494b933f 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -4,14 +4,13 @@
 /////////////////////////////////////////////////////////////////////////
 // NOTE: this module replaces NodeWeight.move, which becomes redundant since
 // all validators have equal weight in consensus.
-// TODO: the bubble sort functions were lifted directly from NodeWeight, needs checking.
 ///////////////////////////////////////////////////////////////////////////
 
-
 module ol_framework::proof_of_fee {
   use std::error;
   use std::signer;
   use std::vector;
+  use std::math64;
   use std::fixed_point32;
   use diem_framework::validator_universe;
   use diem_framework::transaction_fee;
@@ -24,7 +23,7 @@ module ol_framework::proof_of_fee {
   use ol_framework::vouch;
   use ol_framework::epoch_helper;
   use ol_framework::globals;
-  // use diem_std::debug::print;
+  //use diem_std::debug::print;
 
   friend diem_framework::genesis;
   friend ol_framework::epoch_boundary;
@@ -38,8 +37,12 @@ module ol_framework::proof_of_fee {
 
   /// Number of vals needed before PoF becomes competitive for
   /// performant nodes as well
-  const VAL_BOOT_UP_THRESHOLD: u64 = 19;
-
+  const VAL_BOOT_UP_THRESHOLD: u64 = 21;
+  /// This figure is experimental and a different percentage may be finalized
+  /// after some experience in the wild. Additionally it could be dynamic
+  /// based on another function or simply randomized within a range
+  /// (as originally proposed in this feature request)
+  const PCT_REDUCTION_FOR_COMPETITION: u64 = 10; // 10%
 
   //////// ERRORS /////////
   /// Not an active validator
@@ -131,57 +134,86 @@ module ol_framework::proof_of_fee {
     }
   }
 
-  /// Consolidates all the logic for the epoch boundary/
-  /// Includes: getting the sorted bids,
-  /// filling the seats (determined by MusicalChairs), and getting a price.
-  /// and finally charging the validators for their bid (everyone pays the lowest)
-  /// for audit instrumentation returns: final set size, auction winners, all the bidders, (including not-qualified), and all qualified bidders.
-  /// we also return the auction entry price (clearing price)
+  /// Consolidates all the logic for the epoch boundary, including:
+  /// 1. Getting the sorted bidders,
+  /// 2. Calculate final validators set size (number of seats to fill),
+  /// 3. Filling the seats,
+  /// 4. Getting a price,
+  /// 5. Finally charging the validators for their bid (everyone pays the lowest)
+  /// For audit instrumentation returns: final set size, auction winners, all the bidders, (including not-qualified), and all qualified bidders.
+  /// We also return the auction entry price (clearing price)
   /// (final_set_size, auction_winners, all_bidders, only_qualified_bidders, actually_paid, entry_fee)
   public(friend) fun end_epoch(
     vm: &signer,
     outgoing_compliant_set: &vector<address>,
-    final_set_size: u64
+    mc_set_size: u64 // musical chairs set size suggestion
   ): (vector<address>, vector<address>, vector<address>, u64) acquires ProofOfFeeAuction, ConsensusReward {
       system_addresses::assert_ol(vm);
 
       let all_bidders = get_bidders(false);
       let only_qualified_bidders = get_bidders(true);
-      // The set size as determined by musical chairs is a target size
-      // but the actual final size depends on how much can we expand the set
-      // without adding too many unproven nodes (which we don't know if they are prepared to validate, and risk halting th network).
-
-
-      // Boot up
-      // After an upgrade or incident the network may need to rebuild the
-      // validator set from a small base.
-      // we should increase the available seats starting from a base of
-      // compliant nodes. And make it competitive for the unknown nodes.
-      // Instead of increasing the seats by +1 the compliant vals we should
-      // increase by compliant + (1/2 compliant - 1) or another
-      // safe threshold.
-      // Another effect is that with PoF we might be dropping compliant nodes,
-      //  in favor of unknown nodes with high bids.
-      // So in the case of a small validator set, we ignore the musical_chairs
-      // suggestion, and increase the seats offered, and guarantee seats to
-      // performant nodes.
-      let performant_len = vector::length(outgoing_compliant_set);
-      if (
-        performant_len < VAL_BOOT_UP_THRESHOLD &&
-        performant_len > 2
-      ) {
-        final_set_size = performant_len + (performant_len/2 - 1)
-      };
+
+      // Calculate the final set size considering the number of compliant validators,
+      // number of qualified bidders, and musical chairs set size suggestion
+      let final_set_size = calculate_final_set_size(
+        vector::length(outgoing_compliant_set),
+        vector::length(&only_qualified_bidders),
+        mc_set_size);
 
       // This is the core of the mechanism, the uniform price auction
       // the winners of the auction will be the validator set.
-      // other lists are created for audit purposes of the BoundaryStatus
+      // Other lists are created for audit purposes of the BoundaryStatus
       let (auction_winners, entry_fee, _clearing_bid, _proven, _unproven) = fill_seats_and_get_price(vm, final_set_size, &only_qualified_bidders, outgoing_compliant_set);
 
-
       (auction_winners, all_bidders, only_qualified_bidders, entry_fee)
   }
 
+
+  // The set size as determined by musical chairs is a target size
+  // but the actual final size depends on:
+  // a. how much can we expand the set without adding too many unproven nodes (which we don't know
+  // if they are prepared to validate, and risk halting the network).
+  // b. how many qualified bidders are there, and how many seats can we offer to ensure competition.
+
+  // 1. Boot Up
+  // After an upgrade or incident the network may need to rebuild the validator set
+  // from a small base. We should increase the available seats starting
+  // from a base of compliant nodes. And make it competitive for the unknown nodes.
+  // Instead of increasing the seats by +1 the compliant vals we should
+  // increase by compliant + (1/2 compliant - 1) or another safe threshold.
+  // Another effect is that with PoF we might be dropping compliant nodes,
+  // in favor of unknown nodes with high bids. So in the case of a small validator set,
+  // we ignore the musical_chairs suggestion, and increase the seats offered, and guarantee seats to
+  // performant nodes.
+  //
+  // 2. Competitive Set
+  // If we have more qualified bidders than the threshold, we should limit the final set size
+  // to 90% of the qualified bidders to ensure that vals will compete for seats.
+
+  fun calculate_final_set_size(
+    outgoing_compliant: u64,
+    qualified_bidders: u64,
+    mc_set_size: u64 // musical chairs set size suggestion
+  ): u64 {
+    // 1. Boot Up
+    if (
+      outgoing_compliant < VAL_BOOT_UP_THRESHOLD &&
+      outgoing_compliant > 2
+    ) {
+      return math64::min(outgoing_compliant + (outgoing_compliant/2 - 1), VAL_BOOT_UP_THRESHOLD)
+    };
+
+    // 2. Competitive Set
+    if (mc_set_size >= VAL_BOOT_UP_THRESHOLD && qualified_bidders >= VAL_BOOT_UP_THRESHOLD) {
+      let seats_to_remove = qualified_bidders * PCT_REDUCTION_FOR_COMPETITION / 100;
+      let max_qualified = qualified_bidders - seats_to_remove;
+      // do note increase beyond musical chairs suggestion and competitive set size
+      return math64::min(max_qualified, mc_set_size)
+    };
+
+    mc_set_size
+  }
+
   /// The fees are charged seperate from the auction and seating loop
   /// this is because there are edge conditions in which the winners
   /// may not be the ones seated (once we consider failover rules).
@@ -196,9 +228,6 @@ module ol_framework::proof_of_fee {
   }
 
 
-
-
-
   //////// CONSENSUS CRITICAL ////////
   // Get the validator universe sorted by bid
   // By default this will return a FILTERED list of validators
@@ -233,11 +262,8 @@ module ol_framework::proof_of_fee {
     let k = 0;
     while (k < length) {
       // TODO: Ensure that this address is an active validator
-
       let cur_address = *vector::borrow<address>(eligible_validators, k);
-
       let (bid, _expire) = current_bid(cur_address);
-
       let (_, qualified) = audit_qualification(cur_address);
       if (remove_unqualified && !qualified) {
         k = k + 1;
@@ -248,7 +274,7 @@ module ol_framework::proof_of_fee {
       k = k + 1;
     };
 
-    // Sorting the accounts vector based on value (weights)
+    // Sorting the accounts vector based on their bids
     bubble_sort_bids(&mut bids, &mut filtered_vals);
 
     // Reverse to have sorted order - high to low.
@@ -261,6 +287,7 @@ module ol_framework::proof_of_fee {
     return (filtered_vals, bids)
   }
 
+  // Bubble sort bids and corresponding addresses
   fun bubble_sort_bids(bids: &mut vector<u64>, addresses: &mut vector<address>) {
     let len = vector::length<u64>(bids);
     let i = 0;
@@ -279,6 +306,7 @@ module ol_framework::proof_of_fee {
     };
   }
 
+  // Shuffle addresses with the same bid amount to ensure randomness position
   fun shuffle_duplicates(bids: &vector<u64>, addresses: &mut vector<address>) {
     let len = vector::length(bids);
     let i = 0;
@@ -326,7 +354,7 @@ module ol_framework::proof_of_fee {
   // Here we place the bidders into their seats.
   // The order of the bids will determine placement.
   // One important aspect of picking the next validator set:
-  // it should have 2/3rds of known good ("proven") validators
+  // It should have 2/3rds of known good ("proven") validators
   // from the previous epoch. Otherwise the unproven nodes, who
   // may not be ready for consensus, might be offline and cause a halt.
   // Validators can be inattentive and have bids that qualify, but their nodes
@@ -340,7 +368,9 @@ module ol_framework::proof_of_fee {
   // This is a potential issue again with inattentive validators who
   // have have a high bid, but again they fail repeatedly to finalize an epoch
   // successfully. Their bids should not penalize validators who don't have
-  // a streak of jailed epochs. So of the 1/3 unproven nodes, we'll first seat the validators with Jail.consecutive_failure_to_rejoin < 2, and after that the remainder.
+  // a streak of jailed epochs. So of the 1/3 unproven nodes,
+  // we'll first seat the validators with Jail.consecutive_failure_to_rejoin < 2,
+  // and after that the remainder.
 
   // There's some code implemented which is not enabled in the current form.
   // Unsealed auctions are tricky. The Proof Of Fee
@@ -350,14 +380,18 @@ module ol_framework::proof_of_fee {
   // As such per epoch the validator is only allowed to revise their bids /
   // down once. To do this in practice they need to retract a bid (sit out
   // the auction), and then place a new bid.
-  // A validator can always leave the auction, but if they rejoin a second time in the epoch, then they've committed a bid until the next epoch.
-  // So retracting should be done with care.  The ergonomics are not great.
+  // A validator can always leave the auction, but if they rejoin a second time in the epoch,
+  // then they've committed a bid until the next epoch.
+  // So retracting should be done with care. The ergonomics are not great.
   // The preference would be not to have this constraint if on the margins
   // the ergonomics brings more bidders than attackers.
   // After more experience in the wild, the network may decide to
   // limit bid retracting.
 
-  // The Validator must qualify on a number of metrics: have funds in their Unlocked account to cover bid, have miniumum viable vouches, and not have been jailed in the previous round.
+  // The Validator must qualify on a number of metrics:
+  // 1. have funds in their Unlocked account to cover bid,
+  // 2. have miniumum viable vouches,
+  // 3. and not have been jailed in the previous round.
 
   /// Showtime.
   /// This is where we take all the bidders and seat them.
@@ -365,11 +399,11 @@ module ol_framework::proof_of_fee {
   /// This function assumes we have already filtered out ineligible validators.
   /// but we will check again here.
   /// we return:
-  // a. the list of winning validators (the validator set)
-  // b. the entry fee paid
-  // c. the clearing bid (percentage paid)
-  // d. the list of proven nodes added, for audit and instrumentation
-  // e. the list of unproven, for audit and instrumentation
+  /// a. the list of winning validators (the validator set)
+  /// b. the entry fee paid
+  /// c. the clearing bid (percentage paid)
+  /// d. the list of proven nodes added, for audit and instrumentation
+  /// e. the list of unproven, for audit and instrumentation
   public(friend) fun fill_seats_and_get_price(
     vm: &signer,
     final_set_size: u64,
@@ -522,14 +556,12 @@ module ol_framework::proof_of_fee {
 
     let cr = borrow_global_mut<ConsensusReward>(@ol_framework);
 
-
     let len = vector::length<u64>(&cr.median_history);
     let i = 0;
 
     let epochs_above = 0;
     let epochs_below = 0;
     while (i < 16 && i < len) { // max ten days, but may have less in history, filling set should truncate the history at 15 epochs.
-
       let avg_bid = *vector::borrow<u64>(&cr.median_history, i);
 
       if (avg_bid > bid_upper_bound) {
@@ -541,10 +573,7 @@ module ol_framework::proof_of_fee {
       i = i + 1;
     };
 
-
     if (cr.nominal_reward > 0) {
-
-
       // TODO: this is an initial implementation, we need to
       // decide if we want more granularity in the reward adjustment
       // Note: making this readable for now, but we can optimize later
@@ -562,51 +591,43 @@ module ol_framework::proof_of_fee {
         // at 1% median bid, the implicit bond is 100x the reward.
         // We need to DECREASE the reward
 
-
         if (epochs_above > long_window) {
-
           // decrease the reward by 10%
           let less_ten_pct = (cr.nominal_reward / 10);
           cr.nominal_reward = cr.nominal_reward - less_ten_pct;
           return (true, false, less_ten_pct)
-
         } else if (epochs_above > short_window) {
           // decrease the reward by 5%
           let less_five_pct = (cr.nominal_reward / 20);
           cr.nominal_reward = cr.nominal_reward - less_five_pct;
-
           return (true, false, less_five_pct)
         }
       };
       // return early since we can't increase and decrease simultaneously
 
+      // if validators are bidding low percentages
+      // it means the nominal reward is not high enough.
+      // That is the validator's opportunity cost is not met within a
+      // range where the bond is meaningful.
+      // For example: if the bids for the epoch's reward is 50% of the  value, that means the potential profit, is the same as the potential loss.
+      // At a 25% bid (potential loss), the profit is thus 75% of the value, which means the implicit bond is 25/75, or 1/3 of the bond, the risk favors the validator. This means among other things, that an attacker can pay for the cost of the attack with the profits. See paper, for more details.
+
+      // we need to INCREASE the reward, so that the bond is more meaningful.
+
+      if (epochs_below > long_window) {
+        // increase the reward by 10%
+        let increase_ten_pct = (cr.nominal_reward / 10);
+        cr.nominal_reward = cr.nominal_reward + increase_ten_pct;
+        return (true, true, increase_ten_pct)
+      } else if (epochs_below > short_window) {
+        // increase the reward by 5%
+        let increase_five_pct = (cr.nominal_reward / 20);
+        cr.nominal_reward = cr.nominal_reward + increase_five_pct;
+        return (true, true, increase_five_pct)
+      };
 
-        // if validators are bidding low percentages
-        // it means the nominal reward is not high enough.
-        // That is the validator's opportunity cost is not met within a
-        // range where the bond is meaningful.
-        // For example: if the bids for the epoch's reward is 50% of the  value, that means the potential profit, is the same as the potential loss.
-        // At a 25% bid (potential loss), the profit is thus 75% of the value, which means the implicit bond is 25/75, or 1/3 of the bond, the risk favors the validator. This means among other things, that an attacker can pay for the cost of the attack with the profits. See paper, for more details.
-
-        // we need to INCREASE the reward, so that the bond is more meaningful.
-
-
-        if (epochs_below > long_window) {
-          // increase the reward by 10%
-          let increase_ten_pct = (cr.nominal_reward / 10);
-          cr.nominal_reward = cr.nominal_reward + increase_ten_pct;
-          return (true, true, increase_ten_pct)
-        } else if (epochs_below > short_window) {
-
-
-          // increase the reward by 5%
-          let increase_five_pct = (cr.nominal_reward / 20);
-          cr.nominal_reward = cr.nominal_reward + increase_five_pct;
-          return (true, true, increase_five_pct)
-        };
-
-        // we ran the thermostat but no change was made.
-        return (true, false, 0)
+      // we ran the thermostat but no change was made.
+      return (true, false, 0)
     };
 
     // nominal reward is zero, there's a problem
@@ -1089,6 +1110,141 @@ module ol_framework::proof_of_fee {
 
   // }
 
+
+  // Calculate Final Set Size tests
+
+  #[test]
+  fun test_calculate_final_set_size_boot_up_happy_day() {
+    // Happy Day: test complete boot up with plenty qualified bidders over multiple epochs
+    // having validators always compliant
+
+    // Epoch 1
+    let outgoing_compliant = 0;
+    let qualified_bidders = 100;
+    let mc_set_size = 4;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 4, 7357023);
+
+    // Epoch 2
+    outgoing_compliant = 4;
+    mc_set_size = 5;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 4 + (4/2 - 1) = 5
+    assert!(result == 5, 7357024);
+
+    // Epoch 3
+    outgoing_compliant = 5;
+    mc_set_size = 6;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 5 + (5/2 - 1) = 6
+    assert!(result == 6, 7357025);
+
+    // Epoch 4
+    outgoing_compliant = 6;
+    mc_set_size = 7;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 6 + (6/2 - 1) = 8
+    assert!(result == 8, 7357026);
+
+    // Epoch 5
+    outgoing_compliant = 8;
+    mc_set_size = 9;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 8 + (8/2 - 1) = 11
+    assert!(result == 11, 7357027);
+
+    // Epoch 6
+    outgoing_compliant = 11;
+    mc_set_size = 12;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 11 + (11/2 - 1) = 15
+    assert!(result == 15, 7357028);
+
+    // Epoch 6
+    outgoing_compliant = 15;
+    mc_set_size = 16;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // 15 + (15/2 - 1) = 21
+    // min (21, 21)
+    assert!(result == 21, 7357028);
+
+    // Epoch 7 - Boot up ended
+    outgoing_compliant = 21;
+    mc_set_size = 22;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // min(22, 100*90%) = 22
+    assert!(result == 22, 7357029);
+  }
+
+  #[test]
+  fun test_calculate_final_set_size_boot_up_threshold() {
+    let qualified_bidders = 100;
+
+    // Test boot up increases maximum set size to 21
+    let outgoing_compliant = 20;
+    let mc_set_size = 20;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 21, 7357030);
+
+    // Test set size stays at 21
+    outgoing_compliant = 21;
+    mc_set_size = 21;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 21, 7357030);
+
+    // Test set size increases to 22
+    outgoing_compliant = 22;
+    mc_set_size = 22;
+    result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // min (22, 100*90%) = 22
+    assert!(result == 22, 7357030);
+  }
+
+  #[test]
+  fun test_calculate_final_set_size_competitive_set_no_changes() {
+    let outgoing_compliant = 21;
+    let qualified_bidders = 40;
+    let mc_set_size = 21;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 21, 7357030);
+  }
+
+  #[test]
+  fun test_calculate_final_set_size_competitive_set_increases() {
+    let outgoing_compliant = 30;
+    let qualified_bidders = 40;
+    let mc_set_size = 31;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 31, 7357030);
+  }
+
+  #[test]
+  fun test_calculate_final_set_size_competitive_set_decreases() {
+    let outgoing_compliant = 50;
+    let qualified_bidders = 50;
+    let mc_set_size = 50;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    assert!(result == 45, 7357030);
+  }
+
+  #[test]
+  fun test_calculate_final_set_size_competitive_set_decreases_to_boot_up() {
+    let outgoing_compliant = 21;
+    let qualified_bidders = 21;
+    let mc_set_size = 21;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // min(21, 21*90%) = 19
+    assert!(result == 19, 7357030);
+
+    let outgoing_compliant = 21;
+    let qualified_bidders = 20;
+    let mc_set_size = 21;
+    let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
+    // mc value
+    assert!(result == 21, 7357030);
+  }
+
+
   // Bubble Sort tests
 
   #[test]
@@ -1154,6 +1310,8 @@ module ol_framework::proof_of_fee {
     assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357014);
   }
 
+
+
   // Shuffle Tests
 
   #[test]

From 15b55fb7bcd64e47e057b7f4e64f7448bc8e6bce Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 12 Jul 2024 09:31:14 -0300
Subject: [PATCH 03/16] initializes randomness on ol_reconfigure_for_test

---
 .../sources/ol_sources/epoch_boundary.move         |  2 ++
 .../sources/ol_sources/proof_of_fee.move           |  9 +++------
 .../ol_sources/tests/proof_of_fee.test.move        | 14 +-------------
 3 files changed, 6 insertions(+), 19 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index b8df79f4f..36fb97925 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -506,8 +506,10 @@ module diem_framework::epoch_boundary {
   public fun ol_reconfigure_for_test(vm: &signer, closing_epoch: u64,
   epoch_round: u64) acquires BoundaryStatus {
       use diem_framework::system_addresses;
+      use diem_framework::randomness;
 
       system_addresses::assert_ol(vm);
+      randomness::initialize_for_testing(vm);
       epoch_boundary(vm, closing_epoch, epoch_round);
   }
 
diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index e494b933f..7ba4351f9 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -1327,8 +1327,7 @@ module ol_framework::proof_of_fee {
   #[test(root = @ol_framework)]
   fun test_shuffle_with_duplicates(root: &signer) {
     // One group of duplicates in the bids vector
-    randomness::initialize(root);
-    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    randomness::initialize_for_testing(root);
     let bids = vector[1, 2, 2, 3, 4];
     let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
     let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
@@ -1351,8 +1350,7 @@ module ol_framework::proof_of_fee {
   #[test(root = @ol_framework)]
   fun test_shuffle_multiple_duplicate_groups(root: &signer) {
     // Multiple groups of duplicates in the bids vector
-    randomness::initialize(root);
-    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    randomness::initialize_for_testing(root);
     let bids = vector[1, 2, 2, 3, 3, 4];
     let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
     let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
@@ -1375,8 +1373,7 @@ module ol_framework::proof_of_fee {
   #[test(root = @ol_framework)]
   fun test_shuffle_all_elements_equal(root: &signer) {
     // All elements in the bids vector are the same
-    randomness::initialize(root);
-    randomness::set_seed(x"0000000000000000000000000000000000000000000000000000000000000000");
+    randomness::initialize_for_testing(root);
     let bids = vector[2, 2, 2, 2];
     let addresses = vector[@0x1, @0x2, @0x3, @0x4];
     let original_addresses = vector[@0x1, @0x2, @0x3, @0x4];
diff --git a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
index 8be5ac065..abea11e07 100644
--- a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
@@ -331,18 +331,15 @@ module ol_framework::test_pof {
 
     let sorted_two = proof_of_fee::get_bidders(true);
     assert!(vector::length(&sorted_two) != vector::length(&val_universe), 1004);
-
     assert!(vector::length(&sorted_two) == vector::length(&val_universe) - 1, 1005);
-
   }
 
   // We can send the fill seats function a list of validators, and the list of performing validators, and it will return the winning bidders and the bid.
   #[test(root = @ol_framework)]
   fun fill_seats_happy(root: signer) {
     let set = mock::genesis_n_vals(&root, 5);
-    mock::ol_initialize_coin_and_fund_vals(&root, 500000, true);
     let len = vector::length(&set);
-
+    mock::ol_initialize_coin_and_fund_vals(&root, 500000, true);
     mock::pof_default();
 
     slow_wallet::slow_wallet_epoch_drip(&root, 500000);
@@ -351,7 +348,6 @@ module ol_framework::test_pof {
     assert!(vector::length(&sorted) == vector::length(&set), 1003);
 
     let (seats, _, _, _, _) = proof_of_fee::fill_seats_and_get_price(&root, len, &sorted, &sorted);
-
     assert!(vector::contains(&seats, vector::borrow(&set, 0)), 1004);
 
     // filling the seat updated the computation of the consensu reward.
@@ -359,7 +355,6 @@ module ol_framework::test_pof {
     assert!(reward == 1000000, 1005);
     assert!(clear_percent == 1, 1006);
     assert!(median_bid == 3, 1007);
-
   }
 
   // We fill all the seats, and run the thermostat
@@ -410,11 +405,9 @@ module ol_framework::test_pof {
     mock::ol_initialize_coin_and_fund_vals(&root, 500000, true);
     mock::pof_default();
 
-
     // Ok now EVE changes her mind. Will force the bid to expire.
     let a_sig = account::create_signer_for_test(*vector::borrow(&set, 4));
     proof_of_fee::pof_update_bid(&a_sig, 0, 0);
-
     slow_wallet::slow_wallet_epoch_drip(&root, 500000);
 
     let sorted = proof_of_fee::get_bidders(true);
@@ -452,14 +445,9 @@ module ol_framework::test_pof {
   fun fill_seats_many_bidders(root: signer) {
     let set = mock::genesis_n_vals(&root, 5);
     mock::pof_default();
-
     mock::ol_initialize_coin_and_fund_vals(&root, 500000, true);
 
-
     let sorted = proof_of_fee::get_bidders(true);
-
-
-
     let set_size = 3;
     let (seats, _, _, _, _) = proof_of_fee::fill_seats_and_get_price(&root, set_size, &sorted, &sorted);
 

From 7a761fb54f35cf563daa8c0a0ff2f837ff91fa13 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 12 Jul 2024 10:51:42 -0300
Subject: [PATCH 04/16] refactors musical chairs mod and adds more tests

---
 .../sources/ol_sources/mock.move              | 502 +++++++++---------
 .../sources/ol_sources/musical_chairs.move    | 495 +++++++++--------
 .../ol_sources/tests/musical_chairs.test.move |  86 ++-
 3 files changed, 557 insertions(+), 526 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/mock.move b/framework/libra-framework/sources/ol_sources/mock.move
index b99e36079..2ff072302 100644
--- a/framework/libra-framework/sources/ol_sources/mock.move
+++ b/framework/libra-framework/sources/ol_sources/mock.move
@@ -36,265 +36,265 @@ module ol_framework::mock {
 
   #[test_only]
   public fun reset_val_perf_all(vm: &signer) {
-      let vals = stake::get_current_validators();
-      let i = 0;
-      while (i < vector::length(&vals)) {
-        let a = vector::borrow(&vals, i);
-        stake::mock_performance(vm, *a, 0, 0);
-        i = i + 1;
-      };
+    let vals = stake::get_current_validators();
+    let i = 0;
+    while (i < vector::length(&vals)) {
+      let a = vector::borrow(&vals, i);
+      stake::mock_performance(vm, *a, 0, 0);
+      i = i + 1;
+    };
   }
 
 
   #[test_only]
-  public fun mock_case_1(vm: &signer, addr: address){
-      assert!(stake::is_valid(addr), 01);
-      stake::mock_performance(vm, addr, 100, 10);
-      let (compliant, _, _) = grade::get_validator_grade(addr);
-      assert!(compliant, 01);
-    }
-
-
-    #[test_only]
-    // did not do enough mining, but did validate.
-    public fun mock_case_4(vm: &signer, addr: address){
-      assert!(stake::is_valid(addr), 01);
-      stake::mock_performance(vm, addr, 0, 100); // 100 failing proposals
-      // let (compliant, _, _, _) = grade::get_validator_grade(addr, 0);
-      let (compliant, _, _) = grade::get_validator_grade(addr);
-      assert!(!compliant, 02);
-    }
-
-    // Mock all nodes being compliant case 1
-    #[test_only]
-    public fun mock_all_vals_good_performance(vm: &signer) {
-
-      let vals = stake::get_current_validators();
-
-      let i = 0;
-      while (i < vector::length(&vals)) {
-
-        let a = vector::borrow(&vals, i);
-        mock_case_1(vm, *a);
-        i = i + 1;
-      };
-
-    }
-
-    //////// PROOF OF FEE ////////
-    #[test_only]
-    public fun pof_default(): (vector<address>, vector<u64>, vector<u64>){
-
-      let vals = stake::get_current_validators();
-
-      let (bids, expiry) = mock_bids(&vals);
-
-      // make all validators pay auction fee
-      // the clearing price in the fibonacci sequence is is 1
-      let (alice_bid, _) = proof_of_fee::current_bid(*vector::borrow(&vals, 0));
-      assert!(alice_bid == 1, 03);
-      (vals, bids, expiry)
-    }
-
-    #[test_only]
-    public fun mock_bids(vals: &vector<address>): (vector<u64>, vector<u64>) {
-      // system_addresses::assert_ol(vm);
-      let bids = vector::empty<u64>();
-      let expiry = vector::empty<u64>();
-      let i = 0;
-      let prev = 0;
-      let fib = 1;
-      while (i < vector::length(vals)) {
-
-        vector::push_back(&mut expiry, 1000);
-        let b = prev + fib;
-        vector::push_back(&mut bids, b);
-
-        let a = vector::borrow(vals, i);
-        let sig = account::create_signer_for_test(*a);
-        // initialize and set.
-        proof_of_fee::pof_update_bid(&sig, b, 1000);
-        prev = fib;
-        fib = b;
-        i = i + 1;
-      };
-
-      (bids, expiry)
-
-    }
-
-    use diem_framework::chain_status;
-    #[test_only]
-    public fun ol_test_genesis(root: &signer) {
-      system_addresses::assert_ol(root);
-      genesis::setup();
-      genesis::test_end_genesis(root);
-
-      let mint_cap = init_coin_impl(root);
-      libra_coin::restore_mint_cap(root, mint_cap);
-
-      assert!(!chain_status::is_genesis(), 0);
-    }
-
-    #[test_only]
-    public fun ol_initialize_coin(root: &signer) {
-      system_addresses::assert_ol(root);
-
-      let mint_cap = init_coin_impl(root);
-
-      libra_coin::restore_mint_cap(root, mint_cap);
-    }
-
-    #[test_only]
-    public fun ol_mint_to(root: &signer, addr: address, amount: u64) {
-      system_addresses::assert_ol(root);
-
-
-      let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
-         libra_coin::extract_mint_cap(root)
-      } else {
-        init_coin_impl(root)
-      };
+  public fun mock_case_1(vm: &signer, addr: address) {
+    assert!(stake::is_valid(addr), 01);
+    stake::mock_performance(vm, addr, 100, 10);
+    let (compliant, _, _) = grade::get_validator_grade(addr);
+    assert!(compliant, 01);
+  }
+
+
+  #[test_only]
+  // did not do enough mining, but did validate.
+  public fun mock_case_4(vm: &signer, addr: address) {
+    assert!(stake::is_valid(addr), 01);
+    stake::mock_performance(vm, addr, 0, 100); // 100 failing proposals
+    // let (compliant, _, _, _) = grade::get_validator_grade(addr, 0);
+    let (compliant, _, _) = grade::get_validator_grade(addr);
+    assert!(!compliant, 02);
+  }
+
+  // Mock all nodes being compliant case 1
+  #[test_only]
+  public fun mock_all_vals_good_performance(vm: &signer) {
+    let vals = stake::get_current_validators();
+    let i = 0;
+    while (i < vector::length(&vals)) {
+      let a = vector::borrow(&vals, i);
+      mock_case_1(vm, *a);
+      i = i + 1;
+    };
+  }
+
+  // Mock some nodes not compliant
+  /*#[test_only]
+  public fun mock_some_vals_bad_performance(vm: &signer, bad_vals: u64) {
+    let vals = stake::get_current_validators();
+    let vals_compliant = vector::length(&vals) - bad_vals;
+    let i = 0;
+    while (i < vals_compliant) {
+      let a = vector::borrow(&vals, i);
+      stake::mock_performance(vm, *a, 0, 100); // 100 failing proposals
+      i = i + 1;
+    };
+  }*/
+
+  //////// PROOF OF FEE ////////
+  #[test_only]
+  public fun pof_default(): (vector<address>, vector<u64>, vector<u64>){
+
+    let vals = stake::get_current_validators();
+
+    let (bids, expiry) = mock_bids(&vals);
+
+    // make all validators pay auction fee
+    // the clearing price in the fibonacci sequence is is 1
+    let (alice_bid, _) = proof_of_fee::current_bid(*vector::borrow(&vals, 0));
+    assert!(alice_bid == 1, 03);
+    (vals, bids, expiry)
+  }
+
+  #[test_only]
+  public fun mock_bids(vals: &vector<address>): (vector<u64>, vector<u64>) {
+    // system_addresses::assert_ol(vm);
+    let bids = vector::empty<u64>();
+    let expiry = vector::empty<u64>();
+    let i = 0;
+    let prev = 0;
+    let fib = 1;
+    while (i < vector::length(vals)) {
+
+      vector::push_back(&mut expiry, 1000);
+      let b = prev + fib;
+      vector::push_back(&mut bids, b);
+
+      let a = vector::borrow(vals, i);
+      let sig = account::create_signer_for_test(*a);
+      // initialize and set.
+      proof_of_fee::pof_update_bid(&sig, b, 1000);
+      prev = fib;
+      fib = b;
+      i = i + 1;
+    };
+
+    (bids, expiry)
+  }
+
+  use diem_framework::chain_status;
+  #[test_only]
+  public fun ol_test_genesis(root: &signer) {
+    system_addresses::assert_ol(root);
+    genesis::setup();
+    genesis::test_end_genesis(root);
+
+    let mint_cap = init_coin_impl(root);
+    libra_coin::restore_mint_cap(root, mint_cap);
+
+    assert!(!chain_status::is_genesis(), 0);
+  }
+
+  #[test_only]
+  public fun ol_initialize_coin(root: &signer) {
+    system_addresses::assert_ol(root);
+
+    let mint_cap = init_coin_impl(root);
+
+    libra_coin::restore_mint_cap(root, mint_cap);
+  }
+
+  #[test_only]
+  public fun ol_mint_to(root: &signer, addr: address, amount: u64) {
+    system_addresses::assert_ol(root);
+
+    let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
+        libra_coin::extract_mint_cap(root)
+    } else {
+      init_coin_impl(root)
+    };
+
+    let c = coin::test_mint(amount, &mint_cap);
+    ol_account::deposit_coins(addr, c);
+
+    let b = coin::balance<LibraCoin>(addr);
+    assert!(b == amount, 0001);
+
+    libra_coin::restore_mint_cap(root, mint_cap);
+  }
+
+  #[test_only]
+  public fun ol_initialize_coin_and_fund_vals(root: &signer, amount: u64,
+  drip: bool) {
+    system_addresses::assert_ol(root);
+
+    let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
+        libra_coin::extract_mint_cap(root)
+    } else {
+      init_coin_impl(root)
+    };
+
+    let vals = stake::get_current_validators();
+    let i = 0;
+    while (i < vector::length(&vals)) {
+      let addr = vector::borrow(&vals, i);
       let c = coin::test_mint(amount, &mint_cap);
-      ol_account::deposit_coins(addr, c);
+      ol_account::deposit_coins(*addr, c);
 
-      let b = coin::balance<LibraCoin>(addr);
+      let b = libra_coin::balance(*addr);
       assert!(b == amount, 0001);
 
-      libra_coin::restore_mint_cap(root, mint_cap);
-    }
-
-    #[test_only]
-    public fun ol_initialize_coin_and_fund_vals(root: &signer, amount: u64,
-    drip: bool) {
-      system_addresses::assert_ol(root);
-
-      let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
-         libra_coin::extract_mint_cap(root)
-      } else {
-        init_coin_impl(root)
-      };
-
-      let vals = stake::get_current_validators();
-      let i = 0;
-
-      while (i < vector::length(&vals)) {
-        let addr = vector::borrow(&vals, i);
-        let c = coin::test_mint(amount, &mint_cap);
-        ol_account::deposit_coins(*addr, c);
-
-        let b = libra_coin::balance(*addr);
-        assert!(b == amount, 0001);
-
-
-        i = i + 1;
-      };
-
-      if (drip) {
-        slow_wallet::slow_wallet_epoch_drip(root, amount);
-      };
-      libra_coin::restore_mint_cap(root, mint_cap);
-    }
-
-    #[test_only]
-    fun init_coin_impl(root: &signer): coin::MintCapability<LibraCoin> {
-      system_addresses::assert_ol(root);
-
-      let (burn_cap, mint_cap) = libra_coin::initialize_for_test_without_aggregator_factory(root);
-      coin::destroy_burn_cap(burn_cap);
-
-      transaction_fee::initialize_fee_collection_and_distribution(root, 0);
-
-      let initial_fees = 1000000 * 100; // coin scaling * 100 coins
-      let tx_fees = coin::test_mint(initial_fees, &mint_cap);
-      transaction_fee::vm_pay_fee(root, @ol_framework, tx_fees);
-      let supply_pre = libra_coin::supply();
-      assert!(supply_pre == initial_fees, ESUPPLY_MISMATCH);
-      libra_coin::test_set_final_supply(root, initial_fees);
-
-      mint_cap
-    }
-
-    #[test_only]
-    public fun personas(): vector<address> {
-      let val_addr = vector::empty<address>();
-
-      vector::push_back(&mut val_addr, @0x1000a);
-      vector::push_back(&mut val_addr, @0x1000b);
-      vector::push_back(&mut val_addr, @0x1000c);
-      vector::push_back(&mut val_addr, @0x1000d);
-      vector::push_back(&mut val_addr, @0x1000e);
-      vector::push_back(&mut val_addr, @0x1000f);
-      vector::push_back(&mut val_addr, @0x10010); // g
-      vector::push_back(&mut val_addr, @0x10011); // h
-      vector::push_back(&mut val_addr, @0x10012); // i
-      vector::push_back(&mut val_addr, @0x10013); // k
-      val_addr
-    }
-
-    #[test_only]
-    /// mock up to 6 validators alice..frank
-    public fun genesis_n_vals(root: &signer, num: u64): vector<address> {
-      system_addresses::assert_ol(root);
-      let framework_sig = account::create_signer_for_test(@diem_framework);
-      ol_test_genesis(&framework_sig);
-      // need to initialize musical chairs separate from genesis.
-      let musical_chairs_default_seats = 10;
-      musical_chairs::initialize(root, musical_chairs_default_seats);
-
-      let val_addr = personas();
-      let i = 0;
-      while (i < num) {
-        let val = vector::borrow(&val_addr, i);
-        let sig = account::create_signer_for_test(*val);
-
-        let (_sk, pk, pop) = stake::generate_identity();
-
-        validator_universe::test_register_validator(root, &pk, &pop, &sig, 100,
-        true, true);
-
-        vouch::init(&sig);
-        vouch::test_set_buddies(*val, val_addr);
-
-        i = i + 1;
-      };
-
-      timestamp::fast_forward_seconds(2); // or else reconfigure wont happen
-      stake::test_reconfigure(root, validator_universe::get_eligible_validators());
-
-      stake::get_current_validators()
-    }
-
-    #[test_only]
-    const EPOCH_DURATION: u64 = 60;
-
-    #[test_only]
-    // NOTE: The order of these is very important.
-    // ol first runs its own accounting at end of epoch with epoch_boundary
-    // Then the stake module needs to update the validators.
-    // the reconfiguration module must run last, since no other
-    // transactions or operations can happen after the reconfig.
-    public fun trigger_epoch(root: &signer) {
-      trigger_epoch_exactly_at(
-        root,
-        reconfiguration::get_current_epoch(),
-        block::get_current_block_height()
-      );
-    }
-
-    public fun trigger_epoch_exactly_at(root: &signer, old_epoch: u64, round: u64) {
-        timestamp::fast_forward_seconds(EPOCH_DURATION);
-
-        epoch_boundary::ol_reconfigure_for_test(root, old_epoch, round);
-
-        // always advance
-        assert!(reconfiguration::get_current_epoch() > old_epoch,
-        EDID_NOT_ADVANCE_EPOCH);
-
-        // epoch helper should always be in sync
-        assert!(reconfiguration::get_current_epoch() ==
-        epoch_helper::get_current_epoch(), 666);
-    }
+      i = i + 1;
+    };
+
+    if (drip) {
+      slow_wallet::slow_wallet_epoch_drip(root, amount);
+    };
+    libra_coin::restore_mint_cap(root, mint_cap);
+  }
+
+  #[test_only]
+  fun init_coin_impl(root: &signer): coin::MintCapability<LibraCoin> {
+    system_addresses::assert_ol(root);
+
+    let (burn_cap, mint_cap) = libra_coin::initialize_for_test_without_aggregator_factory(root);
+    coin::destroy_burn_cap(burn_cap);
+
+    transaction_fee::initialize_fee_collection_and_distribution(root, 0);
+
+    let initial_fees = 1000000 * 100; // coin scaling * 100 coins
+    let tx_fees = coin::test_mint(initial_fees, &mint_cap);
+    transaction_fee::vm_pay_fee(root, @ol_framework, tx_fees);
+    let supply_pre = libra_coin::supply();
+    assert!(supply_pre == initial_fees, ESUPPLY_MISMATCH);
+    libra_coin::test_set_final_supply(root, initial_fees);
+
+    mint_cap
+  }
+
+  #[test_only]
+  public fun personas(): vector<address> {
+    let val_addr = vector::empty<address>();
+    vector::push_back(&mut val_addr, @0x1000a);
+    vector::push_back(&mut val_addr, @0x1000b);
+    vector::push_back(&mut val_addr, @0x1000c);
+    vector::push_back(&mut val_addr, @0x1000d);
+    vector::push_back(&mut val_addr, @0x1000e);
+    vector::push_back(&mut val_addr, @0x1000f);
+    vector::push_back(&mut val_addr, @0x10010); // g
+    vector::push_back(&mut val_addr, @0x10011); // h
+    vector::push_back(&mut val_addr, @0x10012); // i
+    vector::push_back(&mut val_addr, @0x10013); // k
+    val_addr
+  }
+
+  #[test_only]
+  /// mock up to 6 validators alice..frank
+  public fun genesis_n_vals(root: &signer, num: u64): vector<address> {
+    system_addresses::assert_ol(root);
+    let framework_sig = account::create_signer_for_test(@diem_framework);
+    ol_test_genesis(&framework_sig);
+    // need to initialize musical chairs separate from genesis.
+    let musical_chairs_default_seats = 10;
+    musical_chairs::initialize(root, musical_chairs_default_seats);
+
+    let val_addr = personas();
+    let i = 0;
+    while (i < num) {
+      let val = vector::borrow(&val_addr, i);
+      let sig = account::create_signer_for_test(*val);
+      let (_sk, pk, pop) = stake::generate_identity();
+      validator_universe::test_register_validator(root, &pk, &pop, &sig, 100, true, true);
+
+      vouch::init(&sig);
+      vouch::test_set_buddies(*val, val_addr);
+
+      i = i + 1;
+    };
+
+    timestamp::fast_forward_seconds(2); // or else reconfigure wont happen
+    stake::test_reconfigure(root, validator_universe::get_eligible_validators());
+
+    stake::get_current_validators()
+  }
+
+  #[test_only]
+  const EPOCH_DURATION: u64 = 60;
+
+  #[test_only]
+  // NOTE: The order of these is very important.
+  // ol first runs its own accounting at end of epoch with epoch_boundary
+  // Then the stake module needs to update the validators.
+  // the reconfiguration module must run last, since no other
+  // transactions or operations can happen after the reconfig.
+  public fun trigger_epoch(root: &signer) {
+    trigger_epoch_exactly_at(
+      root,
+      reconfiguration::get_current_epoch(),
+      block::get_current_block_height()
+    );
+  }
+
+  public fun trigger_epoch_exactly_at(root: &signer, old_epoch: u64, round: u64) {
+    timestamp::fast_forward_seconds(EPOCH_DURATION);
+    epoch_boundary::ol_reconfigure_for_test(root, old_epoch, round);
+
+    // always advance
+    assert!(reconfiguration::get_current_epoch() > old_epoch,
+    EDID_NOT_ADVANCE_EPOCH);
+
+    // epoch helper should always be in sync
+    assert!(reconfiguration::get_current_epoch() == epoch_helper::get_current_epoch(), 666);
+  }
 
 
   //////// META TESTS ////////
diff --git a/framework/libra-framework/sources/ol_sources/musical_chairs.move b/framework/libra-framework/sources/ol_sources/musical_chairs.move
index fee0eff82..8e3283a8b 100644
--- a/framework/libra-framework/sources/ol_sources/musical_chairs.move
+++ b/framework/libra-framework/sources/ol_sources/musical_chairs.move
@@ -1,240 +1,273 @@
 module ol_framework::musical_chairs {
-    use diem_framework::chain_status;
-    use diem_framework::system_addresses;
-    use diem_framework::stake;
-    use ol_framework::grade;
-    use ol_framework::testnet;
-    use std::fixed_point32;
-    use std::vector;
-
-    // use diem_std::debug::print;
-
-    friend diem_framework::genesis;
-    friend diem_framework::diem_governance;
-    friend ol_framework::epoch_boundary;
-    #[test_only]
-    friend ol_framework::mock;
-
-
-  /// we don't want to play the validator selection games
+  use std::fixed_point32;
+  use std::vector;
+  use diem_framework::chain_status;
+  use diem_framework::system_addresses;
+  use diem_framework::stake;
+  use ol_framework::grade;
+  use ol_framework::testnet;
+  //use diem_std::debug::print;
+
+  friend diem_framework::genesis;
+  friend diem_framework::diem_governance;
+  friend ol_framework::epoch_boundary;
+  #[test_only]
+  friend ol_framework::mock;
+
+  /// We don't want to play the validator selection games
   /// before we're clear out of genesis
   const EPOCH_TO_START_EVAL: u64 = 2;
-
-  /// we can't evaluate the performance of validators
+  /// We can't evaluate the performance of validators
   /// when there are too few rounds committed
   const MINIMUM_ROUNDS_PER_EPOCH: u64 = 1000;
 
-
-    struct Chairs has key {
-        // The number of chairs in the game
-        seats_offered: u64,
-        // TODO: A small history, for future use.
-        history: vector<u64>,
-    }
-
-    // With musical chairs we are trying to estimate
-    // the number of nodes which the network can support
-    // BFT has upperbounds in the low hundreds, but we
-    // don't need to hard code it.
-    // There also needs to be an upper bound so that there is some
-    // competition among validators.
-    // Instead of hard coding a number, and needing to reach social
-    // consensus to change it:  we'll determine the size based on
-    // the network's performance as a whole.
-    // There are many metrics that can be used. For now we'll use
-    // a simple heuristic that is already on chain: compliant node cardinality.
-    // Other heuristics may be explored, so long as the information
-    // reliably committed to the chain.
-
-    // The rules:
-    // Validators who perform, are not guaranteed entry into the
-    // next epoch of the chain. All we are establishing is the ceiling
-    // for validators.
-    // When the 100% of the validators are performing well
-    // the network can safely increase the threshold by 1 node.
-    // We can also say if less that 5% fail, no change happens.
-    // When the network is performing poorly, greater than 5%,
-    // the threshold is reduced not by a predetermined unit, but
-    // to the number of compliant and performant nodes.
-
-    /// Called by root in genesis to initialize the GAS coin
-    public(friend) fun initialize(
-        vm: &signer,
-        genesis_seats: u64,
-    ) {
-        // system_addresses::assert_vm(vm);
-        // TODO: replace with VM
-        system_addresses::assert_ol(vm);
-
-        chain_status::is_genesis();
-        if (exists<Chairs>(@ol_framework)) {
-            return
-        };
-
-        move_to(vm, Chairs {
-            seats_offered: genesis_seats,
-            history: vector::empty<u64>(),
-        });
-    }
-
-    /// get the number of seats in the game
-    /// returns the list of compliant validators and the number of seats
-    /// we should offer in the next epoch
-    /// (compliant_vals, seats_offered)
-    public(friend) fun stop_the_music( // sorry, had to.
-        vm: &signer,
-        epoch: u64,
-        round: u64,
-    ): (vector<address>, u64) acquires Chairs {
-        system_addresses::assert_ol(vm);
-
-        let validators = stake::get_current_validators();
-
-        let (compliant_vals, _non, fail_ratio) =
-        eval_compliance_impl(validators, epoch, round);
-
-        let chairs = borrow_global_mut<Chairs>(@ol_framework);
-
-        let num_compliant_nodes = vector::length(&compliant_vals);
-
-
-        // Error handle. We should not have gone into an epoch where we
-        // had MORE validators than seats offered.
-        // If this happens it's because we are in some kind of a fork condition.
-        // return with no changes
-        if (num_compliant_nodes > chairs.seats_offered) {
-          return (compliant_vals, chairs.seats_offered)
-        };
-
-        // The happiest case. All filled seats performed well in the last epoch
-        if (fixed_point32::is_zero(*&fail_ratio)) { // handle this here to prevent multiplication error below
-          chairs.seats_offered = chairs.seats_offered + 1;
-          return (compliant_vals, chairs.seats_offered)
-        };
-
-        // Conditions under which seats should be one more than the number of compliant nodes(<= 5%)
-        // Sad case. If we are not getting compliance, need to ratchet down the offer of seats in next epoch.
-        // See below find_safe_set_size, how we determine what that number
-        // should be
-        let non_compliance_pct = fixed_point32::multiply_u64(100, *&fail_ratio);
-
-        if (non_compliance_pct > 5) {
-          // If network is bootstrapping don't reduce the seat count below
-          // compliant nodes,
-
-          chairs.seats_offered = num_compliant_nodes;
-
-        } else {
-            // Ok case. If it's between 0 and 5% then we accept that margin as if it was fully compliant
-            chairs.seats_offered = chairs.seats_offered + 1;
-        };
-
-        // catch failure mode
-        // mostly for genesis, or testnets
-        if (chairs.seats_offered < 4) {
-          chairs.seats_offered = 4;
-        };
-
-        (compliant_vals, chairs.seats_offered)
-    }
-
-    // Update seat count to match filled seats post-PoF auction.
-    // in case we were not able to fill all the seats offered
-    // we don't want to keep incrementing from a baseline which we cannot fill
-    // it can spiral out of range.
-    public(friend) fun set_current_seats(framework: &signer, filled_seats: u64): u64 acquires Chairs{
-      system_addresses::assert_diem_framework(framework);
-      let chairs = borrow_global_mut<Chairs>(@ol_framework);
-      chairs.seats_offered = filled_seats;
+  struct Chairs has key {
+    // The number of chairs in the game
+    seats_offered: u64,
+    // TODO: A small history, for future use.
+    history: vector<u64>,
+  }
+
+  // With musical chairs we are trying to estimate
+  // the number of nodes which the network can support
+  // BFT has upperbounds in the low hundreds, but we
+  // don't need to hard code it.
+  // There also needs to be an upper bound so that there is some
+  // competition among validators.
+  // Instead of hard coding a number, and needing to reach social
+  // consensus to change it:  we'll determine the size based on
+  // the network's performance as a whole.
+  // There are many metrics that can be used. For now we'll use
+  // a simple heuristic that is already on chain: compliant node cardinality.
+  // Other heuristics may be explored, so long as the information
+  // reliably committed to the chain.
+
+  // The rules:
+  // Validators who perform, are not guaranteed entry into the
+  // next epoch of the chain. All we are establishing is the ceiling
+  // for validators.
+  // When the 100% of the validators are performing well
+  // the network can safely increase the threshold by 1 node.
+  // We can also say if less that 5% fail, no change happens.
+  // When the network is performing poorly, greater than 5%,
+  // the threshold is reduced not by a predetermined unit, but
+  // to the number of compliant and performant nodes.
+
+  /// Called by root in genesis to initialize the GAS coin
+  public(friend) fun initialize(
+      vm: &signer,
+      genesis_seats: u64,
+  ) {
+    // system_addresses::assert_vm(vm);
+    // TODO: replace with VM
+    system_addresses::assert_ol(vm);
+
+    chain_status::is_genesis();
+    if (exists<Chairs>(@ol_framework)) {
+      return
+    };
+
+    move_to(vm, Chairs {
+      seats_offered: genesis_seats,
+      history: vector::empty<u64>(),
+    });
+  }
+
+  /// get the number of seats in the game
+  /// returns the list of compliant validators and the number of seats
+  /// we should offer in the next epoch
+  /// (compliant_vals, seats_offered)
+  public(friend) fun stop_the_music(
+    vm: &signer,
+    epoch: u64,
+    round: u64,
+  ): (vector<address>, u64) acquires Chairs {
+    system_addresses::assert_ol(vm);
+
+    let chairs = borrow_global_mut<Chairs>(@ol_framework);
+    let validators = stake::get_current_validators();
+    let (compliant_vals, _non, fail_ratio) = eval_compliance_impl(validators, epoch, round);
+    let num_compliant_vals = vector::length(&compliant_vals);
+
+    // Error handle. We should not have gone into an epoch where we had MORE validators than seats offered.
+    // If this happens it's because we are in some kind of a fork condition. Return with no changes
+    if (num_compliant_vals > chairs.seats_offered) {
+      return (compliant_vals, chairs.seats_offered)
+    };
+
+    // Calculate the number of seats to offer
+    chairs.seats_offered = calculate_seats_to_offer(
+      num_compliant_vals,
+      fail_ratio,
       chairs.seats_offered
+    );
+
+    (compliant_vals, chairs.seats_offered)
+  }
+
+  // Case: All seats performed well in the last epoch
+  // - The happiest case: All filled seats performed well in the last epoch.
+  // - Increment the number of seats offered by 1.
+  //
+  // Case: Non-compliance detected
+  // - If non-compliance is detected (> 5%), reduce the number of seats offered to the number of compliant nodes.
+  // - Otherwise, if non-compliance is between 0 and 5%, increment the number of seats offered by 1.
+  //
+  // Error Handling
+  // - If there are more validators than seats offered, it indicates a fork condition. In such a case, return with no changes.
+  //
+  // Bootstrap Mode
+  // - If the network is bootstrapping, ensure that the seat count does not fall below the number of compliant nodes.
+  // - Ensure that the number of seats offered is not less than 4, especially during genesis or in testnets.
+
+  public fun calculate_seats_to_offer(
+    num_compliant_vals: u64,
+    fail_ratio: fixed_point32::FixedPoint32,
+    current_seats_offered: u64
+  ): u64 {
+    let new_seats_offered = if (fixed_point32::is_zero(fail_ratio)) {
+      // The happiest case. All filled seats performed well in the last epoch
+      current_seats_offered + 1
+    } else {
+      let non_compliance_pct = fixed_point32::multiply_u64(100, fail_ratio);
+      if (non_compliance_pct > 5) {
+        // Sad case. If we are not getting compliance, need to ratchet down the offer of seats in the next epoch.
+        // See below find_safe_set_size, how we determine what that number should be
+        num_compliant_vals
+      } else {
+        // Ok case. If it's between 0 and 5% then we accept that margin as if it was fully compliant
+        current_seats_offered + 1
+      }
+    };
+
+    // Catch failure mode mostly for genesis, or testnets
+    if (new_seats_offered < 4) {
+      4
+    } else {
+      new_seats_offered
     }
-
-    // use the Case statistic to determine what proportion of the network is compliant.
-    // private function prevent list DoS.
-    fun eval_compliance_impl(
-      validators: vector<address>,
-      epoch: u64,
-      _round: u64,
-    ): (vector<address>, vector<address>, fixed_point32::FixedPoint32) {
-
-        let val_set_len = vector::length(&validators);
-
-        // skip first epoch, don't evaluate if the network doesn't have sufficient data
-        if (epoch < EPOCH_TO_START_EVAL) return (validators, vector::empty<address>(), fixed_point32::create_from_rational(1, 1));
-
-        let (compliant_nodes, non_compliant_nodes) = grade::eval_compliant_vals(validators);
-
-        let good_len = vector::length(&compliant_nodes) ;
-        let bad_len = vector::length(&non_compliant_nodes);
-
-        // Note: sorry for repetition but necessary for writing tests and debugging.
-        let null = fixed_point32::create_from_raw_value(0);
-        if (good_len > val_set_len) { // safety
-          return (vector::empty(), vector::empty(), null)
-        };
-
-        if (bad_len > val_set_len) { // safety
-          return (vector::empty(), vector::empty(), null)
-        };
-
-        if ((good_len + bad_len) != val_set_len) { // safety
-          return (vector::empty(), vector::empty(), null)
-        };
-
-        let ratio = if (bad_len > 0) {
-          fixed_point32::create_from_rational(bad_len, val_set_len)
-        } else {
-          null
-        };
-
-        (compliant_nodes, non_compliant_nodes, ratio)
-    }
-
-    // Check for genesis, upgrade or recovery mode scenarios
-    // if we are at genesis or otherwise at start of an epoch and don't
-    // have a sufficient amount of history to evaluate nodes
-    // we might reduce the validator set too agressively.
-    // Musical chairs should not evaluate performance with less than 1000 rounds
-    // created on mainnet,
-    // there's something else very wrong in that case.
-
-    fun is_booting_up(epoch: u64, round: u64): bool {
-      !testnet::is_testnet() &&
-      (epoch < EPOCH_TO_START_EVAL ||
-      round < MINIMUM_ROUNDS_PER_EPOCH)
-    }
-
-    //////// GETTERS ////////
-
-    #[view]
-    public fun get_current_seats(): u64 acquires Chairs {
-        borrow_global<Chairs>(@ol_framework).seats_offered
-    }
-
-    //////// TEST HELPERS ////////
-
-    #[test_only]
-    use diem_framework::chain_id;
-
-    #[test_only]
-    public fun test_stop(vm: &signer, epoch: u64, epoch_round: u64): (vector<address>, u64) acquires Chairs {
-      stop_the_music(vm, epoch, epoch_round)
-    }
-
-    #[test_only]
-    public fun test_eval_compliance(root: &signer, validators: vector<address>,
-    epoch: u64, round: u64): (vector<address>, vector<address>,
-    fixed_point32::FixedPoint32) {
-      system_addresses::assert_ol(root);
-      eval_compliance_impl(validators, epoch, round)
-
-    }
-    //////// TESTS ////////
-
-    #[test(vm = @ol_framework)]
-    public entry fun initialize_chairs(vm: signer) acquires Chairs {
-      chain_id::initialize_for_test(&vm, 4);
-      initialize(&vm, 10);
-      assert!(get_current_seats() == 10, 1004);
-    }
+  }
+
+  // Update seat count to match filled seats post-PoF auction.
+  // in case we were not able to fill all the seats offered
+  // we don't want to keep incrementing from a baseline which we cannot fill
+  // it can spiral out of range.
+  public(friend) fun set_current_seats(framework: &signer, filled_seats: u64): u64 acquires Chairs{
+    system_addresses::assert_diem_framework(framework);
+    let chairs = borrow_global_mut<Chairs>(@ol_framework);
+    chairs.seats_offered = filled_seats;
+    chairs.seats_offered
+  }
+
+  // use the Case statistic to determine what proportion of the network is compliant.
+  // private function prevent list DoS.
+  fun eval_compliance_impl(
+    validators: vector<address>,
+    epoch: u64,
+    _round: u64,
+  ): (vector<address>, vector<address>, fixed_point32::FixedPoint32) {
+    let val_set_len = vector::length(&validators);
+
+    // skip first epoch, don't evaluate if the network doesn't have sufficient data
+    if (epoch < EPOCH_TO_START_EVAL) return (validators, vector::empty<address>(), fixed_point32::create_from_rational(1, 1));
+
+    let (compliant_nodes, non_compliant_nodes) = grade::eval_compliant_vals(validators);
+
+    let good_len = vector::length(&compliant_nodes) ;
+    let bad_len = vector::length(&non_compliant_nodes);
+
+    // Note: sorry for repetition but necessary for writing tests and debugging.
+    let null = fixed_point32::create_from_raw_value(0);
+    if (good_len > val_set_len) { // safety
+      return (vector::empty(), vector::empty(), null)
+    };
+
+    if (bad_len > val_set_len) { // safety
+      return (vector::empty(), vector::empty(), null)
+    };
+
+    if ((good_len + bad_len) != val_set_len) { // safety
+      return (vector::empty(), vector::empty(), null)
+    };
+
+    let ratio = if (bad_len > 0) {
+      fixed_point32::create_from_rational(bad_len, val_set_len)
+    } else {
+      null
+    };
+
+    (compliant_nodes, non_compliant_nodes, ratio)
+  }
+
+  // Check for genesis, upgrade or recovery mode scenarios
+  // if we are at genesis or otherwise at start of an epoch and don't
+  // have a sufficient amount of history to evaluate nodes
+  // we might reduce the validator set too agressively.
+  // Musical chairs should not evaluate performance with less than 1000 rounds
+  // created on mainnet,
+  // there's something else very wrong in that case.
+
+  fun is_booting_up(epoch: u64, round: u64): bool {
+    !testnet::is_testnet() &&
+    (epoch < EPOCH_TO_START_EVAL ||
+    round < MINIMUM_ROUNDS_PER_EPOCH)
+  }
+
+  //////// GETTERS ////////
+
+  #[view]
+  public fun get_current_seats(): u64 acquires Chairs {
+      borrow_global<Chairs>(@ol_framework).seats_offered
+  }
+
+  //////// TEST HELPERS ////////
+
+  #[test_only]
+  use diem_framework::chain_id;
+
+  #[test_only]
+  public fun test_stop(vm: &signer, epoch: u64, epoch_round: u64): (vector<address>, u64) acquires Chairs {
+    stop_the_music(vm, epoch, epoch_round)
+  }
+
+  #[test_only]
+  public fun test_eval_compliance(root: &signer, validators: vector<address>,
+  epoch: u64, round: u64): (vector<address>, vector<address>,
+  fixed_point32::FixedPoint32) {
+    system_addresses::assert_ol(root);
+    eval_compliance_impl(validators, epoch, round)
+
+  }
+
+  //////// TESTS ////////
+
+  #[test(vm = @ol_framework)]
+  public entry fun initialize_chairs(vm: signer) acquires Chairs {
+    chain_id::initialize_for_test(&vm, 4);
+    initialize(&vm, 10);
+    assert!(get_current_seats() == 10, 1004);
+  }
+
+  #[test]
+  fun test_calculate_seats_to_offer() {
+    // Test case: all seats are compliant
+    let result = calculate_seats_to_offer(5, fixed_point32::create_from_rational(0, 1), 5);
+    assert!(result == 6, 1001);
+
+    // Test case: more than 5% non-compliance
+    let result = calculate_seats_to_offer(18, fixed_point32::create_from_rational(2, 20), 20);
+    assert!(result == 18, 1002);
+
+    // Test case: 5% non-compliance
+    let result = calculate_seats_to_offer(19, fixed_point32::create_from_rational(1, 20), 20);
+    assert!(result == 21, 1003);
+
+    // Test case: less than 5% non-compliance
+    let result = calculate_seats_to_offer(98, fixed_point32::create_from_rational(2, 100), 100);
+    assert!(result == 101, 1003);
+
+    // Test case: seats offered should not be less than 4
+    let result = calculate_seats_to_offer(2, fixed_point32::create_from_rational(1, 1), 2);
+    assert!(result == 4, 1004);
+  }
 }
diff --git a/framework/libra-framework/sources/ol_sources/tests/musical_chairs.test.move b/framework/libra-framework/sources/ol_sources/tests/musical_chairs.test.move
index e6e6a485b..6305519be 100644
--- a/framework/libra-framework/sources/ol_sources/tests/musical_chairs.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/musical_chairs.test.move
@@ -3,61 +3,59 @@
 /// tests for external apis, and where a dependency cycle with genesis is created.
 module ol_framework::test_musical_chairs {
 
-    use ol_framework::musical_chairs;
-    use ol_framework::mock;
-    use std::vector;
-    use std::fixed_point32;
+  use ol_framework::musical_chairs;
+  use ol_framework::mock;
+  use std::vector;
+  use std::fixed_point32;
 
-    // use diem_std::debug::print;
+  // use diem_std::debug::print;
 
-    #[test(root = @ol_framework)]
-    public entry fun eval_compliance_happy(root: signer) {
+  #[test(root = @ol_framework)]
+  public entry fun eval_compliance_happy(root: signer) {
 
-      let musical_chairs_default_seats = 10;
-      let vals = mock::genesis_n_vals(&root, 5);
-      assert!(vector::length(&vals) == 5, 7357001);
+    let musical_chairs_default_seats = 10;
+    let vals = mock::genesis_n_vals(&root, 5);
+    assert!(vector::length(&vals) == 5, 7357001);
 
-      // all vals compliant
-      mock::mock_all_vals_good_performance(&root);
-      let epoch = 10; // we don't evaluate epoch 0, 1
-      let round = 2000; // we don't evaluate is rounds are below 1000 (one thousand)
-      let (good, bad, ratio) = musical_chairs::test_eval_compliance(&root, vals,
-      epoch, round);
-      assert!(vector::length(&good) == 5, 7357002);
-      assert!(vector::length(&bad) == 0, 7357003);
-      assert!(fixed_point32::is_zero(ratio), 7357004);
+    // all vals compliant
+    mock::mock_all_vals_good_performance(&root);
+    let epoch = 10; // we don't evaluate epoch 0, 1
+    let round = 2000; // we don't evaluate is rounds are below 1000 (one thousand)
+    let (good, bad, ratio) = musical_chairs::test_eval_compliance(&root, vals,
+    epoch, round);
+    assert!(vector::length(&good) == 5, 7357002);
+    assert!(vector::length(&bad) == 0, 7357003);
+    assert!(fixed_point32::is_zero(ratio), 7357004);
 
+    let (outgoing_compliant_set, new_set_size) =
+    musical_chairs::test_stop(&root, epoch, round);
 
-      let (outgoing_compliant_set, new_set_size) =
-      musical_chairs::test_stop(&root, epoch, round);
+    assert!(vector::length(&outgoing_compliant_set) == 5, 7357005);
+    assert!(new_set_size == (musical_chairs_default_seats + 1), 7357006);
+  }
 
+  #[test(root = @ol_framework)]
+  // only one seat opens up
+  public entry fun eval_compliance_one_val(root: signer) {
 
-      assert!(vector::length(&outgoing_compliant_set) == 5, 7357005);
-      assert!(new_set_size == (musical_chairs_default_seats + 1), 7357006);
-    }
+    let vals = mock::genesis_n_vals(&root, 5);
+    assert!(vector::length(&vals) == 5, 7357001);
 
-    #[test(root = @ol_framework)]
-    // only one seat opens up
-    public entry fun eval_compliance_one_val(root: signer) {
+    // all vals compliant
+    mock::mock_case_1(&root, *vector::borrow(&vals, 0));
 
-      let vals = mock::genesis_n_vals(&root, 5);
-      assert!(vector::length(&vals) == 5, 7357001);
+    let epoch = 10; // we don't evaluate epoch 0, 1
+    let round = 2000; // we don't evaluate is rounds are below 1000 (one thousand)
+    let (good, bad, bad_ratio) = musical_chairs::test_eval_compliance(&root,
+    vals, epoch, round);
+    assert!(vector::length(&good) == 1, 7357002);
+    assert!(vector::length(&bad) == 4, 7357003);
+    assert!(!fixed_point32::is_zero(bad_ratio), 7357004);
+    assert!(fixed_point32::create_from_rational(4, 5) == bad_ratio, 7357005);
 
-      // all vals compliant
-      mock::mock_case_1(&root, *vector::borrow(&vals, 0));
 
-      let epoch = 10; // we don't evaluate epoch 0, 1
-      let round = 2000; // we don't evaluate is rounds are below 1000 (one thousand)
-      let (good, bad, bad_ratio) = musical_chairs::test_eval_compliance(&root,
-      vals, epoch, round);
-      assert!(vector::length(&good) == 1, 7357002);
-      assert!(vector::length(&bad) == 4, 7357003);
-      assert!(!fixed_point32::is_zero(bad_ratio), 7357004);
-      assert!(fixed_point32::create_from_rational(4, 5) == bad_ratio, 7357005);
+    let (_outgoing_compliant_set, _new_set_size) =
+    musical_chairs::test_stop(&root, epoch, round);
 
-
-      let (_outgoing_compliant_set, _new_set_size) =
-      musical_chairs::test_stop(&root, epoch, round);
-
-    }
+  }
 }

From 0671c3cb57ca85e38075878d2926ebb0b0456b30 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 12 Jul 2024 11:11:55 -0300
Subject: [PATCH 05/16] gitignore target folders, and move coverage files

---
 .gitignore | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/.gitignore b/.gitignore
index 21446d574..1a8778d90 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,6 @@
 # Generated by Cargo
 # will have compiled files and executables
-/target/
+**/target/
 
 # Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
 # More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
@@ -24,4 +24,8 @@ sccache.log
 *.bpl
 
 # exclude diem dependency
-diem/
\ No newline at end of file
+diem/
+
+# exclude move coverage
+.coverage_map.mvcov
+.trace
\ No newline at end of file

From 0ee11d8665f73281a7478ce9a65cedac07d92ebc Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Tue, 16 Jul 2024 15:49:40 -0300
Subject: [PATCH 06/16] fixes reward thermostat call order - WIP clean up code

---
 .../sources/ol_sources/ancestry.move          |   2 +-
 .../sources/ol_sources/epoch_boundary.move    | 762 +++++++++---------
 .../sources/ol_sources/infra_escrow.move      |  12 +-
 .../sources/ol_sources/mock.move              |  41 +-
 .../sources/ol_sources/pledge_accounts.move   |  88 +-
 .../sources/ol_sources/proof_of_fee.move      |  74 +-
 .../tests/validator_reward.test.move          | 131 +--
 7 files changed, 567 insertions(+), 543 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/ancestry.move b/framework/libra-framework/sources/ol_sources/ancestry.move
index 3bed49f99..0bb89368c 100644
--- a/framework/libra-framework/sources/ol_sources/ancestry.move
+++ b/framework/libra-framework/sources/ol_sources/ancestry.move
@@ -174,7 +174,7 @@ module ol_framework::ancestry {
 
         // now loop through all the accounts again, and check if this target
         // account is related to anyone.
-        let  k = 0;
+        let k = 0;
         while (k < vector::length<address>(&list)) {
           let comparison_acc = vector::borrow(&list, k);
           // skip if you're the same person
diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index 36fb97925..48bf35888 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -1,382 +1,377 @@
 
 module diem_framework::epoch_boundary {
-    use ol_framework::slow_wallet;
-    use ol_framework::musical_chairs;
-    use ol_framework::proof_of_fee;
-    use ol_framework::stake;
-    use ol_framework::libra_coin::LibraCoin;
-    use ol_framework::rewards;
-    use ol_framework::jail;
-    use ol_framework::safe;
-    use ol_framework::burn;
-    use ol_framework::donor_voice_txs;
-    use ol_framework::fee_maker;
-    use ol_framework::infra_escrow;
-    use ol_framework::libra_coin;
-    use ol_framework::match_index;
-    use ol_framework::community_wallet_init;
-    use ol_framework::testnet;
-
-    use diem_framework::account;
-    use diem_framework::reconfiguration;
-    use diem_framework::transaction_fee;
-    use diem_framework::system_addresses;
-    use diem_framework::coin::{Coin};
-    use std::vector;
-    use std::error;
-    use std::string;
-    use std::signer;
-    use diem_framework::create_signer;
-
-    use diem_std::debug::print;
-
-    friend diem_framework::genesis;
-    friend diem_framework::diem_governance;
-    friend diem_framework::block; // for testnet only
-
-    //////// ERRORS ////////
-    /// The transaction fee coin has not been initialized
-    const ETX_FEES_NOT_INITIALIZED: u64 = 0;
-
-    /// Epoch trigger can only be called on mainnet or in smoketests
-    const ETRIGGER_EPOCH_UNAUTHORIZED: u64 = 1;
-
-    /// Epoch is not ready for reconfiguration
-    const ETRIGGER_NOT_READY: u64 = 2;
+  use ol_framework::slow_wallet;
+  use ol_framework::musical_chairs;
+  use ol_framework::proof_of_fee;
+  use ol_framework::stake;
+  use ol_framework::libra_coin::LibraCoin;
+  use ol_framework::rewards;
+  use ol_framework::jail;
+  use ol_framework::safe;
+  use ol_framework::burn;
+  use ol_framework::donor_voice_txs;
+  use ol_framework::fee_maker;
+  use ol_framework::infra_escrow;
+  use ol_framework::libra_coin;
+  use ol_framework::match_index;
+  use ol_framework::community_wallet_init;
+  use ol_framework::testnet;
+
+  use diem_framework::account;
+  use diem_framework::reconfiguration;
+  use diem_framework::transaction_fee;
+  use diem_framework::system_addresses;
+  use diem_framework::coin::{Coin};
+  use std::vector;
+  use std::error;
+  use std::string;
+  use std::signer;
+  use diem_framework::create_signer;
+
+  use diem_std::debug::print;
+
+  friend diem_framework::genesis;
+  friend diem_framework::diem_governance;
+  friend diem_framework::block; // for testnet only
+
+  //////// ERRORS ////////
+  /// The transaction fee coin has not been initialized
+  const ETX_FEES_NOT_INITIALIZED: u64 = 0;
+  /// Epoch trigger can only be called on mainnet or in smoketests
+  const ETRIGGER_EPOCH_UNAUTHORIZED: u64 = 1;
+  /// Epoch is not ready for reconfiguration
+  const ETRIGGER_NOT_READY: u64 = 2;
+  /// Epoch number mismat
+  const ENOT_SAME_EPOCH: u64 = 3;
+
+  /////// Constants ////////
+  /// How many PoF baseline rewards to we set aside for the miners.
+  /// equivalent reward of one seats of the validator set
+  const ORACLE_PROVIDERS_SEATS: u64 = 1;
+
+  /// The VM can set the boundary bit to allow reconfiguration
+  struct BoundaryBit has key {
+    ready: bool,
+    closing_epoch: u64,
+  }
 
-    /// Epoch number mismat
-    const ENOT_SAME_EPOCH: u64 = 3;
+  /// I just checked in, to see what condition my condition was in.
+  struct BoundaryStatus has key, drop {
+    security_bill_count: u64,
+    security_bill_amount: u64,
+    security_bill_success: bool,
+
+    dd_accounts_count: u64,
+    dd_accounts_amount: u64,
+    dd_accounts_success: bool,
+
+    set_fee_makers_success: bool,
+    system_fees_collected: u64,
+    // Process Outgoing
+    outgoing_vals_paid: vector<address>,
+    outgoing_total_reward: u64,
+    outgoing_nominal_reward_to_vals: u64,
+    outgoing_entry_fee: u64,
+    outgoing_clearing_percent: u64,
+    outgoing_vals_success: bool, // TODO
+
+    // Oracle / Tower
+    tower_state_success: bool, // TODO
+    oracle_budget: u64,
+    oracle_pay_count: u64,
+    oracle_pay_amount: u64,
+    oracle_pay_success: bool,
+
+    epoch_burn_fees: u64,
+    epoch_burn_success: bool,
+
+    slow_wallet_drip_amount: u64,
+    slow_wallet_drip_success: bool,
+    // Process Incoming
+    // musical chairs
+    incoming_compliant: vector<address>,
+    incoming_compliant_count: u64,
+    incoming_seats_offered: u64,
+
+    // proof of fee
+    incoming_all_bidders: vector<address>,
+    incoming_only_qualified_bidders: vector<address>,
+    incoming_auction_winners: vector<address>,
+    incoming_filled_seats: u64,
+    incoming_fees: u64,
+    incoming_fees_success: bool,
+
+    // reconfiguration
+    incoming_post_failover_check: vector<address>,
+    incoming_vals_missing_configs: vector<address>,
+    incoming_actual_vals: vector<address>,
+    incoming_final_set_size: u64,
+    incoming_reconfig_success: bool,
+
+    infra_subsidize_amount: u64, // TODO
+    infra_subsidize_success: bool, // TODO
+
+    pof_thermo_success: bool,
+    pof_thermo_increase: bool,
+    pof_thermo_amount: u64,
+  }
 
-    /////// Constants ////////
-    /// how many PoF baseline rewards to we set aside for the miners.
-    /// equivalent reward of one seats of the validator set
-    const ORACLE_PROVIDERS_SEATS: u64 = 1;
+  /// initialize structs, requires both signers since BoundaryBit can only be
+  // accessed by VM
+  public(friend) fun initialize(framework_signer: &signer) {
+    if (!exists<BoundaryStatus>(@ol_framework)){
+      move_to(framework_signer, reset());
+    };
 
-    // the VM can set the boundary bit to allow reconfiguration
-    struct BoundaryBit has key {
-      ready: bool,
-      closing_epoch: u64,
+    // boundary bit can only be written by VM
+    if (!exists<BoundaryBit>(@ol_framework)) {
+      move_to(framework_signer, BoundaryBit {
+        ready: false,
+        closing_epoch: 0,
+      });
     }
+  }
 
-    // I just checked in, to see what condition my condition was in.
-    struct BoundaryStatus has key, drop {
-      security_bill_count: u64,
-      security_bill_amount: u64,
-      security_bill_success: bool,
+  fun reset(): BoundaryStatus {
+    BoundaryStatus {
+      security_bill_count: 0,
+      security_bill_amount: 0,
+      security_bill_success: false,
+
+      dd_accounts_count: 0,
+      dd_accounts_amount: 0,
+      dd_accounts_success: false,
 
-      dd_accounts_count: u64,
-      dd_accounts_amount: u64,
-      dd_accounts_success: bool,
+      set_fee_makers_success: false,
+      system_fees_collected: 0,
 
-      set_fee_makers_success: bool,
-      system_fees_collected: u64,
       // Process Outgoing
-      outgoing_vals_paid: vector<address>,
-      outgoing_total_reward: u64,
-      outgoing_nominal_reward_to_vals: u64,
-      outgoing_entry_fee: u64,
-      outgoing_clearing_percent: u64,
-      outgoing_vals_success: bool, // TODO
+      outgoing_vals_paid: vector::empty(),
+      outgoing_total_reward: 0,
+      outgoing_vals_success: false,
+      outgoing_nominal_reward_to_vals: 0,
+      outgoing_entry_fee: 0,
+      outgoing_clearing_percent: 0,
 
       // Oracle / Tower
-      tower_state_success: bool, // TODO
-      oracle_budget: u64,
-      oracle_pay_count: u64,
-      oracle_pay_amount: u64,
-      oracle_pay_success: bool,
-
-      epoch_burn_fees: u64,
-      epoch_burn_success: bool,
-
-      slow_wallet_drip_amount: u64,
-      slow_wallet_drip_success: bool,
+      tower_state_success: false,
+      oracle_budget: 0,
+      oracle_pay_count: 0,
+      oracle_pay_amount: 0,
+      oracle_pay_success: false,
+      epoch_burn_fees: 0,
+      epoch_burn_success: false,
+
+      slow_wallet_drip_amount: 0,
+      slow_wallet_drip_success: false,
       // Process Incoming
-      // musical chairs
-      incoming_compliant: vector<address>,
-      incoming_compliant_count: u64,
-      incoming_seats_offered: u64,
-
-      // proof of fee
-      incoming_all_bidders: vector<address>,
-      incoming_only_qualified_bidders: vector<address>,
-      incoming_auction_winners: vector<address>,
-      incoming_filled_seats: u64,
-      incoming_fees: u64,
-      incoming_fees_success: bool,
-
-      // reconfiguration
-      incoming_post_failover_check: vector<address>,
-      incoming_vals_missing_configs: vector<address>,
-      incoming_actual_vals: vector<address>,
-      incoming_final_set_size: u64,
-      incoming_reconfig_success: bool,
-
-      infra_subsidize_amount: u64, // TODO
-      infra_subsidize_success: bool, // TODO
-
-      pof_thermo_success: bool,
-      pof_thermo_increase: bool,
-      pof_thermo_amount: u64,
-    }
-
-    /// initialize structs, requires both signers since BoundaryBit can only be
-    // accessed by VM
-    public(friend) fun initialize(framework_signer: &signer) {
-      if (!exists<BoundaryStatus>(@ol_framework)){
-        move_to(framework_signer, reset());
-      };
-
-      // boundary bit can only be written by VM
-      if (!exists<BoundaryBit>(@ol_framework)) {
-        move_to(framework_signer, BoundaryBit {
-          ready: false,
-          closing_epoch: 0,
-        });
-      }
-    }
-
-    fun reset(): BoundaryStatus {
-      BoundaryStatus {
-          security_bill_count: 0,
-          security_bill_amount: 0,
-          security_bill_success: false,
-
-          dd_accounts_count: 0,
-          dd_accounts_amount: 0,
-          dd_accounts_success: false,
-
-          set_fee_makers_success: false,
-          system_fees_collected: 0,
-
-          // Process Outgoing
-          outgoing_vals_paid: vector::empty(),
-          outgoing_total_reward: 0,
-          outgoing_vals_success: false,
-          outgoing_nominal_reward_to_vals: 0,
-          outgoing_entry_fee: 0,
-          outgoing_clearing_percent: 0,
-
-          // Oracle / Tower
-          tower_state_success: false,
-          oracle_budget: 0,
-          oracle_pay_count: 0,
-          oracle_pay_amount: 0,
-          oracle_pay_success: false,
-          epoch_burn_fees: 0,
-          epoch_burn_success: false,
-
-          slow_wallet_drip_amount: 0,
-          slow_wallet_drip_success: false,
-          // Process Incoming
-          incoming_compliant: vector::empty(),
-          incoming_compliant_count: 0,
-          incoming_seats_offered: 0,
-          incoming_filled_seats: 0,
-          incoming_auction_winners: vector::empty(),
-          incoming_all_bidders: vector::empty(),
-          incoming_only_qualified_bidders: vector::empty(),
-          incoming_final_set_size: 0,
-          incoming_fees: 0,
-          incoming_fees_success: false,
-
-          incoming_post_failover_check: vector::empty(),
-          incoming_vals_missing_configs: vector::empty(),
-          incoming_actual_vals: vector::empty(),
-          incoming_reconfig_success: false,
-
-          infra_subsidize_amount: 0,
-          infra_subsidize_success: false,
-
-          pof_thermo_success: false,
-          pof_thermo_increase: false,
-          pof_thermo_amount: 0,
-        }
+      incoming_compliant: vector::empty(),
+      incoming_compliant_count: 0,
+      incoming_seats_offered: 0,
+      incoming_filled_seats: 0,
+      incoming_auction_winners: vector::empty(),
+      incoming_all_bidders: vector::empty(),
+      incoming_only_qualified_bidders: vector::empty(),
+      incoming_final_set_size: 0,
+      incoming_fees: 0,
+      incoming_fees_success: false,
+
+      incoming_post_failover_check: vector::empty(),
+      incoming_vals_missing_configs: vector::empty(),
+      incoming_actual_vals: vector::empty(),
+      incoming_reconfig_success: false,
+
+      infra_subsidize_amount: 0,
+      infra_subsidize_success: false,
+
+      pof_thermo_success: false,
+      pof_thermo_increase: false,
+      pof_thermo_amount: 0,
     }
+  }
 
-    ///TODO: epoch trigger is currently disabled and requires further testing.
-    /// refer to block.move and std::features
-    /// flip the bit to allow the epoch to be reconfigured on any transaction
-    public(friend) fun enable_epoch_trigger(vm_signer: &signer, closing_epoch:
-    u64) acquires BoundaryBit {
-      if (signer::address_of(vm_signer) != @vm_reserved) return;
-
-      // though the VM is calling this, we need the struct to be on
-      // diem_framework. So we need to use create_signer
-
-      let framework_signer = create_signer::create_signer(@ol_framework);
-      if (!exists<BoundaryBit>(@ol_framework)) {
-        // Just like a prayer, your voice can take me there
-        // Just like a muse to me, you are a mystery
-        // Just like a dream, you are not what you seem
-        // Just like a prayer, no choice your voice can take me there...
-        move_to(&framework_signer, BoundaryBit {
-          closing_epoch: closing_epoch,
-          ready: true,
-        })
-      } else {
-        let state = borrow_global_mut<BoundaryBit>(@ol_framework);
-        state.closing_epoch = closing_epoch;
-        state.ready = true;
-      }
-    }
-    /// Once epoch boundary time has passed, and the BoundaryBit set to true
-    /// any user can trigger the epoch boundary.
-    /// Why do this? It's preferable that the VM never trigger any function.
-    /// An abort by the VM will cause a network halt. The same abort, if called
-    /// by a user, would not cause a halt.
-    public(friend) fun trigger_epoch(framework_signer: &signer) acquires BoundaryBit,
-    BoundaryStatus {
-      // COMMIT NOTE: there's no reason to gate this, if th trigger is not
-      // ready (which only happens on Main and Stage, then user will get an error)
-      // assert!(!testnet::is_testnet(), ETRIGGER_EPOCH_MAINNET);
-      // must get root permission from governance.move
-      system_addresses::assert_diem_framework(framework_signer);
-      let _ = can_trigger(); // will abort if false
-
-      // update the state and flip the Bit
-      // note we are using the 0x0 address for BoundaryBit
+  ///TODO: epoch trigger is currently disabled and requires further testing.
+  /// refer to block.move and std::features
+  /// flip the bit to allow the epoch to be reconfigured on any transaction
+  public(friend) fun enable_epoch_trigger(vm_signer: &signer, closing_epoch:
+  u64) acquires BoundaryBit {
+    if (signer::address_of(vm_signer) != @vm_reserved) return;
+
+    // though the VM is calling this, we need the struct to be on
+    // diem_framework. So we need to use create_signer
+
+    let framework_signer = create_signer::create_signer(@ol_framework);
+    if (!exists<BoundaryBit>(@ol_framework)) {
+      // Just like a prayer, your voice can take me there
+      // Just like a muse to me, you are a mystery
+      // Just like a dream, you are not what you seem
+      // Just like a prayer, no choice your voice can take me there...
+      move_to(&framework_signer, BoundaryBit {
+        closing_epoch: closing_epoch,
+        ready: true,
+      })
+    } else {
       let state = borrow_global_mut<BoundaryBit>(@ol_framework);
-      state.ready = false;
-
-      epoch_boundary(framework_signer, state.closing_epoch, 0);
+      state.closing_epoch = closing_epoch;
+      state.ready = true;
     }
+  }
 
-    // utility to use in smoke tests
-    public entry fun smoke_trigger_epoch(framework_signer: &signer) acquires BoundaryBit,
-    BoundaryStatus {
-      // cannot call this on mainnet
-      // only for smoke testing
-      assert!(testnet::is_not_mainnet(), ETRIGGER_EPOCH_UNAUTHORIZED);
-      // must get 0x1 sig from governance.move
-      system_addresses::assert_diem_framework(framework_signer);
-      let state = borrow_global_mut<BoundaryBit>(@ol_framework);
-      epoch_boundary(framework_signer, state.closing_epoch, 0);
-    }
+  /// Once epoch boundary time has passed, and the BoundaryBit set to true
+  /// any user can trigger the epoch boundary.
+  /// Why do this? It's preferable that the VM never trigger any function.
+  /// An abort by the VM will cause a network halt. The same abort, if called
+  /// by a user, would not cause a halt.
+  public(friend) fun trigger_epoch(framework_signer: &signer)
+  acquires BoundaryBit, BoundaryStatus {
+    // COMMIT NOTE: there's no reason to gate this, if th trigger is not
+    // ready (which only happens on Main and Stage, then user will get an error)
+    // assert!(!testnet::is_testnet(), ETRIGGER_EPOCH_MAINNET);
+    // must get root permission from governance.move
+    system_addresses::assert_diem_framework(framework_signer);
+    let _ = can_trigger(); // will abort if false
+
+    // update the state and flip the Bit
+    // note we are using the 0x0 address for BoundaryBit
+    let state = borrow_global_mut<BoundaryBit>(@ol_framework);
+    state.ready = false;
+
+    epoch_boundary(framework_signer, state.closing_epoch, 0);
+  }
 
-    #[view]
-    /// check to see if the epoch Boundary Bit is true
-    public fun can_trigger(): bool acquires BoundaryBit {
-      let state = borrow_global_mut<BoundaryBit>(@ol_framework);
-      assert!(state.ready, ETRIGGER_NOT_READY);
-      assert!(state.closing_epoch == reconfiguration::get_current_epoch(),
-      ENOT_SAME_EPOCH);
-      true
-    }
+  // utility to use in smoke tests
+  public entry fun smoke_trigger_epoch(framework_signer: &signer)
+  acquires BoundaryBit, BoundaryStatus {
+    // cannot call this on mainnet
+    // only for smoke testing
+    assert!(testnet::is_not_mainnet(), ETRIGGER_EPOCH_UNAUTHORIZED);
+    // must get 0x1 sig from governance.move
+    system_addresses::assert_diem_framework(framework_signer);
+    let state = borrow_global_mut<BoundaryBit>(@ol_framework);
+    epoch_boundary(framework_signer, state.closing_epoch, 0);
+  }
 
-    // Contains all of 0L's business logic for end of epoch.
-    // This removed business logic from reconfiguration.move
-    // and prevents dependency cycling.
-    public(friend) fun epoch_boundary(root: &signer, closing_epoch: u64,
-    epoch_round: u64) acquires BoundaryStatus {
-        print(&string::utf8(b"EPOCH BOUNDARY BEGINS"));
-        // either 0x0 or 0x1 can call, but we will always use framework signer
-        system_addresses::assert_ol(root);
-        let root = &create_signer::create_signer(@ol_framework);
-        let status = borrow_global_mut<BoundaryStatus>(@ol_framework);
-
-        print(&string::utf8(b"status reset"));
-        *status = reset();
-
-        // bill root service fees;
-        print(&string::utf8(b"root_service_billing"));
-        root_service_billing(root, status);
-
-        print(&string::utf8(b"process_donor_voice_accounts"));
-        // run the transactions of donor directed accounts
-        let (count, amount, success) = donor_voice_txs::process_donor_voice_accounts(root, closing_epoch);
-        status.dd_accounts_count = count;
-        status.dd_accounts_amount = amount;
-        status.dd_accounts_success = success;
-
-        print(&string::utf8(b"tower_state::reconfig"));
-        // reset fee makers tracking
-        status.set_fee_makers_success = fee_maker::epoch_reset_fee_maker(root);
-
-        print(&string::utf8(b"musical_chairs::stop_the_music"));
-        let (compliant_vals, n_seats) = musical_chairs::stop_the_music(root,
-        closing_epoch, epoch_round);
-        status.incoming_compliant_count = vector::length(&compliant_vals);
-        status.incoming_compliant = compliant_vals;
-        status.incoming_seats_offered = n_seats;
-
-        print(&string::utf8(b"settle_accounts"));
-
-        settle_accounts(root, compliant_vals, status);
-
-        print(&string::utf8(b"slow_wallet::on_new_epoch"));
-        // drip coins
-        let (s_success, s_amount) = slow_wallet::on_new_epoch(root);
-
-        status.slow_wallet_drip_amount = s_amount;
-        status.slow_wallet_drip_success = s_success;
-
-        // ======= THE BOUNDARY =======
-        // And to know yourself
-        // is to be yourself
-        // keeps you walking through these tears.
-
-        print(&string::utf8(b"process_incoming_validators"));
-        process_incoming_validators(root, status, compliant_vals, n_seats);
-
-        print(&string::utf8(b"subsidize_from_infra_escrow"));
-        let (i_success, i_fee) = subsidize_from_infra_escrow(root);
-        status.infra_subsidize_amount = i_fee;
-        status.infra_subsidize_success = i_success;
-
-        print(&string::utf8(b"reward_thermostat"));
-        let (t_success, t_increase, t_amount) =
-        proof_of_fee::reward_thermostat(root);
-        status.pof_thermo_success = t_success;
-        status.pof_thermo_increase = t_increase;
-        status.pof_thermo_amount = t_amount;
-
-        print(&string::utf8(b"EPOCH BOUNDARY END"));
-        print(status);
-        reconfiguration::reconfigure();
+  #[view]
+  /// check to see if the epoch Boundary Bit is true
+  public fun can_trigger(): bool acquires BoundaryBit {
+    let state = borrow_global_mut<BoundaryBit>(@ol_framework);
+    assert!(state.ready, ETRIGGER_NOT_READY);
+    assert!(state.closing_epoch == reconfiguration::get_current_epoch(),
+    ENOT_SAME_EPOCH);
+    true
+  }
+
+  // Contains all of 0L's business logic for end of epoch.
+  // This removed business logic from reconfiguration.move
+  // and prevents dependency cycling.
+  public(friend) fun epoch_boundary(root: &signer, closing_epoch: u64, epoch_round: u64)
+  acquires BoundaryStatus {
+    print(&string::utf8(b"EPOCH BOUNDARY BEGINS"));
+    // either 0x0 or 0x1 can call, but we will always use framework signer
+    system_addresses::assert_ol(root);
+    let root = &create_signer::create_signer(@ol_framework);
+    let status = borrow_global_mut<BoundaryStatus>(@ol_framework);
+
+    print(&string::utf8(b"status reset"));
+    *status = reset();
+
+    // bill root service fees;
+    print(&string::utf8(b"root_service_billing"));
+    root_service_billing(root, status);
+
+    print(&string::utf8(b"process_donor_voice_accounts"));
+    // run the transactions of donor directed accounts
+    let (count, amount, success) = donor_voice_txs::process_donor_voice_accounts(root, closing_epoch);
+    status.dd_accounts_count = count;
+    status.dd_accounts_amount = amount;
+    status.dd_accounts_success = success;
+
+    print(&string::utf8(b"tower_state::reconfig"));
+    // reset fee makers tracking
+    status.set_fee_makers_success = fee_maker::epoch_reset_fee_maker(root);
+
+    print(&string::utf8(b"musical_chairs::stop_the_music"));
+    let (compliant_vals, n_seats) = musical_chairs::stop_the_music(root,
+    closing_epoch, epoch_round);
+    status.incoming_compliant_count = vector::length(&compliant_vals);
+    status.incoming_compliant = compliant_vals;
+    status.incoming_seats_offered = n_seats;
+
+    print(&string::utf8(b"settle_accounts"));
+    settle_accounts(root, compliant_vals, status);
+
+    print(&string::utf8(b"slow_wallet::on_new_epoch"));
+    // drip coins
+    let (s_success, s_amount) = slow_wallet::on_new_epoch(root);
+    status.slow_wallet_drip_amount = s_amount;
+    status.slow_wallet_drip_success = s_success;
+
+    // ======= THE BOUNDARY =======
+    // And to know yourself
+    // is to be yourself
+    // keeps you walking through these tears.
+
+    print(&string::utf8(b"process_incoming_validators"));
+    process_incoming_validators(root, status, compliant_vals, n_seats);
+
+    print(&string::utf8(b"reward_thermostat"));
+    let (t_success, t_increase, t_amount) =
+    proof_of_fee::reward_thermostat(root);
+    status.pof_thermo_success = t_success;
+    status.pof_thermo_increase = t_increase;
+    status.pof_thermo_amount = t_amount;
+
+    print(&string::utf8(b"subsidize_from_infra_escrow"));
+    let (i_success, i_fee) = subsidize_from_infra_escrow(root);
+    status.infra_subsidize_amount = i_fee;
+    status.infra_subsidize_success = i_success;
+
+    print(&string::utf8(b"EPOCH BOUNDARY END"));
+    print(status);
+    reconfiguration::reconfigure();
   }
 
   /// withdraw coins and settle accounts for validators and oracles
   /// returns the list of compliant_vals
   fun settle_accounts(root: &signer, compliant_vals: vector<address>, status: &mut BoundaryStatus): vector<address> {
-        assert!(transaction_fee::is_fees_collection_enabled(), error::invalid_state(ETX_FEES_NOT_INITIALIZED));
-
-        if (transaction_fee::system_fees_collected() > 0) {
-          let all_fees = transaction_fee::root_withdraw_all(root);
-          status.system_fees_collected = libra_coin::value(&all_fees);
-
-          // Nominal fee set by the PoF thermostat
-          let (nominal_reward_to_vals, entry_fee, clearing_percent, _ ) = proof_of_fee::get_consensus_reward();
-          status.outgoing_nominal_reward_to_vals = nominal_reward_to_vals;
-          status.outgoing_entry_fee = entry_fee;
-          status.outgoing_clearing_percent = clearing_percent;
-
-          // validators get the gross amount of the reward, since they already paid to enter. This results in a net payment equivalent to:
-          // nominal_reward_to_vals - entry_fee.
-          let (compliant_vals, total_reward) = process_outgoing_validators(root, &mut all_fees, nominal_reward_to_vals, compliant_vals);
-
-          status.outgoing_vals_paid = compliant_vals;
-          status.outgoing_total_reward = total_reward;
-
-          // check that the sustem fees collect were greater than reward
-          status.outgoing_vals_success = (status.system_fees_collected >= total_reward);
-          // check the the total actually deposited/paid is the expected amount
-          if (nominal_reward_to_vals > 0) { // check for zero
-            status.outgoing_vals_success = total_reward == (vector::length(&compliant_vals) * nominal_reward_to_vals)
-          };
-
-          // Commit note: deprecated with tower mining.
-
-          // remainder gets burnt according to fee maker preferences
-          let (b_success, b_fees) = burn::epoch_burn_fees(root, &mut all_fees);
-          status.epoch_burn_success = b_success;
-          status.epoch_burn_fees = b_fees;
-
-          // coin can finally be destroyed. Up to here we have been extracting from a mutable.
-          // It's possible there might be some dust, that should get burned
-          burn::burn_and_track(all_fees);
-        };
+    assert!(transaction_fee::is_fees_collection_enabled(), error::invalid_state(ETX_FEES_NOT_INITIALIZED));
+
+    if (transaction_fee::system_fees_collected() > 0) {
+      let all_fees = transaction_fee::root_withdraw_all(root);
+      status.system_fees_collected = libra_coin::value(&all_fees);
+
+      // Nominal fee set by the PoF thermostat
+      let (nominal_reward_to_vals, entry_fee, clearing_percent, _ ) = proof_of_fee::get_consensus_reward();
+      status.outgoing_nominal_reward_to_vals = nominal_reward_to_vals;
+      status.outgoing_entry_fee = entry_fee;
+      status.outgoing_clearing_percent = clearing_percent;
+
+      // validators get the gross amount of the reward, since they already paid to enter. This results in a net payment equivalent to:
+      // nominal_reward_to_vals - entry_fee.
+      let (compliant_vals, total_reward) = process_outgoing_validators(root, &mut all_fees, nominal_reward_to_vals, compliant_vals);
+      status.outgoing_vals_paid = compliant_vals;
+      status.outgoing_total_reward = total_reward;
+
+      // check that the system fees collect were greater than reward
+      status.outgoing_vals_success = (status.system_fees_collected >= total_reward);
+      // check the the total actually deposited/paid is the expected amount
+      if (nominal_reward_to_vals > 0) { // check for zero
+        status.outgoing_vals_success = total_reward == (vector::length(&compliant_vals) * nominal_reward_to_vals)
+      };
 
-        compliant_vals
+      // Commit note: deprecated with tower mining.
+
+      // remainder gets burnt according to fee maker preferences
+      let (b_success, b_fees) = burn::epoch_burn_fees(root, &mut all_fees);
+      status.epoch_burn_success = b_success;
+      status.epoch_burn_fees = b_fees;
+
+      // coin can finally be destroyed. Up to here we have been extracting from a mutable.
+      // It's possible there might be some dust, that should get burned
+      burn::burn_and_track(all_fees);
+    };
+
+    compliant_vals
   }
 
 
@@ -407,7 +402,7 @@ module diem_framework::epoch_boundary {
           let user_coin = libra_coin::extract(reward_budget, reward_per);
           reward_deposited = reward_deposited + libra_coin::value(&user_coin);
           rewards::process_single(root, *addr, user_coin, 1);
-        }
+        };
       };
 
       i = i + 1;
@@ -427,7 +422,6 @@ module diem_framework::epoch_boundary {
     status.incoming_only_qualified_bidders = only_qualified_bidders;
     status.incoming_auction_winners = auction_winners;
 
-
     let post_failover_check = stake::check_failover_rules(auction_winners, n_seats);
     status.incoming_post_failover_check = post_failover_check;
 
@@ -449,25 +443,25 @@ module diem_framework::epoch_boundary {
 
   // set up rewards subsidy for coming epoch
   fun subsidize_from_infra_escrow(root: &signer): (bool, u64) {
-      system_addresses::assert_ol(root);
-      let (reward_per, _, _, _ ) = proof_of_fee::get_consensus_reward();
-      let vals = stake::get_current_validators();
-      let count_vals = vector::length(&vals);
-      count_vals = count_vals + ORACLE_PROVIDERS_SEATS;
-      let total_epoch_budget = count_vals * reward_per;
-      infra_escrow::epoch_boundary_collection(root,
-      total_epoch_budget)
+    system_addresses::assert_ol(root);
+    let (reward_per, _, _, _ ) = proof_of_fee::get_consensus_reward();
+    let vals = stake::get_current_validators();
+    let count_vals = vector::length(&vals);
+    count_vals = count_vals + ORACLE_PROVIDERS_SEATS;
+    let total_epoch_budget = count_vals * reward_per;
+    print(&999);
+    print(&total_epoch_budget);
+    infra_escrow::epoch_boundary_collection(root, total_epoch_budget)
   }
 
-    /// check qualifications of community wallets
-    /// need to check every epoch so that wallets who no longer qualify are not biasing the Match algorithm.
-    fun reset_match_index_ratios(root: &signer) {
-      system_addresses::assert_ol(root);
-      let list = match_index::get_address_list();
-      let good = community_wallet_init::get_qualifying(list);
-      match_index::calc_ratios(root, good);
-    }
-
+  /// check qualifications of community wallets
+  /// need to check every epoch so that wallets who no longer qualify are not biasing the Match algorithm.
+  fun reset_match_index_ratios(root: &signer) {
+    system_addresses::assert_ol(root);
+    let list = match_index::get_address_list();
+    let good = community_wallet_init::get_qualifying(list);
+    match_index::calc_ratios(root, good);
+  }
 
   // all services the root collective security is billing for
   fun root_service_billing(vm: &signer, status: &mut BoundaryStatus) {
@@ -505,27 +499,27 @@ module diem_framework::epoch_boundary {
   #[test_only]
   public fun ol_reconfigure_for_test(vm: &signer, closing_epoch: u64,
   epoch_round: u64) acquires BoundaryStatus {
-      use diem_framework::system_addresses;
-      use diem_framework::randomness;
+    use diem_framework::system_addresses;
+    use diem_framework::randomness;
 
-      system_addresses::assert_ol(vm);
-      randomness::initialize_for_testing(vm);
-      epoch_boundary(vm, closing_epoch, epoch_round);
+    system_addresses::assert_ol(vm);
+    randomness::initialize_for_testing(vm);
+    epoch_boundary(vm, closing_epoch, epoch_round);
   }
 
   #[test_only]
   public fun test_set_boundary_ready(framework: &signer, closing_epoch: u64) acquires
   BoundaryBit {
-      system_addresses::assert_ol(framework);
-      // don't check for "testnet" here, otherwise we can't test the production
-      // settings
-      let vm_signer = create_signer::create_signer(@vm_reserved);
-      enable_epoch_trigger(&vm_signer, closing_epoch);
+    system_addresses::assert_ol(framework);
+    // don't check for "testnet" here, otherwise we can't test the production
+    // settings
+    let vm_signer = create_signer::create_signer(@vm_reserved);
+    enable_epoch_trigger(&vm_signer, closing_epoch);
   }
 
   #[test_only]
   public fun test_trigger(vm: &signer) acquires BoundaryStatus, BoundaryBit {
-      // don't check for "testnet" here, otherwise we can't test the production settings
-      trigger_epoch(vm);
+    // don't check for "testnet" here, otherwise we can't test the production settings
+    trigger_epoch(vm);
   }
 }
diff --git a/framework/libra-framework/sources/ol_sources/infra_escrow.move b/framework/libra-framework/sources/ol_sources/infra_escrow.move
index c41061c5a..c9c121e5d 100644
--- a/framework/libra-framework/sources/ol_sources/infra_escrow.move
+++ b/framework/libra-framework/sources/ol_sources/infra_escrow.move
@@ -10,21 +10,21 @@
 ///////////////////////////////////////////////////////////////////////////
 
 module ol_framework::infra_escrow{
+    use std::error;
     use std::option::{Self, Option};
+    use diem_framework::coin;
+    use diem_framework::transaction_fee;
     use diem_framework::system_addresses;
+    use ol_framework::ol_account;
     use ol_framework::libra_coin::LibraCoin;
     use ol_framework::pledge_accounts;
     // use ol_framework::slow_wallet;
-    use ol_framework::ol_account;
-    use diem_framework::coin;
-    use diem_framework::transaction_fee;
     // use std::fixed_point32;
     // use std::signer;
-    use std::error;
-    // use diem_std::debug::print;
+     use diem_std::debug::print;
 
-    friend ol_framework::epoch_boundary;
     friend diem_framework::genesis;
+    friend ol_framework::epoch_boundary;
 
     const EGENESIS_REWARD: u64 = 0;
     /// for use on genesis, creates the infra escrow pledge policy struct
diff --git a/framework/libra-framework/sources/ol_sources/mock.move b/framework/libra-framework/sources/ol_sources/mock.move
index 2ff072302..006f5288e 100644
--- a/framework/libra-framework/sources/ol_sources/mock.move
+++ b/framework/libra-framework/sources/ol_sources/mock.move
@@ -1,26 +1,28 @@
 // Some fixtures are complex and are repeatedly needed
 #[test_only]
 module ol_framework::mock {
+  use std::vector;
+  use std::signer;
+  use diem_framework::coin;
+  use diem_framework::block;
   use diem_framework::stake;
+  use diem_framework::account;
+  use diem_framework::genesis;
+  use diem_framework::timestamp;
   use diem_framework::reconfiguration;
+  use diem_framework::system_addresses;
+  use diem_framework::transaction_fee;
   use ol_framework::grade;
   use ol_framework::vouch;
-  use std::vector;
-  use diem_framework::genesis;
-  use diem_framework::account;
   use ol_framework::slow_wallet;
   use ol_framework::proof_of_fee;
   use ol_framework::validator_universe;
-  use diem_framework::timestamp;
-  use diem_framework::system_addresses;
   use ol_framework::epoch_boundary;
-  use diem_framework::coin;
   use ol_framework::libra_coin::{Self, LibraCoin};
-  use diem_framework::transaction_fee;
   use ol_framework::ol_account;
   use ol_framework::epoch_helper;
   use ol_framework::musical_chairs;
-  use diem_framework::block;
+  use ol_framework::pledge_accounts;
 
   // use diem_std::debug::print;
 
@@ -158,7 +160,7 @@ module ol_framework::mock {
     system_addresses::assert_ol(root);
 
     let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
-        libra_coin::extract_mint_cap(root)
+      libra_coin::extract_mint_cap(root)
     } else {
       init_coin_impl(root)
     };
@@ -178,7 +180,7 @@ module ol_framework::mock {
     system_addresses::assert_ol(root);
 
     let mint_cap = if (coin::is_coin_initialized<LibraCoin>()) {
-        libra_coin::extract_mint_cap(root)
+      libra_coin::extract_mint_cap(root)
     } else {
       init_coin_impl(root)
     };
@@ -211,11 +213,26 @@ module ol_framework::mock {
 
     transaction_fee::initialize_fee_collection_and_distribution(root, 0);
 
-    let initial_fees = 1000000 * 100; // coin scaling * 100 coins
+    let initial_fees = 5_000_000; // coin scaling * 100 coins
     let tx_fees = coin::test_mint(initial_fees, &mint_cap);
     transaction_fee::vm_pay_fee(root, @ol_framework, tx_fees);
+
+    // Forge Bruce
+    let fortune = 100_000_000_000;
+    let bruce_address = @0xBA7;
+    ol_account::create_account(root, bruce_address);
+
+    // Bruce mints a fortune
+    let bruce = account::create_signer_for_test(bruce_address);
+    let fortune_mint = coin::test_mint(fortune, &mint_cap);
+    ol_account::deposit_coins(bruce_address, fortune_mint);
+
+    // Bruce funds infra escrow
+    let framework = signer::address_of(root);
+    pledge_accounts::user_pledge(&bruce, framework, 37_000_000_000);
+
     let supply_pre = libra_coin::supply();
-    assert!(supply_pre == initial_fees, ESUPPLY_MISMATCH);
+    assert!(supply_pre == (initial_fees + fortune), ESUPPLY_MISMATCH);
     libra_coin::test_set_final_supply(root, initial_fees);
 
     mint_cap
diff --git a/framework/libra-framework/sources/ol_sources/pledge_accounts.move b/framework/libra-framework/sources/ol_sources/pledge_accounts.move
index 1aebfd115..c25cf387c 100644
--- a/framework/libra-framework/sources/ol_sources/pledge_accounts.move
+++ b/framework/libra-framework/sources/ol_sources/pledge_accounts.move
@@ -51,12 +51,15 @@
         use diem_framework::coin;
         use diem_framework::system_addresses;
 
-        // use diem_std::debug::print;
+        //use diem_std::debug::print;
 
         friend ol_framework::infra_escrow;
         friend ol_framework::genesis_migration;
         friend ol_framework::genesis;
 
+        #[test_only]
+        friend ol_framework::mock;
+
         /// no policy at this address
         const ENO_BENEFICIARY_POLICY: u64 = 1;
         /// there is a non zero balance
@@ -160,7 +163,7 @@
           sig: &signer,
           address_of_beneficiary: address,
           pledge: coin::Coin<LibraCoin>
-          ) acquires MyPledges, BeneficiaryPolicy {
+        ) acquires MyPledges, BeneficiaryPolicy {
           maybe_initialize_my_pledges(sig);
           assert!(exists<BeneficiaryPolicy>(address_of_beneficiary), error::invalid_state(ENO_BENEFICIARY_POLICY));
           let sender_addr = signer::address_of(sig);
@@ -248,57 +251,56 @@
         // withdraw an amount from all pledge accounts. Check first that there are remaining funds before attempting to withdraw.
         public(friend) fun withdraw_from_all_pledge_accounts(sig_beneficiary: &signer, amount: u64): option::Option<coin::Coin<LibraCoin>> acquires MyPledges, BeneficiaryPolicy {
 
-            let address_of_beneficiary = signer::address_of(sig_beneficiary);
-            if (!exists<BeneficiaryPolicy>(address_of_beneficiary)) {
-              return option::none<coin::Coin<LibraCoin>>()
-            };
-
-            let pledgers = *&borrow_global<BeneficiaryPolicy>(address_of_beneficiary).pledgers;
-            let amount_available = *&borrow_global<BeneficiaryPolicy>(address_of_beneficiary).amount_available;
-
-            if (amount_available == 0 || amount == 0) {
-              return option::none<coin::Coin<LibraCoin>>()
-            };
-
-            let pct_withdraw = fixed_point64::create_from_rational((amount as u128), (amount_available as u128));
-
-            let i = 0;
-            let all_coins = option::none<coin::Coin<LibraCoin>>();
-            while (i < vector::length(&pledgers)) {
-                let pledge_account = *vector::borrow(&pledgers, i);
-
-                // DANGER: this is a private function that changes balances.
-                if (!exists<MyPledges>(pledge_account)) continue;
+          let address_of_beneficiary = signer::address_of(sig_beneficiary);
+          if (!exists<BeneficiaryPolicy>(address_of_beneficiary)) {
+            return option::none<coin::Coin<LibraCoin>>()
+          };
 
-                let c = withdraw_pct_from_one_pledge_account(&address_of_beneficiary, &pledge_account, &pct_withdraw);
-                // GROSS: dealing with options in Move.
-                // TODO: find a better way.
-                if (option::is_none(&all_coins) && option::is_some(&c)) {
+          let pledgers = *&borrow_global<BeneficiaryPolicy>(address_of_beneficiary).pledgers;
+          let amount_available = *&borrow_global<BeneficiaryPolicy>(address_of_beneficiary).amount_available;
 
-                  let coin =  option::extract(&mut c);
-                  option::fill(&mut all_coins, coin);
-                  option::destroy_none(c);
-                } else if (option::is_some(&c)) {
+          if (amount_available == 0 || amount == 0) {
+            return option::none<coin::Coin<LibraCoin>>()
+          };
 
-                  let temp = option::extract(&mut all_coins);
-                  let coin =  option::extract(&mut c);
-                  libra_coin::merge(&mut temp, coin);
-                  option::destroy_none(all_coins);
-                  all_coins = option::some(temp);
-                  option::destroy_none(c);
-                } else {
-                  option::destroy_none(c);
-                };
+          let pct_withdraw = fixed_point64::create_from_rational((amount as u128), (amount_available as u128));
 
-                i = i + 1;
+          let i = 0;
+          let all_coins = option::none<coin::Coin<LibraCoin>>();
+          while (i < vector::length(&pledgers)) {
+            let pledge_account = *vector::borrow(&pledgers, i);
+
+            // DANGER: this is a private function that changes balances.
+            if (!exists<MyPledges>(pledge_account)) continue;
+
+            let c = withdraw_pct_from_one_pledge_account(&address_of_beneficiary, &pledge_account, &pct_withdraw);
+            // GROSS: dealing with options in Move.
+            // TODO: find a better way.
+            if (option::is_none(&all_coins) && option::is_some(&c)) {
+
+              let coin =  option::extract(&mut c);
+              option::fill(&mut all_coins, coin);
+              option::destroy_none(c);
+            } else if (option::is_some(&c)) {
+
+              let temp = option::extract(&mut all_coins);
+              let coin =  option::extract(&mut c);
+              libra_coin::merge(&mut temp, coin);
+              option::destroy_none(all_coins);
+              all_coins = option::some(temp);
+              option::destroy_none(c);
+            } else {
+              option::destroy_none(c);
             };
 
+            i = i + 1;
+          };
+
           all_coins
         }
 
 
-        fun get_user_pledges(account: &address): vector<address> acquires
-        MyPledges {
+        fun get_user_pledges(account: &address): vector<address> acquires MyPledges {
           let list = vector::empty<address>();
           if (!exists<MyPledges>(*account)) return list;
           let user_state = borrow_global<MyPledges>(*account);
diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index 7ba4351f9..03bf9b22b 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -148,24 +148,24 @@ module ol_framework::proof_of_fee {
     outgoing_compliant_set: &vector<address>,
     mc_set_size: u64 // musical chairs set size suggestion
   ): (vector<address>, vector<address>, vector<address>, u64) acquires ProofOfFeeAuction, ConsensusReward {
-      system_addresses::assert_ol(vm);
+    system_addresses::assert_ol(vm);
 
-      let all_bidders = get_bidders(false);
-      let only_qualified_bidders = get_bidders(true);
+    let all_bidders = get_bidders(false);
+    let only_qualified_bidders = get_bidders(true);
 
-      // Calculate the final set size considering the number of compliant validators,
-      // number of qualified bidders, and musical chairs set size suggestion
-      let final_set_size = calculate_final_set_size(
-        vector::length(outgoing_compliant_set),
-        vector::length(&only_qualified_bidders),
-        mc_set_size);
+    // Calculate the final set size considering the number of compliant validators,
+    // number of qualified bidders, and musical chairs set size suggestion
+    let final_set_size = calculate_final_set_size(
+      vector::length(outgoing_compliant_set),
+      vector::length(&only_qualified_bidders),
+      mc_set_size);
 
-      // This is the core of the mechanism, the uniform price auction
-      // the winners of the auction will be the validator set.
-      // Other lists are created for audit purposes of the BoundaryStatus
-      let (auction_winners, entry_fee, _clearing_bid, _proven, _unproven) = fill_seats_and_get_price(vm, final_set_size, &only_qualified_bidders, outgoing_compliant_set);
+    // This is the core of the mechanism, the uniform price auction
+    // the winners of the auction will be the validator set.
+    // Other lists are created for audit purposes of the BoundaryStatus
+    let (auction_winners, entry_fee, _clearing_bid, _proven, _unproven) = fill_seats_and_get_price(vm, final_set_size, &only_qualified_bidders, outgoing_compliant_set);
 
-      (auction_winners, all_bidders, only_qualified_bidders, entry_fee)
+    (auction_winners, all_bidders, only_qualified_bidders, entry_fee)
   }
 
 
@@ -436,12 +436,12 @@ module ol_framework::proof_of_fee {
       (i < vector::length(&sorted_vals_by_bid))
     ) {
       let val = vector::borrow(&sorted_vals_by_bid, i);
-        if (!account::exists_at(*val)) {
-          i = i + 1;
-          continue
-        };
+      if (!account::exists_at(*val)) {
+        i = i + 1;
+        continue
+      };
       // check if a proven node
-      // NOTE: if the top bidders all all "proven" nodes, then there will
+      // NOTE: if the top bidders are all "proven" nodes, then there will
       // be no reason to add an unproven. Unproven nodes will only
       // be picked if they have bids higher than the bottom 1/3 bids of the proven nodes
       if (vector::contains(proven_nodes, val)) {
@@ -532,6 +532,7 @@ module ol_framework::proof_of_fee {
   fun bid_as_fixedpoint(bid_pct: u64): fixed_point32::FixedPoint32 {
     fixed_point32::create_from_rational(bid_pct, 1000)
   }
+
   /// Adjust the reward at the end of the epoch
   /// as described in the paper, the epoch reward needs to be adjustable
   /// given that the implicit bond needs to be sufficient, eg 5-10x the reward.
@@ -670,8 +671,6 @@ module ol_framework::proof_of_fee {
   }
 
   //////////////// GETTERS ////////////////
-  // get the current bid for a validator
-
 
   #[view]
   /// get the baseline reward from ConsensusReward
@@ -681,6 +680,7 @@ module ol_framework::proof_of_fee {
     return (b.nominal_reward, b.entry_fee, b.clearing_bid, b.median_win_bid)
   }
 
+  // get the current bid for a validator
   // CONSENSUS CRITICAL
   // ALL EYES ON THIS
   // Proof of Fee returns the current bid of the validator during the auction for upcoming epoch seats.
@@ -714,19 +714,19 @@ module ol_framework::proof_of_fee {
 
   // Get the top N validators by bid, this is FILTERED by default
   public(friend) fun top_n_accounts(account: &signer, n: u64, unfiltered: bool): vector<address> acquires ProofOfFeeAuction, ConsensusReward {
-      system_addresses::assert_vm(account);
+    system_addresses::assert_vm(account);
 
-      let eligible_validators = get_bidders(unfiltered);
-      let len = vector::length<address>(&eligible_validators);
-      if(len <= n) return eligible_validators;
+    let eligible_validators = get_bidders(unfiltered);
+    let len = vector::length<address>(&eligible_validators);
+    if(len <= n) return eligible_validators;
 
-      let diff = len - n;
-      while(diff > 0){
-        vector::pop_back(&mut eligible_validators);
-        diff = diff - 1;
-      };
+    let diff = len - n;
+    while(diff > 0){
+      vector::pop_back(&mut eligible_validators);
+      diff = diff - 1;
+    };
 
-      eligible_validators
+    eligible_validators
   }
 
 
@@ -755,13 +755,11 @@ module ol_framework::proof_of_fee {
   /// Note that the validator will not be bidding on any future
   /// epochs if they retract their bid. The must set a new bid.
   fun retract_bid(account_sig: &signer) acquires ProofOfFeeAuction {
-
     let acc = signer::address_of(account_sig);
     if (!exists<ProofOfFeeAuction>(acc)) {
       init(account_sig);
     };
 
-
     let pof = borrow_global_mut<ProofOfFeeAuction>(acc);
     let this_epoch = epoch_helper::get_current_epoch();
 
@@ -772,7 +770,6 @@ module ol_framework::proof_of_fee {
     // assert!(this_epoch > pof.last_epoch_retracted, error::ol_tx(EABOVE_RETRACT_LIMIT));
     //////// LEAVE COMMENTED. Code for a potential upgrade. ////////
 
-
     pof.epoch_expiration = 0;
     pof.bid = 0;
     pof.last_epoch_retracted = this_epoch;
@@ -952,10 +949,8 @@ module ol_framework::proof_of_fee {
     assert!(reward == 105, 1003);
     assert!(clear_percent == 50, 1004);
     assert!(median_bid == 33, 1005);
-
   }
 
-
   // Scenario: The reward is too low during 5 days (short window). People are not bidding very high.
   #[test(vm = @ol_framework)]
   fun thermostat_increase_long(vm: signer) acquires ConsensusReward {
@@ -977,7 +972,6 @@ module ol_framework::proof_of_fee {
       i = i + 1;
     };
 
-
     test_mock_reward(
       &vm,
       100,
@@ -1000,10 +994,8 @@ module ol_framework::proof_of_fee {
     assert!(reward == 110, 1003);
     assert!(clear_percent == 50, 1004);
     assert!(median_bid == 33, 1005);
-
   }
 
-
   // Scenario: The reward is too high during 5 days (short window). People are bidding over 95% of the baseline fee.
   #[test(vm = @ol_framework)]
   fun thermostat_decrease_short(vm: signer) acquires ConsensusReward {
@@ -1024,7 +1016,6 @@ module ol_framework::proof_of_fee {
       i = i + 1;
     };
 
-
     test_mock_reward(
       &vm,
       100,
@@ -1047,7 +1038,6 @@ module ol_framework::proof_of_fee {
     assert!(reward == 95, 1000);
     assert!(clear_percent == 50, 1004);
     assert!(median_bid == 33, 1005);
-
   }
 
   // Scenario: The reward is too low during 5 days (short window). People are not bidding very high.
@@ -1093,7 +1083,6 @@ module ol_framework::proof_of_fee {
     assert!(reward == 90, 1003);
     assert!(clear_percent == 50, 1004);
     assert!(median_bid == 33, 1005);
-
   }
 
   // #[test(vm = @ol_framework)]
@@ -1311,7 +1300,6 @@ module ol_framework::proof_of_fee {
   }
 
 
-
   // Shuffle Tests
 
   #[test]
diff --git a/framework/libra-framework/sources/ol_sources/tests/validator_reward.test.move b/framework/libra-framework/sources/ol_sources/tests/validator_reward.test.move
index 8d41753b5..bcccaba78 100644
--- a/framework/libra-framework/sources/ol_sources/tests/validator_reward.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/validator_reward.test.move
@@ -4,6 +4,7 @@
 module ol_framework::test_reconfiguration {
   use std::vector;
   use diem_framework::stake;
+  use diem_framework::transaction_fee;
   // use diem_framework::coin;
   use ol_framework::mock;
   use ol_framework::testnet;
@@ -12,90 +13,112 @@ module ol_framework::test_reconfiguration {
   use diem_framework::reconfiguration;
   use ol_framework::epoch_helper;
   use ol_framework::ol_account;
+  use ol_framework::infra_escrow;
 
-  // use diem_std::debug::print;
+   use diem_std::debug::print;
 
   // Scenario: all genesis validators make it to next epoch
   #[test(root = @ol_framework)]
   fun reconfig_reward_happy_case(root: signer) {
-      let vals = mock::genesis_n_vals(&root, 5);
+    let vals = mock::genesis_n_vals(&root, 5);
 
+    mock::pof_default();
+    assert!(vector::length(&vals) == 5, 7357001);
+    let vals = stake::get_current_validators();
+    assert!(vector::length(&vals) == 5, 7357002);
+    // all vals compliant
+    mock::mock_all_vals_good_performance(&root);
 
+    let (unlocked, alice_bal) = ol_account::balance(@0x1000a);
+    assert!(unlocked==0, 7367001);
+    assert!(alice_bal==0, 7357002);
 
-      mock::pof_default();
-      assert!(vector::length(&vals) == 5, 7357001);
-      let vals = stake::get_current_validators();
-      assert!(vector::length(&vals) == 5, 7357002);
-      // all vals compliant
-      mock::mock_all_vals_good_performance(&root);
+    let (reward_one, _entry_fee, _, _ ) = proof_of_fee::get_consensus_reward();
 
-      let (unlocked, alice_bal) = ol_account::balance(@0x1000a);
-      assert!(unlocked==0, 7367001);
-      assert!(alice_bal==0, 7357002);
+    // The epoch's reward BEFORE reconfiguration
+    assert!(reward_one == 1000000, 7357004);
 
-      let (reward_one, _entry_fee, _, _ ) = proof_of_fee::get_consensus_reward();
-      // The epoch's reward BEFORE reconfiguration
-      assert!(reward_one == 1000000, 7357004);
-      // run ol reconfiguration
-      mock::trigger_epoch(&root);
+    let infra = infra_escrow::infra_escrow_balance();
+    print(&555);
+    print(&infra);
 
-      let vals = stake::get_current_validators();
+    let subsidy = transaction_fee::system_fees_collected();
+    print(&666);
+    print(&subsidy);
 
-      assert!(vector::length(&vals) == 5, 7357005);
-      // let alice_bal = libra_coin::balance(@0x1000a);
-      let (_unlocked, alice_bal) = ol_account::balance(@0x1000a);
+    // run ol reconfiguration
+    mock::trigger_epoch(&root);
 
-      let (_, entry_fee, _,  _ ) = proof_of_fee::get_consensus_reward();
-      // need to check that the user paid an PoF entry fee for next epoch.
-      // which means the balance will be the nominal reward, net of the PoF clearing price bid
-      assert!(alice_bal == (reward_one-entry_fee), 7357006)
+    let infra = infra_escrow::infra_escrow_balance();
+    print(&5552);
+    print(&infra);
 
+    let subsidy = transaction_fee::system_fees_collected();
+    print(&6662);
+    print(&subsidy);
 
-  }
+    let vals = stake::get_current_validators();
+    assert!(vector::length(&vals) == 5, 7357005);
+    // let alice_bal = libra_coin::balance(@0x1000a);
+    let (_unlocked, alice_bal) = ol_account::balance(@0x1000a);
 
-  #[test(root = @ol_framework)]
-  fun drop_non_performing(root: signer) {
-      let _vals = mock::genesis_n_vals(&root, 5);
-      // mock::ol_initialize_coin(&root);
-      mock::pof_default();
-      assert!(libra_coin::balance(@0x1000a) == 0, 7357000);
+    let (_, entry_fee, _,  _ ) = proof_of_fee::get_consensus_reward();
+    // need to check that the user paid an PoF entry fee for next epoch.
+    // which means the balance will be the nominal reward, net of the PoF clearing price bid
+    assert!(alice_bal == (reward_one - entry_fee), 7357006);
 
-      // NOTE: epoch 0 and 1 are a special case, we don't run performance grades on that one. Need to move two epochs ahead
-      reconfiguration::test_helper_increment_epoch_dont_reconfigure(1);
-      reconfiguration::test_helper_increment_epoch_dont_reconfigure(1);
+    // test new subsidy
+    let (reward_two, _entry_fee, _, _ ) = proof_of_fee::get_consensus_reward();
+    print(&777);
+    print(&reward_two);
+    let new_budget = reward_two * 5;
+    print(&new_budget);
 
-      assert!(epoch_helper::get_current_epoch() == 2, 7357001);
+    let subsidy = transaction_fee::system_fees_collected();
+    print(&888);
+    print(&subsidy);
 
-      let vals = stake::get_current_validators();
-      assert!(vector::length(&vals) == 5, 7357002);
+  }
 
-      // all vals compliant
-      mock::mock_all_vals_good_performance(&root);
+  #[test(root = @ol_framework)]
+  fun drop_non_performing(root: signer) {
+    let _vals = mock::genesis_n_vals(&root, 5);
+    // mock::ol_initialize_coin(&root);
+    mock::pof_default();
+    assert!(libra_coin::balance(@0x1000a) == 0, 7357000);
 
-      // make alice non performant
-      mock::mock_case_4(&root, *vector::borrow(&vals, 0));
+    // NOTE: epoch 0 and 1 are a special case, we don't run performance grades on that one. Need to move two epochs ahead
+    reconfiguration::test_helper_increment_epoch_dont_reconfigure(1);
+    reconfiguration::test_helper_increment_epoch_dont_reconfigure(1);
 
-      let (reward, _, _, _ ) = proof_of_fee::get_consensus_reward();
+    assert!(epoch_helper::get_current_epoch() == 2, 7357001);
 
-      // run ol reconfiguration
-      mock::trigger_epoch(&root);
-      // mock::trigger_epoch(&root);
+    let vals = stake::get_current_validators();
+    assert!(vector::length(&vals) == 5, 7357002);
 
-      let vals = stake::get_current_validators();
+    // all vals compliant
+    mock::mock_all_vals_good_performance(&root);
+
+    // make alice non performant
+    mock::mock_case_4(&root, *vector::borrow(&vals, 0));
 
-      // one validator missing.
-      assert!(vector::length(&vals) == 4, 7357003);
-      assert!(!vector::contains(&vals, &@0x1000a), 7357004);
+    let (reward, _, _, _ ) = proof_of_fee::get_consensus_reward();
 
-      let (_, entry_fee, _, _ ) = proof_of_fee::get_consensus_reward();
+    // run ol reconfiguration
+    mock::trigger_epoch(&root);
 
-      // alice doesn't get paid
+    let vals = stake::get_current_validators();
 
-      assert!(libra_coin::balance(@0x1000a) == 0, 7357005);
-      // bob does
-      assert!(libra_coin::balance(@0x1000b) == (reward - entry_fee), 7357006);
+    // one validator missing.
+    assert!(vector::length(&vals) == 4, 7357003);
+    assert!(!vector::contains(&vals, &@0x1000a), 7357004);
 
+    let (_, entry_fee, _, _ ) = proof_of_fee::get_consensus_reward();
 
+    // alice doesn't get paid
+    assert!(libra_coin::balance(@0x1000a) == 0, 7357005);
+    // bob does
+    assert!(libra_coin::balance(@0x1000b) == (reward - entry_fee), 7357006);
   }
 
 

From b16d97e570ead67c959eb1df32dbbec26bb679fb Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Tue, 16 Jul 2024 21:07:06 -0300
Subject: [PATCH 07/16] fix budget to collect, and fee calculus test subsidy,
 fees and reward payments

---
 .../sources/ol_sources/epoch_boundary.move    |  3 +-
 .../sources/ol_sources/infra_escrow.move      |  3 +-
 .../sources/ol_sources/mock.move              |  2 +-
 .../sources/ol_sources/proof_of_fee.move      |  2 +-
 .../ol_sources/tests/boundary.test.move       | 78 ++++++++++++++++---
 .../ol_sources/tests/proof_of_fee.test.move   |  4 -
 6 files changed, 73 insertions(+), 19 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index 48bf35888..73f873985 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -447,8 +447,7 @@ module diem_framework::epoch_boundary {
     let (reward_per, _, _, _ ) = proof_of_fee::get_consensus_reward();
     let vals = stake::get_current_validators();
     let count_vals = vector::length(&vals);
-    count_vals = count_vals + ORACLE_PROVIDERS_SEATS;
-    let total_epoch_budget = count_vals * reward_per;
+    let total_epoch_budget = (count_vals * reward_per) + 1; // +1 for rounding
     print(&999);
     print(&total_epoch_budget);
     infra_escrow::epoch_boundary_collection(root, total_epoch_budget)
diff --git a/framework/libra-framework/sources/ol_sources/infra_escrow.move b/framework/libra-framework/sources/ol_sources/infra_escrow.move
index c9c121e5d..b91fbd34d 100644
--- a/framework/libra-framework/sources/ol_sources/infra_escrow.move
+++ b/framework/libra-framework/sources/ol_sources/infra_escrow.move
@@ -21,7 +21,7 @@ module ol_framework::infra_escrow{
     // use ol_framework::slow_wallet;
     // use std::fixed_point32;
     // use std::signer;
-     use diem_std::debug::print;
+    // use diem_std::debug::print;
 
     friend diem_framework::genesis;
     friend ol_framework::epoch_boundary;
@@ -71,7 +71,6 @@ module ol_framework::infra_escrow{
     }
 
 
-
     // Transaction script for user to pledge to infra escrow.
     fun user_pledge_infra(user_sig: &signer, amount: u64){
       pledge_accounts::user_pledge(user_sig, @ol_framework, amount);
diff --git a/framework/libra-framework/sources/ol_sources/mock.move b/framework/libra-framework/sources/ol_sources/mock.move
index 006f5288e..fd6f7c4fd 100644
--- a/framework/libra-framework/sources/ol_sources/mock.move
+++ b/framework/libra-framework/sources/ol_sources/mock.move
@@ -213,7 +213,7 @@ module ol_framework::mock {
 
     transaction_fee::initialize_fee_collection_and_distribution(root, 0);
 
-    let initial_fees = 5_000_000; // coin scaling * 100 coins
+    let initial_fees = 5_000_000 * 100; // coin scaling * 100 coins
     let tx_fees = coin::test_mint(initial_fees, &mint_cap);
     transaction_fee::vm_pay_fee(root, @ol_framework, tx_fees);
 
diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index 03bf9b22b..4a3e690a1 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -477,7 +477,7 @@ module ol_framework::proof_of_fee {
     cr.clearing_bid = lowest_bid_pct;
 
     if (lowest_bid_pct > 0) {
-      cr.entry_fee = fixed_point32::multiply_u64(cr.nominal_reward, bid_as_fixedpoint(lowest_bid_pct));
+      cr.entry_fee = cr.nominal_reward * lowest_bid_pct / 1000;
 
       if (cr.nominal_reward > cr.entry_fee)  {
         cr.net_reward = cr.nominal_reward - cr.entry_fee;
diff --git a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
index d89036ca8..3060e1cb1 100644
--- a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
@@ -4,6 +4,11 @@ module ol_framework::test_boundary {
   use std::vector;
   use std::features;
   use diem_std::bls12381;
+  use diem_framework::stake;
+  use diem_framework::timestamp;
+  use diem_framework::reconfiguration;
+  use diem_framework::diem_governance;
+  use diem_framework::transaction_fee;
   use ol_framework::mock;
   use ol_framework::proof_of_fee;
   use ol_framework::jail;
@@ -14,12 +19,8 @@ module ol_framework::test_boundary {
   use ol_framework::epoch_boundary;
   use ol_framework::block;
   use ol_framework::ol_account;
-  use diem_framework::stake;
-  use diem_framework::reconfiguration;
-  use diem_framework::timestamp;
-  use diem_framework::diem_governance;
 
-  // use diem_std::debug::print;
+  use diem_std::debug::print;
 
   const Alice: address = @0x1000a;
   const Bob: address = @0x1000b;
@@ -46,7 +47,13 @@ module ol_framework::test_boundary {
   // We need to test e2e of the epoch boundary
   #[test(root = @ol_framework)]
   fun e2e_boundary_happy(root: signer) {
-    let _vals = common_test_setup(&root);
+    let vals = common_test_setup(&root);
+
+    // check vals balance
+    vector::for_each(vals, |addr| {
+      let (_unlocked, total) = ol_account::balance(addr);
+      assert!(total == 500_000, 7357000);
+    });
 
     mock::trigger_epoch(&root);
 
@@ -56,17 +63,28 @@ module ol_framework::test_boundary {
 
     // all validators were compliant, should be +1 of the 10 vals
     assert!(epoch_boundary::get_seats_offered() == 11, 7357002);
-
     // all vals had winning bids, but it was less than the seats on offer
     assert!(vector::length(&epoch_boundary::get_auction_winners()) == 10, 7357003);
     // all of the auction winners became the validators ulitmately
     assert!(vector::length(&epoch_boundary::get_actual_vals()) == 10, 7357004);
+
+    // check vals rewards received and bid fees collected
+    // balance + reward - fee = 500_000 + 1_000_000 - 10_000 = 1_490_000
+    vector::for_each(vals, |addr| {
+      let (_unlocked, total) = ol_account::balance(addr);
+      assert!(total == 1_499_000, 7357005);
+    });
+
+    // check subsidy for new rewards and fees collected
+    // fees collected = 10 * 1_000_000 + 10 * 1_000 = 10_010_000
+    print(&transaction_fee::system_fees_collected());
+    assert!(transaction_fee::system_fees_collected() == 10_010_000, 7357006);
   }
 
 
   #[test(root = @ol_framework, alice = @0x1000a,  marlon_rando = @0x12345)]
   fun e2e_add_validator_happy(root: signer, alice: signer, marlon_rando: signer) {
-    let _vals = common_test_setup(&root);
+    let initial_vals = common_test_setup(&root);
 
     // generate credentials for validator registration
     ol_account::transfer(&alice, @0x12345, 200000);
@@ -78,6 +96,7 @@ module ol_framework::test_boundary {
     // MARLON PAYS THE BID
     let vals = validator_universe::get_eligible_validators();
     assert!(vector::length(&vals) == 11, 7357000);
+
     mock::mock_bids(&vals);
 
     // MARLON HAS MANY FRIENDS
@@ -86,24 +105,65 @@ module ol_framework::test_boundary {
     let (errs, _pass) = proof_of_fee::audit_qualification(@0x12345);
     assert!(vector::length(&errs) == 0, 7357001);
 
+    // get initial vals balance
+    let balances = vector::map(initial_vals, |addr| {
+      let (_unlocked, total) = ol_account::balance(addr);
+      total
+    });
+
     mock::trigger_epoch(&root);
 
     assert!(epoch_boundary::get_reconfig_success(), 7357002);
 
     // all validators were compliant, should be +1 of the 10 vals
     assert!(epoch_boundary::get_seats_offered() == 11, 7357003);
-
     // NOTE: now MARLON is INCLUDED in this, and we filled all the seats on offer.
     // all vals had winning bids, but it was less than the seats on offer
     assert!(vector::length(&epoch_boundary::get_auction_winners()) == 11, 7357003);
     // all of the auction winners became the validators ulitmately
     assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357004);
 
+    // check initial vals rewards received and bid fees collected
+    // previous balance = current - reward + fee
+    let i = 0;
+    while (i < vector::length(&initial_vals)) {
+      let (_unlocked, current) = ol_account::balance(*vector::borrow(&initial_vals, i));
+      let previous = *vector::borrow(&balances, i);
+      assert!(current == (previous + 1_000_000 - 1_000), 7357005);
+      i = i + 1;
+    };
+
+    // check Marlon's balance: 200_000 - 1_000 = 199_000
+    let (_unlocked, marlon_balance) = ol_account::balance(@0x12345);
+    assert!(marlon_balance == 199_000, 7357006);
+
+    // check subsidy for new rewards and fees collected
+    // fees collected = 11 * 1_000_000 + 11 * 1_000 = 11_011_000
+    assert!(transaction_fee::system_fees_collected() == 11_011_000, 7357006);
+
     // another epoch and everyone is compliant as well
     mock::mock_all_vals_good_performance(&root);
     mock::trigger_epoch(&root);
     assert!(epoch_boundary::get_seats_offered() == 12, 7357005);
     assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357006);
+
+    // check initial vals rewards received and bid fees collected
+    // previous balance = current - 2*reward + 2*fee
+    let i = 0;
+    while (i < vector::length(&initial_vals)) {
+      let (_unlocked, current) = ol_account::balance(*vector::borrow(&initial_vals, i));
+      let previous = *vector::borrow(&balances, i);
+      assert!(current == (previous + 2_000_000 - 2_000), 7357005);
+      i = i + 1;
+    };
+
+    // check Marlon's balance: 200_000 + 1_000_000 - 2_000 = 1_198_000
+    let (_unlocked, marlon_balance) = ol_account::balance(@0x12345);
+    assert!(marlon_balance == 1_198_000, 7357006);
+
+    // check subsidy for new rewards and fees collected
+    // fees collected = 11 * 1_000_000 + 11 * 1_000 = 11_011_000
+    assert!(transaction_fee::system_fees_collected() == 11_011_000, 7357007);
   }
 
   #[test(root = @ol_framework, alice = @0x1000a,  marlon_rando = @0x12345)]
diff --git a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
index abea11e07..6de127ede 100644
--- a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
@@ -21,8 +21,6 @@ module ol_framework::test_pof {
   const Eve: address = @0x1000e;
   const Frank: address = @0x1000f;
 
-
-
   #[test_only]
   fun mock_good_bid(_root: &signer, alice: &address) {
     let a_sig = account::create_signer_for_test(*alice);
@@ -56,13 +54,11 @@ module ol_framework::test_pof {
     assert!(bid == 0, 1001);
     assert!(expires == 0, 1002);
 
-
     proof_of_fee::pof_update_bid(&a_sig, 100, 0);
     let (bid, expires) = proof_of_fee::current_bid(*alice);
     assert!(bid == 100, 1003);
     assert!(expires == 0, 1004);
 
-
     // now retract
     proof_of_fee::pof_retract_bid(a_sig);
     let (bid, expires) = proof_of_fee::current_bid(*alice);

From 2afd4e92b0f4c78e296d88e7409b8c334da71852 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Wed, 17 Jul 2024 19:40:19 -0300
Subject: [PATCH 08/16] test subsidy and rewards having a non compliant val

---
 .../ol_sources/tests/boundary.test.move       | 33 +++++++++++++++++--
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
index 3060e1cb1..d48790bb0 100644
--- a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
@@ -200,12 +200,39 @@ module ol_framework::test_boundary {
   fun e2e_boundary_excludes_jail(root: signer) {
     let vals = common_test_setup(&root);
     let alice_addr = *vector::borrow(&vals, 0);
-    jail::jail(&root, alice_addr);
-    assert!(jail::is_jailed(alice_addr), 7357000);
+
+    // mock vals performance
+    let i = 1;
+    while (i < vector::length(&vals)) {
+      let addr = *vector::borrow(&vals, i);
+      stake::mock_performance(&root, addr, 10, 0);
+      i = i + 1;
+    };
+
+    // make Alice val not compliant to end up in jail
+    stake::mock_performance(&root, alice_addr, 10, 10);
+
+    // get Alice balance before epoch boundary
+    let (_unlocked, alice_before) = ol_account::balance(alice_addr);
+
+    // new epoch
     mock::trigger_epoch(&root);
 
+    // check that Alice is jailed
+    assert!(jail::is_jailed(alice_addr), 7357000);
+
+    // ensure Alice did not receive rewards
+    let (_unlocked, alice_after) = ol_account::balance(alice_addr);
+    assert!(alice_before == alice_after, 7357001);
+
+    // check that validator set reduced by 1
     let qualified_bidders = epoch_boundary::get_qualified_bidders();
-    assert!(vector::length(&qualified_bidders) == (vector::length(&vals) - 1), 7357003);
+    assert!(vector::length(&qualified_bidders) == 9, 7357003);
+
+    // check subsidy for new rewards and fees collected
+    // fees collected = 9 * 1_000_000 + 9 * 2_000 = 9_018_000
+    print(&transaction_fee::system_fees_collected());
+    assert!(transaction_fee::system_fees_collected() == 9_018_000, 7357006);
 
     // all vals had winning bids, but it was less than the seats on offer
     assert!(vector::length(&epoch_boundary::get_auction_winners()) == vector::length(&qualified_bidders) , 7357003);

From a01514ecfe54795619d5758fa1184b35efaf8dfc Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Thu, 18 Jul 2024 12:09:56 -0300
Subject: [PATCH 09/16] test that entry fee sum is burnt on epoch trigger

---
 .../sources/ol_sources/epoch_boundary.move    |  2 -
 .../ol_sources/tests/boundary.test.move       | 54 +++++++++++--------
 2 files changed, 32 insertions(+), 24 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index 73f873985..76332d728 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -448,8 +448,6 @@ module diem_framework::epoch_boundary {
     let vals = stake::get_current_validators();
     let count_vals = vector::length(&vals);
     let total_epoch_budget = (count_vals * reward_per) + 1; // +1 for rounding
-    print(&999);
-    print(&total_epoch_budget);
     infra_escrow::epoch_boundary_collection(root, total_epoch_budget)
   }
 
diff --git a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
index d48790bb0..1fea71e5d 100644
--- a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
@@ -9,6 +9,7 @@ module ol_framework::test_boundary {
   use diem_framework::reconfiguration;
   use diem_framework::diem_governance;
   use diem_framework::transaction_fee;
+  use ol_framework::burn;
   use ol_framework::mock;
   use ol_framework::proof_of_fee;
   use ol_framework::jail;
@@ -95,7 +96,7 @@ module ol_framework::test_boundary {
 
     // MARLON PAYS THE BID
     let vals = validator_universe::get_eligible_validators();
-    assert!(vector::length(&vals) == 11, 7357000);
+    assert!(vector::length(&vals) == 11, 7357001);
 
     mock::mock_bids(&vals);
 
@@ -103,7 +104,7 @@ module ol_framework::test_boundary {
     vouch::test_set_buddies(@0x12345, vals);
 
     let (errs, _pass) = proof_of_fee::audit_qualification(@0x12345);
-    assert!(vector::length(&errs) == 0, 7357001);
+    assert!(vector::length(&errs) == 0, 7357002);
 
     // get initial vals balance
     let balances = vector::map(initial_vals, |addr| {
@@ -113,15 +114,15 @@ module ol_framework::test_boundary {
 
     mock::trigger_epoch(&root);
 
-    assert!(epoch_boundary::get_reconfig_success(), 7357002);
+    assert!(epoch_boundary::get_reconfig_success(), 7357003);
 
     // all validators were compliant, should be +1 of the 10 vals
-    assert!(epoch_boundary::get_seats_offered() == 11, 7357003);
+    assert!(epoch_boundary::get_seats_offered() == 11, 7357004);
     // NOTE: now MARLON is INCLUDED in this, and we filled all the seats on offer.
     // all vals had winning bids, but it was less than the seats on offer
-    assert!(vector::length(&epoch_boundary::get_auction_winners()) == 11, 7357003);
+    assert!(vector::length(&epoch_boundary::get_auction_winners()) == 11, 7357005);
     // all of the auction winners became the validators ulitmately
-    assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357004);
+    assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357006);
 
     // check initial vals rewards received and bid fees collected
     // previous balance = current - reward + fee
@@ -129,23 +130,24 @@ module ol_framework::test_boundary {
     while (i < vector::length(&initial_vals)) {
       let (_unlocked, current) = ol_account::balance(*vector::borrow(&initial_vals, i));
       let previous = *vector::borrow(&balances, i);
-      assert!(current == (previous + 1_000_000 - 1_000), 7357005);
+      assert!(current == (previous + 1_000_000 - 1_000), 7357007);
       i = i + 1;
     };
 
     // check Marlon's balance: 200_000 - 1_000 = 199_000
     let (_unlocked, marlon_balance) = ol_account::balance(@0x12345);
-    assert!(marlon_balance == 199_000, 7357006);
+    assert!(marlon_balance == 199_000, 7357008);
 
     // check subsidy for new rewards and fees collected
     // fees collected = 11 * 1_000_000 + 11 * 1_000 = 11_011_000
-    assert!(transaction_fee::system_fees_collected() == 11_011_000, 7357006);
+    assert!(transaction_fee::system_fees_collected() == 11_011_000, 7357009);
 
     // another epoch and everyone is compliant as well
     mock::mock_all_vals_good_performance(&root);
     mock::trigger_epoch(&root);
-    assert!(epoch_boundary::get_seats_offered() == 12, 7357005);
-    assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357006);
+
+    assert!(epoch_boundary::get_seats_offered() == 12, 7357010);
+    assert!(vector::length(&epoch_boundary::get_actual_vals()) == 11, 7357011);
 
     // check initial vals rewards received and bid fees collected
     // previous balance = current - 2*reward + 2*fee
@@ -153,17 +155,26 @@ module ol_framework::test_boundary {
     while (i < vector::length(&initial_vals)) {
       let (_unlocked, current) = ol_account::balance(*vector::borrow(&initial_vals, i));
       let previous = *vector::borrow(&balances, i);
-      assert!(current == (previous + 2_000_000 - 2_000), 7357005);
+      assert!(current == (previous + 2_000_000 - 2_000), 7357012);
       i = i + 1;
     };
 
     // check Marlon's balance: 200_000 + 1_000_000 - 2_000 = 1_198_000
     let (_unlocked, marlon_balance) = ol_account::balance(@0x12345);
-    assert!(marlon_balance == 1_198_000, 7357006);
+    assert!(marlon_balance == 1_198_000, 7357013);
 
-    // check subsidy for new rewards and fees collected
-    // fees collected = 11 * 1_000_000 + 11 * 1_000 = 11_011_000
-    assert!(transaction_fee::system_fees_collected() == 11_011_000, 7357007);
+    // CHECK BURNT FEES
+
+    // prepare clean epoch
+    mock::trigger_epoch(&root);
+
+    let (before, _) = burn::get_lifetime_tracker();
+
+    mock::trigger_epoch(&root);
+
+    // check that only the entry fee sum is being burnt
+    let (after,_) = burn::get_lifetime_tracker();
+    assert!(after - before == 11_000_000, 7357014); // scale 1_000
   }
 
   #[test(root = @ol_framework, alice = @0x1000a,  marlon_rando = @0x12345)]
@@ -219,11 +230,11 @@ module ol_framework::test_boundary {
     mock::trigger_epoch(&root);
 
     // check that Alice is jailed
-    assert!(jail::is_jailed(alice_addr), 7357000);
+    assert!(jail::is_jailed(alice_addr), 7357001);
 
     // ensure Alice did not receive rewards
     let (_unlocked, alice_after) = ol_account::balance(alice_addr);
-    assert!(alice_before == alice_after, 7357001);
+    assert!(alice_before == alice_after, 7357002);
 
     // check that validator set reduced by 1
     let qualified_bidders = epoch_boundary::get_qualified_bidders();
@@ -231,12 +242,11 @@ module ol_framework::test_boundary {
 
     // check subsidy for new rewards and fees collected
     // fees collected = 9 * 1_000_000 + 9 * 2_000 = 9_018_000
-    print(&transaction_fee::system_fees_collected());
-    assert!(transaction_fee::system_fees_collected() == 9_018_000, 7357006);
+    assert!(transaction_fee::system_fees_collected() == 9_018_000, 7357004);
 
     // all vals had winning bids, but it was less than the seats on offer
-    assert!(vector::length(&epoch_boundary::get_auction_winners()) == vector::length(&qualified_bidders) , 7357003);
-    assert!(epoch_boundary::get_reconfig_success(), 7357001);
+    assert!(vector::length(&epoch_boundary::get_auction_winners()) == vector::length(&qualified_bidders) , 7357005);
+    assert!(epoch_boundary::get_reconfig_success(), 7357006);
   }
 
   #[test(root = @ol_framework, marlon = @0x12345)]

From f6ab542cc5965ab600b1a473b51308d065f9f414 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Thu, 18 Jul 2024 17:53:51 -0300
Subject: [PATCH 10/16] adds tests to reward_thermostat increasing and
 decreasing rewards fixes tests broken by mock changes

---
 .../sources/ol_sources/epoch_boundary.move    |   2 +-
 .../sources/ol_sources/mock.move              |  11 +-
 .../ol_sources/tests/boundary.test.move       |  60 ++
 .../sources/ol_sources/tests/burn.test.move   | 553 +++++++++---------
 .../ol_sources/tests/donor_voice.test.move    |  13 +-
 .../ol_sources/tests/slow_wallet.test.move    |   9 +-
 6 files changed, 350 insertions(+), 298 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index 76332d728..e78bb6f1b 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -398,7 +398,7 @@ module diem_framework::epoch_boundary {
         jail::jail(root, *addr);
       } else {
         // vector::push_back(&mut compliant_vals, *addr);
-        if (libra_coin::value(reward_budget) > reward_per) {
+        if (libra_coin::value(reward_budget) >= reward_per) {
           let user_coin = libra_coin::extract(reward_budget, reward_per);
           reward_deposited = reward_deposited + libra_coin::value(&user_coin);
           rewards::process_single(root, *addr, user_coin, 1);
diff --git a/framework/libra-framework/sources/ol_sources/mock.move b/framework/libra-framework/sources/ol_sources/mock.move
index fd6f7c4fd..40acbcecd 100644
--- a/framework/libra-framework/sources/ol_sources/mock.move
+++ b/framework/libra-framework/sources/ol_sources/mock.move
@@ -356,11 +356,12 @@ module ol_framework::mock {
 
     let n_vals = 5;
     let _vals = genesis_n_vals(root, n_vals); // need to include eve to init funds
-    let genesis_mint = 1000000;
+    let genesis_mint = 1_000_000;
     ol_initialize_coin_and_fund_vals(root, genesis_mint, true);
     let supply_pre = libra_coin::supply();
-    let mocked_tx_fees = 1000000 * 100;
-    assert!(supply_pre == mocked_tx_fees + (n_vals * genesis_mint), 73570001);
+    let bruce_fortune = 100_000_000_000;
+    let mocked_tx_fees = 5_000_000 * 100;
+    assert!(supply_pre == bruce_fortune + mocked_tx_fees + (n_vals * genesis_mint), 73570001);
   }
 
 
@@ -375,9 +376,9 @@ module ol_framework::mock {
 
     let (nominal_reward, entry_fee, clearing_percent, median_bid ) = proof_of_fee::get_consensus_reward();
 
-    assert!(nominal_reward == 1000000, 73570001);
+    assert!(nominal_reward == 1_000_000, 73570001);
     assert!(clearing_percent == 1, 73570002);
-    assert!(entry_fee == 999, 73570003);
+    assert!(entry_fee == 1_000, 73570003);
     assert!(median_bid == 3, 73570004);
   }
 }
diff --git a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
index 1fea71e5d..659f207d1 100644
--- a/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/boundary.test.move
@@ -9,6 +9,7 @@ module ol_framework::test_boundary {
   use diem_framework::reconfiguration;
   use diem_framework::diem_governance;
   use diem_framework::transaction_fee;
+  use diem_framework::account;
   use ol_framework::burn;
   use ol_framework::mock;
   use ol_framework::proof_of_fee;
@@ -275,6 +276,65 @@ module ol_framework::test_boundary {
     assert!(epoch == 4, 7357003);
   }
 
+  #[test(root = @ol_framework)]
+  fun epoch_increase_thermostat(root: &signer) {
+    let vals = common_test_setup(root);
+
+    // mock bids
+    vector::for_each(vals, |a| {
+      let sig = account::create_signer_for_test(a);
+      proof_of_fee::pof_update_bid(&sig, 0100, 30); // 10% for 30 epochs
+    });
+
+    // mock bid history to increase thermostat by 5%
+    proof_of_fee::test_mock_reward(
+      root,
+      1000, // nominal reward
+      0100, // clearing bid
+      0100, // median win bid
+      vector[ 0100, 0100, 0100, 0100, 0100, 0100 ] // median history bellow 50%
+    );
+
+    // trigger epoch
+    mock::trigger_epoch(root);
+
+    // check subsidy increased by 5%
+    // fees collected = entry fee + reward * 105%
+    // entry fee = 100 * 10 = 1_000
+    // reward = 1050 * 10 = 10_500
+    // fees collected = 11_500
+    assert!(transaction_fee::system_fees_collected() == 11_500, 7357001);
+  }
+
+  #[test(root = @ol_framework)]
+  fun epoch_decrease_thermostat(root: &signer) {
+    let vals = common_test_setup(root);
+
+    // mock bids
+    vector::for_each(vals, |a| {
+      let sig = account::create_signer_for_test(a);
+      proof_of_fee::pof_update_bid(&sig, 0970, 30); // 97% for 30 epochs
+    });
+
+    // mock bid history to decrease thermostat by 5%
+    proof_of_fee::test_mock_reward(
+      root,
+      100_000, // nominal reward
+      0970, // clearing bid
+      0970, // median win bid
+      vector[ 0970, 0970, 0970, 0970, 0970, 0970 ] // median history above 95%
+    );
+
+    // trigger epoch
+    mock::trigger_epoch(root);
+
+    // check subsidy decreased by 5%
+    // fees collected = entry fee + reward * 95%
+    // entry fee = 97_000 * 10 = 970_000
+    // reward = 95_000 * 10 = 950_000
+    // fees collected = 1_920_000
+    assert!(transaction_fee::system_fees_collected() == 1_920_000, 7357001);
+  }
 
   #[test(root = @ol_framework, marlon = @0x12345)]
   #[expected_failure(abort_code = 2, location = 0x1::epoch_boundary)]
diff --git a/framework/libra-framework/sources/ol_sources/tests/burn.test.move b/framework/libra-framework/sources/ol_sources/tests/burn.test.move
index 2f79941ad..51c66a9f6 100644
--- a/framework/libra-framework/sources/ol_sources/tests/burn.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/burn.test.move
@@ -66,303 +66,297 @@ module ol_framework::test_burn {
   }
 
 
-    #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
-    fun burn_to_match_index(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
-      // Scenario:
-      // There are two community wallets. Alice and Bob's
-      // EVE donates to both. But mostly to Alice.
-      // The Match Index, should reflect that.
-
-      let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
-      mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
-      // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
-      mock::trigger_epoch(root);
-
-      let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
-      let addr_A = signer::address_of(&communityA);
-      community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
-
-      let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
-      let addr_B = signer::address_of(&communityB);
-      community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
-
-      let eve_donation_to_A = 75;
-      ol_account::transfer(eve, addr_A, eve_donation_to_A);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
-      assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
-
-      let eve_donation_to_B = 25;
-      ol_account::transfer(eve, addr_B, eve_donation_to_B);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
-      assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
-
-      let qualifying = vector::singleton(addr_A);
-      vector::push_back(&mut qualifying, addr_B);
-
-      // simulate index recalculation at epoch boundary
-      match_index::test_reset_ratio(root, qualifying);
-      let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
-
-      // so far addr_A should have 75 coins from Eve's transfer
-      let(_, balance_pre) = ol_account::balance(addr_A);
-      assert!(balance_pre == eve_donation_to_A, 7357003);
-
-      // let's burn some of bob's coins
-      // first he sets his burn preference
-      burn::set_send_community(bob, true);
-      let bob_burn = 100000;
-      let c = ol_account::withdraw(bob, bob_burn);
-      // then the system burns based on his preference.
-      burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
-      // check that a recycle to match index happened instead of a straight burn
-      let (_lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
-      assert!(lifetime_match > 0, 7357003);
-
-
-      // the balance of address A should be increase by the ratio above 75% *  bob's burn of 100_000
-      let ratio_A = vector::borrow(&ratio_vec, 0);
-      let bob_burn_share_A = fixed_point32::multiply_u64(bob_burn, *ratio_A);
-
-      let(_, balance) = ol_account::balance(addr_A);
-      assert!(balance > balance_pre, 7357004);
-      assert!(balance == (bob_burn_share_A + eve_donation_to_A), 7357005);
-    }
-
-
-    #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
-    fun simple_burn(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
-      // Scenario:
-      // There are two community wallets. Alice and Bob's
-      // EVE donates to both. But mostly to Alice.
-      // The Match Index, should reflect that.
-
-      let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
-      mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
-      // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
-      mock::trigger_epoch(root);
-
-      let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
-      let addr_A = signer::address_of(&communityA);
-      community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
-
-      let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
-      let addr_B = signer::address_of(&communityB);
-      community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
-
-      let eve_donation_to_A = 75;
-      ol_account::transfer(eve, addr_A, eve_donation_to_A);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
-      assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
-
-      let eve_donation_to_B = 25;
-      ol_account::transfer(eve, addr_B, eve_donation_to_B);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
-      assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
-
-      let qualifying = vector::singleton(addr_A);
-      vector::push_back(&mut qualifying, addr_B);
-
-      // simulate index recalculation at epoch boundary
-      match_index::test_reset_ratio(root, qualifying);
-      // let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
-
-      // so far addr_A should have 75 coins from Eve's transfer
-      let(_, balance_pre) = ol_account::balance(addr_A);
-      assert!(balance_pre == eve_donation_to_A, 7357003);
-
-      // let's burn some of bob's coins
-      // first he sets his burn preference
-      // IMPORTANT: BOB IS SETTING PREFERENCE TO SIMPLE BURN
-      burn::set_send_community(bob, false);
-      let bob_burn = 100000;
-      let c = ol_account::withdraw(bob, bob_burn);
-      // then the system burns based on his preference.
-      burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
-
-      // no match recycling happened
-      let (lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
-      assert!(lifetime_match == 0, 7357003);
-      assert!(lifetime_burn > 0, 7357004);
-
-
-      // NONE OF THE MATCH INDEX ACCOUNTS HAVE ANY CHANGE
-      let(_, balance) = ol_account::balance(addr_A);
-      assert!(balance == balance_pre, 7357005);
-      assert!(balance == eve_donation_to_A, 7357006);
-    }
-
-    #[test(root = @ol_framework)]
-    fun epoch_fees_burn(root: &signer) {
-      // Scenario:
-      // the network starts.
-      // we mock some tx fees going into the collection
-      // the epoch turns and the fee account should be empty
-      // and the supply should be lower
-
-      let n_vals = 5;
-      let _vals = mock::genesis_n_vals(root, n_vals); // need to include eve to init funds
-      let genesis_mint = 1000000; // 1 coin per
-      let epoch_reward = genesis_mint; // just to be explicit
-
-      mock::ol_initialize_coin_and_fund_vals(root, genesis_mint, true);
-      let supply_pre = libra_coin::supply();
-      let mocked_tx_fees = 1000000 * 100; // 100 coins in tx fee account
-      // 105 coins total
-      assert!(supply_pre == mocked_tx_fees + (n_vals * genesis_mint), 73570001);
-
-      let fees = transaction_fee::system_fees_collected();
-      assert!(fees == mocked_tx_fees, 73570002);
-      // start at epoch 1. NOTE Validators WILL GET PAID FOR EPOCH 1
-      mock::trigger_epoch(root); // under 1000 rounds we don't
-      // evaluate performance of validators
-      let fees = transaction_fee::system_fees_collected();
-      // There should be no fees left in tx fee wallet
-      assert!(fees == 0, 73570003);
-
-      let validator_rewards = epoch_reward * n_vals;
-
-      // of the initial supply,
-      // we expect to burn everything which was in the TX FEEs AFTER PAYING VALIDATOR REWARDS
-      let amount_burned_excess_tx_account = mocked_tx_fees - validator_rewards;
-
-      // So the current supply should be lower,
-      // The the old supply was reduced by what was burned (the excess in tx bucket)
-
-      let supply_post = libra_coin::supply();
-
-      assert!(supply_post == supply_pre - amount_burned_excess_tx_account, 73570003);
-
-      // this ALSO means that the only supply left in this example
-      // is the rewards to validators from genesis, and from epoch 1
-      assert!(supply_post == validator_rewards + (n_vals * genesis_mint), 73570003);
-
-    }
-
-
-    #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
-    fun epoch_fees_match(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
-      // Scenario:
-      // There are two community wallets. Alice and Bob's
-      // EVE donates to both. But mostly to Alice.
-      // The Match Index, should reflect that.
-
-      let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
-      mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
-      // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
-      mock::trigger_epoch(root);
-
-      let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
-      let addr_A = signer::address_of(&communityA);
-      community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
-
-      let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
-      let addr_B = signer::address_of(&communityB);
-      community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
-
-      let eve_donation_to_A = 75;
-      ol_account::transfer(eve, addr_A, eve_donation_to_A);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
-      assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
-
-      let eve_donation_to_B = 25;
-      ol_account::transfer(eve, addr_B, eve_donation_to_B);
-      let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
-      assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
-
-      let qualifying = vector::singleton(addr_A);
-      vector::push_back(&mut qualifying, addr_B);
-
-      // simulate index recalculation at epoch boundary
-      match_index::test_reset_ratio(root, qualifying);
-      let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
-
-      // so far addr_A should have 75 coins from Eve's transfer
-      let(_, balance_pre) = ol_account::balance(addr_A);
-      assert!(balance_pre == eve_donation_to_A, 7357003);
-
-      // let's burn some of bob's coins
-      // first he sets his burn preference
-      burn::set_send_community(bob, true);
-      let bob_burn = 100000;
-      let c = ol_account::withdraw(bob, bob_burn);
-      // then the system burns based on his preference.
-      burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
-      // check that a recycle to match index happened instead of a straight burn
-      let (_lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
-      assert!(lifetime_match > 0, 7357003);
+  #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
+  fun burn_to_match_index(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
+    // Scenario:
+    // There are two community wallets. Alice and Bob's
+    // EVE donates to both. But mostly to Alice.
+    // The Match Index, should reflect that.
+
+    let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
+    mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
+    // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
+    mock::trigger_epoch(root);
+
+    let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
+    let addr_A = signer::address_of(&communityA);
+    community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
+
+    let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
+    let addr_B = signer::address_of(&communityB);
+    community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
+
+    let eve_donation_to_A = 75;
+    ol_account::transfer(eve, addr_A, eve_donation_to_A);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
+    assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
+
+    let eve_donation_to_B = 25;
+    ol_account::transfer(eve, addr_B, eve_donation_to_B);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
+    assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
+
+    let qualifying = vector::singleton(addr_A);
+    vector::push_back(&mut qualifying, addr_B);
+
+    // simulate index recalculation at epoch boundary
+    match_index::test_reset_ratio(root, qualifying);
+    let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
+
+    // so far addr_A should have 75 coins from Eve's transfer
+    let(_, balance_pre) = ol_account::balance(addr_A);
+    assert!(balance_pre == eve_donation_to_A, 7357003);
+
+    // let's burn some of bob's coins
+    // first he sets his burn preference
+    burn::set_send_community(bob, true);
+    let bob_burn = 100000;
+    let c = ol_account::withdraw(bob, bob_burn);
+    // then the system burns based on his preference.
+    burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
+    // check that a recycle to match index happened instead of a straight burn
+    let (_lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
+    assert!(lifetime_match > 0, 7357003);
+
+
+    // the balance of address A should be increase by the ratio above 75% *  bob's burn of 100_000
+    let ratio_A = vector::borrow(&ratio_vec, 0);
+    let bob_burn_share_A = fixed_point32::multiply_u64(bob_burn, *ratio_A);
+
+    let(_, balance) = ol_account::balance(addr_A);
+    assert!(balance > balance_pre, 7357004);
+    assert!(balance == (bob_burn_share_A + eve_donation_to_A), 7357005);
+  }
+
+
+  #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
+  fun simple_burn(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
+    // Scenario:
+    // There are two community wallets. Alice and Bob's
+    // EVE donates to both. But mostly to Alice.
+    // The Match Index, should reflect that.
+
+    let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
+    mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
+    // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
+    mock::trigger_epoch(root);
+
+    let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
+    let addr_A = signer::address_of(&communityA);
+    community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
+
+    let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
+    let addr_B = signer::address_of(&communityB);
+    community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
+
+    let eve_donation_to_A = 75;
+    ol_account::transfer(eve, addr_A, eve_donation_to_A);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
+    assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
+
+    let eve_donation_to_B = 25;
+    ol_account::transfer(eve, addr_B, eve_donation_to_B);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
+    assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
+
+    let qualifying = vector::singleton(addr_A);
+    vector::push_back(&mut qualifying, addr_B);
+
+    // simulate index recalculation at epoch boundary
+    match_index::test_reset_ratio(root, qualifying);
+    // let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
+
+    // so far addr_A should have 75 coins from Eve's transfer
+    let(_, balance_pre) = ol_account::balance(addr_A);
+    assert!(balance_pre == eve_donation_to_A, 7357003);
+
+    // let's burn some of bob's coins
+    // first he sets his burn preference
+    // IMPORTANT: BOB IS SETTING PREFERENCE TO SIMPLE BURN
+    burn::set_send_community(bob, false);
+    let bob_burn = 100000;
+    let c = ol_account::withdraw(bob, bob_burn);
+    // then the system burns based on his preference.
+    burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
+
+    // no match recycling happened
+    let (lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
+    assert!(lifetime_match == 0, 7357003);
+    assert!(lifetime_burn > 0, 7357004);
+
+
+    // NONE OF THE MATCH INDEX ACCOUNTS HAVE ANY CHANGE
+    let(_, balance) = ol_account::balance(addr_A);
+    assert!(balance == balance_pre, 7357005);
+    assert!(balance == eve_donation_to_A, 7357006);
+  }
+
+  #[test(root = @ol_framework)]
+  fun epoch_fees_burn(root: &signer) {
+    // Scenario:
+    // the network starts.
+    // we mock some tx fees going into the collection
+    // the epoch turns and the fee account should be empty
+    // and the supply should be lower
 
+    let n_vals = 5;
+    let _vals = mock::genesis_n_vals(root, n_vals); // need to include eve to init funds
+    let genesis_mint = 1_000_000; // 1 coin per
+    let epoch_reward = genesis_mint; // just to be explicit
 
-      // the balance of address A should be increase by the ratio above 75% *  bob's burn of 100_000
-      let ratio_A = vector::borrow(&ratio_vec, 0);
-      let bob_burn_share_A = fixed_point32::multiply_u64(bob_burn, *ratio_A);
-
-      let(_, balance) = ol_account::balance(addr_A);
-      assert!(balance > balance_pre, 7357004);
-      assert!(balance == (bob_burn_share_A + eve_donation_to_A), 7357005);
-    }
+    mock::ol_initialize_coin_and_fund_vals(root, genesis_mint, true);
+    let supply_pre = libra_coin::supply();
+    let bruce_fortune = 100_000_000_000;
+    let mocked_tx_fees = 5_000_000 * 100; // 100 coins in tx fee account
+    assert!(supply_pre == mocked_tx_fees + bruce_fortune + (n_vals * genesis_mint), 73570001);
 
+    let fees = transaction_fee::system_fees_collected();
+    assert!(fees == mocked_tx_fees, 73570002);
 
-    // TODO:
+    // start at epoch 1. NOTE Validators WILL GET PAID FOR EPOCH 1
+    mock::trigger_epoch(root); // under 1000 rounds we don't
 
-    // #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
-    // fun fee_makers_calc(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
-    //   // Scenario:
-    //   assert!(TransactionFee::get_fees_collected()==0, 735701);
-    //   let coin = Diem::mint<GAS>(&vm, 1);
-    //   TransactionFee::pay_fee_and_track(@Alice, coin);
+    // evaluate performance of validators
+    let fees = transaction_fee::system_fees_collected();
+    // There should be only entry fee left in tx fee wallet
+    assert!(fees == 5_000_000, 73570003);
 
-    //   let fee_makers = TransactionFee::get_fee_makers();
-    //   assert!(Vector::length(&fee_makers)==1, 735702);
-    //   assert!(TransactionFee::get_fees_collected()==1, 735703);
-    // }
+    let validator_rewards = epoch_reward * n_vals;
 
-    #[test(root=@ol_framework, alice=@0x1000a)]
-    fun track_fees(root: &signer, alice: address) {
-      // use ol_framework::libra_coin;
-      let _vals = mock::genesis_n_vals(root, 1); // need to include eve to init funds
-      mock::ol_initialize_coin_and_fund_vals(root, 10000, true);
+    // of the initial supply,
+    // we expect to burn everything which was in the TX FEEs AFTER PAYING VALIDATOR REWARDS
+    let amount_burned_excess_tx_account = mocked_tx_fees - validator_rewards;
 
-      let marlon_rando = @0x12345;
-      ol_account::create_account(root, marlon_rando);
+    // So the current supply should be lower,
+    // The the old supply was reduced by what was burned (the excess in tx bucket)
 
+    let supply_post = libra_coin::supply();
+    assert!(supply_post == supply_pre - amount_burned_excess_tx_account, 73570003);
 
-      let rando_money = 5;
-      let coin_option = ol_account::test_vm_withdraw(root, alice, rando_money);
+    // this ALSO means that the only supply left in this example
+    // is the rewards to validators from genesis, and from epoch 1
+    // and the bruce fortune used to pledge infra escrow
+    assert!(supply_post == validator_rewards + (n_vals * genesis_mint) + bruce_fortune, 73570003);
+  }
 
-      if (option::is_some(&coin_option)) {
-        let c = option::extract(&mut coin_option);
-        // shortcut: we have the VM use alices money to pay a fee for marlon.
-        transaction_fee::vm_pay_fee(root, marlon_rando, c);
-      };
-      option::destroy_none(coin_option);
 
+  #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
+  fun epoch_fees_match(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
+    // Scenario:
+    // There are two community wallets. Alice and Bob's
+    // EVE donates to both. But mostly to Alice.
+    // The Match Index, should reflect that.
+
+    let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
+    mock::ol_initialize_coin_and_fund_vals(root, 1000000, true);
+    // start at epoch 1, since turnout tally needs epoch info, and 0 may cause issues
+    mock::trigger_epoch(root);
+
+    let (communityA, _cap) = ol_account::test_ol_create_resource_account(alice, b"0x1");
+    let addr_A = signer::address_of(&communityA);
+    community_wallet_init::init_community(&communityA, vals, 2); // make all the vals signers
+
+    let (communityB, _cap) = ol_account::test_ol_create_resource_account(bob, b"0xdeadbeef");
+    let addr_B = signer::address_of(&communityB);
+    community_wallet_init::init_community(&communityB, vals, 2); // make all the vals signers
+
+    let eve_donation_to_A = 75;
+    ol_account::transfer(eve, addr_A, eve_donation_to_A);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_A);
+    assert!(total_funds_sent_by_eve == eve_donation_to_A, 7357001);
+
+    let eve_donation_to_B = 25;
+    ol_account::transfer(eve, addr_B, eve_donation_to_B);
+    let (_, _, total_funds_sent_by_eve) = receipts::read_receipt(signer::address_of(eve), addr_B);
+    assert!(total_funds_sent_by_eve == eve_donation_to_B, 7357002);
+
+    let qualifying = vector::singleton(addr_A);
+    vector::push_back(&mut qualifying, addr_B);
+
+    // simulate index recalculation at epoch boundary
+    match_index::test_reset_ratio(root, qualifying);
+    let (_addrs_vec, _index_vec, ratio_vec) = match_index::get_ratios();
+
+    // so far addr_A should have 75 coins from Eve's transfer
+    let(_, balance_pre) = ol_account::balance(addr_A);
+    assert!(balance_pre == eve_donation_to_A, 7357003);
+
+    // let's burn some of bob's coins
+    // first he sets his burn preference
+    burn::set_send_community(bob, true);
+    let bob_burn = 100000;
+    let c = ol_account::withdraw(bob, bob_burn);
+    // then the system burns based on his preference.
+    burn::test_vm_burn_with_user_preference(root, signer::address_of(bob), c);
+    // check that a recycle to match index happened instead of a straight burn
+    let (_lifetime_burn, lifetime_match) = burn::get_lifetime_tracker();
+    assert!(lifetime_match > 0, 7357003);
+
+
+    // the balance of address A should be increase by the ratio above 75% *  bob's burn of 100_000
+    let ratio_A = vector::borrow(&ratio_vec, 0);
+    let bob_burn_share_A = fixed_point32::multiply_u64(bob_burn, *ratio_A);
+
+    let(_, balance) = ol_account::balance(addr_A);
+    assert!(balance > balance_pre, 7357004);
+    assert!(balance == (bob_burn_share_A + eve_donation_to_A), 7357005);
+  }
 
-      let fees = transaction_fee::system_fees_collected();
-      assert!(fees == 100000005, 735701);
-      // Fees will include the initialization by MOCK. ol_initialize_coin_and_fund_vals
-
-      // marlon is the only fee maker (since genesis)
-      let fee_makers = fee_maker::get_fee_makers();
-      // includes 0x1 which makes a deposit on
-      assert!(vector::length(&fee_makers)==1, 735702);
 
-      let marlon_fees_made = fee_maker::get_user_fees_made(marlon_rando);
-      assert!(marlon_fees_made == 5, 735703);
+  // TODO:
 
-      mock::trigger_epoch(root);
-      // should reset the fee counter on everything.
-      // TODO: no proof of fee was charged on alice. But this is changed in
-      // feature branch `coin-methods-hygiene`
+  // #[test(root = @ol_framework, alice = @0x1000a, bob = @0x1000d, eve = @0x1000e)]
+  // fun fee_makers_calc(root: &signer, alice: &signer, bob: &signer, eve: &signer) {
+  //   // Scenario:
+  //   assert!(TransactionFee::get_fees_collected()==0, 735701);
+  //   let coin = Diem::mint<GAS>(&vm, 1);
+  //   TransactionFee::pay_fee_and_track(@Alice, coin);
 
-      let marlon_fees_made = fee_maker::get_user_fees_made(marlon_rando);
-      assert!(marlon_fees_made == 0, 735704);
-      let fee_makers = fee_maker::get_fee_makers();
-      assert!(vector::length(&fee_makers)==0, 735705);
-      let fees = transaction_fee::system_fees_collected();
-      assert!(fees == 0, 7357008);
+  //   let fee_makers = TransactionFee::get_fee_makers();
+  //   assert!(Vector::length(&fee_makers)==1, 735702);
+  //   assert!(TransactionFee::get_fees_collected()==1, 735703);
+  // }
 
-    }
+  #[test(root=@ol_framework, alice=@0x1000a)]
+  fun track_fees(root: &signer, alice: address) {
+    // use ol_framework::libra_coin;
+    let _vals = mock::genesis_n_vals(root, 1); // need to include eve to init funds
+    mock::ol_initialize_coin_and_fund_vals(root, 10000, true);
 
+    let marlon_rando = @0x12345;
+    ol_account::create_account(root, marlon_rando);
+
+    let rando_money = 5;
+    let coin_option = ol_account::test_vm_withdraw(root, alice, rando_money);
+
+    if (option::is_some(&coin_option)) {
+      let c = option::extract(&mut coin_option);
+      // shortcut: we have the VM use alices money to pay a fee for marlon.
+      transaction_fee::vm_pay_fee(root, marlon_rando, c);
+    };
+    option::destroy_none(coin_option);
+
+    let fees = transaction_fee::system_fees_collected();
+    assert!(fees == 500_000_005, 7357001);
+    // Fees will include the initialization by MOCK. ol_initialize_coin_and_fund_vals
+
+    // marlon is the only fee maker (since genesis)
+    let fee_makers = fee_maker::get_fee_makers();
+    // includes 0x1 which makes a deposit on
+    assert!(vector::length(&fee_makers)==1, 7357002);
+
+    let marlon_fees_made = fee_maker::get_user_fees_made(marlon_rando);
+    assert!(marlon_fees_made == 5, 7357003);
+
+    mock::trigger_epoch(root);
+
+    let marlon_fees_made = fee_maker::get_user_fees_made(marlon_rando);
+    assert!(marlon_fees_made == 0, 7357004);
+    let fee_makers = fee_maker::get_fee_makers();
+    assert!(vector::length(&fee_makers) == 0, 7357005);
+    let fees = transaction_fee::system_fees_collected();
+    assert!(fees == 1_000_000, 7357006); // val set entry fee
+  }
 
   #[test(root = @ol_framework, alice_val = @0x1000a)]
   fun test_init_burn_tracker(root: &signer, alice_val: &signer) {
@@ -383,7 +377,6 @@ module ol_framework::test_burn {
     assert!(prev_balance == marlon_salary, 7357002);
     assert!(burn_at_last_calc == 0, 7357003);
     assert!(cumu_burn == 0, 7357004);
-
   }
 
   #[test(root = @ol_framework, alice_val=@0x1000a)]
diff --git a/framework/libra-framework/sources/ol_sources/tests/donor_voice.test.move b/framework/libra-framework/sources/ol_sources/tests/donor_voice.test.move
index bff2ba214..2b39cd964 100644
--- a/framework/libra-framework/sources/ol_sources/tests/donor_voice.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/donor_voice.test.move
@@ -40,7 +40,7 @@ module ol_framework::test_donor_voice {
       // vals claim the offer
       multi_action::claim_offer(alice, donor_voice_address);
       multi_action::claim_offer(bob, donor_voice_address);
-      
+
       //need to be caged to finalize donor directed workflow and release control of the account
       multi_action::finalize_and_cage(&resource_sig, 2);
 
@@ -61,7 +61,7 @@ module ol_framework::test_donor_voice {
 
       // vals claim the offer
       multi_action::claim_offer(alice, donor_voice_address);
-      multi_action::claim_offer(bob, donor_voice_address); 
+      multi_action::claim_offer(bob, donor_voice_address);
 
       //need to be caged to finalize donor directed workflow and release control of the account
       multi_action::finalize_and_cage(&resource_sig, vector::length(&vals));
@@ -578,7 +578,7 @@ module ol_framework::test_donor_voice {
       multi_action::claim_offer(alice, donor_voice_address);
       multi_action::claim_offer(bob, donor_voice_address);
       multi_action::claim_offer(carol, donor_voice_address);
-      
+
       //need to be caged to finalize donor directed workflow and release control of the account
       multi_action::finalize_and_cage(&resource_sig, 2);
 
@@ -676,7 +676,7 @@ module ol_framework::test_donor_voice {
       // Dave and Eve are unhappy, and vote to liquidate the account.
 
       let vals = mock::genesis_n_vals(root, 5); // need to include eve to init funds
-      mock::ol_initialize_coin_and_fund_vals(root, 100000, true);
+      mock::ol_initialize_coin_and_fund_vals(root, 100_000, true);
       // start at epoch 1, since turnout tally needs epoch info, and 0 may cause
       // issues
       mock::trigger_epoch(root);
@@ -723,7 +723,6 @@ module ol_framework::test_donor_voice {
       assert!(*vector::borrow(&addrs, 0) == @0x1000e, 7357006);
       assert!(*vector::borrow(&addrs, 1) == @0x1000d, 7357007);
 
-
       let eve_donation_pro_rata = vector::borrow(&refunds, 0);
       let superman_3 = 1; // rounding from fixed_point32
       assert!((*eve_donation_pro_rata + superman_3) == eve_donation, 7357008);
@@ -732,7 +731,6 @@ module ol_framework::test_donor_voice {
       let superman_3 = 1; // rounding from fixed_point32
       assert!((*dave_donation_pro_rata + superman_3) == dave_donation, 7357009);
 
-
       let (_, program_balance_pre) = ol_account::balance(donor_voice_address);
       let (_, eve_balance_pre) = ol_account::balance(@0x1000e);
 
@@ -747,10 +745,9 @@ module ol_framework::test_donor_voice {
       // eve shoul have received funds back
       assert!(eve_balance > eve_balance_pre, 7357010);
 
-      let (lifetime_burn_now, _) = burn::get_lifetime_tracker();
       // nothing should have been burned, it was a refund
+      let (lifetime_burn_now, _) = burn::get_lifetime_tracker();
       assert!(lifetime_burn_now == lifetime_burn_pre, 7357011);
-
     }
 
     #[test(root = @ol_framework, alice = @0x1000a, dave = @0x1000d, eve = @0x1000e)]
diff --git a/framework/libra-framework/sources/ol_sources/tests/slow_wallet.test.move b/framework/libra-framework/sources/ol_sources/tests/slow_wallet.test.move
index b640e0c26..e4b9103c6 100644
--- a/framework/libra-framework/sources/ol_sources/tests/slow_wallet.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/slow_wallet.test.move
@@ -18,7 +18,7 @@ module ol_framework::test_slow_wallet {
   use std::vector;
   use std::signer;
 
-  // use diem_std::debug::print;
+   use diem_std::debug::print;
 
   #[test(root = @ol_framework)]
   // we are testing that genesis creates the needed struct
@@ -112,8 +112,8 @@ module ol_framework::test_slow_wallet {
   fun test_epoch_drip(root: signer) {
     let set = mock::genesis_n_vals(&root, 4);
     mock::ol_initialize_coin_and_fund_vals(&root, 100, false);
-    let a = *vector::borrow(&set, 0);
 
+    let a = *vector::borrow(&set, 0);
     assert!(slow_wallet::is_slow(a), 7357000);
     assert!(slow_wallet::unlocked_amount(a) == 100, 735701);
 
@@ -121,12 +121,13 @@ module ol_framework::test_slow_wallet {
     rewards::test_helper_pay_reward(&root, a, coin, 0);
 
     let (u, b) = ol_account::balance(a);
-    assert!(b==100000100, 735702);
+    print(&b);
+    assert!(b==500_000_100, 735702);
     assert!(u==100, 735703);
 
     slow_wallet::slow_wallet_epoch_drip(&root, 233);
     let (u, b) = ol_account::balance(a);
-    assert!(b==100000100, 735704);
+    assert!(b==500_000_100, 735704);
     assert!(u==333, 735705);
   }
 

From 58bbe964ac310f84e1423882fa4ae53fab70bb05 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Thu, 18 Jul 2024 23:26:03 -0300
Subject: [PATCH 11/16] extracts pure function from reward_thermostat and adds
 tests creates view query_reward_adjustment

---
 .../sources/ol_sources/proof_of_fee.move      | 336 ++++++++++++++----
 .../ol_sources/tests/proof_of_fee.test.move   |  55 +++
 2 files changed, 312 insertions(+), 79 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index 4a3e690a1..327a88f86 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -43,6 +43,14 @@ module ol_framework::proof_of_fee {
   /// based on another function or simply randomized within a range
   /// (as originally proposed in this feature request)
   const PCT_REDUCTION_FOR_COMPETITION: u64 = 10; // 10%
+  /// Upper bound threshold for bid percentages.
+  const BID_UPPER_BOUND: u64 = 0950; // 95%
+  /// Lower bound threshold for bid percentages.
+  const BID_LOWER_BOUND: u64 = 0500; // 50%
+  /// Short window period for recent bid trends.
+  const SHORT_WINDOW: u64 = 5; // 5 epochs
+  /// Long window period for extended bid trends.
+  const LONG_WINDOW: u64 = 10; // 10 epochs
 
   //////// ERRORS /////////
   /// Not an active validator
@@ -533,106 +541,87 @@ module ol_framework::proof_of_fee {
     fixed_point32::create_from_rational(bid_pct, 1000)
   }
 
-  /// Adjust the reward at the end of the epoch
-  /// as described in the paper, the epoch reward needs to be adjustable
-  /// given that the implicit bond needs to be sufficient, eg 5-10x the reward.
+
+  /// Calculates the reward adjustment based on bid history and nominal reward.
+  /// @param median_history - The median history of bids.
+  /// @param nominal_reward - The current nominal reward.
   /// @return Tuple (bool, bool, u64)
   /// 0: did the thermostat run,
   /// 1: did it increment, or decrease, bool
   /// 2: how much
-  /// if the thermostat returns (false, false, 0), it means there was an error running
-  public(friend) fun reward_thermostat(vm: &signer): (bool, bool, u64) acquires ConsensusReward {
-    system_addresses::assert_ol(vm);
-    // check the bid history
-    // if there are 5 days above 95% adjust the reward up by 5%
-    // adjust by more if it has been 10 days then, 10%
-    // if there are 5 days below 50% adjust the reward down.
-    // adjust by more if it has been 10 days then 10%
-
-    let bid_upper_bound = 0950;
-    let bid_lower_bound = 0500;
-
-    let short_window: u64 = 5;
-    let long_window: u64 = 10;
-
-    let cr = borrow_global_mut<ConsensusReward>(@ol_framework);
-
-    let len = vector::length<u64>(&cr.median_history);
-    let i = 0;
-
+  fun calculate_reward_adjustment(
+    median_history: &vector<u64>,
+    nominal_reward: u64
+  ): (bool, bool, u64) {
+    let history_length = vector::length<u64>(median_history);
+    let index = 0;
     let epochs_above = 0;
     let epochs_below = 0;
-    while (i < 16 && i < len) { // max ten days, but may have less in history, filling set should truncate the history at 15 epochs.
-      let avg_bid = *vector::borrow<u64>(&cr.median_history, i);
 
-      if (avg_bid > bid_upper_bound) {
+    while (index < 16 && index < history_length) {
+      let avg_bid = *vector::borrow<u64>(median_history, index);
+
+      if (avg_bid > BID_UPPER_BOUND) {
         epochs_above = epochs_above + 1;
-      } else if (avg_bid < bid_lower_bound) {
+      } else if (avg_bid < BID_LOWER_BOUND) {
         epochs_below = epochs_below + 1;
       };
 
-      i = i + 1;
+      index = index + 1;
     };
 
-    if (cr.nominal_reward > 0) {
-      // TODO: this is an initial implementation, we need to
-      // decide if we want more granularity in the reward adjustment
-      // Note: making this readable for now, but we can optimize later
+    if (nominal_reward > 0) {
       if (epochs_above > epochs_below) {
-
-        // if (epochs_above > short_window) {
-
-        // check for zeros.
-        // TODO: put a better safety check here
-
-        // If the Validators are bidding near 100% that means
-        // the reward is very generous, i.e. their opportunity
-        // cost is met at small percentages. This means the
-        // implicit bond is very high on validators. E.g.
-        // at 1% median bid, the implicit bond is 100x the reward.
-        // We need to DECREASE the reward
-
-        if (epochs_above > long_window) {
-          // decrease the reward by 10%
-          let less_ten_pct = (cr.nominal_reward / 10);
-          cr.nominal_reward = cr.nominal_reward - less_ten_pct;
+        if (epochs_above > LONG_WINDOW) {
+          let less_ten_pct = (nominal_reward / 10);
           return (true, false, less_ten_pct)
-        } else if (epochs_above > short_window) {
-          // decrease the reward by 5%
-          let less_five_pct = (cr.nominal_reward / 20);
-          cr.nominal_reward = cr.nominal_reward - less_five_pct;
+        } else if (epochs_above > SHORT_WINDOW) {
+          let less_five_pct = (nominal_reward / 20);
           return (true, false, less_five_pct)
         }
+      } else {
+        if (epochs_below > LONG_WINDOW) {
+          let increase_ten_pct = (nominal_reward / 10);
+          return (true, true, increase_ten_pct)
+        } else if (epochs_below > SHORT_WINDOW) {
+          let increase_five_pct = (nominal_reward / 20);
+          return (true, true, increase_five_pct)
+        }
       };
-      // return early since we can't increase and decrease simultaneously
-
-      // if validators are bidding low percentages
-      // it means the nominal reward is not high enough.
-      // That is the validator's opportunity cost is not met within a
-      // range where the bond is meaningful.
-      // For example: if the bids for the epoch's reward is 50% of the  value, that means the potential profit, is the same as the potential loss.
-      // At a 25% bid (potential loss), the profit is thus 75% of the value, which means the implicit bond is 25/75, or 1/3 of the bond, the risk favors the validator. This means among other things, that an attacker can pay for the cost of the attack with the profits. See paper, for more details.
-
-      // we need to INCREASE the reward, so that the bond is more meaningful.
-
-      if (epochs_below > long_window) {
-        // increase the reward by 10%
-        let increase_ten_pct = (cr.nominal_reward / 10);
-        cr.nominal_reward = cr.nominal_reward + increase_ten_pct;
-        return (true, true, increase_ten_pct)
-      } else if (epochs_below > short_window) {
-        // increase the reward by 5%
-        let increase_five_pct = (cr.nominal_reward / 20);
-        cr.nominal_reward = cr.nominal_reward + increase_five_pct;
-        return (true, true, increase_five_pct)
-      };
-
-      // we ran the thermostat but no change was made.
       return (true, false, 0)
     };
 
-    // nominal reward is zero, there's a problem
-    return (false, false, 0)
+    (false, false, 0)
+  }
+
+
+  /// Adjust the reward at the end of the epoch
+  /// as described in the paper, the epoch reward needs to be adjustable
+  /// given that the implicit bond needs to be sufficient, eg 5-10x the reward.
+  /// @param vm - The signer.
+  /// @return Tuple (bool, bool, u64)
+  /// 0: did the thermostat run,
+  /// 1: did it increment, or decrease, bool
+  /// 2: how much
+  /// if the thermostat returns (false, false, 0), it means there was an error running
+  public(friend) fun reward_thermostat(vm: &signer): (bool, bool, u64) acquires ConsensusReward {
+    system_addresses::assert_ol(vm);
+    let cr = borrow_global_mut<ConsensusReward>(@ol_framework);
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(
+      &cr.median_history,
+      cr.nominal_reward
+    );
+
+    if (did_run) {
+      if (did_increment) {
+        cr.nominal_reward = cr.nominal_reward + amount;
+      } else {
+        cr.nominal_reward = cr.nominal_reward - amount;
+      }
+    };
+
+    (did_run, did_increment, amount)
   }
 
   /// find the median bid to push to history
@@ -712,6 +701,26 @@ module ol_framework::proof_of_fee {
     return (false, 0)
   }
 
+  #[view]
+  /// Query the reward adjustment without altering the nominal reward.
+  /// @param vm - The signer.
+  /// @return Tuple (bool, bool, u64)
+  /// 0: did the thermostat run,
+  /// 1: did it increment, or decrease, bool
+  /// 2: how much
+  /// if the thermostat returns (false, false, 0), it means there was an error running
+  public fun query_reward_adjustment(): (bool, bool, u64) acquires ConsensusReward {
+    let cr = borrow_global<ConsensusReward>(@ol_framework);
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(
+      &cr.median_history,
+      cr.nominal_reward
+    );
+
+    (did_run, did_increment, amount)
+  }
+
+
   // Get the top N validators by bid, this is FILTERED by default
   public(friend) fun top_n_accounts(account: &signer, n: u64, unfiltered: bool): vector<address> acquires ProofOfFeeAuction, ConsensusReward {
     system_addresses::assert_vm(account);
@@ -1380,4 +1389,173 @@ module ol_framework::proof_of_fee {
     assert!(bids == vector[2, 2, 2, 2], 7357021);
     assert!(shuffled, 7357022);
   }
+
+
+  // Tests for calculate_reward_adjustment
+
+  #[test]
+  public fun cra_nominal_reward_zero() {
+    let median_history = vector::empty<u64>();
+    let nominal_reward = 0;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == false, 7357001);
+    assert!(did_increment == false, 7357002);
+    assert!(amount == 0, 7357003);
+  }
+
+  #[test]
+  public fun cra_empty_bid_history() {
+    let median_history = vector::empty<u64>();
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357004);
+    assert!(did_increment == false, 7357005);
+    assert!(amount == 0, 7357006);
+  }
+
+  #[test]
+  public fun cra_less_than_16_bids() {
+    // 10 entries all with value 600
+    let median_history = vector[600, 600, 600, 600, 600, 600, 600, 600, 600, 600];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357007);
+    assert!(did_increment == false, 7357008);
+    assert!(amount == 0, 7357009);
+  }
+
+  #[test]
+  public fun cra_exactly_16_bids() {
+    // 16 entries all with value 600
+    let median_history = vector[600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357010);
+    assert!(did_increment == false, 7357011);
+    assert!(amount == 0, 7357012);
+  }
+
+  #[test]
+  public fun cra_more_than_16_bids() {
+    // 20 entries all with value 600
+    let median_history = vector[600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357013);
+    assert!(did_increment == false, 7357014);
+    assert!(amount == 0, 7357015);
+  }
+
+  #[test]
+  public fun cra_all_bids_above_upper_bound_short_window() {
+    // 6 entries all with value 960
+    let median_history = vector[960, 960, 960, 960, 960, 960];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357016);
+    assert!(did_increment == false, 7357017);
+    assert!(amount == nominal_reward / 20, 7357018);
+  }
+
+  #[test]
+  public fun cra_all_bids_above_upper_bound_long_window() {
+    // 11 entries all with value 960
+    let median_history = vector[960, 960, 960, 960, 960, 960, 960, 960, 960, 960, 960];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357019);
+    assert!(did_increment == false, 7357020);
+    assert!(amount == nominal_reward / 10, 7357021);
+  }
+
+  #[test]
+  public fun cra_all_bids_below_lower_bound_short_window() {
+    // 6 entries all with value 400
+    let median_history = vector[400, 400, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357022);
+    assert!(did_increment == true, 7357023);
+    assert!(amount == nominal_reward / 20, 7357024);
+  }
+
+  #[test]
+  public fun cra_all_bids_below_lower_bound_long_window() {
+    // 11 entries all with value 400
+    let median_history = vector[400, 400, 400, 400, 400, 400, 400, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357025);
+    assert!(did_increment == true, 7357026);
+    assert!(amount == nominal_reward / 10, 7357027);
+  }
+
+  #[test]
+  public fun cra_mixed_bids_with_majority_above() {
+    // 9 entries above upper bound and 7 entries below lower bound
+    let median_history = vector[960, 960, 960, 960, 960, 960, 960, 960, 960, 400, 400, 400, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357028);
+    assert!(did_increment == false, 7357029);
+    assert!(amount == nominal_reward / 20, 7357030); // Since the total entries are 16, it falls under the short window
+  }
+
+  #[test]
+  public fun cra_mixed_bids_with_majority_below() {
+    // 9 entries below lower bound and 7 entries above upper bound
+    let median_history = vector[400, 400, 400, 400, 400, 400, 400, 400, 400, 960, 960, 960, 960, 960, 960, 960];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357031);
+    assert!(did_increment == true, 7357032);
+    assert!(amount == nominal_reward / 20, 7357033); // Since the total entries are 16, it falls under the short window
+  }
+
+  #[test]
+  public fun cra_mixed_bids_without_clear_majority() {
+    // 4 entries below lower bound and 4 entries above upper bound
+    let median_history = vector[400, 400, 400, 400, 960, 960, 960, 960];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357034);
+    assert!(did_increment == false, 7357035);
+    assert!(amount == 0, 7357036);
+  }
+
+  #[test]
+  public fun cra_majority_above_long_window() {
+    // 12 entries above upper bound and 4 entries below lower bound
+    let median_history = vector[960, 960, 960, 960, 960, 960, 960, 960, 960, 960, 960, 960, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357037);
+    assert!(did_increment == false, 7357038);
+    assert!(amount == nominal_reward / 10, 7357039); // Majority above and longer than long window
+  }
+
+  #[test]
+  public fun cra_majority_above_short_window() {
+    // 7 entries above upper bound and 4 entries below lower bound
+    let median_history = vector[960, 960, 960, 960, 960, 960, 960, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    let (did_run, did_increment, amount) = calculate_reward_adjustment(&median_history, nominal_reward);
+    assert!(did_run == true, 7357040);
+    assert!(did_increment == false, 7357041);
+    assert!(amount == nominal_reward / 20, 7357042); // Majority above and longer than short window but not long window
+  }
 }
diff --git a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
index 6de127ede..26a849121 100644
--- a/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/proof_of_fee.test.move
@@ -594,4 +594,59 @@ module ol_framework::test_pof {
     assert!(median_bid == 3, 10014);
   }
 
+  // Tests for query_reward_adjustment
+
+  #[test(root = @ol_framework)]
+  public fun test_query_reward_adjustment_no_change(root: &signer) {
+    use diem_framework::chain_id;
+    proof_of_fee::init_genesis_baseline_reward(root);
+    chain_id::initialize_for_test(root, 4);
+
+    // 16 entries all with value 600
+    let median_history = vector[600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600, 600];
+    let nominal_reward = 1000;
+
+    proof_of_fee::test_mock_reward(root, nominal_reward, 500, 500, median_history);
+
+    let (did_run, did_increment, amount) = proof_of_fee::query_reward_adjustment();
+    assert!(did_run == true, 7357043);
+    assert!(did_increment == false, 7357044);
+    assert!(amount == 0, 7357045);
+  }
+
+  #[test(root = @ol_framework)]
+  public fun test_query_reward_adjustment_increase(root: &signer) {
+    use diem_framework::chain_id;
+    proof_of_fee::init_genesis_baseline_reward(root);
+    chain_id::initialize_for_test(root, 4);
+
+    // 11 entries all with value 400
+    let median_history = vector[400, 400, 400, 400, 400, 400, 400, 400, 400, 400, 400];
+    let nominal_reward = 1000;
+
+    proof_of_fee::test_mock_reward(root, nominal_reward, 500, 500, median_history);
+
+    let (did_run, did_increment, amount) = proof_of_fee::query_reward_adjustment();
+    assert!(did_run == true, 7357046);
+    assert!(did_increment == true, 7357047);
+    assert!(amount == nominal_reward / 10, 7357048);
+  }
+
+  #[test(root = @ol_framework)]
+  public fun test_query_reward_adjustment_decrease(root: &signer) {
+    use diem_framework::chain_id;
+    proof_of_fee::init_genesis_baseline_reward(root);
+    chain_id::initialize_for_test(root, 4);
+
+    // 11 entries all with value 960
+    let median_history = vector[960, 960, 960, 960, 960, 960, 960, 960, 960, 960, 960];
+    let nominal_reward = 1000;
+
+    proof_of_fee::test_mock_reward(root, nominal_reward, 500, 500, median_history);
+
+    let (did_run, did_increment, amount) = proof_of_fee::query_reward_adjustment();
+    assert!(did_run == true, 7357049);
+    assert!(did_increment == false, 7357050);
+    assert!(amount == nominal_reward / 10, 7357051);
+  }
 }

From e3ceeb0c6b07e0b0a895911e97ea9d990e618e8d Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 19 Jul 2024 18:26:17 -0300
Subject: [PATCH 12/16] fixes persist_genesis smoke test

---
 tools/config/src/make_yaml_public_fullnode.rs | 34 ++++++++++++++-----
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/tools/config/src/make_yaml_public_fullnode.rs b/tools/config/src/make_yaml_public_fullnode.rs
index 04ee7e1e3..24c68bb6d 100644
--- a/tools/config/src/make_yaml_public_fullnode.rs
+++ b/tools/config/src/make_yaml_public_fullnode.rs
@@ -181,8 +181,7 @@ mempool:
 /// download genesis blob and save it to the specified directory.
 pub async fn download_genesis(home_dir: Option<PathBuf>) -> anyhow::Result<()> {
     // Base URL for GitHub API requests
-    let base_url =
-        "https://api.github.com/repos/0LNetworkCommunity/epoch-archive-mainnet/contents/upgrades";
+    let base_url = "https://api.github.com/repos/0LNetworkCommunity/epoch-archive-mainnet/contents/upgrades";
     let client = reqwest::Client::new();
     let resp = client
         .get(base_url)
@@ -191,6 +190,7 @@ pub async fn download_genesis(home_dir: Option<PathBuf>) -> anyhow::Result<()> {
         .await?
         .json::<Vec<GithubContent>>()
         .await?;
+
     // Find the latest version by parsing version numbers and sorting
     let latest_version = resp
         .iter()
@@ -202,16 +202,23 @@ pub async fn download_genesis(home_dir: Option<PathBuf>) -> anyhow::Result<()> {
         "https://raw.githubusercontent.com/0LNetworkCommunity/epoch-archive-mainnet/main/upgrades",
         latest_version.unwrap_or(DEFAULT_WAYPOINT_VERSION)
     );
+
     // Fetch the latest waypoint
     let blob_bytes = reqwest::get(&latest_path).await?.bytes().await?;
     let home = home_dir.unwrap_or_else(libra_types::global_config_dir);
     let genesis_dir = home.join("genesis/");
+
+    // Ensure the genesis directory exists
+    std::fs::create_dir_all(&genesis_dir)?;
+
     let p = genesis_dir.join("genesis.blob");
 
+    // Write the genesis blob to the file
     std::fs::write(p, &blob_bytes)?;
     Ok(())
 }
 
+
 /// Fetch the genesis waypoint from the GitHub repository.
 pub async fn get_genesis_waypoint(home_dir: Option<PathBuf>) -> anyhow::Result<Waypoint> {
     // Base URL for GitHub API requests
@@ -289,11 +296,20 @@ async fn persist_genesis() {
 
     let path = p.path().to_owned();
 
-    download_genesis(Some(path)).await.unwrap();
-    let l = std::fs::read_dir(p.path())
-        .unwrap()
-        .next()
-        .unwrap()
-        .unwrap();
-    assert!(l.file_name().to_str().unwrap().contains("genesis.blob"));
+    // Ensure the directory exists
+    assert!(std::fs::metadata(&path).is_ok(), "Directory does not exist: {:?}", path);
+
+    // Verify path is a directory
+    assert!(Path::new(&path).is_dir(), "Path is not a directory: {:?}", path);
+
+    // Attempt to download genesis
+    download_genesis(Some(path.clone())).await.unwrap();
+
+    // Check if the genesis.blob file exists
+    let genesis_blob_path = path.join("genesis").join("genesis.blob");
+    assert!(
+        genesis_blob_path.exists(),
+        "genesis.blob file does not exist: {:?}",
+        genesis_blob_path
+    );
 }

From cf21355497474172bb4e76f9a92ce9c1a0478f33 Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Fri, 19 Jul 2024 18:45:28 -0300
Subject: [PATCH 13/16] applies rlint

---
 tools/config/src/make_yaml_public_fullnode.rs | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/tools/config/src/make_yaml_public_fullnode.rs b/tools/config/src/make_yaml_public_fullnode.rs
index 24c68bb6d..0ecd48389 100644
--- a/tools/config/src/make_yaml_public_fullnode.rs
+++ b/tools/config/src/make_yaml_public_fullnode.rs
@@ -181,7 +181,8 @@ mempool:
 /// download genesis blob and save it to the specified directory.
 pub async fn download_genesis(home_dir: Option<PathBuf>) -> anyhow::Result<()> {
     // Base URL for GitHub API requests
-    let base_url = "https://api.github.com/repos/0LNetworkCommunity/epoch-archive-mainnet/contents/upgrades";
+    let base_url =
+        "https://api.github.com/repos/0LNetworkCommunity/epoch-archive-mainnet/contents/upgrades";
     let client = reqwest::Client::new();
     let resp = client
         .get(base_url)
@@ -218,7 +219,6 @@ pub async fn download_genesis(home_dir: Option<PathBuf>) -> anyhow::Result<()> {
     Ok(())
 }
 
-
 /// Fetch the genesis waypoint from the GitHub repository.
 pub async fn get_genesis_waypoint(home_dir: Option<PathBuf>) -> anyhow::Result<Waypoint> {
     // Base URL for GitHub API requests
@@ -297,10 +297,18 @@ async fn persist_genesis() {
     let path = p.path().to_owned();
 
     // Ensure the directory exists
-    assert!(std::fs::metadata(&path).is_ok(), "Directory does not exist: {:?}", path);
+    assert!(
+        std::fs::metadata(&path).is_ok(),
+        "Directory does not exist: {:?}",
+        path
+    );
 
     // Verify path is a directory
-    assert!(Path::new(&path).is_dir(), "Path is not a directory: {:?}", path);
+    assert!(
+        Path::new(&path).is_dir(),
+        "Path is not a directory: {:?}",
+        path
+    );
 
     // Attempt to download genesis
     download_genesis(Some(path.clone())).await.unwrap();

From c86d64b4f8421ad00c16b516a65a9d7eb78b34da Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Sun, 21 Jul 2024 15:00:27 -0300
Subject: [PATCH 14/16] initializes randomness data

---
 .../src/libra_framework_sdk_builder.rs        |  30 +++++------
 .../libra-framework/sources/genesis.move      |   2 +
 .../sources/ol_sources/epoch_boundary.move    |  47 +++++++++++-------
 framework/releases/head.mrb                   | Bin 863549 -> 878837 bytes
 4 files changed, 46 insertions(+), 33 deletions(-)

diff --git a/framework/cached-packages/src/libra_framework_sdk_builder.rs b/framework/cached-packages/src/libra_framework_sdk_builder.rs
index 4458a648e..83266963c 100644
--- a/framework/cached-packages/src/libra_framework_sdk_builder.rs
+++ b/framework/cached-packages/src/libra_framework_sdk_builder.rs
@@ -32,6 +32,8 @@ type Bytes = Vec<u8>;
 /// }
 /// ```
 #[derive(Clone, Debug, PartialEq, Eq)]
+#[cfg_attr(feature = "fuzzing", derive(proptest_derive::Arbitrary))]
+#[cfg_attr(feature = "fuzzing", proptest(no_params))]
 pub enum EntryFunctionCall {
     /// Offers rotation capability on behalf of `account` to the account at address `recipient_address`.
     /// An account can delegate its rotation capability to only one other address at one time. If the account
@@ -93,14 +95,14 @@ pub enum EntryFunctionCall {
     /// Generic authentication key rotation function that allows the user to rotate their authentication key from any scheme to any scheme.
     /// To authorize the rotation, we need two signatures:
     /// - the first signature `cap_rotate_key` refers to the signature by the account owner's current key on a valid `RotationProofChallenge`,
-    ///   demonstrating that the user intends to and has the capability to rotate the authentication key of this account;
+    /// demonstrating that the user intends to and has the capability to rotate the authentication key of this account;
     /// - the second signature `cap_update_table` refers to the signature by the new key (that the account owner wants to rotate to) on a
-    ///   valid `RotationProofChallenge`, demonstrating that the user owns the new private key, and has the authority to update the
-    ///   `OriginatingAddress` map with the new address mapping `<new_address, originating_address>`.
-    ///   To verify these two signatures, we need their corresponding public key and public key scheme: we use `from_scheme` and `from_public_key_bytes`
-    ///   to verify `cap_rotate_key`, and `to_scheme` and `to_public_key_bytes` to verify `cap_update_table`.
-    ///   A scheme of 0 refers to an Ed25519 key and a scheme of 1 refers to Multi-Ed25519 keys.
-    ///   `originating address` refers to an account's original/first address.
+    /// valid `RotationProofChallenge`, demonstrating that the user owns the new private key, and has the authority to update the
+    /// `OriginatingAddress` map with the new address mapping `<new_address, originating_address>`.
+    /// To verify these two signatures, we need their corresponding public key and public key scheme: we use `from_scheme` and `from_public_key_bytes`
+    /// to verify `cap_rotate_key`, and `to_scheme` and `to_public_key_bytes` to verify `cap_update_table`.
+    /// A scheme of 0 refers to an Ed25519 key and a scheme of 1 refers to Multi-Ed25519 keys.
+    /// `originating address` refers to an account's original/first address.
     ///
     /// Here is an example attack if we don't ask for the second signature `cap_update_table`:
     /// Alice has rotated her account `addr_a` to `new_addr_a`. As a result, the following entry is created, to help Alice when recovering her wallet:
@@ -1027,14 +1029,14 @@ pub fn account_revoke_signer_capability(
 /// Generic authentication key rotation function that allows the user to rotate their authentication key from any scheme to any scheme.
 /// To authorize the rotation, we need two signatures:
 /// - the first signature `cap_rotate_key` refers to the signature by the account owner's current key on a valid `RotationProofChallenge`,
-///   demonstrating that the user intends to and has the capability to rotate the authentication key of this account;
+/// demonstrating that the user intends to and has the capability to rotate the authentication key of this account;
 /// - the second signature `cap_update_table` refers to the signature by the new key (that the account owner wants to rotate to) on a
-///   valid `RotationProofChallenge`, demonstrating that the user owns the new private key, and has the authority to update the
-///   `OriginatingAddress` map with the new address mapping `<new_address, originating_address>`.
-///   To verify these two signatures, we need their corresponding public key and public key scheme: we use `from_scheme` and `from_public_key_bytes`
-///   to verify `cap_rotate_key`, and `to_scheme` and `to_public_key_bytes` to verify `cap_update_table`.
-///   A scheme of 0 refers to an Ed25519 key and a scheme of 1 refers to Multi-Ed25519 keys.
-///   `originating address` refers to an account's original/first address.
+/// valid `RotationProofChallenge`, demonstrating that the user owns the new private key, and has the authority to update the
+/// `OriginatingAddress` map with the new address mapping `<new_address, originating_address>`.
+/// To verify these two signatures, we need their corresponding public key and public key scheme: we use `from_scheme` and `from_public_key_bytes`
+/// to verify `cap_rotate_key`, and `to_scheme` and `to_public_key_bytes` to verify `cap_update_table`.
+/// A scheme of 0 refers to an Ed25519 key and a scheme of 1 refers to Multi-Ed25519 keys.
+/// `originating address` refers to an account's original/first address.
 ///
 /// Here is an example attack if we don't ask for the second signature `cap_update_table`:
 /// Alice has rotated her account `addr_a` to `new_addr_a`. As a result, the following entry is created, to help Alice when recovering her wallet:
diff --git a/framework/libra-framework/sources/genesis.move b/framework/libra-framework/sources/genesis.move
index 161e92c1b..f61594a56 100644
--- a/framework/libra-framework/sources/genesis.move
+++ b/framework/libra-framework/sources/genesis.move
@@ -24,6 +24,7 @@ module diem_framework::genesis {
     use diem_framework::transaction_fee;
     use diem_framework::transaction_validation;
     use diem_framework::version;
+    use diem_framework::randomness;
 
     //////// 0L ////////
     use diem_framework::validator_universe;
@@ -137,6 +138,7 @@ module diem_framework::genesis {
         reconfiguration::initialize(&diem_framework_account);
         block::initialize(&diem_framework_account, epoch_interval_microsecs);
         state_storage::initialize(&diem_framework_account);
+        randomness::initialize(&diem_framework_account);
 
         //////// 0L ////////
 
diff --git a/framework/libra-framework/sources/ol_sources/epoch_boundary.move b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
index e78bb6f1b..ba93fa84c 100644
--- a/framework/libra-framework/sources/ol_sources/epoch_boundary.move
+++ b/framework/libra-framework/sources/ol_sources/epoch_boundary.move
@@ -1,32 +1,32 @@
 
 module diem_framework::epoch_boundary {
-  use ol_framework::slow_wallet;
-  use ol_framework::musical_chairs;
-  use ol_framework::proof_of_fee;
+  use std::error;
+  use std::vector;
+  use std::string;
+  use std::signer;
+  use diem_framework::account;
+  use diem_framework::randomness;
+  use diem_framework::coin::{Coin};
+  use diem_framework::create_signer;
+  use diem_framework::reconfiguration;
+  use diem_framework::transaction_fee;
+  use diem_framework::system_addresses;
   use ol_framework::stake;
-  use ol_framework::libra_coin::LibraCoin;
-  use ol_framework::rewards;
   use ol_framework::jail;
   use ol_framework::safe;
   use ol_framework::burn;
-  use ol_framework::donor_voice_txs;
+  use ol_framework::rewards;
+  use ol_framework::testnet;
   use ol_framework::fee_maker;
-  use ol_framework::infra_escrow;
   use ol_framework::libra_coin;
+  use ol_framework::slow_wallet;
   use ol_framework::match_index;
+  use ol_framework::proof_of_fee;
+  use ol_framework::infra_escrow;
+  use ol_framework::musical_chairs;
+  use ol_framework::donor_voice_txs;
+  use ol_framework::libra_coin::LibraCoin;
   use ol_framework::community_wallet_init;
-  use ol_framework::testnet;
-
-  use diem_framework::account;
-  use diem_framework::reconfiguration;
-  use diem_framework::transaction_fee;
-  use diem_framework::system_addresses;
-  use diem_framework::coin::{Coin};
-  use std::vector;
-  use std::error;
-  use std::string;
-  use std::signer;
-  use diem_framework::create_signer;
 
   use diem_std::debug::print;
 
@@ -261,6 +261,12 @@ module diem_framework::epoch_boundary {
     true
   }
 
+  // This function handles the necessary migrations that occur at the epoch boundary
+  // when new modules or structures are added by chain upgrades.
+  fun migrate_data(root: &signer) {
+    randomness::initialize(root);
+  }
+
   // Contains all of 0L's business logic for end of epoch.
   // This removed business logic from reconfiguration.move
   // and prevents dependency cycling.
@@ -272,6 +278,9 @@ module diem_framework::epoch_boundary {
     let root = &create_signer::create_signer(@ol_framework);
     let status = borrow_global_mut<BoundaryStatus>(@ol_framework);
 
+    print(&string::utf8(b"migrate_data"));
+    migrate_data(root);
+
     print(&string::utf8(b"status reset"));
     *status = reset();
 
diff --git a/framework/releases/head.mrb b/framework/releases/head.mrb
index b63243772b0f84f612318448d21b2e022d261b20..14d5715b6d642cdb7a4b6128a30d563883a4fc88 100644
GIT binary patch
delta 103672
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%0DaKc|
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
MeAzmz%nZQ(KSBH^rvLx|

delta 88460
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


From 17d33692948791b9d4ef065967e07e31809ce85e Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Sun, 21 Jul 2024 19:42:09 -0300
Subject: [PATCH 15/16] creates address_utils module to host bubble sort
 algorithm and shuffle duplicates

---
 framework/drop-user-tools/jail_with_gc.move   |  32 +--
 .../sources/ol_sources/address_utils.move     | 229 ++++++++++++++++++
 .../sources/ol_sources/jail.move              |  33 +--
 .../sources/ol_sources/proof_of_fee.move      | 205 +---------------
 .../sources/ol_sources/rank.todo              |   2 +-
 .../sources/ol_sources/tests/jail.test.move   |   3 +-
 .../sources/ol_sources/tests/stake.test.move  |  24 +-
 framework/libra-framework/sources/stake.move  |  29 +--
 8 files changed, 273 insertions(+), 284 deletions(-)
 create mode 100644 framework/libra-framework/sources/ol_sources/address_utils.move

diff --git a/framework/drop-user-tools/jail_with_gc.move b/framework/drop-user-tools/jail_with_gc.move
index cab301d38..1e355fcd0 100644
--- a/framework/drop-user-tools/jail_with_gc.move
+++ b/framework/drop-user-tools/jail_with_gc.move
@@ -160,31 +160,21 @@ module ol_framework::jail {
     };
   }
 
-  /// gets a list of validators based on their jail reputation
+  /// Sort validators based on their jail reputation
   /// this is used in the bidding process for Proof-of-Fee where
   /// we seat the validators with the least amount of consecutive failures
   /// to rejoin.
   public(friend) fun sort_by_jail(vec_address: vector<address>): vector<address> acquires Jail {
-
-    // Sorting the accounts vector based on value (weights).
-    // Bubble sort algorithm
-    let length = vector::length(&vec_address);
-
-    let i = 0;
-    while (i < length){
-      let j = 0;
-      while(j < length-i-1){
-
-        let (_, value_j) = get_jail_reputation(*vector::borrow(&vec_address, j));
-        let (_, value_jp1) = get_jail_reputation(*vector::borrow(&vec_address, j + 1));
-
-        if(value_j > value_jp1){
-          vector::swap<address>(&mut vec_address, j, j+1);
-        };
-        j = j + 1;
-      };
-      i = i + 1;
-    };
+    // get the reputation of the validators
+    let reputation = vector::map(vec_address, |addr| {
+      let (_, value) = get_jail_reputation(addr);
+      value
+    });
+
+    // sort the validators based on their reputation
+    address_utils::sort_by_values(&mut vec_address, &mut reputation);
+    // shuffle duplicates scores to ensure fairness
+    address_utils::shuffle_duplicates(&mut vec_address, &reputation);
 
     vec_address
   }
diff --git a/framework/libra-framework/sources/ol_sources/address_utils.move b/framework/libra-framework/sources/ol_sources/address_utils.move
new file mode 100644
index 000000000..dd696932a
--- /dev/null
+++ b/framework/libra-framework/sources/ol_sources/address_utils.move
@@ -0,0 +1,229 @@
+/// This module provides utility functions for handling and manipulating vectors of
+/// addresses and their corresponding values.
+
+module ol_framework::address_utils {
+  use std::error;
+  use std::vector;
+  use diem_framework::randomness;
+
+  // Error code for different length of addresses and values
+  const EDIFFERENT_LENGTH: u64 = 1;
+
+  // A, B, C, easy as 1, 2, 3
+
+  // Bubble sort addresses and corresponding values
+  public fun sort_by_values(addresses: &mut vector<address>, values: &mut vector<u64>) {
+    assert!(vector::length(addresses) == vector::length(values), error::invalid_argument(EDIFFERENT_LENGTH));
+    let len = vector::length<u64>(values);
+    let i = 0;
+    while (i < len) {
+      let j = 0;
+      while (j < len - i - 1) {
+        let value_j = *vector::borrow<u64>(values, j);
+        let value_jp1 = *vector::borrow<u64>(values, j + 1);
+        if (value_j > value_jp1) {
+          vector::swap<u64>(values, j, j + 1);
+          vector::swap<address>(addresses, j, j + 1);
+        };
+        j = j + 1;
+      };
+      i = i + 1;
+    };
+  }
+
+  // Shuffle addresses with the same values to ensure randomness position
+  public fun shuffle_duplicates(addresses: &mut vector<address>, values: &vector<u64>) {
+    assert!(vector::length(addresses) == vector::length(values), error::invalid_argument(EDIFFERENT_LENGTH));
+    let len = vector::length(values);
+    let i = 0;
+    while (i < len) {
+      let j = i + 1;
+      while (j < len && *vector::borrow(values, i) == *vector::borrow(values, j)) {
+        j = j + 1;
+      };
+      if (j > i + 1) {
+        let slice_len = j - i;
+        let perm = randomness::permutation(slice_len);
+        let temp_addresses = vector::empty<address>();
+        let k = 0;
+        while (k < slice_len) {
+          let pos = i + k;
+          vector::push_back(&mut temp_addresses, *vector::borrow(addresses, pos));
+          k = k + 1;
+        };
+        k = 0;
+        while (k < slice_len) {
+          let perm_pos = *vector::borrow(&perm, k);
+          *vector::borrow_mut(addresses, i + k) = *vector::borrow(&temp_addresses, perm_pos);
+          k = k + 1;
+        };
+      };
+      i = j;
+    };
+  }
+
+  // Bubble Sort tests
+
+  #[test]
+  #[expected_failure(abort_code = 0x10001, location = ol_framework::address_utils)]
+  fun test_sort_by_values_different_lengths() {
+    let values = vector[1, 2, 3];
+    let addresses = vector[@0x1, @0x2];
+    // This should trigger an assertion error due to different lengths
+    sort_by_values(&mut addresses, &mut values);
+  }
+
+  #[test]
+  fun test_sort_empty_vectors() {
+    let values: vector<u64> = vector::empty();
+    let addresses: vector<address> = vector::empty();
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[], 10002);
+    assert!(addresses == vector[], 10003);
+  }
+
+  #[test]
+  fun test_sort_single_element() {
+    let values = vector[10];
+    let addresses = vector[@0x1];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[10], 10004);
+    assert!(addresses == vector[@0x1], 10005);
+  }
+
+  #[test]
+  fun test_sort_already_sorted() {
+    let values = vector[1, 2, 3, 4, 5];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[1, 2, 3, 4, 5], 10006);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 10007);
+  }
+
+  #[test]
+  fun test_sort_reverse_order() {
+    let values = vector[5, 4, 3, 2, 1];
+    let addresses = vector[@0x5, @0x4, @0x3, @0x2, @0x1];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[1, 2, 3, 4, 5], 10008);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 10009);
+  }
+
+  #[test]
+  fun test_sort_with_duplicates() {
+    let values = vector[4, 2, 2, 3, 1];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[1, 2, 2, 3, 4], 10010);
+    assert!(addresses == vector[@0x5, @0x2, @0x3, @0x4, @0x1], 10011);
+  }
+
+  #[test]
+  fun test_sort_random_order() {
+    let values = vector[3, 1, 4, 5, 2];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[1, 2, 3, 4, 5], 10012);
+    assert!(addresses == vector[@0x2, @0x5, @0x1, @0x3, @0x4], 10013);
+  }
+
+  #[test]
+  fun test_sort_all_elements_equal() {
+    let values = vector[3, 3, 3, 3, 3];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    sort_by_values(&mut addresses, &mut values);
+    assert!(values == vector[3, 3, 3, 3, 3], 10014);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 10015);
+  }
+
+
+  // Shuffle Tests
+
+  #[test]
+  #[expected_failure(abort_code = 0x10001, location = ol_framework::address_utils)]
+  fun test_shuffle_duplicates_different_lengths() {
+    let values = vector[1, 2, 3];
+    let addresses = vector[@0x1, @0x2];
+    // This should trigger an assertion error due to different lengths
+    shuffle_duplicates(&mut addresses, &mut values);
+  }
+
+  #[test]
+  fun test_shuffle_no_duplicates() {
+    // No duplicates in the values vector
+    let values = vector[1, 2, 3, 4, 5];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    shuffle_duplicates(&mut addresses, &mut values);
+    assert!(values == vector[1, 2, 3, 4, 5], 10017);
+    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 10018);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_with_duplicates(root: &signer) {
+    // One group of duplicates in the values vector
+    randomness::initialize_for_testing(root);
+    let values = vector[1, 2, 2, 3, 4];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut addresses, &mut values);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(values == vector[1, 2, 2, 3, 4], 10019);
+    assert!(shuffled, 10020);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_multiple_duplicate_groups(root: &signer) {
+    // Multiple groups of duplicates in the values vector
+    randomness::initialize_for_testing(root);
+    let values = vector[1, 2, 2, 3, 3, 4];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut addresses, &mut values);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(values == vector[1, 2, 2, 3, 3, 4], 10021);
+    assert!(shuffled, 10022);
+  }
+
+  #[test(root = @ol_framework)]
+  fun test_shuffle_all_elements_equal(root: &signer) {
+    // All elements in the values vector are the same
+    randomness::initialize_for_testing(root);
+    let values = vector[2, 2, 2, 2];
+    let addresses = vector[@0x1, @0x2, @0x3, @0x4];
+    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4];
+    let shuffled = false;
+    let i = 0;
+
+    while (i < 10) {
+      shuffle_duplicates(&mut addresses, &mut values);
+      if (addresses != original_addresses) {
+        shuffled = true;
+        break
+      };
+      i = i + 1;
+    };
+
+    assert!(values == vector[2, 2, 2, 2], 10023);
+    assert!(shuffled, 10024);
+  }
+}
diff --git a/framework/libra-framework/sources/ol_sources/jail.move b/framework/libra-framework/sources/ol_sources/jail.move
index 8c32fd4a4..cde4d4e77 100644
--- a/framework/libra-framework/sources/ol_sources/jail.move
+++ b/framework/libra-framework/sources/ol_sources/jail.move
@@ -46,6 +46,7 @@ module ol_framework::jail {
   use std::error;
   use ol_framework::vouch;
   use ol_framework::stake;
+  use ol_framework::address_utils;
 
   friend ol_framework::validator_universe;
   friend ol_framework::epoch_boundary;
@@ -157,31 +158,21 @@ module ol_framework::jail {
     };
   }
 
-  /// gets a list of validators based on their jail reputation
+  /// Sort validators based on their jail reputation
   /// this is used in the bidding process for Proof-of-Fee where
   /// we seat the validators with the least amount of consecutive failures
   /// to rejoin.
   public(friend) fun sort_by_jail(vec_address: vector<address>): vector<address> acquires Jail {
-
-    // Sorting the accounts vector based on value (weights).
-    // Bubble sort algorithm
-    let length = vector::length(&vec_address);
-
-    let i = 0;
-    while (i < length){
-      let j = 0;
-      while(j < length-i-1){
-
-        let (_, value_j) = get_jail_reputation(*vector::borrow(&vec_address, j));
-        let (_, value_jp1) = get_jail_reputation(*vector::borrow(&vec_address, j + 1));
-
-        if(value_j > value_jp1){
-          vector::swap<address>(&mut vec_address, j, j+1);
-        };
-        j = j + 1;
-      };
-      i = i + 1;
-    };
+    // get the reputation of the validators
+    let reputation = vector::map(vec_address, |addr| {
+      let (_, value) = get_jail_reputation(addr);
+      value
+    });
+
+    // sort the validators based on their reputation
+    address_utils::sort_by_values(&mut vec_address, &mut reputation);
+    // shuffle duplicates scores to ensure fairness
+    address_utils::shuffle_duplicates(&mut vec_address, &reputation);
 
     vec_address
   }
diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index 327a88f86..bfc57be74 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -14,7 +14,6 @@ module ol_framework::proof_of_fee {
   use std::fixed_point32;
   use diem_framework::validator_universe;
   use diem_framework::transaction_fee;
-  use diem_framework::randomness;
   use diem_framework::account;
   use diem_framework::stake;
   use diem_framework::system_addresses;
@@ -23,6 +22,7 @@ module ol_framework::proof_of_fee {
   use ol_framework::vouch;
   use ol_framework::epoch_helper;
   use ol_framework::globals;
+  use ol_framework::address_utils;
   //use diem_std::debug::print;
 
   friend diem_framework::genesis;
@@ -283,68 +283,18 @@ module ol_framework::proof_of_fee {
     };
 
     // Sorting the accounts vector based on their bids
-    bubble_sort_bids(&mut bids, &mut filtered_vals);
+    address_utils::sort_by_values(&mut filtered_vals, &mut bids);
 
     // Reverse to have sorted order - high to low.
     vector::reverse(&mut filtered_vals);
     vector::reverse(&mut bids);
 
     // Shuffle duplicates to garantee randomness/fairness
-    shuffle_duplicates(&mut bids, &mut filtered_vals);
+    address_utils::shuffle_duplicates(&mut filtered_vals, &mut bids);
 
     return (filtered_vals, bids)
   }
 
-  // Bubble sort bids and corresponding addresses
-  fun bubble_sort_bids(bids: &mut vector<u64>, addresses: &mut vector<address>) {
-    let len = vector::length<u64>(bids);
-    let i = 0;
-    while (i < len) {
-      let j = 0;
-      while (j < len - i - 1) {
-        let value_j = *vector::borrow<u64>(bids, j);
-        let value_jp1 = *vector::borrow<u64>(bids, j + 1);
-        if (value_j > value_jp1) {
-          vector::swap<u64>(bids, j, j + 1);
-          vector::swap<address>(addresses, j, j + 1);
-        };
-        j = j + 1;
-      };
-      i = i + 1;
-    };
-  }
-
-  // Shuffle addresses with the same bid amount to ensure randomness position
-  fun shuffle_duplicates(bids: &vector<u64>, addresses: &mut vector<address>) {
-    let len = vector::length(bids);
-    let i = 0;
-    while (i < len) {
-      let j = i + 1;
-      while (j < len && *vector::borrow(bids, i) == *vector::borrow(bids, j)) {
-        j = j + 1;
-      };
-      if (j > i + 1) {
-        let slice_len = j - i;
-        let perm = randomness::permutation(slice_len);
-        let temp_addresses = vector::empty<address>();
-        let k = 0;
-        while (k < slice_len) {
-          let pos = i + k;
-          vector::push_back(&mut temp_addresses, *vector::borrow(addresses, pos));
-          k = k + 1;
-        };
-        k = 0;
-        while (k < slice_len) {
-          let perm_pos = *vector::borrow(&perm, k);
-          *vector::borrow_mut(addresses, i + k) = *vector::borrow(&temp_addresses, perm_pos);
-          k = k + 1;
-        };
-      };
-      i = j;
-    };
-  }
-
-
   #[view]
   /// checks if the validator has enough vouchers in the current set (prior to entry)
   /// @params incoming address to be evaluated
@@ -1242,155 +1192,6 @@ module ol_framework::proof_of_fee {
     assert!(result == 21, 7357030);
   }
 
-
-  // Bubble Sort tests
-
-  #[test]
-  fun test_bubble_sort_empty_vectors() {
-    let bids: vector<u64> = vector::empty();
-    let addresses: vector<address> = vector::empty();
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[], 7357001);
-    assert!(addresses == vector[], 7357002);
-  }
-
-  #[test]
-  fun test_bubble_sort_single_element() {
-    let bids = vector[10];
-    let addresses = vector[@0x1];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[10], 7357003);
-    assert!(addresses == vector[@0x1], 7357004);
-  }
-
-  #[test]
-  fun test_bubble_sort_already_sorted() {
-    let bids = vector[1, 2, 3, 4, 5];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[1, 2, 3, 4, 5], 7357005);
-    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357006);
-  }
-
-  #[test]
-  fun test_bubble_sort_reverse_order() {
-    let bids = vector[5, 4, 3, 2, 1];
-    let addresses = vector[@0x5, @0x4, @0x3, @0x2, @0x1];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[1, 2, 3, 4, 5], 7357007);
-    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357008);
-  }
-
-  #[test]
-  fun test_bubble_sort_with_duplicates() {
-    let bids = vector[4, 2, 2, 3, 1];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[1, 2, 2, 3, 4], 7357009);
-    assert!(addresses == vector[@0x5, @0x2, @0x3, @0x4, @0x1], 7357010);
-  }
-
-  #[test]
-  fun test_bubble_sort_random_order() {
-    let bids = vector[3, 1, 4, 5, 2];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[1, 2, 3, 4, 5], 7357011);
-    assert!(addresses == vector[@0x2, @0x5, @0x1, @0x3, @0x4], 7357012);
-  }
-
-  #[test]
-  fun test_bubble_sort_all_elements_equal() {
-    let bids = vector[3, 3, 3, 3, 3];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    bubble_sort_bids(&mut bids, &mut addresses);
-    assert!(bids == vector[3, 3, 3, 3, 3], 7357013);
-    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357014);
-  }
-
-
-  // Shuffle Tests
-
-  #[test]
-  fun test_shuffle_no_duplicates() {
-    // No duplicates in the bids vector
-    let bids = vector[1, 2, 3, 4, 5];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    shuffle_duplicates(&mut bids, &mut addresses);
-    assert!(bids == vector[1, 2, 3, 4, 5], 7357015);
-    assert!(addresses == vector[@0x1, @0x2, @0x3, @0x4, @0x5], 7357016);
-  }
-
-  #[test(root = @ol_framework)]
-  fun test_shuffle_with_duplicates(root: &signer) {
-    // One group of duplicates in the bids vector
-    randomness::initialize_for_testing(root);
-    let bids = vector[1, 2, 2, 3, 4];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5];
-    let shuffled = false;
-    let i = 0;
-
-    while (i < 10) {
-      shuffle_duplicates(&mut bids, &mut addresses);
-      if (addresses != original_addresses) {
-        shuffled = true;
-        break
-      };
-      i = i + 1;
-    };
-
-    assert!(bids == vector[1, 2, 2, 3, 4], 7357017);
-    assert!(shuffled, 7357018);
-  }
-
-  #[test(root = @ol_framework)]
-  fun test_shuffle_multiple_duplicate_groups(root: &signer) {
-    // Multiple groups of duplicates in the bids vector
-    randomness::initialize_for_testing(root);
-    let bids = vector[1, 2, 2, 3, 3, 4];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
-    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4, @0x5, @0x6];
-    let shuffled = false;
-    let i = 0;
-
-    while (i < 10) {
-      shuffle_duplicates(&mut bids, &mut addresses);
-      if (addresses != original_addresses) {
-        shuffled = true;
-        break
-      };
-      i = i + 1;
-    };
-
-    assert!(bids == vector[1, 2, 2, 3, 3, 4], 7357019);
-    assert!(shuffled, 7357020);
-  }
-
-  #[test(root = @ol_framework)]
-  fun test_shuffle_all_elements_equal(root: &signer) {
-    // All elements in the bids vector are the same
-    randomness::initialize_for_testing(root);
-    let bids = vector[2, 2, 2, 2];
-    let addresses = vector[@0x1, @0x2, @0x3, @0x4];
-    let original_addresses = vector[@0x1, @0x2, @0x3, @0x4];
-    let shuffled = false;
-    let i = 0;
-
-    while (i < 10) {
-      shuffle_duplicates(&mut bids, &mut addresses);
-      if (addresses != original_addresses) {
-        shuffled = true;
-        break
-      };
-      i = i + 1;
-    };
-
-    assert!(bids == vector[2, 2, 2, 2], 7357021);
-    assert!(shuffled, 7357022);
-  }
-
-
   // Tests for calculate_reward_adjustment
 
   #[test]
diff --git a/framework/libra-framework/sources/ol_sources/rank.todo b/framework/libra-framework/sources/ol_sources/rank.todo
index d6527dab2..d7e869004 100644
--- a/framework/libra-framework/sources/ol_sources/rank.todo
+++ b/framework/libra-framework/sources/ol_sources/rank.todo
@@ -82,7 +82,7 @@ module ol_framework::rank{
       };
 
       // Sorting the accounts vector based on value (weights).
-      // Bubble sort algorithm
+      // Bubble sort algorithm => use address_utils::sort_by_values
       let len_filtered = vector::length(&weights);
       if (len_filtered < 2) return weights;
       let i = 0;
diff --git a/framework/libra-framework/sources/ol_sources/tests/jail.test.move b/framework/libra-framework/sources/ol_sources/tests/jail.test.move
index 4e0457d7e..8ea8cfbc1 100644
--- a/framework/libra-framework/sources/ol_sources/tests/jail.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/jail.test.move
@@ -4,6 +4,7 @@ module ol_framework::test_jail {
     use std::vector;
     use ol_framework::mock;
     use ol_framework::jail;
+    use ol_framework::randomness;
     // use diem_std::debug::print;
 
     #[test(root = @ol_framework)]
@@ -76,7 +77,7 @@ module ol_framework::test_jail {
 
     #[test(root = @ol_framework)]
     public entry fun sort_by_jail(root: signer) {
-
+      randomness::initialize_for_testing(&root);
       let vals = mock::genesis_n_vals(&root, 5);
       let alice = *vector::borrow(&vals, 0);
       let bob = *vector::borrow(&vals, 1);
diff --git a/framework/libra-framework/sources/ol_sources/tests/stake.test.move b/framework/libra-framework/sources/ol_sources/tests/stake.test.move
index bdb19a01c..047ec5ae8 100644
--- a/framework/libra-framework/sources/ol_sources/tests/stake.test.move
+++ b/framework/libra-framework/sources/ol_sources/tests/stake.test.move
@@ -7,7 +7,7 @@ module ol_framework::test_stake {
   use ol_framework::testnet;
   use ol_framework::grade;
 
-  // use diem_std::debug::print;
+  //use diem_std::debug::print;
 
   // Scenario: can take 6 already initialized validators, from a previous set
   // and reduce the set to 3 of those validators.
@@ -44,6 +44,9 @@ module ol_framework::test_stake {
   // within these ranges we have different rules to recover.
   #[test(root = @ol_framework)]
   fun failover_scenarios(root: signer) {
+    use diem_framework::randomness;
+    randomness::initialize_for_testing(&root);
+
     let set = mock::genesis_n_vals(&root, 10);
     testnet::unset(&root); // set to production mode
 
@@ -60,7 +63,7 @@ module ol_framework::test_stake {
     // should return 10
     let proposed = vals;
     let cfg_list = stake::check_failover_rules(proposed, 11);
-    assert!(vector::length(&cfg_list) == 10, 1003);
+    assert!(vector::length(&cfg_list) == 10, 1002);
     // second case:
     // number of seats has no effect, as long as proposed in above mininum for
     // happy case(9).
@@ -76,24 +79,24 @@ module ol_framework::test_stake {
     // First case: We qualified fewer vals (7) than our theshhold (10). The
     // number of seats (7) is same as qualifying (the typical case)
     let cfg_list = stake::check_failover_rules(proposed, 7);
-    assert!(vector::length(&cfg_list) == 7, 1004);
+    assert!(vector::length(&cfg_list) == 7, 1005);
 
     // Second case: we have more qualified vals (7) than we intended to seat (6)
     // but it's all below our minimum (9). Take everyone that qualified.
     // This case is likely a bug
     let cfg_list = stake::check_failover_rules(proposed, 6);
-    assert!(vector::length(&cfg_list) == 7, 1004);
+    assert!(vector::length(&cfg_list) == 7, 1006);
 
     // C) Defibrillator
     // First case: we are not qualifying enough validators to stay alive
     // let's check we can get at least up to the number of seats offered
     let cfg_list = stake::check_failover_rules(proposed, 8);
-    assert!(vector::length(&cfg_list) == 8, 1004);
+    assert!(vector::length(&cfg_list) == 8, 1007);
 
     // Second case : we are not qualifying enough validators to stay alive
     // but the seats proposed is unrealistic. Let's just get back to a healthy
     let cfg_list = stake::check_failover_rules(proposed, 50);
-    assert!(vector::length(&cfg_list) == 9, 1004);
+    assert!(vector::length(&cfg_list) == 9, 1008);
 
     // even an empty list, but with seats to fill will work
     let cfg_list = stake::check_failover_rules(vector::empty(), 8);
@@ -103,23 +106,20 @@ module ol_framework::test_stake {
     // health (9), even if musical chairs picked more (12). (Though this case should
     // never happen)
     let cfg_list = stake::check_failover_rules(vector::empty(), 12);
-    assert!(vector::length(&cfg_list) == 9, 1004);
+    assert!(vector::length(&cfg_list) == 9, 1009);
 
     // D) Hail Mary. If nothing we've done gets us above 4 proposed validators,
     // then don't change anything.
     let cfg_list = stake::check_failover_rules(vector::empty(), 0);
-    assert!(vector::length(&cfg_list) == 4, 1004);
+    assert!(vector::length(&cfg_list) == 4, 1010);
 
     // Other corner cases
     // musical chairs fails, but we have a list of qualifying validators
     // above threshold
     let cfg_list = stake::check_failover_rules(vals, 2);
-    assert!(vector::length(&cfg_list) == 10, 1004);
-
-
+    assert!(vector::length(&cfg_list) == 10, 1011);
   }
 
-
   // Scenario: in production mode, we can't have fewer than 4 validators.
   // when that happens, the first failover is to get the validators with the most successful proposals.
   #[test(root = @ol_framework)]
diff --git a/framework/libra-framework/sources/stake.move b/framework/libra-framework/sources/stake.move
index 4d1c77dfd..d98825ebf 100644
--- a/framework/libra-framework/sources/stake.move
+++ b/framework/libra-framework/sources/stake.move
@@ -15,6 +15,7 @@ module diem_framework::stake {
     use diem_framework::system_addresses;
     use ol_framework::slow_wallet;
     use ol_framework::testnet;
+    use ol_framework::address_utils;
 
     // use diem_std::debug::print;
 
@@ -878,7 +879,7 @@ module diem_framework::stake {
         current_vals
     }
 
-    /// Bubble sort the validators by their proposal counts.
+    /// Sort the validators by their proposal counts.
     public fun get_sorted_vals_by_net_props(): vector<address> acquires ValidatorSet, ValidatorConfig, ValidatorPerformance {
       let eligible_validators = get_current_validators();
       let length = vector::length<address>(&eligible_validators);
@@ -905,36 +906,12 @@ module diem_framework::stake {
       };
 
       // Sorting the accounts vector based on value (weights).
-      // Bubble sort algorithm
-      let len_filtered = vector::length<address>(&filtered_vals);
-      if (len_filtered < 2) return filtered_vals;
-      let i = 0;
-      while (i < len_filtered){
-        let j = 0;
-        while(j < len_filtered-i-1){
-
-          let value_j = *(vector::borrow<u64>(&weights, j));
-
-          let value_jp1 = *(vector::borrow<u64>(&weights, j+1));
-          if(value_j > value_jp1){
-
-            vector::swap<u64>(&mut weights, j, j+1);
-
-            vector::swap<address>(&mut filtered_vals, j, j+1);
-          };
-          j = j + 1;
-
-        };
-        i = i + 1;
-
-      };
-
+      address_utils::sort_by_values(&mut filtered_vals, &mut weights);
 
       // Reverse to have sorted order - high to low.
       vector::reverse<address>(&mut filtered_vals);
 
       return filtered_vals
-
     }
 
     //////// 0L ////////

From 5103549f7674895b47c6d3289ba87249143d591d Mon Sep 17 00:00:00 2001
From: soaresa <10797037+soaresa@users.noreply.github.com>
Date: Mon, 5 Aug 2024 14:10:30 -0300
Subject: [PATCH 16/16] updates pof competitive pct parameter

---
 .../libra-framework/sources/ol_sources/proof_of_fee.move  | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/framework/libra-framework/sources/ol_sources/proof_of_fee.move b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
index bfc57be74..16ff5ff2d 100644
--- a/framework/libra-framework/sources/ol_sources/proof_of_fee.move
+++ b/framework/libra-framework/sources/ol_sources/proof_of_fee.move
@@ -42,7 +42,7 @@ module ol_framework::proof_of_fee {
   /// after some experience in the wild. Additionally it could be dynamic
   /// based on another function or simply randomized within a range
   /// (as originally proposed in this feature request)
-  const PCT_REDUCTION_FOR_COMPETITION: u64 = 10; // 10%
+  const PCT_REDUCTION_FOR_COMPETITION: u64 = 20; // 20%
   /// Upper bound threshold for bid percentages.
   const BID_UPPER_BOUND: u64 = 0950; // 95%
   /// Lower bound threshold for bid percentages.
@@ -1172,7 +1172,7 @@ module ol_framework::proof_of_fee {
     let qualified_bidders = 50;
     let mc_set_size = 50;
     let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
-    assert!(result == 45, 7357030);
+    assert!(result == 40, 7357030);
   }
 
   #[test]
@@ -1181,8 +1181,8 @@ module ol_framework::proof_of_fee {
     let qualified_bidders = 21;
     let mc_set_size = 21;
     let result = calculate_final_set_size(outgoing_compliant, qualified_bidders, mc_set_size);
-    // min(21, 21*90%) = 19
-    assert!(result == 19, 7357030);
+    // min(21, 21*80%) = 17
+    assert!(result == 17, 7357030);
 
     let outgoing_compliant = 21;
     let qualified_bidders = 20;