Merge pull request #699 from threefoldtech/development_minting_process

add minting process, update 2025 minting periods

src/SUMMARY.md

@@ -178,6 +178,7 @@
       - [GPU Farming](documentation/farmers/3node_building/gpu_farming.md)
       - [HDD-Only Nodes](documentation/farmers/farming_optimization/hdd_only_nodes.md)
       - [Set Additional Fees](documentation/farmers/farming_optimization/set_additional_fees.md)
+      - [Minting Process](documentation/farmers/farming_optimization/minting_process.md)
       - [Minting Receipts](documentation/farmers/3node_building/minting_receipts.md)
       - [Minting Periods](documentation/farmers/farming_optimization/minting_periods.md)
       - [Room Parameters](documentation/farmers/farming_optimization/farm_room_parameters.md)

src/documentation/farmers/farming_optimization/farming_optimization.md

@@ -7,6 +7,7 @@ The section [Build a 3Node](../3node_building/3node_building.md) covered the not
 - [GPU Farming](../3node_building/gpu_farming.md)
 - [HDD-Only Nodes](./hdd_only_nodes.md)
 - [Set Additional Fees](./set_additional_fees.md)
+- [Minting Process](./minting_process.md)
 - [Minting Receipts](../3node_building/minting_receipts.md)
 - [Minting Periods](./minting_periods.md)
 - [Room Parameters](./farm_room_parameters.md)

src/documentation/farmers/farming_optimization/minting_periods.md

@@ -1,7 +1,5 @@
 <h1>Minting Periods</h1>
 
-
-
 ## Introduction
 
 We discuss the length and the frequencies of the ThreeFold farming minting periods.
@@ -10,25 +8,6 @@ We discuss the length and the frequencies of the ThreeFold farming minting perio
 
 Each minting period has: 2630880 seconds = 43848 minutes = 730.8 hours.
 
-## 2023 Minting Periods
-
-The minting periods for the 12 months of 2023 are the following:
-
-| Month    | Start of the Minting Period     | End of the Minting Period       |
-|----------|---------------------------------|---------------------------------|
-| Jan 2023 | December 31, 2022 at 4\:32\:40 am | January 30, 2023 at 3\:20\:40 pm  |
-| Feb 2023 | January 30, 2023 at 3\:20\:40 pm  | March 2, 2023 at 2\:08\:40 am     |
-| Mar 2023 | March 2, 2023 at 2\:08\:40 am     | April 1, 2023 at 12\:56\:40 pm    |
-| Apr 2023 | April 1, 2023 at 12\:56\:40 pm    | May 1, 2023 at 11\:44\:40 pm      |
-| May 2023 | May 1, 2023 at 11\:44\:40 pm      | June 1, 2023 at 10\:32\:40 am     |
-| Jun 2023 | June 1, 2023 at 10\:32\:40 am     | July 1, 2023 at 9\:20\:40 pm      |
-| Jul 2023 | July 1, 2023 at 9\:20\:40 pm      | August 1, 2023 at 8\:08\:40 am    |
-| Aug 2023 | August 1, 2023 at 8\:08\:40 am    | August 31, 2023 at 6\:56\:40 pm   |
-| Sep 2023 | August 31, 2023 at 6\:56\:40 pm   | October 1, 2023 at 5\:44\:40 am   |
-| Oct 2023 | October 1, 2023 at 5\:44\:40 am   | October 31, 2023 at 4\:32\:40 pm  |
-| Nov 2023 | October 31, 2023 at 4\:32\:40 pm  | December 1, 2023 at 3\:20\:40 am  |
-| Dec 2023 | December 1, 2023 at 3\:20\:40 am  | December 31, 2023 at 2\:08\:40 pm |
-
 ## 2024 Minting Periods
 
 The minting periods for the 12 months of 2024 are the following:
@@ -47,3 +26,22 @@ The minting periods for the 12 months of 2024 are the following:
 | Oct 2024 | September 30, 2024 at 15\:20\:40   | October 31, 2024 at 02\:08\:40  |
 | Nov 2024 | October 31, 2024 at 02\:08\:40  | November 30, 2024 at 12\:56\:40  |
 | Dec 2024 | November 30, 2024 at 12\:56\:40  | December 30, 2024 at 23\:44\:40 |
+
+## 2025 Minting Periods
+
+The minting periods for the 12 months of 2025 are the following:
+
+| Month    | Start of the Minting Period     | End of the Minting Period       |
+|----------|---------------------------------|---------------------------------|
+| Jan 2025 | December 30, 2024 at 23:44:40   | January 29, 2025 at 22:32:40    |
+| Feb 2025 | January 29, 2025 at 22:32:40    | March 1, 2025 at 21:20:40       |
+| Mar 2025 | March 1, 2025 at 21:20:40       | March 31, 2025 at 20:08:40      |
+| Apr 2025 | March 31, 2025 at 20:08:40      | April 30, 2025 at 18:56:40      |
+| May 2025 | April 30, 2025 at 18:56:40      | May 30, 2025 at 17:44:40        |
+| Jun 2025 | May 30, 2025 at 17:44:40        | June 29, 2025 at 16:32:40       |
+| Jul 2025 | June 29, 2025 at 16:32:40       | July 29, 2025 at 15:20:40       |
+| Aug 2025 | July 29, 2025 at 15:20:40       | August 28, 2025 at 14:08:40     |
+| Sep 2025 | August 28, 2025 at 14:08:40     | September 27, 2025 at 13:56:40  |
+| Oct 2025 | September 27, 2025 at 13:56:40  | October 27, 2025 at 12:44:40    |
+| Nov 2025 | October 27, 2025 at 12:44:40    | November 26, 2025 at 11:32:40   |
+| Dec 2025 | November 26, 2025 at 11:32:40   | December 26, 2025 at 10:20:40   |

src/documentation/farmers/farming_optimization/minting_process.md

@@ -0,0 +1,21 @@
+# Minting Process
+
+Minting is based on blockchain data according to strict rules that are carried out by computers with humans involved only to check for errors and to sign the resulting transactions.
+
+There is a human verification mechanism through multisignatures for calculations done on the data as stored in the blockchain. This explains the timing differences when it comes to the monthly farming rewards distribution, since enough people need to sign off.
+
+The detailed minting process for V3 is as follow:
+
+- TFChain, ThreeFold's blockchain, has all the details about capacity provided by the nodes.
+- TFChain is used to track uptime.
+- Zero-OS reports to TFChain.
+- The code in [this repo](https://github.com/threefoldtech/minting_v3) uses the information from the blockchain to calculate the TFT to be minted.
+- A proof of what needs to be minted and why is created. This proof is then sent to our guardians.
+- The guardians need to double check the execution and the minting report. This is like a human check on the automated process.
+- The guardians need to sign. Only when consensus is achieved the minting as suggested will happen. This allows human to check the code.
+
+It is important to understant that TFChain tracks the capacity and uptime and is the source for the minting.
+
+> Note: Additional auditing code will be added in V4 (i.e. special code generated at runtime for verification) using security primitives on motherboards.
+
+For more information on the minting periods, read [this section](./minting_periods.md).