From 462b1e0a3d64f942d45451b935f8479301faa826 Mon Sep 17 00:00:00 2001
From: 0o-de-lally <1364012+0o-de-lally@users.noreply.github.com>
Date: Wed, 5 Feb 2025 14:36:58 -0500
Subject: [PATCH 1/4] update docs on governance txs

---
 docs/validators/governance-tx.md | 84 ++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 docs/validators/governance-tx.md

diff --git a/docs/validators/governance-tx.md b/docs/validators/governance-tx.md
new file mode 100644
index 00000000..c68e2f90
--- /dev/null
+++ b/docs/validators/governance-tx.md
@@ -0,0 +1,84 @@
+---
+sidebar_position: 8
+sidebar_label: 'Governance Transactions'
+description: 'Updating system state under consensus'
+---
+
+# Create a Upgrade Script
+
+Sometimes we would like to adjust parameters of the network and not upgrade the underlying frameworks. For this we need to prepare and write an upgrade script.
+
+Note: this requires you have the `libra` cli tool built locally.
+
+## Create Template Script
+
+`libra move framework governance --script-dir <Script Dir>  --framework-local-dir ~/libra-framework/framework/ --only-make-template`
+
+## Prepare Script
+
+You will want to name the folders appropriately. We will use [UP-0002](../proposals/up-0002) as an example.
+
+In this example we want to change the nominal consensus reward due to a migration error at v7.0.0.
+
+### Folder Structure
+
+- up-002
+    - sources
+        - patch_nominal_reward_migration_error.move
+
+### Script
+
+By default it prepares a `multi_step_proposal`.
+
+Note: you may notice the requirement of script hash is different from framework `hot upgrades`. Here  will just produce an empty vector (as opposed to a chain of hashes as is done in multi-step upgrades).
+
+#### Before
+
+```
+script {
+  // THIS IS A TEMPLATE GOVERNANCE SCRIPT
+  // you can generate this file with commandline tools:
+  // `libra move framework governance --output-dir --framework-local-dir`
+  use diem_framework::diem_governance;
+  use std::vector;
+
+  fun main(proposal_id: u64){
+      let next_hash = vector::empty();
+      let _framework_signer = diem_governance::resolve_multi_step_proposal(proposal_id, @0000000000000000000000000000000000000000000000000000000000000001, next_hash);
+  }
+}
+```
+
+
+#### After
+Make changes to the template. Here is an example of changing some on chain state for the `ol_framework::proof_of_fee` module
+```
+script {
+
+  use diem_framework::diem_governance;
+  use ol_framework::proof_of_fee;
+
+  fun main(proposal_id: u64){
+      let framework_signer = diem_governance::resolve_multi_step_proposal(
+          proposal_id,
+          @0000000000000000000000000000000000000000000000000000000000000001,
+          vector[],
+      );
+      // Set the nominal_reward to the value prior to v7.0.1 hard fork
+      proof_of_fee::genesis_migrate_reward(&framework_signer, 178204815);
+  }
+}
+```
+
+## Compile
+
+To compile we simply use the same command we originally generated the template with, and point to the `Script Dir` where your modified template is found.
+
+```
+libra move framework governance --script-dir <Script Dir>  --framework-local-dir ~/libra-framework/framework/
+```
+
+
+## Submit Proposal
+Sending, getting consensus, and resolving a Governance Tx proposal follows the same steps as a framework Hot Upgrade.
+Follow instructions [here](hot_upgrades.md#upgrade-ceremony)

From 98b00f8f76a4b584cb8297c59da2ebbb16e8af38 Mon Sep 17 00:00:00 2001
From: 0o-de-lally <1364012+0o-de-lally@users.noreply.github.com>
Date: Wed, 5 Feb 2025 14:47:14 -0500
Subject: [PATCH 2/4] governance mode script

---
 docs/validators/governance-tx.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/validators/governance-tx.md b/docs/validators/governance-tx.md
index c68e2f90..92de65b5 100644
--- a/docs/validators/governance-tx.md
+++ b/docs/validators/governance-tx.md
@@ -70,6 +70,29 @@ script {
 }
 ```
 
+### Example: Governance Mode
+Here's an example script of how the validators can enter "Governance Mode" where coin transfers are disabled during governance upgrades and events.
+
+```
+
+script {
+  // Enter Governance Mode, and disable coin transactions
+  use diem_framework::diem_governance;
+  use ol_framework::ol_features_constants;
+  use std::features;
+  use std::vector;
+
+
+  fun main(proposal_id: u64){
+      let next_hash = vector::empty();
+      let _framework_signer = diem_governance::resolve_multi_step_proposal(proposal_id, @0000000000000000000000000000000000000000000000000000000000000001, next_hash);
+      // set governance mode
+      let gov_mode_id = ol_features_constants::get_governance_mode();
+      features::change_feature_flags(&framework_sig, vector::singleton(gov_mode_id), vector::empty());
+  }
+}
+```
+
 ## Compile
 
 To compile we simply use the same command we originally generated the template with, and point to the `Script Dir` where your modified template is found.

From e99d9d8f17c06dde748fd4440eda877be14ff19a Mon Sep 17 00:00:00 2001
From: 0o-de-lally <1364012+0o-de-lally@users.noreply.github.com>
Date: Wed, 5 Feb 2025 15:20:41 -0500
Subject: [PATCH 3/4] patch build error

---
 docs/validators/governance-tx.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/validators/governance-tx.md b/docs/validators/governance-tx.md
index 92de65b5..d0e66080 100644
--- a/docs/validators/governance-tx.md
+++ b/docs/validators/governance-tx.md
@@ -16,9 +16,7 @@ Note: this requires you have the `libra` cli tool built locally.
 
 ## Prepare Script
 
-You will want to name the folders appropriately. We will use [UP-0002](../proposals/up-0002) as an example.
-
-In this example we want to change the nominal consensus reward due to a migration error at v7.0.0.
+You will want to name the folders appropriately. We will use `UP-0002` as an example. In actual historical example we wanted to change the nominal consensus reward due to a migration error at v7.0.0.
 
 ### Folder Structure
 
@@ -38,7 +36,7 @@ Note: you may notice the requirement of script hash is different from framework
 script {
   // THIS IS A TEMPLATE GOVERNANCE SCRIPT
   // you can generate this file with commandline tools:
-  // `libra move framework governance --output-dir --framework-local-dir`
+  // `libra move framework governance --script-dir --framework-local-dir`
   use diem_framework::diem_governance;
   use std::vector;
 
@@ -89,6 +87,9 @@ script {
       // set governance mode
       let gov_mode_id = ol_features_constants::get_governance_mode();
       features::change_feature_flags(&framework_sig, vector::singleton(gov_mode_id), vector::empty());
+
+      // TO EXIT GOVERNANCE MODE REVERSE THE VECTORS:
+      // features::change_feature_flags(&framework_sig, vector::empty(), vector::singleton(gov_mode_id));
   }
 }
 ```
@@ -104,4 +105,4 @@ libra move framework governance --script-dir <Script Dir>  --framework-local-dir
 
 ## Submit Proposal
 Sending, getting consensus, and resolving a Governance Tx proposal follows the same steps as a framework Hot Upgrade.
-Follow instructions [here](hot_upgrades.md#upgrade-ceremony)
+Follow instructions [here](./hot-upgrades.md)

From e0dd2bf6a804402b441d4440b9bd5d88373f9217 Mon Sep 17 00:00:00 2001
From: 0o-de-lally <1364012+0o-de-lally@users.noreply.github.com>
Date: Wed, 5 Feb 2025 15:22:31 -0500
Subject: [PATCH 4/4] update ci

---
 .github/workflows/{preview.yml => preview.todo} |  0
 .github/workflows/test.yaml                     | 12 ++++++------
 2 files changed, 6 insertions(+), 6 deletions(-)
 rename .github/workflows/{preview.yml => preview.todo} (100%)

diff --git a/.github/workflows/preview.yml b/.github/workflows/preview.todo
similarity index 100%
rename from .github/workflows/preview.yml
rename to .github/workflows/preview.todo
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
index a6a17620..08dad00f 100644
--- a/.github/workflows/test.yaml
+++ b/.github/workflows/test.yaml
@@ -5,12 +5,12 @@ on:
     branches: ["*"]
   # note: not testing on PR, since we are already previews for PRs
   # which have the same effect
-  # pull_request:
-  #   types:
-  #     - opened
-  #     - synchronize
-  #   branches:
-  #     - "main**"
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - closed
 
 jobs:
   test-deploy: