Skip to content

docs(nodes): update BP and node guides for post-Savanna finality - #246

Merged
TheJudii merged 1 commit into
masterfrom
codex/post-savanna-bp-docs
Jul 22, 2026
Merged

docs(nodes): update BP and node guides for post-Savanna finality#246
TheJudii merged 1 commit into
masterfrom
codex/post-savanna-bp-docs

Conversation

@TheJudii

Copy link
Copy Markdown
Contributor

Summary

  • replace the legacy Leap-era BP installation, requirements, and setup guidance with a TelosZero Core post-Savanna runbook
  • add an end-to-end finalizer operations guide covering BLS key creation, registration, policy and vote verification, relays, backups, rotation, failover, recovery, and decommissioning
  • document the safety boundary around unique BLS keys and persistent, host-local safety.dat
  • update node-role, nodeos, consensus, API, SHiP, and exchange guidance to assume instant finality is already active
  • remove or warn against obsolete and unsafe configuration such as chain-id, history_plugin, stale production, wildcard CORS, and public producer services
  • link the operator documentation to the maintained telosnetwork/node-template profiles and tooling

Why

The existing documentation mixed older Leap and pre-Savanna instructions with the current TelosZero operating model. It did not provide BPs with the finalizer configuration and lifecycle procedures required after instant finality activation.

A producer is not operationally ready without a correctly configured BLS key, durable safety state, vote-capable relay paths, and verified on-chain policy and voting status.

Impact

BPs now have a complete steady-state setup and recovery path for block production and finalizer voting. Non-producing operators get distinct relay, read-only API, and SHiP guidance without unnecessary signing keys.

This changes documentation only; it does not change chain or application behavior.

Validation

  • full Docusaurus production build
  • git diff --check
  • manual review of internal routes, configuration examples, role boundaries, and node-template integration

The production build succeeds with existing broken-link and broken-anchor warnings on unrelated EVM, quickstart, TEVMC, and wallet pages. None are introduced by this PR.

Dependency

Merge telosnetwork/node-template#36 first, or alongside this PR, because these guides reference its new profiles, renderer, peer tooling, and systemd service.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying telos-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2630676
Status: ✅  Deploy successful!
Preview URL: https://dfa55bdc.telos-docs.pages.dev
Branch Preview URL: https://codex-post-savanna-bp-docs.telos-docs.pages.dev

View logs

@TheJudii
TheJudii marked this pull request as ready for review July 22, 2026 16:18
@TheJudii
TheJudii merged commit ee49671 into master Jul 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants