iotaledger / iota / 28632575419

Build # 28632575419

Build Type

push

github

Committed by web-flow

Commit Message

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>

Coverage Stats

160883 of 236519 relevant lines covered (68.02%)

461127.4 hits per line

Source File

Press 'n' to go to next uncovered line, 'b' for previous

Source Not Available