Repository navigation
[docs] Split the operator runbook examples into Mainnet and Testnet tabs - #1392
Merged
Merged
Conversation
|
Bridgerz
added this pull request to stack #1393
October 9, 2026 23:54
Bridgerz
marked this pull request as ready for review
October 10, 2026 00:00
0xsiddharthks
approved these changes
Oct 10, 2026
Base automatically changed from
bridgerzoske/runbook-mainnet-registration
to
main
October 10, 2026 00:29
Every worked example was Signet and Sui testnet, so a mainnet validator had to translate each one by hand. - Network-specific examples (Sui RPC, Bitcoin node, validator config, CLI config, metrics push, one troubleshooting fix) are now synced tabs, Mainnet first, with each network's ids and URLs filled in. - Mainnet asks validators to self-host the Sui fullnode and the Bitcoin node on hosts separate from the Hashi node. Testnet guidance is unchanged. - A self-hosted fullnode needs rpc.enable-indexing, which is off by default; without it the node's list calls return NotFound. - Mainnet Bitcoin node sizing, config and checks. - trm-api-key stays optional and is strongly encouraged on mainnet.
Hashi looks up each deposit's block with getrawtransaction by txid, which needs txindex, and Bitcoin Core refuses txindex on a pruned node.
Mainnet validators are asked to self-host the Sui fullnode; the Bitcoin node is strongly encouraged rather than required. Says what a provider must cover if one is used.
The light client drops peers that do not advertise both NODE_NETWORK and NODE_COMPACT_FILTERS, and a pruned node never advertises NODE_NETWORK.
On Bitcoin mainnet the light client anchors at a built-in checkpoint just below Taproot activation for any start height above it, including the default, and does not wait on bitcoind for a start-height block.
Bridgerz
force-pushed
the
bridgerzoske/runbook-network-tabs
branch
from
October 10, 2026 00:29
65b930a to
766a02b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #1391.
Summary
Every worked example in the runbook was Signet and Sui testnet, so a mainnet validator had to translate each one by hand. The network-specific examples are now tabs, and the mainnet tab carries the mainnet hosting policy for the Sui fullnode and the Bitcoin node.
Changes
?network=mainnetor?network=testnetin the URL preselects it. Mainnet is first and the default.rpc.enable-indexing: true, which is off by default. Without it the list calls the node makes returnNotFound, which Hashi reports as a missing package or object. Added to 1.4 and to the matching troubleshooting entry.bitcoin.confbound to a private interface, and checks against the 800000 start height.trm-api-key: still optional, strongly encouraged on mainnet, with a pointer to the sanctions page for creating a key.Verification
npm run buildindesign/passes. The built page has six tab groups with Mainnet selected and every code block rendered.enable-indexingis from reading the Sui source (defaultfalse; the state service list calls return not-found without the index) and the calls the node makes at themainnet-1.0commit. It has not been reproduced against a fullnode with indexing off.