README
​​
​​
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.13.6+​
There are many ways you can install BitSong Blockchain Testnet node on your machine.
Install Go by following the official docs. Remember to set your
$GOPATHand$PATHenvironment variables, for example:wget https://dl.google.com/go/go1.13.6.linux-amd64.tar.gzsudo tar -xvzf go1.13.6.linux-amd64.tar.gzsudo mv go /usr/local​cat <<EOF >> ~/.profileexport GOPATH=$HOME/goexport GO111MODULE=onexport PATH=$PATH:/usr/local/go/bin:$HOME/go/binEOFClone BitSong source code to your machine
mkdir -p $GOPATH/src/github.com/BitSongOfficialcd $GOPATH/src/github.com/BitSongOfficialgit clone https://github.com/BitSongOfficial/go-bitsong.gitcd go-bitsonggit checkout developCompile
# Install the app into your $GOBINmake install# Now you should be able to run the following commands:bitsongd helpbitsongcli helpThe latest
go-bitsong versionis now installed.
Run BitSong
bitsongd start
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
jqto be installed on your machine.NOTE: If you have run the tutorial before, you can start from scratch with a
bitsongd unsafe-reset-allor by deleting both of the home foldersrm -rf ~/.bitsong*NOTE: If you have the Cosmos app for ledger and you want to use it, when you create the key with
bitsongcli keys add jackjust add--ledgerat the end. That's all you need. When you sign,jackwill be recognized as a Ledger key and will require a device.
# Initialize configuration files and genesis filebitsongd init MyValidator --chain-id bitsong-localnet​# Configure your CLI to eliminate need for chain-id flagbitsongcli config chain-id bitsong-localnetbitsongcli config output jsonbitsongcli config indent truebitsongcli config trust-node truebitsongcli config keyring-backend test​# Copy the `Address` output here and save it for later use# [optional] add "--ledger" at the end to use a Ledger Nano Sbitsongcli keys add jack​# Copy the `Address` output here and save it for later usebitsongcli keys add alice​# Add both accounts, with coins to the genesis filebitsongd add-genesis-account jack 100000000000ubtsg --keyring-backend testbitsongd add-genesis-account alice 100000000000ubtsg --keyring-backend test​# Generate the transaction that creates your validatorbitsongd gentx --name jack --amount=10000000ubtsg --keyring-backend test​# Add the generated bonding transaction to the genesis filebitsongd collect-gentxsbitsongd 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.
Open another terminal to run commands against the network you have just created:
# First check the accounts to ensure they have fundsbitsongcli query account $(bitsongcli keys show jack -a)bitsongcli query account $(bitsongcli keys show alice -a)
You can now start the first transaction
bitsongcli tx send jack $(bitsongcli keys show alice -a) 10ubtsg --from jack -b block
bitsongcli query account $(bitsongcli keys show jack -a)
bitsongcli query supply total
bitsongcli tx track create 7b7c8b44-5c57-4060-a189-4432862114e0 \./test-data/mp21/download-big-label.json \--entity=100:$(bitsongcli keys show jack -a) \--entity=400:$(bitsongcli keys show alice -a) \--from jack \--gas 500000 \-b block
Save trackID 7b7c8b44-5c57-4060-a189-4432862114e0
...{"type": "track_create","attributes": [{"key": "track_id","value": "7b7c8b44-5c57-4060-a189-4432862114e0"}]},...
Save share denom btrack7b7c8b445c
...{"key": "amount","value": "100btrack7b7c8b445c"}...
bitsongcli query account $(bitsongcli keys show jack -a)bitsongcli query account $(bitsongcli keys show alice -a)
bitsongcli query track id 7b7c8b44-5c57-4060-a189-4432862114e0​..."total_shares": {"denom": "btrack7b7c8b445c","amount": "0"}...
bitsongcli tx track add-share \7b7c8b44-5c57-4060-a189-4432862114e0 \10btrack7b7c8b445c \--from jack --gas 350000 -b block​bitsongcli tx track add-share \7b7c8b44-5c57-4060-a189-4432862114e0 \5btrack7b7c8b445c \--from alice --gas 350000 -b block​bitsongcli query track id 7b7c8b44-5c57-4060-a189-4432862114e0​..."total_shares": {"denom": "btrack7b7c8b445c","amount": "15"}...
bitsongcli tx track remove-share \7b7c8b44-5c57-4060-a189-4432862114e0 \1btrack7b7c8b445c \--from jack --gas 350000 -b block​bitsongcli query track id 7b7c8b44-5c57-4060-a189-4432862114e0​..."total_shares": {"denom": "btrack7b7c8b445c","amount": "14"}...
TODO
TODO
TODO
# Query all tracksbitsongcli query track all​# Query track by idbitsongcli query track id f888cbdf-3f63-449d-b4dc-93728195093b​# Query all tracks by creatorbitsongcli query track creator $(bitsongcli keys show jack -a)
# Start LCDbitsongcli rest-server
​/tracks​
/tracks​GET http://localhost:1317/tracks
{"height": "716","result": [{"creator": "bitsong10gpzmvlrwkj0wjgpa0duy7xn0yyxynrtn0pf6w","hash": "436d7db6da8250b364663dad59086ef7025e17a33a92f8bb74fb453358e41e3e","track_id": "f888cbdf-3f63-449d-b4dc-93728195093b","track_info": "...","uri": "bitsong:track:f888cbdf-3f63-449d-b4dc-93728195093b"},// ...]}
​/tracks/:track_id​
/tracks/:track_id​GET http://localhost:1317/tracks/f888cbdf-3f63-449d-b4dc-93728195093b
{"height": "716","result": {"creator": "bitsong10gpzmvlrwkj0wjgpa0duy7xn0yyxynrtn0pf6w","hash": "436d7db6da8250b364663dad59086ef7025e17a33a92f8bb74fb453358e41e3e","track_id": "f888cbdf-3f63-449d-b4dc-93728195093b","track_info": "...","uri": "bitsong:track:f888cbdf-3f63-449d-b4dc-93728195093b"}}
​/tracks/:creator​
/tracks/:creator​GET http://localhost:1317/tracks/bitsong10gpzmvlrwkj0wjgpa0duy7xn0yyxynrtn0pf6w
{"height": "716","result": {"creator": "bitsong10gpzmvlrwkj0wjgpa0duy7xn0yyxynrtn0pf6w","hash": "436d7db6da8250b364663dad59086ef7025e17a33a92f8bb74fb453358e41e3e","track_id": "f888cbdf-3f63-449d-b4dc-93728195093b","track_info": "...","uri": "bitsong:track:f888cbdf-3f63-449d-b4dc-93728195093b"}}
​Official Website​
​Uniswap BTSG/ETH​
​Discord​
​Twitter​
​Medium​
​Reddit​
​Facebook​
​BitcoinTalk ANN​
​Linkedin​
​Instagram​
MIT License
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.
