Skip to content

Commit 50e61c9

Browse files
Merge pull request #58 from sei-protocol/docs/update-go-requirements
docs: align Go requirements with source modules
2 parents c09bdf7 + 09ea59f commit 50e61c9

3 files changed

Lines changed: 41 additions & 9 deletions

File tree

‎evm/installing-seid-cli.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The `seid` CLI is the command-line tool for interacting with the Sei blockchain.
1212

1313
## Prerequisites
1414

15-
- Go 1.23+ (build from source only): Installation instructions are available [here](https://go.dev/doc/install). The prebuilt binary has no prerequisites.
15+
- [Go 1.25.6 or later](https://go.dev/doc/install) is required only when building from source. Check the `go.mod` at the release tag you check out below (e.g. [`v6.6.1`](https://github.com/sei-protocol/sei-chain/blob/v6.6.1/go.mod)) for its exact requirement. Prebuilt binaries have no prerequisites.
1616

1717
## Installation
1818

‎node/index.mdx‎

Lines changed: 31 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -63,20 +63,34 @@ timedatectl
6363

6464
##### Install Go
6565

66-
Only needed if you build `seid` from source — the prebuilt binary and Docker
67-
install paths in the next step don't require Go.
66+
You need Go only if you build `seid` from source. The prebuilt binary and Docker
67+
install paths in the next step do not require it.
6868

69-
Suggested Version: Go 1.24.x (required for seid v6.3+)
69+
Current `seid` releases require Go 1.25.6 or later. Check the `go.mod` at the release tag
70+
you check out
71+
(e.g. [`v6.6.1`](https://github.com/sei-protocol/sei-chain/blob/v6.6.1/go.mod)) for its
72+
exact requirement.
7073

7174
###### Installation Steps
7275

7376
```bash
74-
# Check for existing Go installation
77+
# Check for existing Go installations — more than one entry means another copy
78+
# may still win on your PATH after this install
79+
which -a go
7580
go version
7681

77-
# Download and install Go 1.24.x
78-
wget https://go.dev/dl/go1.24.5.linux-amd64.tar.gz
79-
sudo tar -C /usr/local -xzf go1.24.5.linux-amd64.tar.gz
82+
# Bumping Go? Change these two lines only
83+
GO_TARBALL=go1.25.6.linux-amd64.tar.gz
84+
GO_SHA256=f022b6aad78e362bcba9b0b94d09ad58c5a70c6ba3b7582905fababf5fe0181a
85+
86+
curl -fLO https://go.dev/dl/${GO_TARBALL}
87+
88+
# Verify integrity before trusting the archive (go.dev/dl publishes a SHA256 per file
89+
# at ${GO_TARBALL}.sha256), then replace any previous installation — extracting over
90+
# one leaves stale files behind
91+
echo "${GO_SHA256} ${GO_TARBALL}" | sha256sum -c - \
92+
&& sudo rm -rf /usr/local/go \
93+
&& sudo tar -C /usr/local -xzf ${GO_TARBALL}
8094

8195
# Add Go to your environment variables
8296
echo 'export PATH=$PATH:/usr/local/go/bin' >> $HOME/.bashrc
@@ -85,6 +99,16 @@ source $HOME/.bashrc
8599
# Verify installation
86100
go version
87101
```
102+
103+
<Note>
104+
`sudo rm -rf /usr/local/go` is the replacement step [Go's install
105+
docs](https://go.dev/doc/install) prescribe, but it only clears a tarball install. A
106+
package-manager Go (`/usr/lib/go-*`, Homebrew) survives it and can still shadow
107+
`/usr/local/go/bin/go` — if the final `go version` reports the old release,
108+
`which -a go` lists every copy on your `PATH`. If the extraction itself fails, the
109+
verified tarball is still in your working directory: re-run the `sudo tar` command
110+
rather than starting over.
111+
</Note>
88112
</Step>
89113

90114
<Step title="Install Sei">

‎node/seictl.mdx‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,15 @@ If you prefer to build from source or need a specific configuration:
105105

106106
#### Prerequisites
107107

108-
- Go 1.24.5 or higher
108+
- [Go 1.26.0 or later](https://go.dev/doc/install). The commands below build `main`, whose requirement is set in [`go.mod`](https://github.com/sei-protocol/seictl/blob/main/go.mod).
109+
110+
<Note>
111+
This is newer than the Go version needed to build `seid` (1.25.6), so the toolchain from
112+
the [node setup guide](/node) is a minor version behind. Under the default
113+
`GOTOOLCHAIN=auto` that still builds: the go command downloads the toolchain `go.mod`
114+
asks for. If you've set `GOTOOLCHAIN=local` or build without network access, install Go
115+
1.26.0 or later, or use a prebuilt binary above.
116+
</Note>
109117

110118
#### Build
111119

0 commit comments

Comments
 (0)