BitSong is a new music streaming platform based on Tendermint consensus BFT, the Cosmos SDK toolkits and the IPFS distribuited filesystem. Please make sure you study these projects as well if you are not already familiar.

BitSong is a project dedicated to musicians and their fans, which aims to overcome the bureaucratic and economic obstacles within this industry and reward artists and users for simply using the platform.

Artists need no longer to wait several months before a record label sends various reports, they can check the progress in real time directly within the Wallet.

NOTE: This is alpha software. Please contact us if you aim to run it in production.

Note: Requires Go 1.16.0+

Install BitSong Blockchain

There are many ways you can install BitSong Blockchain Testnet node on your machine.

From Source

Install Go by following the official docs. Remember to set your $GOPATH and $PATH environment variables, for example:

wget https://dl.google.com/go/go1.16.3.linux-amd64.tar.gz
sudo tar -xvzf go1.16.3.linux-amd64.tar.gz
sudo mv go /usr/local
 
cat <<EOF >> ~/.profile  
export GOPATH=$HOME/go  
export GO111MODULE=on  
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin  
EOF

Clone BitSong source code to your machine

mkdir -p $GOPATH/src/github.com/BitSongOfficial
cd $GOPATH/src/github.com/BitSongOfficial
git clone https://github.com/BitSongOfficial/go-bitsong.git
cd go-bitsong
git checkout sdk-v0.42.x

Compile

  # Install the app into your $GOBIN
  make install
  # Now you should be able to run the following commands:
  bitsongd help

The latest go-bitsong version is now installed.

Run BitSong
```
bitsongd start
```

Running the test network and using the commands

To initialize configuration and a genesis.json file for your application and an account for the transactions, start by running:

NOTE: In the below commands addresses are are pulled using terminal utilities. You can also just input the raw strings saved from creating keys, shown below. The commands require jq to be installed on your machine.

NOTE: If you have run the tutorial before, you can start from scratch with a bitsongd unsafe-reset-all or by deleting both of the home folders rm -rf ~/.bitsong*

# Initialize configuration files and genesis file
bitsongd init MyValidator --chain-id bitsong-localnet

# Copy the `Address` output here and save it for later use
# [optional] add "--ledger" at the end to use a Ledger Nano S
bitsongd keys add jack

# Add both accounts, with coins to the genesis file
bitsongd add-genesis-account jack 100000000000ubtsg --keyring-backend test

# Generate the transaction that creates your validator
bitsongd gentx jack 10000000ubtsg --keyring-backend test

# Add the generated bonding transaction to the genesis file
bitsongd collect-gentxs
bitsongd validate-genesis

# Now its safe to start `bitsongd`
bitsongd start

You can now start bitsongd by calling bitsongd start. You will see logs begin streaming that represent blocks being produced, this will take a couple of seconds.

Resources

Official Website

Buy/Sell BTSG ERC20

Community

License

APACHE 2.0

Versioning

SemVer

BitSong uses SemVer to determine when and how the version changes. According to SemVer, anything in the public API can change at any time before version 1.0.0

To provide some stability to BitSong users in these 0.X.X days, the MINOR version is used to signal breaking changes across a subset of the total public API. This subset includes all interfaces exposed to other processes, but does not include the in-process Go APIs.

postcap-io / go-bitsong