docs(node): retire the random peer list in favour of the Sei Labs seeds

[monty-sei]

Problem

snippets/random-peers.jsx serves 17 hardcoded community peer addresses, and most of them are gone. Dialling every entry today:

responding:  6/17
refused:     2
timed out:   9

That snippet is rendered on the node setup guide and the troubleshooting guide, so an operator following either one is copying a list that is roughly two thirds dead. It reads as a broken network rather than a stale page, and the troubleshooting guide in particular offers it as the fix for peer handshake failed, which is the error a dead peer produces.

There is also a contradiction on the setup page. It tells you peer discovery needs no manual configuration, then immediately offers the dead list above it, plus a sed snippet writing them to persistent-peers, which is the wrong field for seeds.

Change

Operators do not need a peer list any more. Since v6.6.2, seid init writes the Sei Labs seeds into bootstrap-peers for well-known public networks, so a fresh node bootstraps with no further configuration.

• Replaces random-peers.jsx with seeds.jsx, serving the three Sei Labs seeds per network in the same shape, so both pages keep their copy button
• Folds the setup page's peer content into one Peer discovery section, and drops the persistent-peers snippet
• Points the troubleshooting step at the seeds, noting that init will not overwrite a bootstrap-peers value you have already set
• Corrects max-packet-msg-payload-size in the config.toml example, which read 10240 against an actual default of 1000000

Verification

The six addresses match app/seeds/seeds.go in sei-chain v6.7.1 exactly, and all six complete a P2P handshake:

pacific-1/prod   SPEAKS      atlantic-2/prod   SPEAKS
pacific-1/euw1   SPEAKS      atlantic-2/euw1   SPEAKS
pacific-1/use2   SPEAKS      atlantic-2/use2   SPEAKS

Other [p2p] values in the example were checked against DefaultP2PConfig() and the config.toml template at v6.7.1 and are correct as written, max-outbound-connections included.

Notes

llms-full.txt still contains the old snippet. Left alone deliberately: AGENTS.md says not to hand-edit the generated .txt files, and the weekly regenerate-llms.yml workflow rebuilds them from the deployed site.

Supersedes #57, which predates the seed documentation already on main and had fallen into conflict.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
sei-docs	🟢 Ready	View Preview	Oct 11, 2026, 11:14 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[cursor]

PR Summary

Low Risk
Documentation and a docs-only React snippet swap; no runtime or application code changes.

Overview
Replaces the random community peer list docs snippet with Sei Labs seed nodes and aligns setup/troubleshooting guidance with v6.6.2+ behavior where seid init fills bootstrap-peers automatically.

snippets/random-peers.jsx is removed and snippets/seeds.jsx is added, exposing three regional seeds per mainnet/testnet with copy-to-clipboard output as bootstrap-peers (not persistent-peers). The node setup guide gains a dedicated Peer discovery section: no more sed into persistent-peers or shuffled dead peers; manual seed values are optional for older inits.

Troubleshooting now tells operators to reset to those seeds for handshake/ID mismatches, with a note that re-init will not overwrite existing bootstrap-peers.

Technical reference fixes the config.toml example: max-packet-msg-payload-size 10240 → 1000000 to match the real default.

^{Reviewed by Cursor Bugbot for commit 8ecac82. Bugbot is set up for automated code reviews on this repo. Configure here.}

[seidroid]

This PR swaps the mostly-dead community peer list for the Sei Labs seeds, fixes the persistent-peers vs bootstrap-peers mix-up, and corrects the max-packet-msg-payload-size default. It is clean overall, with only small non-blocking notes.

Findings: 0 blocking | 7 non-blocking | 3 posted inline

Blockers

• None at the file/PR level.

Non-blocking

• The Cursor second-opinion review produced no output. The Codex review reported no material issues.
• REVIEW_GUIDELINES.md is empty, so this review applies only AGENTS.md conventions.
• I found no remaining references to random-peers.jsx / RandomPeers outside the generated llms-full.txt. Leaving that file for the weekly regeneration matches AGENTS.md.
• The format='bash' branch, which outputs SEEDS="...", is no longer used by any caller. Consider dropping it, or making toml the default, so the snippet doesn't suggest a SEEDS shell variable that nothing reads.
• 3 suggestion(s)/nit(s) flagged inline on specific lines.

[seidroid]

[suggestion] This step only shows mainnet seeds. A Sei Testnet operator who hits peer handshake failed would copy pacific-1 seeds into an atlantic-2 node. Consider adding the testnet block with labels, as node/index.mdx does: - Sei Mainnet (pacific-1): / - Sei Testnet (atlantic-2):.

[seidroid]

[nit] The old snippet used text-green-600 dark:text-green-400 for the Copied check icon. The dark: variant was dropped here, so the icon has lower contrast in dark mode. Consider restoring it.

[seidroid]

[nit] This line uses curly quotes (“ ”), while the rest of the codebase uses straight quotes. Purely cosmetic.