# Usage



# Setting up Metamask wallet for BPX Chain (Chrome extension)

1\. Open **MetaMask**. Expand the list of available networks.

[![metamask-chrome1.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/WKQWMd401fJGOLZa-metamask-chrome1.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/WKQWMd401fJGOLZa-metamask-chrome1.jpg)

2\. Scroll to the bottom and select "**Add a custom network**".

[![metamask-chrome2.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/htlnApEne3ZnDfwL-metamask-chrome2.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/htlnApEne3ZnDfwL-metamask-chrome2.jpg)

3\. Fill out the form as follows and click "**Save**":

<p class="callout info">**Network name:** BPX Chain  
**Default RPC URL:** https://rpc.bpxchain.cc  
**Chain ID:** 279  
**Currency symbol:** BPX  
**Block explorer URL:** https://explorer.bpxchain.cc</p>

[![metamask-chrome3.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/P8gyyjhTXWdWYgYP-metamask-chrome3.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/P8gyyjhTXWdWYgYP-metamask-chrome3.jpg)

4\. You should see a success notification. Expand the list of available networks again.

[![metamask-chrome4.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/7SPJPUEZkch2btLH-metamask-chrome4.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/7SPJPUEZkch2btLH-metamask-chrome4.jpg)

5\. Select "**BPX Chain**", which should now be on the list.

[![metamask-chrome5.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/5JJJeOcEXSjXjv9K-metamask-chrome5.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/5JJJeOcEXSjXjv9K-metamask-chrome5.jpg)

6\. Your wallet is now ready to use.

[![metamask-chrome6.jpg](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/HcYDTdkBXa7Zklch-metamask-chrome6.jpg)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/HcYDTdkBXa7Zklch-metamask-chrome6.jpg)

# Setting up Metamask wallet for BPX Chain (Mobile app)

1\. Open **MetaMask**. Expand the list of available networks.

[![metamask-mobile1.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/ejwhE9hEqRIAa2PB-metamask-mobile1.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/ejwhE9hEqRIAa2PB-metamask-mobile1.PNG)

2\. Select "**Add Network**".

[![metamask-mobile2.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/of3ZP46xQOyHIC1A-metamask-mobile2.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/of3ZP46xQOyHIC1A-metamask-mobile2.PNG)

3\. Go to the "**Custom networks**" tab.

<div class="flex-1 overflow-hidden" id="bkmrk--2"><div class="h-full"><div class="react-scroll-to-bottom--css-bpdgj-79elbk h-full"><div class="react-scroll-to-bottom--css-bpdgj-1n7m0yu"><div class="flex flex-col text-sm"><article class="w-full text-token-text-primary focus-visible:outline-2 focus-visible:outline-offset-[-4px]" data-scroll-anchor="true" data-testid="conversation-turn-21" dir="auto"><div class="m-auto text-base py-[18px] px-3 md:px-4 w-full md:px-5 lg:px-4 xl:px-5"><div class="mx-auto flex flex-1 gap-4 text-base md:gap-5 lg:gap-6 md:max-w-3xl lg:max-w-[40rem] xl:max-w-[48rem]"><div class="group/conversation-turn relative flex w-full min-w-0 flex-col agent-turn"><div class="flex-col gap-1 md:gap-3"><div class="flex max-w-full flex-col flex-grow"><div class="min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words [.text-message+&]:mt-5" data-message-author-role="assistant" data-message-id="b292484f-d438-46a0-a203-dea886152b70" data-message-model-slug="gpt-4o" dir="auto"><div class="flex w-full flex-col gap-1 empty:hidden first:pt-[3px]"></div></div></div></div></div></div></div></article></div></div></div></div></div>[![metamask-mobile3.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/RXB1JmyFTRaWnRtt-metamask-mobile3.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/RXB1JmyFTRaWnRtt-metamask-mobile3.PNG)

4\. Fill out the form as follows and confirm:

<p class="callout info">**Network name:** BPX Chain  
**Default RPC URL:** https://rpc.bpxchain.cc  
**Chain ID:** 279  
**Currency symbol:** BPX  
**Block explorer URL:** https://explorer.bpxchain.cc</p>

[![metamask-mobile4.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/TwwSjQo1AA8gN70a-metamask-mobile4.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/TwwSjQo1AA8gN70a-metamask-mobile4.PNG)

5\. Proceed through the next steps by tapping "**Confirm**", "**Switch to network**", and "**Got it**".

[![metamask-mobile5.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/v6m41dIdTYh8Wd68-metamask-mobile5.PNG) ](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/v6m41dIdTYh8Wd68-metamask-mobile5.PNG)[![metamask-mobile6.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/FzoiqPrQeYFEvuHk-metamask-mobile6.PNG) ](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/FzoiqPrQeYFEvuHk-metamask-mobile6.PNG)[![metamask-mobile7.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/zTp33wAFcgYrSLDK-metamask-mobile7.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/zTp33wAFcgYrSLDK-metamask-mobile7.PNG)

6\. Your wallet is now ready to use.

[![metamask-mobile8.PNG](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/AhCXbhwtI9K1BGBT-metamask-mobile8.PNG)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/AhCXbhwtI9K1BGBT-metamask-mobile8.PNG)

# Installing and running BPX full node on Windows

1\. Download the EXE installers for the latest releases of the **[Execution Client](https://github.com/bpx-chain/bpx-execution-client/releases)** and **[Beacon Client](https://github.com/bpx-chain/bpx-beacon-client/releases)**.

2\. Run the **Execution Client** installer first. Depending on your Windows version, different warnings may appear. In these cases, click "**More info**", then select "**Run anyway**", and "**Yes**".

[![VirtualBox_Win10_07_06_2023_15_22_29.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/cN3FCMRV0dXWVPsB-virtualbox-win10-07-06-2023-15-22-29.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/cN3FCMRV0dXWVPsB-virtualbox-win10-07-06-2023-15-22-29.png)

[![VirtualBox_Win10_07_06_2023_15_22_58.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/qr3rt2trR5P6HWWF-virtualbox-win10-07-06-2023-15-22-58.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/qr3rt2trR5P6HWWF-virtualbox-win10-07-06-2023-15-22-58.png)

[![VirtualBox_Win10_07_06_2023_15_24_22.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/iuS3vkSWjBvKYD86-virtualbox-win10-07-06-2023-15-24-22.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/iuS3vkSWjBvKYD86-virtualbox-win10-07-06-2023-15-24-22.png)

3\. Follow all the installer steps by clicking "**I Agree**", "**Next**" and "**Install**". Once the installation process is complete, close the installer.

[![VirtualBox_Win10_07_06_2023_15_27_05.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/xuphBC6JFF7Al8Lb-virtualbox-win10-07-06-2023-15-27-05.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/xuphBC6JFF7Al8Lb-virtualbox-win10-07-06-2023-15-27-05.png)

[![VirtualBox_Win10_07_06_2023_15_28_06.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/ENqEJfOTTI8xQ7cN-virtualbox-win10-07-06-2023-15-28-06.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/ENqEJfOTTI8xQ7cN-virtualbox-win10-07-06-2023-15-28-06.png)

4\. A shortcut to the **BPX Execution Client** will be created in the Start Menu. Launch it from there.

[![VirtualBox_Win10_07_06_2023_15_30_15.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/pLXELv47WTfEBO7s-virtualbox-win10-07-06-2023-15-30-15.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/pLXELv47WTfEBO7s-virtualbox-win10-07-06-2023-15-30-15.png)

5\. Allow the Windows Firewall to open the execution client port. The execution client will start, and you should see its console window.

[![VirtualBox_Win10_07_06_2023_15_35_47.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/ZVmu1FPViOP4IdOm-virtualbox-win10-07-06-2023-15-35-47.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/ZVmu1FPViOP4IdOm-virtualbox-win10-07-06-2023-15-35-47.png)

[![VirtualBox_Win10_07_06_2023_15_35_59.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/SQw66lQAin12lgQ0-virtualbox-win10-07-06-2023-15-35-59.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/SQw66lQAin12lgQ0-virtualbox-win10-07-06-2023-15-35-59.png)

6\. Now run the **Beacon Client** installer. Navigate through the Microsoft Defender pop-ups as before.

7\. Accept the license agreement and proceed through the subsequent installation steps.

[![VirtualBox_Win10_07_06_2023_15_39_55.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/1LJztC6ZHwoBADjl-virtualbox-win10-07-06-2023-15-39-55.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/1LJztC6ZHwoBADjl-virtualbox-win10-07-06-2023-15-39-55.png)

[![VirtualBox_Win10_07_06_2023_15_41_00.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/DFloLvXOfAUQY3Wa-virtualbox-win10-07-06-2023-15-41-00.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/DFloLvXOfAUQY3Wa-virtualbox-win10-07-06-2023-15-41-00.png)

8\. Once the installation is complete, click the "**Get Started**" button.

[![VirtualBox_Win10_07_06_2023_15_41_44.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/ZTODY9NcBSxIdlh8-virtualbox-win10-07-06-2023-15-41-44.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/ZTODY9NcBSxIdlh8-virtualbox-win10-07-06-2023-15-41-44.png)

9\. Allow to open the required port as before.

[![VirtualBox_Win10_07_06_2023_15_42_57.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/SNMKudoFWLv2hnvo-virtualbox-win10-07-06-2023-15-42-57.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/SNMKudoFWLv2hnvo-virtualbox-win10-07-06-2023-15-42-57.png)

10\. Beacon Client GUI will be launched. Select the **Node** mode.

[![VirtualBox_Win10_07_06_2023_15_56_13.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/dwjACt1J8NX0bt5Q-virtualbox-win10-07-06-2023-15-56-13.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/dwjACt1J8NX0bt5Q-virtualbox-win10-07-06-2023-15-56-13.png)

11\. At this point, both clients will begin synchronizing with the network. This process may take several hours or even days.

[![VirtualBox_Win10_07_06_2023_15_57_39.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/eEVgdBV1HbLI7WLQ-virtualbox-win10-07-06-2023-15-57-39.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/eEVgdBV1HbLI7WLQ-virtualbox-win10-07-06-2023-15-57-39.png)

[![VirtualBox_Win10_07_06_2023_15_58_58.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/UjXUtsLrGpJxNjxD-virtualbox-win10-07-06-2023-15-58-58.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/UjXUtsLrGpJxNjxD-virtualbox-win10-07-06-2023-15-58-58.png)

12\. Once synchronization is complete, your full node will be ready to operate.

[![VirtualBox_Win10_08_06_2023_01_46_36.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/dqJne2CC2hozzwbB-virtualbox-win10-08-06-2023-01-46-36.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/dqJne2CC2hozzwbB-virtualbox-win10-08-06-2023-01-46-36.png)

<p class="callout danger">Never stop the **Execution Client** by closing the console window. Instead, use the **Control + C** shortcut and wait for the client to save all data to disk and shut down gracefully.  
[![VirtualBox_Win10_08_06_2023_10_34_18.png](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/scaled-1680-/wq6Ezk8ksgqEiqJN-virtualbox-win10-08-06-2023-10-34-18.png)](https://docs.bpxchain.cc/uploads/images/gallery/2023-06/wq6Ezk8ksgqEiqJN-virtualbox-win10-08-06-2023-10-34-18.png)  
</p>

# Installing and running BPX full node on Debian / Ubuntu

1. Log in as root. Use **wget** to download the DEB packages for the latest releases of the **[Execution Client](https://github.com/bpx-chain/bpx-execution-client/releases)** and **[Beacon Client](https://github.com/bpx-chain/bpx-beacon-client/releases)**. Replace **X.X.X** with the latest versions tags.

```bash
wget "https://github.com/bpx-chain/bpx-execution-client/releases/download/X.X.X/bpx-execution-client_X.X.X+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"
```

[![node-debian1.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/EY3NV23TsTGeZY2q-node-debian1.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/EY3NV23TsTGeZY2q-node-debian1.png)

2\. Install both packages. Replace **X.X.X** with the downloaded versions tags.

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

[![node-debian2.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/oqqS5qC8rwBHvbxv-node-debian2.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/oqqS5qC8rwBHvbxv-node-debian2.png)

3\. Create a new user account for BPX Chain services.

```bash
adduser bpxchain
```

Set a password for the new account. You can leave the additional information fields empty.

[![node-debian3.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/9kK8etHBytK6aq1t-node-debian3.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/9kK8etHBytK6aq1t-node-debian3.png)

4\. Switch to the newly created account.

```bash
su - bpxchain
```

5\. Initialize the Beacon Client configuration.

```bash
bpx init
```

[![node-debian4.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/U6aLVTRKvaVlB1Zj-node-debian4.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/U6aLVTRKvaVlB1Zj-node-debian4.png)

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

7\. Create a configuration file for the BPX Execution Client **systemd** service using any text editor, for example **nano**:

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

Insert the following file content:

```
[Unit]
Description=BPX Execution Client

[Service]
Type=simple
User=bpxchain
ExecStart=bpx-geth --http
Restart=always

[Install]
WantedBy=multi-user.target
```

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

8\. Follow the same procedure to create a configuration file for the Beacon Client service:

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

Insert the following file content:

```
[Unit]
Description=BPX Beacon Client

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

[Install]
WantedBy=multi-user.target
```

9\. Reload the system services configuration.

```bash
systemctl daemon-reload
```

10\. Enable automatic startup of the BPX Chain services.

```bash
systemctl enable bpx-execution
systemctl enable bpx-beacon
```

11\. Start both services.

```bash
systemctl start bpx-execution
systemctl start bpx-beacon
```

[![node-debian5.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/auUAk0Tom7bUR6qS-node-debian5.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/auUAk0Tom7bUR6qS-node-debian5.png)

12\. Your full node has just started and will begin the initial synchronization of the blockchain. This process may take several hours or even days. Use the following command to watch the sync status.

```bash
su - bpxchain
watch -n 10 bpx show -s
```

[![node-debian6.png](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/scaled-1680-/4CV3cz4TTOK5JIXC-node-debian6.png)](https://docs.bpxchain.cc/uploads/images/gallery/2024-11/4CV3cz4TTOK5JIXC-node-debian6.png)

<div class="mb-2 flex gap-3 empty:hidden -ml-2" id="bkmrk--6"><div class="items-center justify-start rounded-xl p-1 flex"><div class="flex items-center"><button aria-label="Read aloud" class="rounded-lg text-token-text-secondary hover:bg-token-main-surface-secondary" data-testid="voice-play-turn-action-button"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"></svg></button><button aria-label="Copy" class="rounded-lg text-token-text-secondary hover:bg-token-main-surface-secondary" data-testid="copy-turn-action-button"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"></svg></button>  
</div></div></div>