iotaledger / iota / 28632575419
68%

DEFAULT BRANCH: develop
Ran
Jobs 1
Files 1110
Run time 2min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 68.021% (+0.2%) from 67.801%
28632575419

push

github

web-flow 
feat(release-notes): report earliest epoch a new protocol version can be enabled (#12124)

# Description of change

When a release introduces a new protocol version, the release notes now
report the earliest epoch — and its UTC time — at which that version can
actually be enabled on the target network. Previously the notes only
stated that a new protocol version was introduced, leaving readers to
guess *when* it could take effect.

The generator learns the target network from a new `--network` argument.
`release.yml` derives it from the release tag suffix (`-alpha` →
`alphanet`, `-beta` → `devnet`, `-rc` → `testnet`, otherwise `mainnet`)
and passes it to `run.sh generate`. When a new protocol version is
present, `release_notes.py` queries that network's public fullnode
(`iotax_getLatestIotaSystemStateV2`) for the current epoch and computes
the next epoch boundary from `epochStartTimestampMs + epochDurationMs`.
If the fullnode is unreachable or returns unexpected data, it logs a
warning and omits the line rather than failing the release run.

## How the change has been tested

- [x] Basic tests (linting, compilation, formatting, unit/integration
tests)
- [ ] Patch-specific tests (correctness, functionality coverage)

Verified that the script parses cleanly and that `--network` accepts
exactly `{alphanet, devnet, testnet, mainnet}` via `generate --help` /
`dry-run --help`. The network lookup and date formatting have not yet
been exercised against a live fullnode as part of a full release run.

Regenerating the exact same release notes of
https://github.com/iotaledger/iota/releases/tag/v1.26.1 produced the
following:
```
## Protocol

#### This release introduces protocol version `29`

On `mainnet`, this protocol version can be enabled no earlier than `2026-07-03 07:41 UTC` (start of epoch 424).
```

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

160883 of 236519 relevant lines covered (68.02%)

461127.4 hits per line

Coverage Regressions

Lines Coverage ∆ File
250
84.29
 -2.99% crates/iota-node/src/lib.rs
238
77.51
 0.3% crates/iota-core/src/checkpoints/mod.rs
213
5.39
 0.15% crates/iota-tool/src/lib.rs
125
78.05
 0.0% crates/iota-core/src/execution_cache.rs
119
70.42
 2.0% crates/iota-core/src/authority/authority_store.rs
116
75.5
 -0.36% crates/iota-snapshot/src/reader.rs
109
0.0
 0.0% crates/iota-tool/src/commands.rs
90
40.03
 2.04% crates/iota-types/src/storage/read_store.rs
81
86.42
 16.02% crates/iota-core/src/grpc_indexes.rs
58
55.42
 0.0% crates/iota-archival/src/reader.rs
52
77.31
 -0.39% crates/iota-storage/src/object_store/util.rs
48
91.53
 0.1% crates/iota-core/src/execution_cache/writeback_cache.rs
47
0.0
 0.0% crates/iota-snapshot/src/uploader.rs
46
85.81
 1.11% crates/iota-snapshot/src/writer.rs
39
80.6
 15.98% crates/iota-snapshot/src/lib.rs
34
90.87
 0.22% crates/iota-core/src/checkpoints/checkpoint_executor/mod.rs
29
56.93
 3.33% crates/iota-types/src/full_checkpoint_content.rs
29
77.16
 8.89% crates/iota-types/src/iota_system_state/mod.rs
24
85.62
 0.0% crates/iota-config/src/node.rs
24
77.61
 21.19% crates/iota-storage/src/lib.rs
22
90.71
 -0.03% crates/iota-grpc-server/src/types.rs
21
84.5
 4.87% crates/iota-core/src/global_state_hasher.rs
21
0.0
 0.0% crates/iota-core/src/verify_indexes.rs
20
34.51
 4.75% crates/iota-storage/src/object_store/http/mod.rs
19
62.08
 1.12% crates/simulacrum/src/lib.rs
15
89.35
 -4.47% crates/iota-core/src/connection_monitor.rs
14
81.06
 4.15% crates/iota-core/src/authority/authority_store_tables.rs
13
0.0
 0.0% crates/iota-storage/src/object_store/http/gcs.rs
13
0.0
 0.0% crates/iota-storage/src/object_store/http/s3.rs
13
45.88
 -0.35% crates/iota-transactional-test-runner/src/simulator_persisted_store.rs
12
93.81
 -0.44% crates/starfish/core/src/authority_service.rs
9
94.77
 1.66% crates/iota-core/src/authority/authority_store_types.rs
8
78.57
 0.19% crates/iota-grpc-server/src/ledger_service/get_epoch.rs
7
75.93
 2.06% crates/test-cluster/src/lib.rs
6
78.4
 -0.83% crates/iota-core/src/traffic_controller/mod.rs
5
81.48
 14.81% crates/iota-storage/src/object_store/mod.rs
4
36.84
 0.0% crates/iota-node-storage/src/lib.rs
3
94.74
 -5.26% crates/iota-snapshot/src/restore.rs
3
75.0
 -5.0% crates/iota-storage/src/object_store/http/local.rs
2
90.94
 -0.08% crates/iota-core/src/authority/authority_per_epoch_store.rs
2
96.3
 -0.32% crates/iota-core/src/overload_monitor.rs
2
95.83
 0.0% crates/iota-core/src/par_index_live_object_set.rs
2
89.62
 -0.21% crates/starfish/core/src/commit_syncer/fast.rs
1
95.65
 -4.35% crates/iota-keys/src/random_names.rs
1
83.41
 -0.24% crates/starfish/core/src/core_thread.rs
1
96.31
 -0.03% crates/starfish/core/src/dag_state.rs
1
91.55
 -0.05% crates/starfish/core/src/header_synchronizer.rs
Jobs
ID Job ID Ran Files Coverage
1 nextest+simtest - 28632575419.1 1110
68.02
 GitHub Action Run
Source Files on build 28632575419