https://github.com/swordedge/coreum
Coreum is a 3rd generation, layer 1 Blockchain built to serve as a core infrastructure of future decentralized applications.
https://github.com/swordedge/coreum
blockchain cosmos
Last synced: 11 months ago
JSON representation
Coreum is a 3rd generation, layer 1 Blockchain built to serve as a core infrastructure of future decentralized applications.
- Host: GitHub
- URL: https://github.com/swordedge/coreum
- Owner: swordEdge
- Created: 2017-08-11T09:00:00.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-10-24T02:04:28.000Z (over 2 years ago)
- Last Synced: 2025-03-06T06:29:51.316Z (about 1 year ago)
- Topics: blockchain, cosmos
- Language: Go
- Homepage: https://coreum.com/
- Size: 5.29 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# 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 and 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](https://www.coreum.com) and [documentation portal](https://docs.coreum.dev).
## 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` installed from your favorite package manager
- `go 1.18` or newer installed and available in your `PATH`
### Build binaries
Steps to build required binaries:
1. Clone our [crust repository](https://github.com/CoreumFoundation/crust) to the directory of your choice (let's call it `$COREUM_PATH`):
```
$ cd $COREUM_PATH
$ git clone https://github.com/CoreumFoundation/crust
```
2. Not required but recommended: Add `$COREUM_PATH/crust/bin` to your `PATH` environment variable:
```
$ export PATH="$COREUM_PATH/crust/bin:$PATH"
```
3. Compile all the required binaries and docker images:
```
$ $COREUM_PATH/crust/bin/crust build images
```
After the command completes you may find executable `$COREUM_PATH/crust/bin/cored`, being both blockchain node and client.
### Start local chain
To start local Coreum blockchain execute:
```
$ $COREUM_PATH/crust/bin/crust znet
(znet) [znet] $ start
```
After a while applications will be deployed to your docker:
- `cored-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](https://github.com/CoreumFoundation/crust).
### Interact with the local chain
After entering `znet` console by executing:
```
$ $HOME/crust/bin/crust znet
(znet) [znet] $ start
```
you may use client to interact with the chain:
1. List pregenerated wallets:
```
(znet) [znet] $ cored-00 keys list
```
You may use those wallets to issue transactions and queries
2. Generate a Wallet and Query balances:
```
(znet) [znet] $ cored-00 keys add {YOUR_WALLET_NAME}
```
This will generate a wallet and print out the mnemonic at the end. It will also print
the address and public key. Use the address in the next commands to query its balance
and transfer funds to it.
```
(znet) [znet] $ cored-00 q bank balances {YOUR_GENERATED_ADDRESS}
```
Remember to replace address with the one existing in your keystore.
You will see the balance is zero.
3. Send tokens from one account to another:
```
(znet) [znet] $ cored-00 tx bank send alice {YOUR_GENERATED_ADDRESS} 10udevcore --broadcast-mode=block
```
Run the query again and you will see that there are now funds in the newly generated account.
```
(znet) [znet] $ cored-00 q bank balances {YOUR_GENERATED_ADDRESS}
```
## Connect to Running Chains
Coreum has `mainnet`, `testnet` and `devnet` chains running. In order to connect to any of those networks, get the
network variables from the docs [here](https://docs.coreum.dev/tutorials/network-variables.html), and
provide the correct `node` and `chain-id` flags to the cli command.
As an example here is a command to connect to the testnet to get the status:
```
$ cored status --chain-id=coreum-testnet-1 --node=https://full-node.testnet-1.coreum.dev:26657
```
It should also be mentioned that for development purposes testnet is more stable than devnet.
You can also find block explorers for each chain by this
[link](https://docs.coreum.dev/tools-ecosystem/block-explorer.html).