Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nolus-protocol/nolus-core
Nolus core is a blockchain built using Cosmos SDK and Tendermint
https://github.com/nolus-protocol/nolus-core
Last synced: 3 months ago
JSON representation
Nolus core is a blockchain built using Cosmos SDK and Tendermint
- Host: GitHub
- URL: https://github.com/nolus-protocol/nolus-core
- Owner: nolus-protocol
- License: apache-2.0
- Created: 2022-04-12T13:02:39.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T13:14:33.000Z (7 months ago)
- Last Synced: 2024-04-12T16:23:55.557Z (7 months ago)
- Language: Go
- Homepage:
- Size: 7.67 MB
- Stars: 37
- Watchers: 7
- Forks: 40
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - nolus-protocol/nolus-core - Nolus core is a blockchain built using Cosmos SDK and Tendermint (Go)
README
# Nolus Core
[](https://goreportcard.com/report/github.com/Nolus-Protocol/nolus-core)
[](https://github.com/Nolus-Protocol/nolus-core/blob/main/LICENSE)
[](https://github.com/Nolus-Protocol/nolus-core/actions/workflows/lint.yaml)
[](https://github.com/Nolus-Protocol/nolus-core/actions/workflows/test.yaml)
[](https://github.com/Nolus-Protocol/nolus-core/actions/workflows/test-fuzz.yaml)
[](https://github.com/Nolus-Protocol/nolus-core/actions/workflows/test-cosmos.yaml)
**Nolus** is a blockchain built using Cosmos SDK and CometBFT.
## Prerequisites
Install [golang](https://golang.org/), [tomlq](https://tomlq.readthedocs.io/en/latest/installation.html) and [jq](https://stedolan.github.io/jq/).
## Get started
### Build, configure and run a single-node locally deployed Nolus chain
#### Build
```sh
make install
```
The command will compile and install nolusd locally on your machine.
#### Initialize, set up and run
`init-local-network.sh` generates a network setup, including the deployment of platform contracts (only) and initial Hermes setup (Nolus chain configuration).
First, generate the mnemonic you will use for Hermes:
```sh
nolusd keys mnemonic
```
Initialize and start (run `./scripts/init-local-network.sh --help` for additional configuration options):
```sh
./scripts/init-local-network.sh --reserve-tokens --hermes-mnemonic --dex-admin-mnemonic --store-code-privileged-account-mnemonic
```
*Notes:
* Make sure the `nolus-money-market` repository is checked out as a sibling to this one.
* !!! Before running the `./scripts/init-local-network.sh` again, make sure the `nolusd` and `hermes` processes are killed.
* The nolusd logs are stored in `~/.nolus`.
### Run an already configured single-node
```sh
nolusd start --home "networks/nolus/local-validator-1"
```
## Set up a new DEX
On a live network, a new DEX can be deployed using the following steps.
### Manual step - Prerequisites
* provide a certain amount for the Hermes account (DEX side)
Recover your Hermes wallet on the DEX network and use a faucet to obtain some amount.
Example for the Osmosis DEX ([Osmo-test-5 faucet](https://faucet.osmotest5.osmosis.zone/)):
```sh
osmosisd keys add hermes_key --recover
```
* start hermes
### Аutomated step
```sh
./scripts/add-new-dex.sh --dex-admin-key --store-code-privileged-user-key --wasm-artifacts-path --dex-name --dex-chain-id --dex-ip-addr-rpc-host --dex-ip-addr-grpc-host --dex-account-prefix --dex-price-denom --dex-trusting-period-secs --dex-if-interchain-security --protocol-currency --protocol-swap-tree
```
The script takes care of setting up Hermes to work with the new DEX and, for now, deploying DEX-specific contracts (More about deploying contracts on a live network can be found [here](https://github.com/nolus-protocol/nolus-money-market)).
*Notes:
* Execute `./scripts/add-new-dex.sh --help` for additional configuration options
* The `protocol-swap-tree` must be passed in single quotes (for example: **--protocol-swap-tree '{"value":[0,"USDC"],"children":[{"value":[5,"OSMO"],"children":[{"value":[12,"ATOM"]}]}]}'**)
* The script will locate the Hermes account from the Hermes configuration directory and link it to the new DEX
## Build a statically linked binary
By default, `make build` generates a dynamically linked binary. In case someone would like to reproduce the way the binary is built in the pipeline then the command to achieve it locally is:
```sh
docker run --rm -it -v "$(pwd)":/code public.ecr.aws/nolus/builder: make build -C /code
```
## Upgrade wasmvm
* Update the Go modules
* Update the wasmvm version in the builder Dockerfile at .github/images/builder.Dockerfile
* Increment the IMAGE_TAG and use the same version in the build-binary step in .github/workflows/build.yaml
## Run a full node with docker
[https://github.com/Nolus-Protocol/nolus-networks](https://github.com/Nolus-Protocol/nolus-networks)