Seismic Node Operations

Operational tooling and configuration for installing and running Seismic validator and observer nodes.

Validator installation

The interactive validator installer is located at:

install/install-validator.sh

For requirements, installation steps, persistent storage, MDBX notes, validator registration, service startup, OpenResty, and troubleshooting, see the Validator Installer and First-Start Guide.

Observer installation

The observer installer is located at:

install/install-observer.sh

See the Observer Installer and First-Start Guide.

Generate bearer tokens for OpenResty-protected endpoints with:

tools/generate-openresty-jwt.sh

The Summit internal-testnet genesis file is provided at:

internal_testnet_genesis.toml

Repository checks

GitHub Actions checks shell scripts and Markdown through .github/workflows/checks.yml.

Run the same checks locally from the repository root. ShellCheck must be installed; Go and Node.js with npx are also required.

go run mvdan.cc/sh/v3/cmd/shfmt@v3.12.0 -d install tools

(
  cd install
  shellcheck -x \
    install-validator.sh \
    install-observer.sh \
    ../tools/generate-openresty-jwt.sh
)

npx --yes prettier@3.6.2 --check '**/*.md'
npx --yes markdownlint-cli2@0.21.0 './**/*.md' '#./.git/**'

Shell formatting is defined in .editorconfig. Markdown formatting and lint rules are defined in .prettierrc.json and .markdownlint-cli2.jsonc.