Developers

Documentation

Everything you need to run a node, mine BSC, and build on Basecoin.

Installation

Windows

Download the latest .zip from the Downloads page, extract it, and run basecoin-qt.exe.

Linux

Download the .tar.gz, extract it, and run ./basecoin-qt.

Build from Source

git clone https://github.com/basecoins/basecoin.git
cd basecoin && mkdir build && cd build
cmake .. -DBUILD_GUI=ON
cmake --build . -j4
./bin/basecoin-qt

Create a Wallet

On first launch, Basecoin Core will prompt you to create a wallet. Give it a name and click Create. Your wallet will be stored in the Basecoin data directory.

Always back up your wallet file. The default location on Windows is %APPDATA%\Basecoin\wallets\

Start Mining

With your wallet open and the node synced, start CPU mining from the command line:

# Start continuous mining (replace with your wallet name)
./basecoin-cli -rpcwallet="YourWallet" generatecontinuous

# Mine a specific number of blocks
./basecoin-cli -rpcwallet="YourWallet" generatecontinuous 100

Satoshi Mode is enabled by default — each mined block sends the reward to a fresh address automatically.

Join the Network

Basecoin Core connects to the network automatically via the DNS seed at seed.mainnet.basecoin.jo3.org. To add a specific node manually:

./basecoin-cli addnode "78.138.17.61:6555" "add"
./basecoin-cli getpeerinfo

Configuration File

The configuration file is located at %APPDATA%\Basecoin\basecoin.conf (Windows) or ~/.basecoin/basecoin.conf (Linux).

# basecoin.conf example
server=1
rpcport=6554
rpcuser=yourusername
rpcpassword=yourpassword
addnode=78.138.17.61:6555

RPC API

The RPC server is enabled by default on port 6554. Use basecoin-cli or direct HTTP calls:

curl --user user:pass \
  --data-binary '{"method":"getblockchaininfo","params":[]}' \
  http://127.0.0.1:6554/

CLI Commands Reference

CommandDescription
getblockchaininfoGet blockchain state
getnetworkinfoGet network info
getpeerinfoList connected peers
getbalanceGet wallet balance
getnewaddressGenerate new address
sendtoaddressSend BSC to address
generatecontinuousStart CPU mining
getwalletinfoGet wallet details

Network Ports

PortProtocolUse
6555TCPP2P network (mainnet)
6554TCPRPC server (local)
6556TCPZMQ notifications
⚠ Never expose port 6554 to the public internet without authentication.

FAQ

What is the difference between Basecoin and Bitcoin?

Basecoin uses SHA-512 instead of SHA-256, supports CPU mining without ASICs, and includes Satoshi Mode for automatic address privacy. The monetary model (21M supply, halving) is identical.

What is Satoshi Mode?

Satoshi Mode automatically generates a new receiving address for every block mined, preventing linkage of multiple rewards to a single identity.

Is there a pre-mine or developer fund?

No. Every BSC in existence must be earned through computational proof-of-work. There is no pre-mine, no developer allocation, and no ICO.