Before proceeding to the next steps, please ensure that the following packages and softwares are well installed in your local machine:
If you would setup nodes on k8s environment, the following packages and softwares are necessary:
Clone this repository
git clone https://github.com/bnb-chain/node-deploy.git
For the first time, please execute the following command
pip3 install -r requirements.txt
Make geth
, bootnode
binary files, and put them into bin/
folder.
git clone https://github.com/bnb-chain/bsc.git
cd bsc && make geth
go build -o ./build/bin/bootnode ./cmd/bootnode
cp ./build/bin/geth ../bin/geth cp ./build/bin/bootnode ../bin/bootnode
4. Configure the cluster
You can configure the cluster by modifying the following files:
config.toml
genesis/genesis-template.json
.env
#native deploy without docker
bash -x ./start_cluster.sh reset # will reset the cluster and start
bash -x ./start_cluster.sh stop # only stop the cluster
bash -x ./start_cluster.sh start # only start the cluster
bash -x ./start_cluster.sh restart # start the cluster after stopping it
#on k8s environment
minikube start
bash -x ./start_cluster.sh install_k8s
kubectl -n bsc port-forward svc/bsc-node-0 8545:8545
Attention: it relies on the validator cluster, so you should set up validators by
start_cluster.sh
first.
# start a full sync node0
bash +x ./start_fullnode.sh start 0 full
# start a snap sync node1
bash +x ./start_fullnode.sh start 1 snap
# restart the snap sync node1
bash +x ./start_fullnode.sh restart 1 snap
# stop the snap sync node1
bash +x ./start_fullnode.sh stop 1 snap
# clean the snap sync node1
bash +x ./start_fullnode.sh clean 1 snap
# start a snap sync node as fast node
bash +x ./start_fullnode.sh start 2 snap "--tries-verify-mode none"
# start a snap sync node with prune ancient
bash +x ./start_fullnode.sh start 3 snap "--pruneancient"
# start pruneblock for a node
bash +x ./start_fullnode.sh pruneblock 3 snap
You can see the logs in .local/bsc/fullnode
.
Generally, you need to wait for the validator to produce a certain amount of blocks before starting the full/snap syncing test, such as 1000 blocks.
## normal tx
cd txbot
go build
./air-drops
## blob tx
cd txblob
go build
./txblob
After bc-fusion, the governance feature is transferred to bsc from bc, so register the validators into StakeHub if trying to test the governance.
cd create-validator
go build
switch the flag
needRegister=true