Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions skill/references/cli/seid-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,38 @@ Requirements:
- Go 1.24.x required. Run `go version` to confirm.
- If `seid` is not found after install: run `go env GOPATH` and ensure `$GOPATH/bin` is on `PATH`.

## Node Initialization

```bash
seid init <moniker> --chain-id <chain-id> [--home <dir>] [--mode full|validator|seed|archive] [--overwrite]
```

- `--chain-id` is **required** — e.g. `pacific-1` or `atlantic-2`. `seid init` panics with `chain-id is required, please set using --chain-id` if it is left blank.
- For validator or seed nodes, pass `--mode validator` or `--mode seed` so RPC and P2P are configured for that role. Default mode is `full`. `--mode archive` is also accepted: it runs as a full node in CometBFT but takes archive-specific app and EVM config.

### Default bootstrap-peers

On a public network `seid init` now auto-populates the `bootstrap-peers` field in `config.toml` with the Sei Labs seed nodes for that chain, so a freshly initialised node bootstraps peer discovery with no manual seed configuration. Behaviour by chain-id:

| Chain-id | bootstrap-peers written |
|---|---|
| `pacific-1` (mainnet) | Sei Labs seeds (3 nodes) |
| `atlantic-2` (testnet) | Sei Labs seeds (3 nodes) |
| `arctic-1` (devnet) | none — devnets set peers explicitly |
| unknown / private / local chains | none |

Notes:
- The seeds go in `bootstrap-peers` (dialled to populate the address book via PEX, then may be dropped), not `persistent-peers`.
- An existing `bootstrap-peers` value is never overwritten — if the field is already set, `seid init` leaves it untouched.
- Chain-id matching is exact and case-sensitive; `Pacific-1` or a trailing space contributes no seeds.

Example:

```bash
seid init my-node --chain-id pacific-1
# config.toml now has bootstrap-peers pre-filled with the Sei Labs mainnet seeds
```

## Network Reference

| Network | Cosmos chain ID | EVM chain ID |
Expand Down