starsign

Cosmos node configuration, simplified. 🚀🪐🌍

Introduction

Starsign manages many of the routine steps in setting up a node with simple, reusable, and endlessly customizable commands. Supported chains have default settings applied automatically and any others can be configured with the powerful --custom flag.

Supported files include app.toml, config.toml, and genesis.json.

WARNING: This software is not fully tested and may contain some bugs. Back up your configs and use at your own risk!

Installation

Compile with cargo

bash cargo install starsign

Run with docker

bash docker run -v $HOME/.kujira:/config ghcr.io/mintthemoon/starsign config -o /config <...>

Configure your node

Supported chain

bash starsign config -c kaiyo-1 -o $HOME/.kujira/config --statesync Run starsign config -h for a full list of options.

Custom chain

bash starsign config -o $HOME/.osmosisd/config \ --genesis-url https://github.com/osmosis-labs/networks/raw/main/osmosis-1/genesis.json \ --custom '{"app": {"minimum-gas-prices": "0.0025uosmo"}}' \ --moniker <moniker> Run starsign config -h for a full list of options.

Individual files

bash starsign config-app -c kaiyo-1 --custom '{"pruning": "everything"}' starsign config-tendermint -c kaiyo-1 -m <moniker> Run starsign -h for a full list of supported actions.

Existing genesis

Rather than downloading genesis.json from a URL, provide a path to an existing file which you can customize. Useful for initializing local chains. bash starsign config-genesis --genesis-file /path/to/genesis.json \ --custom '{"app_state": {"wasm": {"params": {"instantiate_default_permission": "Everybody"}}}}'

Supported chains

| Chain | Type | ID | | ----- | ---- | -- | | Kujira | Mainnet | kaiyo-1 | | Kujira | Testnet | harpoon-4 | | Gaia | Mainnet | cosmoshub-4 | | Gaia | Testnet | theta-testnet-001 |