sunrise is a blockchain built using Cosmos SDK and CometBFT and created with Ignite CLI.
# install go
go version
# install ignite
ignite version
# v28.3.0
apt install -y protobuf-compiler
protoc --version
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc
go install github.com/cosmos/cosmos-proto/cmd/protoc-gen-go-pulsar
^ +-------------------------------+ ^
| | | |
| | State-machine = Application | |
| | | | sunrise (built with Cosmos SDK)
| | ^ + | |
| +----------- | ABCI | ----------+ v
Sunrise | | + v | ^
validator or | | | |
full consensus | | Consensus | |
node | | | |
| +-------------------------------+ | sunrise-core (fork of CometBFT)
| | | |
| | Networking | |
| | | |
v +-------------------------------+ v
-
Install Go 1.22.2
-
Clone this repo
-
Install the sunrise CLI
make install
If you'd rather not install from source, you can download a prebuilt binary from the releases page.
-
Navigate to the latest release on https://github.com/SunriseLayer/sunrise/releases.
-
Download the binary for your platform (e.g.
sunrise_Linux_x86_64.tar.gz
) from the Assets section. Tip: if you're not sure what platform you're on, you can rununame -a
and look for the operating system (e.g.Linux
,Darwin
) and architecture (e.g.x86_64
,arm64
). -
Extract the archive
tar -xvf sunrise_Linux_x86_64.tar.gz
-
Verify the extracted binary works
./sunrised --help
-
[Optional] verify the prebuilt binary checksum. Download
checksums.txt
and then verify the checksum:sha256sum --ignore-missing --check checksums.txt
You should see output like this:
sunrise_Linux_x86_64.tar.gz: OK
See https://docs.sunriselayer.io/node/build-node for more information.
# Print help
sunrised --help
Variable | Explanation | Default value | Required |
---|---|---|---|
SUNRISE_HOME |
Home directory for the application | User home dir. Ref. | Optional |
# Start a single node devnet
./scripts/single-node.sh
# Publish blob data to the local devnet
sunrised tx blob pay-for-blob 0x00010203040506070809 0x48656c6c6f2c20576f726c6421 \
--chain-id private \
--from validator \
--keyring-backend test \
--fees 21000usr \
--yes
Note
The sunrised binary doesn't support signing with Ledger hardware wallets on Windows and OpenBSD.
This repo attempts to conform to conventional commits so PR titles should ideally start with fix:
, feat:
, build:
, chore:
, ci:
, docs:
, style:
, refactor:
, perf:
, or test:
because this helps with semantic versioning and changelog generation. It is especially important to include an !
(e.g. feat!:
) if the PR includes a breaking change.
- Install golangci-lint 1.57.0
- Install markdownlint 0.39.0
- Install hadolint
- Install yamllint
- Install markdown-link-check
- Install goreleaser
# Get more info on make commands.
make help
# Build the sunrised binary into the ./build directory.
make build
# Build and install the sunrised binary into the $GOPATH/bin directory.
make install
# Run tests
make test
# Format code with linters (this assumes golangci-lint and markdownlint are installed)
make fmt
# Regenerate Protobuf files (this assumes Docker is running)
make proto-gen