Usage

Setting up Metamask wallet for BPX network (Google Chrome extension)

  1. Find Metamask in Chrome Web Store. Click "Add to Chrome" to begin installation.

VirtualBox_Win10_07_06_2023_14_37_41.png

2. Confirm installation in pop-up window and wait for the installation to complete.

3. On the welcome screen, accept the terms of use and select "Create a new wallet".

VirtualBox_Win10_07_06_2023_14_45_08.png

4. On the next screen, choose whether you consent to some usage statistics be collected by the wallet developers or not. For example, we choose "No thanks".

VirtualBox_Win10_07_06_2023_14_49_13.png

5. Set a password that will be used to unlock the wallet and accept transactions. Tick the password recovery warning checkbox and click "Create a new wallet".

VirtualBox_Win10_07_06_2023_14_50_24.png

6. On the next screen, click "Secure my wallet (recommended)".

VirtualBox_Win10_07_06_2023_14_52_25.png

7. Use the "Reveal Secret Recovery Phrase" button to see the generated secret words. Write down this 12 words and save it a place that you trust and only you can access. You will need them every time you want to log in to your wallet again on a new device or after reinstalling.

VirtualBox_Win10_07_06_2023_14_53_46.png

8. In the next step, the wallet will check if you have saved the secret words. You have to fill in the missing ones.

VirtualBox_Win10_07_06_2023_15_00_15.png

9. Go through the next informational steps and close the "What's new" window. You should see the main wallet screen. Now we will add the BPX network to the wallet. Expand "Ethereum Mainnet" and select "Add network".

VirtualBox_Win10_07_06_2023_15_03_20.png

10. Scroll to the bottom of the list and select "Add a network manually".

VirtualBox_Win10_07_06_2023_15_05_10.png

11. Complete the form as follows and click "Save":

Network name: BPX V3
New RPC URL: https://rpc.bpxchain.cc
Chain ID: 279
Currency symbol: BPX
Block explorer URL: https://explorer.bpxchain.cc

VirtualBox_Win10_07_06_2023_15_06_47.png

12. In the popup window select "Switch to BPX V3". Your wallet is now ready to use.

VirtualBox_Win10_07_06_2023_15_08_31.png

13. For convenience, you can pin the Metamask icon to be always visible

VirtualBox_Win10_07_06_2023_15_11_14.png

14. To copy your full wallet receiving address, click on the "Account 1" header.

VirtualBox_Win10_07_06_2023_15_13_21.png

Setting up Metamask wallet for BPX network (Mobile app)

  1. Install Metamask from App Store / Google Play.
  2. Open the app. Tap Get started on the welcome screen.

099AC79C-88D7-4AAD-B148-0B04AFD16F32.png

3. Select "Create a new wallet".

49BB4FBE-679A-48EB-9AA7-079B393A0718.png

4. On the next screen, choose whether you consent to some usage statistics be collected by the wallet developers or not. For example, we choose "No thanks".

C205A67E-C89B-4449-8C91-753733B62C3A.png

5. Scroll down the terms of use, tick a checkbox and tap Accept.

75DD8433-9F79-4E11-9D7B-0A872D9B3664.png

6. Set a password that will be used to unlock the wallet and accept transactions. Optionally enable unlocking with Face ID. Tick the password recovery warning checkbox and tap "Create password".

49D8C6B8-BDED-4B40-B541-969BF54E23E6.png

7. On the next two screens, select "Start" to backup your wallet keys.

3607ADB6-29AF-4D44-BB41-50D355DE5D4F.png32586A9A-F0C8-4B56-B5B0-DAB6E7032260.png

8. Use the "View" button to see the generated secret words. Write down this 12 words and save it a place that you trust and only you can access. You will need them every time you want to log in to your wallet again on a new device or after reinstalling.

285F2924-1A51-41A7-B59F-0A013D68D552.png

9. In the next step, the wallet will check if you have saved the secret words. You have to click on all of them in the same order as they were previously shown.

F094C470-BECD-4D8D-A074-74CB37B67E7B.png

10. Go through the next informational steps by tapping "Done", "Enable aytomatic security checks" and "No, Thanks". You should see the main wallet screen.

0E518EBA-3410-4F53-8FBA-B0E15FF44524.png0DDFA3E8-1AB7-446B-98FF-FF6FF5227261.png865FF662-DC4B-4281-99DB-3D79A2A28C32.png

11. Now we will add the BPX network to the wallet. Expand "Ethereum Main Network" on the top of the screen and select "Add a network".

7F64E26E-AF98-4FFE-AB7E-8CC8FE2EFDF1.png

12. Switch to the "Custom networks" tab.

06F201F7-7598-4E1B-8403-8430B9E0C2B8.png

13. Complete the form as follows and click "Add":

Network Name: BPX V3
RPC Url: https://rpc.bpxchain.cc
Chain ID: 279
Symbol: BPX
Block explorer URL: https://explorer.bpxchain.cc

05FB4B82-9525-488D-AFBF-C2DFFCAB336B.png

14. In the popup window tap "Got it". Your wallet is now ready to use.

4A337917-E9E8-4E44-A162-D3A60E69A796.png

15. To copy your full wallet receiving address, tap "Receive".

A7CFDD0C-88B8-4F08-B63F-3D27BA4D6730.png

Installing and running BPX full node on Windows

  1. Download the Execution Client and Beacon Client latest releases EXE installers.

VirtualBox_Win10_07_06_2023_15_18_56.png

VirtualBox_Win10_07_06_2023_15_18_19.png

2. Go to your Downloads folder. There should be two installers there. Run the execution client installer first.

VirtualBox_Win10_07_06_2023_15_21_06.png

3. Different warnings may appear depending on the Windows version. In such cases, select "More info", "Run anyway" and "Yes".

VirtualBox_Win10_07_06_2023_15_22_29.png

VirtualBox_Win10_07_06_2023_15_22_58.png

VirtualBox_Win10_07_06_2023_15_24_22.png

4. Accept the license. Go through all installer steps by clicking "Next" and "Install". When the installation process is finished, close the installer.

VirtualBox_Win10_07_06_2023_15_27_05.png

VirtualBox_Win10_07_06_2023_15_28_06.png

5. A shortcut to BPX Execution Client will appear in the Start Menu. Launch it.

VirtualBox_Win10_07_06_2023_15_30_15.png

6. Allow the Windows firewall to open the execution client port. Execution client will be started. You should see its console output window.

VirtualBox_Win10_07_06_2023_15_35_47.png

VirtualBox_Win10_07_06_2023_15_35_59.png

7. Now start the Beacon Client installer. Confirm pop-up warnings as before.

VirtualBox_Win10_07_06_2023_15_39_55.png

8. Accept the license, go through the next installation steps.

VirtualBox_Win10_07_06_2023_15_41_00.png

9. When the installation is finished, click the "Get Started" button.

VirtualBox_Win10_07_06_2023_15_41_44.png

10. Agree to open the beacon client port as before.

VirtualBox_Win10_07_06_2023_15_42_57.png

11. Beacon Client GUI will be launched. Select Node mode.

VirtualBox_Win10_07_06_2023_15_56_13.png

12. At this point, both clients will start synchronizing with the network. This may take many hours or days.

VirtualBox_Win10_07_06_2023_15_57_39.png

VirtualBox_Win10_07_06_2023_15_58_58.png

13. When synchronization is finished, your full node is ready to work. You'll know it by the green "Synced" status.

VirtualBox_Win10_08_06_2023_01_46_36.png

14. When you need to stop your full node, it's highly recommended to close the beacon client first, then the execution client. To start it again, run the execution client first, then the beacon client.

Never stop the Execution Client by closing the console window. Use the Control + C shortcut and wait for the client to close itself.
VirtualBox_Win10_08_06_2023_10_34_18.png

Installing and running BPX full node on Debian / Ubuntu

  1. Check latest versions of BPX Execution Client and Beacon Client. Log in as root. Download both DEB packages by following commands. Replace X.X.X to latest versions tags.
wget https://github.com/bpx-chain/bpx-execution-client/releases/download/X.X.X/bpx-execution-client_X.X.X-stable+stable_amd64.deb
wget https://github.com/bpx-chain/bpx-beacon-client/releases/download/X.X.X/bpx-beacon-client-cli_X.X.X-1_amd64.deb

2. Install execution client and beacon client. Replace X.X.X to latest versions tags.

dpkg -i bpx-execution-client_X.X.X-stable+stable_amd64.deb bpx-beacon-client-cli_X.X.X-1_amd64.deb

VirtualBox_Debian_09_06_2023_11_16_04.png

3. Create new user for BPX services

adduser bpxv3

Create any password. You can skip entering additional information about the user by pressing Enter each time. Answer "Y" when asked if the information is correct.

VirtualBox_Debian_09_06_2023_11_20_24.png

4. Switch to the newly created account

su - bpxv3

5. Initialize Beacon Client configuration

bpx init

VirtualBox_Debian_09_06_2023_11_24_02.png

6. Press Control + D to log out and return to the root console.

7. Create the execution client service descriptor file using for example nano editor

nano /etc/systemd/system/bpx-execution.service

Insert the following file content:

[Unit]
Description=BPX Execution Client

[Service]
Type=simple
User=bpxv3
ExecStart=bpx-geth --syncmode snap --http
Restart=always

[Install]
WantedBy=multi-user.target

Save the file by pressing Control + O and close the editor with Control + X.

8. Create the beacon client service descriptor file:

nano /etc/systemd/system/bpx-beacon.service

Insert the following file content:

[Unit]
Description=BPX Beacon Client

[Service]
Type=forking
User=bpxv3
ExecStart=bpx start node
ExecStop=bpx stop -d all
Restart=always

[Install]
WantedBy=multi-user.target

Save the file and close the editor.

9. Refresh startup services configuration

systemctl daemon-reload

10. Activate automatic startup of BPX services

systemctl enable bpx-execution
systemctl enable bpx-beacon

11. Launch both services

systemctl start bpx-execution
systemctl start bpx-beacon

VirtualBox_Debian_09_06_2023_11_42_06.png

12. Your full node is already working and configured to automatically start on system boot. Use the commands below to watch the initial sync status (it will refresh every 10 seconds).

su - bpxv3
watch -n 10 bpx show -s

VirtualBox_Debian_09_06_2023_11_51_29.png

13. After a few hours or days, the initial sync should complete.

VirtualBox_Debian_09_06_2023_23_22_40.png