5 releases

0.1.4 Mar 10, 2023
0.1.3 Mar 1, 2023
0.1.2 Mar 1, 2023
0.1.1 Feb 28, 2023
0.1.0 Feb 27, 2023

#17 in #genesis

MIT license

34KB
728 lines

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

cargo install starsign

Run with docker

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

Configure your node

Supported chain

starsign config -c kaiyo-1 -o $HOME/.kujira/config --statesync

Run starsign config -h for a full list of options.

Custom chain

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

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.

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

Dependencies

~27–44MB
~798K SLoC