Skip to content

docs: inline embeddable widgets as in-repo Mintlify snippets #31

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexander-sei merged 8 commits into from
Jun 19, 2026
Merged

docs: inline embeddable widgets as in-repo Mintlify snippets #31

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
24fb87e
docs: inline embeddable widgets as in-repo Mintlify snippets
alexander-sei Jun 18, 2026
3a85f9a
docs: inline changelog, ecosystem grid, and rpc-selector widgets
alexander-sei Jun 18, 2026
cb9d9bb
Enhance changelog, RPC UI, and version checks
alexander-sei Jun 18, 2026
d0ee3d2
Improve snippets error handling and styles
alexander-sei Jun 18, 2026
7671222
Refine inlined widget snippets
alexander-sei Jun 18, 2026
c92d1f7
Improve changelog link parsing & grid icons
alexander-sei Jun 19, 2026
b100730
Stabilize AppCard and use dynamic comp name
alexander-sei Jun 19, 2026
6bba2d0
Defer search scroll, use grid rows, sync tab hash
alexander-sei Jun 19, 2026
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
5 changes: 5 additions & 0 deletions _typos.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,8 @@ UPnP = "UPnP"
# "maxiumum" is an upstream typo in CometBFT's config.toml comments, inlined by
# scripts/sync-default-configs.mjs — fixing it here would be reverted on re-sync.
maxiumum = "maxiumum"
# Upstream typos in the sei-chain CHANGELOG, inlined verbatim into
# snippets/changelog.jsx (the live GitHub fetch returns the same text, so
# "correcting" the snapshot would only diverge from the source of truth).
numnber = "numnber" # PR #237 title: "Add next-account-numnber cli"
tunning = "tunning" # changelog entry: "log tunning for p2p"
10 changes: 4 additions & 6 deletions evm/changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
description: 'Track the latest updates, improvements, and changes to Sei Chain. Stay informed about new features, bug fixes, and protocol upgrades.'
keywords: ['changelog', 'updates', 'releases', 'protocol upgrades', 'sei chain']
---

import { Changelog } from '/snippets/changelog.jsx';

Stay up-to-date with the latest changes, improvements, and new features in Sei.

<Info>This changelog is automatically synced from the [sei-chain repository](https://github.com/sei-protocol/sei-chain/blob/main/CHANGELOG.md). For the most up-to-date information, you can also view the changelog directly on GitHub.</Info>
Expand All @@ -15,11 +18,6 @@

</Info>

## Latest Changes

Check warning on line 21 in evm/changelog.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/changelog.mdx#L21 

Use sentence case for headings: 'Latest Changes'.

<iframe
src="https://sei-widgets.vercel.app/changelog"
style={{ width: "100%", minHeight: "800px", border: "0" }}
loading="lazy"
title="Sei changelog"
/>
<Changelog />
10 changes: 4 additions & 6 deletions evm/ecosystem-contracts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
description: 'Comprehensive registry of smart contract addresses for projects building on Sei. Find verified contract addresses organized by project.'
keywords: ['ecosystem contracts', 'smart contracts', 'contract addresses', 'DeFi', 'dApps', 'sei']
---

import { EcosystemContracts } from '/snippets/ecosystem-contracts.jsx';

Discover and interact with the ecosystem building on Sei. This registry contains smart contract addresses for projects built across Sei.

<Info>
Expand All @@ -15,7 +18,7 @@

---

### How to Use This Registry

Check warning on line 21 in evm/ecosystem-contracts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/ecosystem-contracts.mdx#L21 

Use sentence case for headings: 'How to Use This Registry'.

- **Search by Project Name**: Use the search bar to quickly find contracts for specific projects.
- **View Contract Details**: Click on the Seiscan link to see detailed information about the contract
Expand All @@ -29,14 +32,9 @@

</Tip>

## Contract Registry

Check warning on line 35 in evm/ecosystem-contracts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/ecosystem-contracts.mdx#L35 

Use sentence case for headings: 'Contract Registry'.

<iframe
src="https://sei-widgets.vercel.app/ecosystem-contracts"
style={{ width: "100%", minHeight: "600px", border: "0" }}
loading="lazy"
title="Sei ecosystem contract registry"
/>
<EcosystemContracts />

---

Expand Down
10 changes: 4 additions & 6 deletions evm/installing-seid-cli.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
description: 'Complete guide to installing and setting up the Sei CLI (seid) tool, including wallet creation, EVM imports, and troubleshooting common installation issues.'
keywords: ['seid installation', 'sei cli setup', 'seid wallet', 'evm wallet import', 'go installation']
---

import { VersionTable } from '/snippets/version-table.jsx';

## What is seid CLI?

The `seid` CLI is the command-line tool for interacting with the Sei blockchain. It allows you to manage wallets, send transactions, query network data, and perform validator operations.
Expand All @@ -15,12 +18,7 @@

To install seid, locate the version you wish to use on the [sei-chain releases page](https://github.com/sei-protocol/sei-chain/releases). A list of the currently used versions on mainnet and testnet are displayed right below.

<iframe
src="https://sei-widgets.vercel.app/version-table"
style={{ width: "100%", minHeight: "320px", border: "0" }}
loading="lazy"
title="Sei network versions"
/>
<VersionTable />

Then, execute the following commands with the version that you picked:

Expand Down Expand Up @@ -51,7 +49,7 @@

For more information see [here](https://pkg.go.dev/cmd/go#hdr-GOPATH_environment_variable).

## Command Overview

Check warning on line 52 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L52 

Use sentence case for headings: 'Command Overview'.

Seid supports all the commands you need to interact with the chain. To see a list of available commands and explanations of what they do, run seid:

Expand Down Expand Up @@ -99,7 +97,7 @@
Use "seid [command] --help" for more information about a command.
```

## Adding a Wallet

Check warning on line 100 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L100 

Use sentence case for headings: 'Adding a Wallet'.

You can create a new wallet using the seid keys command:

Expand Down Expand Up @@ -150,16 +148,16 @@
mnemonic: ""
```

## EVM Wallet Compatibility

Check warning on line 151 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L151 

Use sentence case for headings: 'EVM Wallet Compatibility'.

### Understanding Coin Types

Check warning on line 153 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L153 

Use sentence case for headings: 'Understanding Coin Types'.

Sei supports two coin types:

- Coin type 118 (default): Standard Cosmos address format
- Coin type 60: Ethereum-compatible address format for EVM wallets

### Creating an EVM-Compatible Wallet

Check warning on line 160 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L160 

Use sentence case for headings: 'Creating an EVM-Compatible Wallet'.

To create a new wallet that's compatible with EVM wallets like MetaMask:

Expand All @@ -186,7 +184,7 @@

<Info>`evm_address` is shown as empty here because it's only displayed after the key first broadcasts a transaction or is associated on-chain. The `0x` address is deterministically derived from the secp256k1 public key.</Info>

### Importing an Existing EVM Wallet

Check warning on line 187 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L187 

Use sentence case for headings: 'Importing an Existing EVM Wallet'.

To import an existing wallet from MetaMask or other EVM wallets:

Expand All @@ -212,7 +210,7 @@

<Info>Use coin type 60 when you want to use the same address across EVM-compatible chains or import from MetaMask. Use the default coin type 118 for standard Cosmos operations.</Info>

## Managing Wallets

Check warning on line 213 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L213 

Use sentence case for headings: 'Managing Wallets'.

To see your local wallets, you can run:

Expand Down Expand Up @@ -251,7 +249,7 @@

to see details about a specific wallet.

## Deleting Wallets

Check warning on line 252 in evm/installing-seid-cli.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/installing-seid-cli.mdx#L252 

Use sentence case for headings: 'Deleting Wallets'.

To delete a wallet/key, you can use the following command:

Expand Down
9 changes: 3 additions & 6 deletions evm/networks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,9 @@ description: "Discover network information for Sei EVM across all environments i
keywords: ["sei evm", "network information", "chain ids", "rpc endpoints", "blockchain explorers"]
---

<iframe
src="https://sei-widgets.vercel.app/network-tabs"
style={{ width: "100%", minHeight: "420px", border: "0" }}
loading="lazy"
title="Sei EVM chain information"
/>
import { NetworkTabs } from '/snippets/network-tabs.jsx';

<NetworkTabs />

The panel above is interactive. For plain-text endpoints you can copy directly — plus additional provider options — see:

Expand Down
9 changes: 3 additions & 6 deletions index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@
keywords: ["Sei", "EVM", "blockchain", "smart contracts", "Solidity", "parallelized EVM", "documentation", "web3", "dApps"]
---

import { NetworkTabs } from '/snippets/network-tabs.jsx';

The first parallelized EVM blockchain delivering unmatched scalability and speed.

<Danger>
Expand All @@ -16,7 +18,7 @@
For USDC.n specifically, see: [Holders of USDC.n Need to Swap or Migrate](https://blog.sei.io/announcements/holders-of-usdcn-need-to-swap-or-migrate/).
</Danger>

## Quick Start

Check warning on line 21 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

index.mdx#L21 

Use sentence case for headings: 'Quick Start'.

<CardGroup cols={3}>
<Card title="Deploy a Smart Contract" icon="code" horizontal href="/evm/evm-general">
Expand All @@ -36,7 +38,7 @@
</Card>
</CardGroup>

## Essential Resources

Check warning on line 41 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

index.mdx#L41 

Use sentence case for headings: 'Essential Resources'.

<CardGroup cols={3}>
<Card title="Chain Info" icon="globe" horizontal href="/learn/dev-chains">
Expand Down Expand Up @@ -125,7 +127,7 @@
</Card>
</CardGroup>

## Smart Contracts

Check warning on line 130 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

index.mdx#L130 

Use sentence case for headings: 'Smart Contracts'.

<Card title="Deploy & Debug on Sei" icon="code" horizontal href="/evm/evm-general">
Write, deploy, and debug Solidity smart contracts with your favorite toolchain. Sei is fully EVM-compatible with 400 ms blocks and parallelized execution.
Expand All @@ -138,7 +140,7 @@
<Card title="Best Practices" icon="gauge-high" horizontal href="/evm/best-practices/optimizing-for-parallelization" />
</CardGroup>

## Infrastructure & Tools

Check warning on line 143 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

index.mdx#L143 

Use sentence case for headings: 'Infrastructure & Tools'.

<CardGroup cols={2}>
<Card title="Run a Node" icon="lock" horizontal href="/node">
Expand All @@ -160,9 +162,4 @@

## Network Information

<iframe
src="https://sei-widgets.vercel.app/network-tabs"
style={{ width: "100%", minHeight: "420px", border: "0" }}
loading="lazy"
title="Sei network information"
/>
<NetworkTabs />
17 changes: 5 additions & 12 deletions learn/dev-chains.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@
description: "Compare Sei's different network environments including testnet, mainnet, and local chains, with detailed chain IDs and purposes for each development stage."
keywords: ['sei chains', 'blockchain networks', 'sei mainnet', 'sei testnet', 'chain registry']
---

import { AddSeiButton } from '/snippets/add-sei-button.jsx';

Sei utilizes multiple chains for various stages of the development lifecycle.
This multi-chain approach allows developers to build, deploy, manage, and
iterate confidently, ensuring thorough testing and feedback before updates go
Expand All @@ -24,12 +27,7 @@
- **WebSocket**: `wss://evm-ws.sei-apis.com`
- **Explorer**: `https://seiscan.io`

<iframe
src="https://sei-widgets.vercel.app/add-sei?network=mainnet&label=Add+Sei+Mainnet+to+your+wallet"
style={{ width: "100%", minHeight: "72px", border: "0" }}
loading="lazy"
title="Add Sei Mainnet to your wallet"
/>
<AddSeiButton network="mainnet" label="Add Sei Mainnet to your wallet" />

## Testnet

Expand All @@ -45,14 +43,9 @@
- **WebSocket**: `wss://evm-ws-testnet.sei-apis.com`
- **Explorer**: `https://testnet.seiscan.io`

<iframe
src="https://sei-widgets.vercel.app/add-sei?network=testnet&label=Add+Sei+Testnet+to+your+wallet"
style={{ width: "100%", minHeight: "72px", border: "0" }}
loading="lazy"
title="Add Sei Testnet to your wallet"
/>
<AddSeiButton network="testnet" label="Add Sei Testnet to your wallet" />

## Local Chains

Check warning on line 48 in learn/dev-chains.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/dev-chains.mdx#L48 

Use sentence case for headings: 'Local Chains'.

Developers can also run local chains on their machines for testing and
development purposes. Local chains are isolated environments that mimic the
Expand All @@ -70,7 +63,7 @@
TIP: View more chain specific information, RPC endpoints, and Explorers for the [EVM](/evm/networks).
</Tip>

## Chain Registry

Check warning on line 66 in learn/dev-chains.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/dev-chains.mdx#L66 

Use sentence case for headings: 'Chain Registry'.

The [Sei Chain Registry](https://github.com/sei-protocol/chain-registry)
contains additional information about each chain.
9 changes: 3 additions & 6 deletions learn/indexers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,13 @@
- the graph
---

import { EcosystemAppGrid } from '/snippets/ecosystem-app-grid.jsx';

**Query Sei Data at Scale**

Indexers collect and organize blockchain data, making it easily queryable for applications. They provide structured APIs, real-time updates, and significantly better performance than querying nodes directly.

## Why Use Indexers?

Check warning on line 19 in learn/indexers.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/indexers.mdx#L19 

Use sentence case for headings: 'Why Use Indexers?'.

- **High Performance** — Query millions of transactions in milliseconds with optimized database structures.
- **Complex Queries** — Filter, sort, and aggregate blockchain data with GraphQL and REST APIs.
Expand All @@ -24,12 +26,7 @@

Indexing solutions for querying Sei blockchain data with high performance and reliability.

<iframe
src="https://sei-widgets.vercel.app/ecosystem/indexer"
style={{ width: "100%", minHeight: "600px", border: "0" }}
loading="lazy"
title="Sei indexers"
/>
<EcosystemAppGrid category="indexer" />

<Info>
Projects listed here are developed by the Sei community. Inclusion on this site does not constitute endorsement. For questions related to each, please contact the project directly.
Expand Down
10 changes: 4 additions & 6 deletions learn/oracles.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,17 @@
description: 'Directory of oracle providers for Sei blockchain. Access reliable price feeds and off-chain data for DeFi applications, smart contracts, and dApps.'
keywords: ['oracle providers', 'price feeds', 'DeFi infrastructure', 'Sei oracles', 'blockchain data']
---

import { EcosystemAppGrid } from '/snippets/ecosystem-app-grid.jsx';

Oracles are the bridge between blockchain networks and real-world data. They provide a secure mechanism for bringing off-chain price data on-chain, enabling DeFi protocols, smart contracts, and dApps to access reliable external information.

## Use Cases

Check warning on line 12 in learn/oracles.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/oracles.mdx#L12 

Use sentence case for headings: 'Use Cases'.

- **DeFi Developers:** Query real-time prices and TWAPs for liquidations and trading
- **dApp Builders:** Access reliable price feeds for any on-chain application
- **Infrastructure Providers:** Build enhanced oracle services on top of existing solutions

## Available Providers

Check warning on line 18 in learn/oracles.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/oracles.mdx#L18 

Use sentence case for headings: 'Available Providers'.

<iframe
src="https://sei-widgets.vercel.app/ecosystem/oracle"
style={{ width: "100%", minHeight: "600px", border: "0" }}
loading="lazy"
title="Sei oracle providers"
/>
<EcosystemAppGrid category="oracle" />
9 changes: 3 additions & 6 deletions learn/rpc-providers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,10 @@ description: 'Directory of reliable RPC service providers for Sei blockchain. Ac
keywords: ['RPC endpoints', 'blockchain infrastructure', 'Sei connections', 'node providers', 'developer access']
---

import { EcosystemAppGrid } from '/snippets/ecosystem-app-grid.jsx';

RPC providers offer endpoints for developers to interact with the Sei
blockchain, archive nodes, and more. Some notable providers
include:

<iframe
src="https://sei-widgets.vercel.app/ecosystem/rpc-provider"
style={{ width: "100%", minHeight: "600px", border: "0" }}
loading="lazy"
title="Sei RPC providers"
/>
<EcosystemAppGrid category="rpc-provider" />
10 changes: 4 additions & 6 deletions learn/wallets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,16 @@
- evm wallet
- cosmos wallet
---

import { EcosystemAppGrid } from '/snippets/ecosystem-app-grid.jsx';

Wallets are essential for managing assets and interacting with the Sei
blockchain. There are various types of wallets available, each offering
different features and levels of security.

<Warning>Manually importing your wallet using a mnemonic from an EVM-only wallet app to a Cosmos-based wallet app, or vice versa, is not recommended. This may generate unexpected wallet addresses due to differing [Coin Types](https://en.bitcoin.it/wiki/BIP_0044#Coin_type).</Warning>

## Types of Wallets

Check warning on line 21 in learn/wallets.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/wallets.mdx#L21 

Use sentence case for headings: 'Types of Wallets'.

1. **Software Wallets**: These are applications or browser extensions that
manage private keys and interact with the blockchain. They are easy to use
Expand All @@ -27,7 +30,7 @@
instead of traditional seed phrases, offering an additional layer of
security.

## Recommended Wallets

Check warning on line 33 in learn/wallets.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/wallets.mdx#L33 

Use sentence case for headings: 'Recommended Wallets'.

| Wallet | EVM | Auth Method | Coin Type | Type | Mobile | Link |
| --- | --- | --- | --- | --- | --- | --- |
Expand All @@ -46,23 +49,18 @@
well as deriving wallet addresses properly, please refer to the
[Advanced Concepts on HD Path Coin Types](/learn/accounts#hd-paths-and-coin-types).

## Hardware Wallets

Check warning on line 52 in learn/wallets.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/wallets.mdx#L52 

Use sentence case for headings: 'Hardware Wallets'.

| Wallet | EVM | Cosmos | Coin Type | Type | Mobile | Link |
| --- | --- | --- | --- | --- | --- | --- |
| Ledger | ✅ | ✅ | 118 / 60 | Hardware | ❌ | [Ledger](https://www.ledger.com/) |
| Arculus | ✅ | ✅ | 118 / 60 | Hardware | ✅ | [Arculus](https://www.getarculus.com/) |

## Integration Guides

Check warning on line 59 in learn/wallets.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/wallets.mdx#L59 

Use sentence case for headings: 'Integration Guides'.

- [Pimlico Wallet](/evm/wallet-integrations/pimlico)
- [Particle Wallet](/evm/wallet-integrations/particle)

## All Wallets

Check warning on line 64 in learn/wallets.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

learn/wallets.mdx#L64 

Use sentence case for headings: 'All Wallets'.

<iframe
src="https://sei-widgets.vercel.app/ecosystem/wallet"
style={{ width: "100%", minHeight: "600px", border: "0" }}
loading="lazy"
title="Sei wallet providers"
/>
<EcosystemAppGrid category="wallet" />
26 changes: 7 additions & 19 deletions node/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
keywords: ["sei node", "node operations", "validator", "RPC node", "sei blockchain", "node infrastructure"]
---

import { VersionTable } from '/snippets/version-table.jsx';
import { RandomPeers } from '/snippets/random-peers.jsx';

**Power the Sei Network Infrastructure**

Comprehensive guides for running, maintaining, and optimizing Sei network nodes. Whether you're setting up a validator, an RPC node, or a relayer, you'll find detailed instructions and best practices to ensure optimal performance and security.
Expand All @@ -16,18 +19,13 @@
<Card horizontal title="Archive Nodes" icon="database" />
</CardGroup>

## Network Versions

Check warning on line 22 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L22 

Use sentence case for headings: 'Network Versions'.

<iframe
src="https://sei-widgets.vercel.app/version-table"
style={{ width: "100%", minHeight: "320px", border: "0" }}
loading="lazy"
title="Sei network versions"
/>
<VersionTable />

_Live binary versions, genesis, and seed peers — see the [network versions widget](https://sei-widgets.vercel.app/version-table) or the [technical reference](/node/technical-reference)._
_Live binary versions, genesis, and seed peers — see the [technical reference](/node/technical-reference)._

## Hardware Requirements

Check warning on line 28 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L28 

Use sentence case for headings: 'Hardware Requirements'.

| Component | Required |
| --------- | ------------------------------------------------------ |
Expand All @@ -36,7 +34,7 @@
| Storage | 2 TB NVMe SSD (high IOPS required) |
| Network | 2 Gbps with low latency |

## Installation & Setup Steps

Check warning on line 37 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L37 

Use sentence case for headings: 'Installation & Setup Steps'.

<Steps>

Expand All @@ -49,13 +47,13 @@
sudo apt update && sudo apt upgrade -y
```

###### 2. Install Essential Packages

Check warning on line 50 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L50 

Use sentence case for headings: '2. Install Essential Packages'.

```bash
sudo apt install make gcc git jq chrony curl lz4 wget tar build-essential -y
```

###### 3. Synchronize System Time

Check warning on line 56 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L56 

Use sentence case for headings: '3. Synchronize System Time'.

```bash
sudo timedatectl set-timezone UTC
Expand All @@ -63,11 +61,11 @@
timedatectl
```

##### Install Go

Check warning on line 64 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L64 

Use sentence case for headings: 'Install Go'.

Suggested Version: Go 1.24.x (required for seid v6.3+)

###### Installation Steps

Check warning on line 68 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L68 

Use sentence case for headings: 'Installation Steps'.

```bash
# Check for existing Go installation
Expand Down Expand Up @@ -131,7 +129,7 @@
For more information see [here](https://pkg.go.dev/cmd/go#hdr-GOPATH_environment_variable).
</Info>

##### Initialize Chain Files

Check warning on line 132 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L132 

Use sentence case for headings: 'Initialize Chain Files'.

<Info>Default init mode is **full** (RPC/P2P bind to all interfaces). For **validator** or **seed** nodes, use `--mode validator` or `--mode seed` so RPC and P2P bind to localhost only. See the [Validator Operations Guide](/node/validators) for the full validator init example.</Info>

Expand All @@ -139,21 +137,11 @@

- mainnet (pacific-1):

<iframe
src="https://sei-widgets.vercel.app/random-peers?network=mainnet&format=bash"
title="Random Sei mainnet peers"
loading="lazy"
style={{ width: "100%", height: "120px", border: "0", display: "block", margin: "0.75rem 0" }}
/>
<RandomPeers network="mainnet" format="bash" />

- testnet (atlantic-2):

<iframe
src="https://sei-widgets.vercel.app/random-peers?network=testnet&format=bash"
title="Random Sei testnet peers"
loading="lazy"
style={{ width: "100%", height: "120px", border: "0", display: "block", margin: "0.75rem 0" }}
/>
<RandomPeers network="testnet" format="bash" />

```bash
# Initialize node (default mode is full: RPC/P2P bind to all interfaces)
Expand All @@ -169,7 +157,7 @@
sed -i 's/persistent-peers = .*/persistent-peers = "'$PEERS'"/' ~/.sei/config/config.toml
```

##### Configure App Settings

Check warning on line 160 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L160 

Use sentence case for headings: 'Configure App Settings'.

```bash
# Set minimum gas price (recommended; helps prevent spam transactions)
Expand Down Expand Up @@ -199,7 +187,7 @@

<Accordion title="Advanced Configuration">

#### Archive Node Setup

Check warning on line 190 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L190 

Use sentence case for headings: 'Archive Node Setup'.

An archive node maintains the complete historical record of the chain. This requires disabling state sync and starting with a pre-existing database using a "snapshot".

Expand All @@ -213,7 +201,7 @@

**2. Configure Archive Node Peers** — To sync from the height your snapshot was created at, you need peers retaining a large amount of historical blocks. The node will require specific peers during initial sync, which can be changed at a later time.

#### Mempool Configuration

Check warning on line 204 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L204 

Use sentence case for headings: 'Mempool Configuration'.

For optimal transaction handling and resource management, it is recommended to update the mempool settings in your `config.toml` file.

Expand Down Expand Up @@ -301,7 +289,7 @@
sudo systemctl start seid
```

##### Monitoring & Troubleshooting

Check warning on line 292 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L292 

Use sentence case for headings: 'Monitoring & Troubleshooting'.

Check your node's status with these commands:

Expand Down Expand Up @@ -337,9 +325,9 @@

[View Complete Node Setup Guide](/node/node-operators)

## Node Resources

Check warning on line 328 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L328 

Use sentence case for headings: 'Node Resources'.

### Node Setup

Check warning on line 330 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L330 

Use sentence case for headings: 'Node Setup'.

<CardGroup cols={3}>
<Card horizontal title="Node Operations Guide" icon="server" href="/node/node-operators">
Expand All @@ -353,7 +341,7 @@
</Card>
</CardGroup>

### Advanced Operations

Check warning on line 344 in node/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/index.mdx#L344 

Use sentence case for headings: 'Advanced Operations'.

<CardGroup cols={3}>
<Card horizontal title="Configuration & Monitoring" icon="gauge-simple-high" href="/node/advanced-config-monitoring">
Expand Down
10 changes: 4 additions & 6 deletions node/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,17 @@
description: 'Detailed guide for troubleshooting node problems.'
keywords: ['sei node', 'blockchain node', 'node configuration', 'bug', 'troubleshooting']
---

import { RandomPeers } from '/snippets/random-peers.jsx';

Understanding common errors and their solutions helps maintain a healthy node
operation.

## Common Error Codes

Check warning on line 12 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L12 

Use sentence case for headings: 'Common Error Codes'.

Here are the most frequent errors you might encounter and their solutions:

### Consensus Errors

Check warning on line 16 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L16 

Use sentence case for headings: 'Consensus Errors'.

When you encounter consensus errors, quick and appropriate action is essential:

Expand All @@ -32,7 +35,7 @@
Action: Check validator operation on other machines
```

### Network Errors

Check warning on line 38 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L38 

Use sentence case for headings: 'Network Errors'.

Network errors can prevent your node from participating in consensus:

Expand All @@ -52,7 +55,7 @@
- curl localhost:26657/net_info
```

### Database Errors

Check warning on line 58 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L58 

Use sentence case for headings: 'Database Errors'.

Database corruption can require immediate attention:

Expand All @@ -64,7 +67,7 @@
- cp -r backup/data $HOME/.sei/
```

### Diagnostic Commands

Check warning on line 70 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L70 

Use sentence case for headings: 'Diagnostic Commands'.

These commands help you investigate issues and monitor your node:

Expand All @@ -82,7 +85,7 @@
top -p $(pgrep seid)
```

## AppHash Mismatch Errors

Check warning on line 88 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L88 

Use sentence case for headings: 'AppHash Mismatch Errors'.

If you encounter an AppHash mismatch, you'll need to capture the state for comparison with a known good version:

Expand All @@ -101,7 +104,7 @@

Always include the app hash, commit hash, and block height from your logs when reporting issues.

### Identifying AppHash Errors

Check warning on line 107 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L107 

Use sentence case for headings: 'Identifying AppHash Errors'.

AppHash errors typically appear in logs as:

Expand Down Expand Up @@ -129,7 +132,7 @@

4. **Restart the node and monitor logs for continued errors**

### Peer Connection Issues as AppHash Red Herrings

Check warning on line 135 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L135 

Use sentence case for headings: 'Peer Connection Issues as AppHash Red Herrings'.

**Important Note:** Peer connection failures are often symptoms of underlying AppHash errors, not the root cause.

Expand Down Expand Up @@ -165,7 +168,7 @@

This approach can save hours of debugging time by addressing the root cause rather than symptoms.

### Peer Connection and Handshake Issues

Check warning on line 171 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L171 

Use sentence case for headings: 'Peer Connection and Handshake Issues'.

**Identifying Peer Issues:**

Expand All @@ -188,12 +191,7 @@

1. **Update peer configurations** with current node IDs:

<iframe
src="https://sei-widgets.vercel.app/random-peers?network=mainnet&format=toml"
title="Random Sei mainnet persistent_peers (TOML)"
loading="lazy"
style={{ width: "100%", height: "120px", border: "0", display: "block", margin: "0.75rem 0" }}
/>
<RandomPeers network="mainnet" format="toml" />

2. **Verify network connectivity:**

Expand All @@ -211,7 +209,7 @@
curl http://localhost:26657/lag_status | jq .
```

### Sync Performance Issues

Check warning on line 212 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L212 

Use sentence case for headings: 'Sync Performance Issues'.

**Identifying Sync Problems:**

Expand Down Expand Up @@ -255,7 +253,7 @@
- Repeated timeout errors in logs
- Mempool size consistently reaching limits

## Crash and Panic Debugging

Check warning on line 256 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L256 

Use sentence case for headings: 'Crash and Panic Debugging'.

For crashes, panics, or nil pointer exceptions:

Expand All @@ -263,7 +261,7 @@
- Or collect 15 minutes of log data, whichever provides more context
- Include the full stack trace if available

### Logging Configuration

Check warning on line 264 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L264 

Use sentence case for headings: 'Logging Configuration'.

Proper logging configuration is essential for debugging and monitoring:

Expand Down Expand Up @@ -343,7 +341,7 @@
rm -rf $HOME/.sei/data/snapshots/*
```

## Node Rollback

Check warning on line 344 in node/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

node/troubleshooting.mdx#L344 

Use sentence case for headings: 'Node Rollback'.

To rollback a node from an AppHashed state, you need to stop the node first.
Do this in your preferred way.
Expand Down
Loading
Loading