Skip to content

Commit 6d7a2ea

Browse files
committed
fix(evolution-scaling): registry desired-vs-actual state note, summary block precision, remove blockchain terminology
1 parent 05551fd commit 6d7a2ea

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

docs/concepts/evolution-scaling.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ In the worst case, the subnet hosting the NNS canisters itself can fail. Because
4545

4646
ICP scales horizontally by creating new subnets. Each subnet hosts thousands of canisters and processes messages independently. Adding a subnet adds proportional capacity to the network: more canisters, more storage, more throughput.
4747

48-
![ICP nodes divided into subnets, each subnet runs a separate blockchain](/concepts/evolution-scaling/add-new-subnet.webp)
48+
![ICP nodes divided into subnets, each running an independent consensus protocol](/concepts/evolution-scaling/add-new-subnet.webp)
4949

5050
Subnets on the Internet Computer communicate using cross-subnet (XNet) messaging. A canister on any subnet can send asynchronous messages to any canister on any other subnet. XNet messages are included in the receiving subnet's consensus blocks and authenticated using [chain-key cryptography](chain-key-cryptography.md). This loosely coupled architecture means newly created subnets can immediately exchange messages with all existing subnets, without a central bottleneck.
5151

@@ -59,7 +59,7 @@ Subnets on the Internet Computer communicate using cross-subnet (XNet) messaging
5959

6060
3. **Community vote.** Anyone who has staked ICP can vote on the proposal. If a majority approve, the NNS registry canister records the new subnet configuration and instructs the NNS subnet to generate the initial cryptographic key material for the subnet using chain-key cryptography.
6161

62-
4. **Subnet genesis.** Each selected node's orchestrator sees the new subnet record in the registry, downloads the correct replica software, and starts the replica with the genesis catch-up package. The nodes form the new subnet blockchain and begin accepting messages.
62+
4. **Subnet genesis.** Each selected node's orchestrator sees the new subnet record in the registry, downloads the correct replica software, and starts the replica with the genesis catch-up package. The nodes form the subnet and begin accepting messages.
6363

6464
## Chain evolution
6565

@@ -74,7 +74,7 @@ The NNS registry stores the complete configuration of the Internet Computer, inc
7474
Upgrades roll out on a per-subnet basis. Within a subnet, all nodes must switch to the new protocol version simultaneously to avoid a fork. This coordination is achieved using epochs:
7575

7676
- The consensus protocol divides time into epochs, each several hundred rounds long.
77-
- At each epoch boundary, nodes produce a summary block containing the configuration (including replica version and cryptographic key material) to use for the next epoch.
77+
- The first block of each epoch is a summary block containing the configuration (including replica version and cryptographic key material) for both the current epoch and the next one. Nodes therefore know the upcoming version from the start of the current epoch, not at the last moment.
7878
- If the registry indicates a new replica version for the upcoming epoch, all nodes download it in advance.
7979

8080
![Protocol upgrade happens at epoch boundaries; all nodes switch simultaneously](/concepts/evolution-scaling/protocol-transition.webp)
@@ -89,6 +89,8 @@ Upgrades roll out on a per-subnet basis. Within a subnet, all nodes must switch
8989

9090
Blocks and consensus artifacts are tagged with the protocol version that produced them. A replica only processes artifacts from its own version, except CUPs (which must be readable by both the pre-upgrade and post-upgrade replica).
9191

92+
The registry records the desired configuration, not the current running version. A subnet may continue running an older version until the CUP handoff completes. Nodes determine the actual current version by querying peers for the highest valid CUP.
93+
9294
### Upgrade governance
9395

9496
![NNS proposal to upgrade a subnet to a new replica version](/concepts/evolution-scaling/upgrade-proposal.webp)

0 commit comments

Comments
 (0)