Skip to content

Publishing HCU and Rolling upgrade details on the doc site #1215

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Apr 18, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/build/basics/fees.md
Original file line number Diff line number Diff line change
Expand Up @@ -406,7 +406,7 @@ There are several places to learn more about transaction fees:

**When will the fee update go into effect?**

The updates were rolled out with the [Spork on April 6, 2022](../../networks/node-ops/node-operation/past-sporks.md#mainnet-17), and were enabled on [June 1st](https://forum.onflow.org/t/permissionless-contract-deployment-progress/2981) during the [weekly epoch transition](https://github.com/onflow/service-account/tree/main/transactions/set-execution-effort-weights/2022/jun-1).
The updates were rolled out with the [Spork on April 6, 2022](../../networks/node-ops/node-operation/past-upgrades#mainnet-17), and were enabled on [June 1st](https://forum.onflow.org/t/permissionless-contract-deployment-progress/2981) during the [weekly epoch transition](https://github.com/onflow/service-account/tree/main/transactions/set-execution-effort-weights/2022/jun-1).

**Why are fees collected even when transactions fail?**

Expand Down
2 changes: 1 addition & 1 deletion docs/build/basics/scripts.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,6 +131,6 @@ Following are some recommendations on how to write efficient scripts:

3. **Historic block data limit**
1. Script execution on execution nodes is restricted to approximately the last 100 blocks. Any request for script execution on an execution node on a past block (specified by block ID or block height) will fail if that block is more than 100 blocks in the past.
2. Script execution on an access node can go much beyond the last 100 blocks but is restricted to the height when the [last](https://developers.flow.com/networks/node-ops/node-operation/past-sporks) network upgrade ([HCU](https://developers.flow.com/networks/node-ops/node-operation/hcu) or spork) occurred.
2. Script execution on an access node can go much beyond the last 100 blocks but is restricted to the height when the [last](https://developers.flow.com/networks/node-ops/node-operation/past-upgrades) network upgrade ([HCU](https://developers.flow.com/networks/node-ops/node-operation/hcu) or spork) occurred.


2 changes: 1 addition & 1 deletion docs/build/smart-contracts/deploying.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Once all your contracts are deployed, you can visit [flow-view-source](https://f

### Sporks

Currently, **historical event data is not migrated between sporks,** so you'll need to design your application with this in mind. We recognize the usefulness of historical event data and plan on adding a means of accessing it in the near future. Past spork transactional data is available, [See Previous Spork Access Node Info](../../networks/node-ops/node-operation/past-sporks)
Currently, **historical event data is not migrated between sporks,** so you'll need to design your application with this in mind. We recognize the usefulness of historical event data and plan on adding a means of accessing it in the near future. Past spork transactional data is available, [See Previous Spork Access Node Info](../../networks/node-ops/node-operation/past-upgrades)

More Information on [Sporks](../../networks/node-ops/node-operation/spork)

Expand Down
2 changes: 1 addition & 1 deletion docs/networks/node-ops/light-nodes/observer-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,4 +261,4 @@ Access-003:


While the public keys remain the same, the hostnames change each spork to include the spork name. Substitute `[current mainnet spork]` and `[current devnet spork]` with the appropriate spork name (e.g. `mainnet20`).
See [Past Sporks](../node-operation/past-sporks.md) for the current spork for each network.
See [Past Sporks](../node-operation/past-upgrades) for the current spork for each network.
2 changes: 1 addition & 1 deletion docs/networks/node-ops/node-operation/node-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ to automatically restart following a crash.

:::info

The actual Docker image tag can be found [here](./past-sporks.md) for appropriate spork.
The actual Docker image tag can be found [here](./past-upgrades) for appropriate spork.

:::

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,70 @@
---
title: Past Spork Info
description: Information about all Flow Mainnet and Testnet sporks.
title: Past Network Upgrades
description: Information about Flow Mainnet and Testnet network upgrades.
sidebar_position: 14
---

A JSON version of the information below can be found in [onflow/flow/sporks.json](https://github.com/onflow/flow/blob/master/sporks.json)

## Mainnet Sporks
## Mainnet Upgrades

> Currently only includes HCUs from 2025.

## Height Coordinated Upgrade 7

| HCU Info |
|:--------------------------------------------------------------------------------------|
| **Date**: April 10, 2025 |
| **Block Height**: 109384800 |
| **Git Commit**: 86c40b1ff20b3b7f17c4017bde083d26303c508d |
| **Branch/Tag**: v0.40.0 |
| **Docker Image Tag**: v0.40.0 |
| **Release Notes**: [v0.40.0](https://github.com/onflow/flow-go/releases/tag/v0.40.0) |

## Rolling Upgrade 1

| RU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: April 3, 2025 |
| **Block Height**: 108630638 |
| **Block View **: 20504725 |
| **Git Commit**: ad1076f0a36bb2d20cc36295d3573989edc15c6c |
| **Branch/Tag**: v0.39.0 |
| **Docker Image Tag**: v0.39.0 |
| **Release Notes**: [v0.39.0](https://github.com/onflow/flow-go/releases/tag/v0.39.0) |

## Height Coordinated Upgrade 6

| HCU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: Feb 18, 2025 |
| **Block Height**: 103983000 |
| **Git Commit**: 4e7e56b3a92e5772279f1304d88dd445c0ea5016 |
| **Branch/Tag**: v0.38.3 |
| **Docker Image Tag**: v0.38.3 |
| **Release Notes**: [v0.38.3](https://github.com/onflow/flow-go/releases/tag/v0.38.3) |

## Height Coordinated Upgrade 5

| HCU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: Feb 18, 2025 |
| **Block Height**: 103957477 |
| **Git Commit**: bcb8a2264fcde9dcd4c997f6b28d8184af19160b |
| **Branch/Tag**: v0.38.2 |
| **Docker Image Tag**: v0.38.2 |
| **Release Notes**: [v0.38.2](https://github.com/onflow/flow-go/releases/tag/v0.38.2) |

## Height Coordinated Upgrade 4

| HCU Info |
|:---------------------------------------------------------------------------------------|
| **Date**: Jan 27, 2025 |
| **Block Height**: 101584244 |
| **Git Commit**: 5f6b25bd02257e3239341c4be0134b007f3deb49 |
| **Branch/Tag**: v0.37.26 |
| **Docker Image Tag**: v0.37.26 |
| **Release Notes**: [v0.37.26](https://github.com/onflow/flow-go/releases/tag/v0.37.26) |

## Mainnet 26

Expand Down Expand Up @@ -473,7 +531,64 @@ While FCL v0.0.67 is not strictly necessary to use Mainnet 6, we strongly recomm

---

## Testnet Sporks
## Testnet Upgrades

> Currently only includes HCUs from 2025.

## Height Coordinated Upgrade 9

| HCU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: April 9, 2025 |
| **Block Height**: 252457666 |
| **Git Commit**: 86c40b1ff20b3b7f17c4017bde083d26303c508d |
| **Branch/Tag**: v0.40.0 |
| **Docker Image Tag**: v0.40.0 |
| **Release Notes**: [v0.40.0](https://github.com/onflow/flow-go/releases/tag/v0.40.0) |

## Height Coordinated Upgrade 8

| HCU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: Feb 18, 2025 |
| **Block Height**: 243615144 |
| **Git Commit**: 4e7e56b3a92e5772279f1304d88dd445c0ea5016 |
| **Branch/Tag**: v0.38.3 |
| **Docker Image Tag**: v0.38.3 |
| **Release Notes**: [v0.38.3](https://github.com/onflow/flow-go/releases/tag/v0.38.3) |

## Height Coordinated Upgrade 7

| HCU Info |
|:-------------------------------------------------------------------------------------|
| **Date**: Feb 14, 2025 |
| **Block Height**: 242883902 |
| **Git Commit**: bcb8a2264fcde9dcd4c997f6b28d8184af19160b |
| **Branch/Tag**: v0.38.2 |
| **Docker Image Tag**: v0.38.2 |
| **Release Notes**: [v0.38.2](https://github.com/onflow/flow-go/releases/tag/v0.38.2) |

## Height Coordinated Upgrade 6

| HCU Info |
|:---------------------------------------------------------|
| **Date**: Feb 11, 2025 |
| **Block Height**: 242365900 |
| **Git Commit**: bcb8a2264fcde9dcd4c997f6b28d8184af19160b |
| **Branch/Tag**: v0.38.1 |
| **Docker Image Tag**: v0.38.1 |
| **Release Notes**: N/A |

## Height Coordinated Upgrade 5

| HCU Info |
|:---------------------------------------------------------------------------------------|
| **Date**: Jan 24, 2025 |
| **Block Height**: 239255500 |
| **Git Commit**: 5f6b25bd02257e3239341c4be0134b007f3deb49 |
| **Branch/Tag**: v0.37.26 |
| **Docker Image Tag**: v0.37.26 |
| **Release Notes**: [v0.37.26](https://github.com/onflow/flow-go/releases/tag/v0.37.26) |

## Devnet 52

Expand Down
26 changes: 13 additions & 13 deletions docs/networks/node-ops/node-operation/upcoming-sporks.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,19 +26,19 @@ The following are the upcoming Spork dates. These dates indicate the intention t
| Nov 2, 2022 | Mainnet 20 | Oct 19, 2022 —> Nov 2, 2022 | Devnet38 |
| Aug 24, 2022 | Mainnet 19 | Aug 10, 2022 —> Aug 24, 2022 | Devnet37 |
| | | Jul 27, 2022 | Devnet36 |
| June 15, 2022 | [Mainnet 18](./past-sporks#mainnet-18) | June 9, 2022 —> June 15, 2022 | Devnet35 |
| April 6, 2022 | [Mainnet 17](./past-sporks#mainnet-17) | April 4, 2022 —> April 6, 2022 | Devnet34 |
| February 9, 2022 | [Mainnet 16](./past-sporks#mainnet-16) | February 7, 2022 —> February 9, 2022 | Devnet33 |
| December 8, 2021 | [Mainnet 15](./past-sporks#mainnet-15) | December 7, 2021 —> December 8, 2021 | Devnet32 |
| June 15, 2022 | [Mainnet 18](./past-upgrades#mainnet-18) | June 9, 2022 —> June 15, 2022 | Devnet35 |
| April 6, 2022 | [Mainnet 17](./past-upgrades#mainnet-17) | April 4, 2022 —> April 6, 2022 | Devnet34 |
| February 9, 2022 | [Mainnet 16](./past-upgrades#mainnet-16) | February 7, 2022 —> February 9, 2022 | Devnet33 |
| December 8, 2021 | [Mainnet 15](./past-upgrades#mainnet-15) | December 7, 2021 —> December 8, 2021 | Devnet32 |
| November 10, 2021 | Cancelled | November 9, 2021 —> November 10, 2021 | Devnet31 |
| October 6, 2021 | [Mainnet 14](./past-sporks#mainnet-14) | October 5, 2021 —> October 6, 2021 | Devnet30 |
| September 15, 2021 | [Mainnet 13](./past-sporks#mainnet-13) | September 14, 2021 —> September 15, 2021 | Devnet27 |
| August 18, 2021 | [Mainnet 12](./past-sporks#mainnet-12) | August 12, 2021 —> August 18, 2021 | Devnet26 |
| July 21, 2021 | [Mainnet 11](./past-sporks#mainnet-11) | July 20, 2021 —> July 21, 2021 | Devnet25 |
| June 23, 2021 | [Mainnet 10](./past-sporks#mainnet-10) | June 22, 2021 —> June 23, 2021 | Devnet24 |
| May 26, 2021 | [Mainnet 9](./past-sporks#mainnet-9) | May 25, 2021 —> May 26, 2021 | Devnet23 |
| April 28, 2021 | [Mainnet 8](./past-sporks#mainnet-8) | April 27, 2021 —> April 28, 2021 | Devnet22 |
| April 7, 2021 | [Mainnet 7](./past-sporks#mainnet-7) | March 30, 2021 —> March 31, 2021 | Devnet21 |
| March 10, 2021 | [Mainnet 6](./past-sporks#mainnet-6) | March 9, 2021 —> March 10, 2021 | Devnet20 |
| October 6, 2021 | [Mainnet 14](./past-upgrades#mainnet-14) | October 5, 2021 —> October 6, 2021 | Devnet30 |
| September 15, 2021 | [Mainnet 13](./past-upgrades#mainnet-13) | September 14, 2021 —> September 15, 2021 | Devnet27 |
| August 18, 2021 | [Mainnet 12](./past-upgrades#mainnet-12) | August 12, 2021 —> August 18, 2021 | Devnet26 |
| July 21, 2021 | [Mainnet 11](./past-upgrades#mainnet-11) | July 20, 2021 —> July 21, 2021 | Devnet25 |
| June 23, 2021 | [Mainnet 10](./past-upgrades#mainnet-10) | June 22, 2021 —> June 23, 2021 | Devnet24 |
| May 26, 2021 | [Mainnet 9](./past-upgrades#mainnet-9) | May 25, 2021 —> May 26, 2021 | Devnet23 |
| April 28, 2021 | [Mainnet 8](./past-upgrades#mainnet-8) | April 27, 2021 —> April 28, 2021 | Devnet22 |
| April 7, 2021 | [Mainnet 7](./past-upgrades#mainnet-7) | March 30, 2021 —> March 31, 2021 | Devnet21 |
| March 10, 2021 | [Mainnet 6](./past-upgrades#mainnet-6) | March 9, 2021 —> March 10, 2021 | Devnet20 |

</div>
2 changes: 1 addition & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -448,7 +448,7 @@ const config = {
label: 'Flowscan Testnet',
},
{
to: '/networks/node-ops/node-operation/past-sporks',
to: '/networks/node-ops/node-operation/past-upgrades',
label: 'Past Sporks',
},
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,10 +91,10 @@ const NetworkDetailPage = ({
/>
</div>
</PageSection>
<PageSection sectionId="past-sporks">
<PageSection sectionId="past-upgrades">
<div className="container">
<HeaderWithLink
headerLink="past-sporks"
headerLink="past-upgrades"
className="text-h4 xs:font-md mb-8"
>
Past Sporks
Expand Down
5 changes: 5 additions & 0 deletions vercel.json
Original file line number Diff line number Diff line change
Expand Up @@ -1328,6 +1328,11 @@
"destination": "tutorials/ai-plus-flow/cursor",
"permanent": true
},
{
"source": "/networks/node-ops/node-operation/past-sporks",
"destination": "/networks/node-ops/node-operation/past-upgrades",
"permanent": true
},
{
"source": "/tutorials/AI%20Guides/agentkit-flow-guide",
"destination": "/tutorials/ai-plus-flow/agentkit-flow-guide",
Expand Down