Run a Bridge Node
The codebase is currently not public. We will be sharing more details about the node's role and functionality soon. We appreciate your patience and interest. Thank you for your understanding and continued support.
Note: Thanks to your contributions, cycle I of our TestNet Phase 3 journey has officially wrapped up! Now we're one step closer to onboarding the world to Bitcoin. Stay tuned for the next steps!
By following these steps, you should be able to successfully set up and start a Nubit Bridge Node. If you encounter any issues, please provide detailed information, and further assistance will be provided.
Set up the Bridge Node
Ensure Validator is Running
Please Run a Validator first before running your own bridge node. Make sure your nubit-validator
is running in its own terminal.
Open a new terminal to set up the Nubit Bridge Node. All consensus data from validators is sent to the bridge node. The bridge node retrieves data from core validator nodes and then sends the data to full/light nodes.
Due to the current heavy load, we are temporarily unable to provide long-term connection services. Therefore, we recommend users run their own validator nodes and use the RPC interface provided by their validator to retrieve block data. This will ensure the stability and timeliness of data transmission.
Install the Node
Download the Necessary Repositories
Clone the nubit-node
repository.
Note: The git clone
command above already specifies the nubit-alphatestnet-1
branch of the nubit-node
repository, which includes the latest version of the code.
When using git clone
, you may need to temporarily comment out the UseKeychain
fields in your ~/.ssh/config
file. Specifically, comment out # IgnoreUnknown UseKeychain
and # UseKeychain yes
.
Make Build and Install
In the cloned repository directory, run the following command to make build and install the CLI:
Set up the Environment
Set Network and Custom Variables
Remove any existing bridge node data and set up the necessary network and environment variables.
Note: Replace <your-server-IP>
with the IP address of the machine running the validator. The validator will provide the RPC interface for the bridge node to retrieve block data. The default <your-rpc-port>
for the validator is 26657; please replace it with your actual validator RPC port.
If you do not have your own validator, you can use the official validator IP: validator-1.nubit-alphatestnet-1.com
.
Clear Previous Data
Use the following command to clear up any previous data:
Initialize the Bridge Node
Run the following command to initialize the bridge node. This command will automatically generate a Nubit node address and mnemonic phrase. Make sure to save the mnemonic phrase securely.
Synchronize with the Latest Block
To quickly sync to the latest block, a snapshot is provided and updated every 12 hours. Follow these steps:
Remove Old Data Directory
Download the Snapshot
Download the snapshot using wget
. Ensure you have enough disk space (approximately 11GB):
Extract the Snapshot
Extract the downloaded snapshot to update your node's data:
This will update your node to a recent state. Keep it running to ensure it syncs to the latest block. For the most current block information, please visit the chain explorer at explorer.nubit.org.
Start the Bridge Node
Run the following command to start the bridge node. Pay special attention to the output and ensure the node starts correctly.
Successful response will show like thie
Pay special attention to the P2P PEERS, which is the IP address of your host machine. If other machines are on the same local network as your host machine, they can use this P2P PEER address to connect to your bridge node and start their own full/light nodes.
By following these steps, you should be able to successfully set up and start a Nubit Bridge Node. If you encounter any issues, please provide detailed information, and further assistance will be provided.
Last updated