Coreum Blockchain

Coreum addresses the existing limitations of the current blockchains and empowers a solid foundation for future decentralized projects. Coreum’s unique approach is to provide built-in, on-chain solutions to process transactions in a deterministic way to ensure fast, secure, cheap and a green network for a variety of use-cases.

The chain is designed to solve real-world problems at scale by providing native token management systems, Decentralized Exchange (DEX), while being fully decentralized. In addition to the built-on-chain solutions, Coreum uses WebAssembly (WASM) to process smart contracts, and utilizes the Tendermint Byzantine Fault Tolerance (BFT) consensus mechanism and Cosmos SDK’s proven Bonded Proof of Stake (BPoS).

Read more on our website and documentation portal.

Build and Play

Coreum blockchain is under development and all the features are going to be added progressively over time. Everyone is encouraged to run a chain locally for development and testing purposes.

Entire process of running local chain is automated by our tooling. The only prerequisites are:

docker and tmux installed from your favorite package manager
go 1.16 or newer installed and available in your PATH

Build binaries

Steps to build required binaries:

Clone our crust repository to your $HOME directory:

$ cd $HOME
$ git clone https://github.com/CoreumFoundation/crust

Not required but recommended: Add $HOME/crust/bin to your PATH environment variable:

$ export PATH="$HOME/crust/bin:$PATH"

Compile all the required binaries:

$ $HOME/crust/bin/crust build

After the command completes you may find executable $HOME/crust/bin/cored, being both blockchain node and client.

Start local chain

To start local Coreum blockchain execute:

$ $HOME/crust/bin/crust znet
(znet) [znet] $ start

After a while applications will be deployed to your docker:

coredev-00: single cored validator
explorer-postgres, explorer-hasura and explorer-bdjuno: components of the block explorer (work in progress)

To stop and purge the testing environment run:

$ $HOME/crust/bin/crust znet remove

To get all the details on how znet tool might be used, go to the crust repository.

Interact with the chain

After entering znet console by executing:

$ $HOME/crust/bin/crust znet
(znet) [znet] $ start

you may use client to interact with the chain:

List pregenerated wallets:

(znet) [znet] $ coredev-00 keys list

You may use those wallets to issue transactions and queries

Query balances:

(znet) [znet] $ coredev-00 q bank balances core1x645ym2yz4gckqjtpwr8yddqzkkzdpkt4dfrcc

Remember to replace address with the one existing in your keystore.

Send tokens from one account to another:

(znet) [znet] $ coredev-00 tx bank send alice core1cjs7qela0trw2qyyfxw5e5e7cvwzprkj0643h8 10core

Devnet

You may connect to Coreum devnet network by connecting to host 35.223.81.227 on port 26657:

$ cored status --node=tcp://35.223.81.227:26657