crypto-org-chain/cronos

Table of Contents
1. Description
2. Contributing
3. License
4. Documentation
5. Build full node
6. Start a local Development Network and Node
7. Send Your First Transaction
8. Testing
9. Pystarport Quick Start
10. Useful links

1. Description

Cronos is the Crypto.org EVM chain that aims to massively scale the DeFi ecosystem.

2. Contributing

Please abide by the Code of Conduct in all interactions,
and the contributing guidelines when submitting code.

3. License

Apache 2.0

4. Documentation

Technical documentation.

5. Build full node

# COSMOS_BUILD_OPTIONS=rocksdb make install
make build

6. Start a local Development Network and Node

Please follow this documentation to run a local devnet.

7. Send Your First Transaction

After setting the local devnet, you may interact with the your local blockchain by following this documentation.

8. Testing

There are different tests that can be executed in the following ways:

unit tests: make test
integration tests

CI Testing

we use Nix as our CI testing environment and use gomod2nix to convert go modules into nix packages.
Therefore, to install gomod2nix is required:

go install github.com/nix-community/gomod2nix@latest

And then, you can run:

gomod2nix generate

to update gomod2nix.toml if any go package has changed.

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 git@github.com: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 --config ./scripts/cronos-devnet.yaml

get status

pystarport supervisorctl status

stop all

pystarport supervisorctl stop all