Skip to content

docs: add prebuilt seid binary install option (node ops + CLI pages)#44

Merged
alexander-sei merged 3 commits into
mainfrom
docs/prebuilt-seid-binaries
Jul 13, 2026
Merged

docs: add prebuilt seid binary install option (node ops + CLI pages)#44
alexander-sei merged 3 commits into
mainfrom
docs/prebuilt-seid-binaries

Conversation

@monty-sei

Copy link
Copy Markdown
Collaborator

What

Adds the prebuilt release binary as the recommended seid install path on the two install surfaces, presented as tabs alongside the existing build-from-source and Docker options:

  • node/index.mdx — the Install Sei step in the node setup flow
  • evm/installing-seid-cli.mdx — the CLI installation guide

The instructions cover download, sha256 checksum verification, and install, with callouts for the two caveats: linux/amd64 only, and no hardware Ledger support (both routed to build-from-source/Docker).

Why

sei-chain releases attach a statically linked seid (built and boot-tested by CI via sei-protocol/sei-chain#3749's pipeline), which removes the Go-toolchain requirement for operators. The docs currently only describe building from source.

Notes for reviewers

Each sei-chain release now attaches a statically linked linux/amd64 seid
with checksums. Add it as the recommended install path on the node
operations guide and the seid CLI page, alongside build-from-source and
Docker. Includes checksum verification and the amd64/Ledger caveats.
Asset filenames omit the leading v from the version tag, handled via
shell substitution in the examples.
@cursor

cursor Bot commented Jul 13, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Documentation-only changes to installation and upgrade instructions; no application or infrastructure code is modified.

Overview
Documents prebuilt GitHub release binaries as the recommended way to install seid, alongside existing build-from-source (and Docker on the node setup page).

evm/installing-seid-cli.mdx — Installation is now tabbed: download with ${VERSION#v} asset naming, sha256 checksum verification, install to /usr/local/bin. Go is called out as build-from-source only; GOPATH troubleshooting and uninstall cover both install paths. Notes cover linux/amd64, no Ledger, and PATH shadowing from old make install copies.

node/index.mdx — The Install Sei step uses the same prebuilt flow (plus RocksDB / Ledger caveats). Go install is scoped to source builds; Docker moves into its own tab; GOPATH guidance sits under the source tab.

node/node-operators.mdx — Update Procedures add a warning about not mixing install methods, and minor/major upgrade steps are split into prebuilt vs source tabs with the same download-and-verify commands.

Reviewed by Cursor Bugbot for commit cd76293. Bugbot is set up for automated code reviews on this repo. Configure here.

Comment thread evm/installing-seid-cli.mdx Outdated
@mintlify

mintlify Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
sei-docs 🟢 Ready View Preview Jul 13, 2026, 5:31 AM

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

Review follow-ups to the prebuilt binary install option (#44):

Chain verify -> extract -> install with && on both install pages so a
failed checksum stops the block instead of installing an unverified
binary (Bugbot finding). GNU sha256sum -c also exits non-zero when
nothing was verified under --ignore-missing, so pasting the block before
a release carries binaries (asset 404) halts at verification too.

Extend the prebuilt option to the seid surfaces the PR missed:

- node-operators Update Procedures: prebuilt download/verify/replace
  tabs beside build-from-source for both minor and major updates, with
  a callout to upgrade via the original install method (make install
  writes to $(go env GOPATH)/bin, the prebuilt flow to /usr/local/bin;
  mixing them strands the service unit on a stale binary)
- Same PATH-shadowing note on both install pages; Uninstalling seid
  covers both locations
- Prebuilt caveat callout also names the omitted optional RocksDB
  state-store backend (rocksdb builds remain source-only)
- Go prerequisite and GOPATH troubleshooting scoped to source builds
- Consistency: <version-tag> placeholders and plain seid version
  across tabs

mint broken-links passes; all three pages verified rendering on a local
mint dev (tab panels, callouts, no raw MDX leakage).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@alexander-sei

Copy link
Copy Markdown
Collaborator

Pushed review follow-ups in 5e77cc2:

Bugbot fix — the verify → extract → install steps are now &&-chained, so tar/install only run if sha256sum -c exits 0. Both failure modes halt the block on Linux/GNU coreutils: a checksum mismatch (FAILED, exit 1), and nothing-verified-at-all — if the release asset 404s or the tarball isn't in the current dir, --ignore-missing reports "no file was verified" and exits non-zero. So even pasting the whole block before a release carries binaries can't install anything.

Coverage gaps — the install pages weren't the only seid install surfaces:

  • node/node-operators.mdx "Update Procedures" only documented git checkout + make install. Both minor and major update flows now have a Prebuilt binary tab with the same download/verify/replace sequence, plus a callout to upgrade with the method you originally installed with — make install writes to $(go env GOPATH)/bin while the prebuilt flow writes to /usr/local/bin, and mixing them can leave the service unit running a stale binary (which -a seid shows every copy).
  • The prebuilt caveat on the node page now also notes the binaries omit the optional RocksDB state-store backend (make install-rocksdb remains source-only).
  • Smaller alignments: Go prerequisite and GOPATH troubleshooting scoped to source builds, "Uninstalling seid" covers both install locations, <version-tag> placeholders and the verify command made consistent across tabs.

Validated with mint broken-links (passes) and a local mint dev render check of all three pages.

The merge hold from the description still applies — v6.5.2 has no binary assets, so this lands with the first release that ships them.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit cd76293. Configure here.

Comment thread node/index.mdx
@alexander-sei alexander-sei merged commit c7fa1f4 into main Jul 13, 2026
10 checks passed
@alexander-sei alexander-sei deleted the docs/prebuilt-seid-binaries branch July 13, 2026 12:11
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