Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/crypto-org-chain/chain-main
Crypto.org Chain⛓: Croeseid Testnet and beyond development
https://github.com/crypto-org-chain/chain-main
chain cosmos-sdk cro crypto go golang tendermint
Last synced: 3 months ago
JSON representation
Crypto.org Chain⛓: Croeseid Testnet and beyond development
- Host: GitHub
- URL: https://github.com/crypto-org-chain/chain-main
- Owner: crypto-org-chain
- License: other
- Created: 2020-09-01T09:26:27.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-31T04:48:34.000Z (3 months ago)
- Last Synced: 2024-07-31T06:27:18.667Z (3 months ago)
- Topics: chain, cosmos-sdk, cro, crypto, go, golang, tendermint
- Language: Go
- Homepage: https://crypto.org
- Size: 22.3 MB
- Stars: 491
- Watchers: 48
- Forks: 344
- Open Issues: 24
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-ccamel - crypto-org-chain/chain-main - Cronos POS Chain⛓: Croeseid Testnet and beyond development (Go)
- best-of-crypto - GitHub - 5% open · ⏱️ 24.05.2024): (Exchange-based Tokens)
README
## Table of Contents
- [Table of Contents](#table-of-contents)
- [1. Description](#1-description)
- [2. Contributing](#2-contributing)
- [3. License](#3-license)
- [4. Documentation](#4-documentation)
- [5. Build full node](#5-build-full-node)
- [1. Nix](#1-nix)
- [6. Start a local Development Network and Node](#6-start-a-local-development-network-and-node)
- [7. Send Your First Transaction](#7-send-your-first-transaction)
- [8. Testing](#8-testing)
- [9. Pystarport Quick Start](#9-pystarport-quick-start)
- [install latest python (for linux)](#install-latest-python-for-linux)
- [set path (for linux or for mac)](#set-path-for-linux-or-for-mac)
- [install pystarport](#install-pystarport)
- [quick start](#quick-start)
- [get status](#get-status)
- [stop all](#stop-all)
- [10. Useful links](#10-useful-links)
## 1. Description
**Cronos POS Chain** is a blockchain application built using Cosmos SDK and Tendermint,
intended as a backbone for some of the existing and future Cronos ecosystem.
## 2. Contributing
Please abide by the [Code of Conduct](CODE_OF_CONDUCT.md) in all interactions,
and the [contributing guidelines](CONTRIBUTING.md) when submitting code.
## 3. License
[Apache 2.0](./LICENSE)
## 4. Documentation
Technical documentation can be found in this [Github repository](https://github.com/crypto-org-chain/chain-docs) (you can read it in [this hosted version](https://docs.cronos-pos.org/)).
## 5. Build full node
```bash
# COSMOS_BUILD_OPTIONS=rocksdb make build
make build
```
By default, the command will build a binary with Mainnet configurations.
To build with different network, provided `NETWORK` variable to `make` command
```bash
NETWORK=testnet make build
```
#### 1. Nix
Nix is a (cross-language) package manager for reproducible builds.
On Linux and macOS, you can [install it as follows](https://nixos.org/download.html) (on Windows 10, you can possibly use the Windows Subsystem for Linux):
```
$ curl -L https://nixos.org/nix/install | sh
```
If you're using a recent Mac with a [T2 chip](https://support.apple.com/en-us/HT208862), you might need to check [nix macos installation](https://nixos.org/manual/nix/stable/#sect-macos-installation) when the command above is not working in your environment.
You can then run:
```
$ make chaindImage
```
Which will build a docker image that contains the full node binary.
Optionally, you can also use a binary cache to speed up the build process:
```
$ nix-env -iA cachix -f https://cachix.org/api/v1/install
$ cachix use crypto-org-chain
```
## 6. Start a local Development Network and Node
Please follow this [documentation](https://docs.cronos-pos.org/for-node-hosts/getting-started) to run a local devnet.
## 7. Send Your First Transaction
After setting the local devnet, you may interact with your local blockchain by following this [documentation](https://docs.cronos-pos.org/for-node-hosts/getting-started/local-devnet#interact-with-the-chain).
## 8. Testing
There are different tests that can be executed in the following ways:
- unit tests: `make test`
- simulations: `make test-sim-*` (e.g. `make test-sim-nondeterminism`)
- integrations tests: `make nix-integration-test` (see more details in [their documentation](integration_tests/README.md))
## 9. Pystarport Quick Start
you can install pystarport to manage nodes for development.
### install latest python (for linux)
python version should be 3.8 or above.
you can install python like this.
```
git clone [email protected]:python/cpython.git
cd cpython
git checkout tags/v3.9.5
./configure
make
sudo make install
```
### set path (for linux or for mac)
in some cases, if there are multiple python versions, pystarport cannot be found.
then adjust python path.
also `$HOME/.local/bin` should be included to the PATH.
```
export PATH=/usr/local/bin:$HOME/.local/bin:$PATH
```
### install pystarport
python3 -m pip install pystarport
### quick start
run two nodes devnet
```
pystarport serve --data=./data --config=./integration_tests/configs/default.yaml
```
### get status
```
pystarport supervisorctl status
```
### stop all
```
pystarport supervisorctl stop all
```
---
## 10. Useful links
- [Project Website](https://cronos-pos.org/)
- [Technical Documentation](https://docs.cronos-pos.org/)
- Community chatrooms (non-technical): [Discord](https://discord.gg/MkvPzvP5) [Telegram](**Update Telegram Link**)
- Developer community channel (technical): [](https://discord.gg/pahqHz26q4)
- [Cosmos SDK documentation](https://docs.cosmos.network)
- [Cosmos Discord](https://discord.gg/W8trcGV)
- [Pystarport](./pystarport/README.md)