Swarm 2.0 BXX testnet node operation tutorial
Starting Swarm 2.0 is very simple, a total of 4 steps are required:
- Download and modify configuration
- Start the node
- Get ETH & kBXX
Let’s get started!
1. Register third-party RPC EndPoint
After registering and logging in, copy the link of RPC EndPoint of its kovan (Ethereum Kovan Testnet) network, For example, the link address provided by infura https://kovan.infura.io/v3/b4f69e167caa4beba01902c01f358bdf.
Note: This link is used to modify the BEE_SWAP_ENDPOINT field of the subsequent configuration file .env file; If you need to build your own RPC EndPoint, please refer to here.
2. Download and install docker, docker-compose
The following takes the operating system as ubuntu and the machine’s CPU architecture as the amd64 architecture as an example for operation:
a) Run the following command to install docker
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
b) Run the following command to install docker-compose
sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
If you are not the above operating system or CPU architecture, please refer to here to install: https://docs.docker.com/engine/install/
Step2: Download and modify configuration
a) Download configuration
curl 'https://raw.githubusercontent.com/swarm-bxx/bee-docs/main/docker-compose/docker-compose.yml' -o docker-compose.yml
curl 'https://raw.githubusercontent.com/swarm-bxx/bee-docs/main/docker-compose/.env' -o .env
b) Change setting
Using a text editor, open the .env file downloaded above. Modify the value of BEE_PASSWORD to your customized password; Modify the value of BEE_SWAP_ENDPOINT to the link you got from “Registering a third-party RPC EndPoint” in this document. Modify the BEE_P2P_ADDR field to your “public network ip:1634” and make sure its port (note that the docker-compose.yml in this tutorial will modify the port to 2634) is open.
Step3: Start node
Run the following command to start the node
sudo docker-compose up -d
If you need to view specific logs, please refer to the
docker logs command description.
Step4: Get ETH & kBXX
View the wallet address and deposit address of the current node
docker ps -f "ancestor=swarmbxx/bee" -q |xargs docker logs
For example, the address in the log below (0x5476afb588c6ff9a186eb29a73f742a8a9c5419e, pay attention to adding 0x prefix) is the wallet address of the node:
time="2021-07-23T08:54:40Z" level=info msg="using ethereum address 5476afb588c6ff9a186eb29a73f742a8a9c5419e"
/faucet <your ethereum address>
At this point, until the log no longer prompts the following information.
time="2021-07-23T08:54:41Z" level=warning msg="cannot continue until there is sufficient ETH (for Gas) and at least 50 BZZ available on 5476afb588c6ff9a186eb29a73f742a8a9c5419e"
At this point, our Swarm 2.0 BXX test network node is running smoothly :)
If you have any questions, you can discuss and ask for help in the Official Discord testnet channel.
Find us here: