Rewrite staking pool installation for remote install.sh - #98
Open
camembera wants to merge 20 commits into
Open
Conversation
camembera
force-pushed
the
docs/staking-pool-install-cli
branch
from
September 2, 2026 02:23
a8e2fa9 to
49dfa6c
Compare
camembera
commented
Sep 2, 2026
4 tasks
camembera
changed the title
…tor CLI. Thin the per-step behavior lists in the operator flow now that the command reference covers each flag and the underlying call sequence.
…lout. The 5-slot cushion should not run out in normal operation, so the example session no longer walks through the block-not-found error as an expected step.
Draft for Lead review/markup: single `install` entry point, hot-key vs cold-signing mode selection, one confirmation, concise default output with --verbose, resume-safe, set-min-balance/delegated pools out of the automatic flow. deploy/activate/set-min-balance stay available as standalone commands for advanced/manual use.
installation.mdx described a signing-preference prompt (Ledger vs private key) that the CLI never actually reads a key for either way; clarify it defaults to --ledger and is a flag/env override only.
--finalize with no id now finalizes every ready withdrawal request in one batch transaction; --finalize <id> still finalizes just that one.
status/activate/set-min-balance/stake/unstake now read install's scenario file so BEACOND_HOME isn't needed to run them afterward on a remote validator; deploy is the one exception and is unaffected.
Drop env.sh.template copy-and-edit and the deleted standalone verbs.
Replace S-labels and CLI_CHAIN with EL/CL env vars, Plan naming, generated files section, role-address prompts, and compact status expectations.
Align installation, delegators, operators, and overview pages with the shipped installer: no feature-branch checkout, validator-side deposit validate, and separate bastion vs validator scripts.
Point installation and delegation guides at install-helpers, document env.sh.template, and describe optional bracket defaults for pubkey and addresses.
Format only generator outputs with Prettier, and stop chaining a repo-wide make format that rewrites unrelated docs.
Merge delegator-delegate.sh steps into installation.mdx, remove nav entry, redirect old delegators URLs to #form-the-handler, and fix cross-links.
Delegated setup is an internal Foundation process; operators only need an existing DelegationHandler. Redirect delegators URLs to installation without the form-the-handler anchor.
camembera
force-pushed
the
docs/staking-pool-install-cli
branch
from
September 2, 2026 15:49
62a3724 to
0344415
Compare
Mintlify link-rot fails on relative links to repo-only files that are not published pages.
RPC and Node API URLs have script defaults; document override via env.sh and simplify the run example. Align prose with interactive cast/deposit steps.
Drop BUSD ABI path and Prettier API changes from this branch; they ship in #104. Keep only the staking-pools handbook template in generate-pages.mjs.
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
1 participant
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.
Summary
install.shflow inguides/apps/staking-pools/install-helpers/(companion to berachain/guides#448)EL_RPC_URL/CL_NODE_API_URLsetup, validator deposit paste-back, and Ledger or hot-keycast sendfor deploy/activateTest plan
./install.sh(guides PR branch)make checkon changed paths