Run a Bridge Node

Note: We are in the Alpha Testnet stage, so the API may undergo incompatible changes in the future. If you encounter any issues, please join our Discord to get in touch with the Nubit Team.

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.

Download the Node Repo

Navigate back to the nubit-da directory and clone the nubit-node repository.

Note: 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 .

git clone
cd nubit-node

Set Network and Custom Variables

Remove any existing bridge node data and set up the necessary network and environment variables.

Note: Please 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. And Validtor rpc port default is 26657, please replace with your actual validator rpc port.

rm -rf $HOME/.nubit-bridge*
export PATH=$HOME/go/bin:$PATH

Successful echo output example:


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.

nubit bridge init

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.

nubit bridge start --core.ip $VALIDATOR_IP --rpc.addr --rpc.skip-auth

Successful response will show like thie

/_____/  /_____/  /_____/  /_____/  /_____/ 

Started nubit DA node 
node version:   v0.1.0-rc.2
node type:      bridge
network:        nubit-alphatestnet-1

/_____/  /_____/  /_____/  /_____/  /_____/ 

The p2p host is listening on:
*  /ip4/
*  /ip4/
*  /ip4/
*  /ip4/
*  /ip6/::1/tcp/2121/p2p/12D3KooWDeZQatHpmUzNFSgEq1YnRpni4hLgtkk6jcCQ8ppcZocF
*  /ip6/::1/udp/2121/quic-v1/p2p/12D3KooWDeZQatHpmUzNFSgEq1YnRpni4hLgtkk6jcCQ8ppcZocF
*  /ip6/::1/udp/2121/quic-v1/webtransport/certhash/uEiBXY976psAnOWgdyxCgvqd1cUPQJD_49_P6bZDA2gy-sw/certhash/uEiDHhDKsm4aKlsWv6OO3EgMedYpilyc31lpKkoBB_7pdCw/p2p/12D3KooWDeZQatHpmUzNFSgEq1YnRpni4hLgtkk6jcCQ8ppcZocF

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