https://github.com/cosmosregistry/chain-minimal

Mini - A minimal Cosmos SDK chain template
https://github.com/cosmosregistry/chain-minimal

cosmos-sdk cryptocurrency go golang tutorial

Last synced: about 1 month ago
JSON representation

Mini - A minimal Cosmos SDK chain template

• Host: GitHub
• URL: https://github.com/cosmosregistry/chain-minimal
• Owner: cosmosregistry
• License: apache-2.0
• Created: 2022-06-08T14:24:39.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-17T04:56:27.000Z (4 months ago)
• Last Synced: 2024-08-17T05:43:18.283Z (4 months ago)
• Topics: cosmos-sdk, cryptocurrency, go, golang, tutorial
• Language: Go
• Homepage: https://cosmod.xyz
• Size: 676 KB
• Stars: 62
• Watchers: 2
• Forks: 29
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-ccamel - cosmosregistry/chain-minimal - Mini - A minimal Cosmos SDK chain template (Go)
• awesome-cosmos - cosmosregistry/chain-minimal - Template and example of a minimal Cosmos SDK blockchain. (Templates / Terminal Block Explorers)

README

        
# Mini - A minimal Cosmos SDK chain

This repository contains an example of a tiny, but working Cosmos SDK chain.

It uses the least modules possible and is intended to be used as a starting point for building your own chain, without all the boilerplate that other tools generate. It is a simpler version of Cosmos SDK's [simapp](https://github.com/cosmos/cosmos-sdk/tree/main/simapp).

`Minid` uses the **latest** version of the [Cosmos-SDK](https://github.com/cosmos/cosmos-sdk).

> This is an example module for the v0.52.x Cosmos SDK. Looking for the v0.50.x example? Check the [v0.50.x](https://github.com/cosmosregistry/chain-minimal/tree/v0.50.x) branch.

## How to use

In addition to learn how to build a chain thanks to `minid`, you can as well directly run `minid`.

### Prerequisites

* Install Go as described [here](https://go.dev/doc/install).

* Add `GOPATH` to your `PATH`:

  * `export PATH="$PATH:/usr/local/go/bin:$(/usr/local/go/bin/go env GOPATH)/bin"`

You are all set!

### Installation

Install and run `minid`:

```sh

git clone [email protected]:cosmosregistry/chain-minimal.git

cd chain-minimal

make install # install the minid binary

make init # initialize the chain

minid start # start the chain

```

### Troubleshoot

After running `make install`, verify `minid` has been installed by doing `which minid`.

If `minid` is not found, verify that your `$PATH` is configured correctly.

## Useful links

* [Cosmos-SDK Documentation](https://docs.cosmos.network/)