Run a Node

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!

---

This step allows you to quickly start a light node on the Nubit DA Alpha Testnet. We support Mac, Linux, and Windows systems. If you want to explore more options, such as running a validator, bridge node, and a full node on the Nubit DA Alpha Testnet, please refer to Run a Node (For Developers). If you encounter any issues, please feel free to contact the Nubit team.

Run a Light Node with One Command

Note: Our Alpha Testnet Campaign "Phase 2: Light Node Quest" has officially ended. You can still run and start the light node, but no further verification and points will be given.

Linux/Mac

To start your light node, simply run the following command:

curl -sL1 https://nubit.sh | bash

Whether you are launching the light node for the first time or are an existing user, this single command will automatically upgrade to the latest version of nubit-node and initiate the light node, regardless of the directory you are in. You will immediately benefit from a more resource-efficient way to participate in the Bitcoin network while maintaining a high level of security and decentralization.

Windows

While Nubit’s light node currently only supports Linux and Mac systems, we understand that some users may prefer or need to use Windows. Please note that using Windows might present unexpected failures, and we highly recommend using Mac or Linux for the best experience.

If you still wish to proceed with Windows, you can do so by installing the Windows Subsystem for Linux (WSL) and following the Linux instructions provided below.

Installing WSL on Windows

1. Open Windows PowerShell and run:

wsl --install --no-distribution

This process may take a while, and you will need to restart your computer when it's done.

1. Choose Available Linux distributions

wsl --list --online

Install Ubuntu (recommended for this guide) by running:

wsl --install ubuntu

You will be prompted to set a username and password for your new Ubuntu installation.

To start your light node, simply run the following command:

curl -sL1 https://nubit.sh | bash

Whether you are launching the light node for the first time or are an existing user, this single command will automatically upgrade to the latest version of nubit-node and initiate the light node, regardless of the directory you are in. You will immediately benefit from a more resource-efficient way to participate in the Bitcoin network while maintaining a high level of security and decentralization.

After running a light node, you will have access to a wider range of operations on the Nubit DA Alpha Testnet. For detailed instructions, please refer to Integrate with Nubit DA.

---

Process of Running nubit.sh (The First Time)

Here is the entire process of what the nubit.sh script does when first executed.

1. Start the Script:

   • The script begins with a message "Starting Nubit node..." to indicate that the process has started.

2. Determine the Architecture:

   • The script uses the uname command to determine the system's architecture and operating system and sets the ARCH_STRING variable based on the detected architecture:

     • darwin-arm64 for ARM-based macOS

     • darwin-x86_64 for Intel-based macOS

     • linux-arm64 for ARM-based Linux

     • linux-x86_64 for 64-bit Linux

     • linux-x86 for 32-bit Linux

   • If the ARCH_STRING is not set (indicating an unsupported architecture), the script prints an error message and exits.

3. Download and Extract Nubit Node Package:

   • The script checks if the nubit-node directory already exists:

     • If it does not exist, it constructs the URL for the appropriate Nubit node package based on the ARCH_STRING and prints the URL.

     • It then downloads the package using either curl or wget, whichever is available.

     • After downloading, it extracts the package using tar, renames the extracted directory to nubit-node, and deletes the tar file.

4. Make Necessary Installation:

   • Once the package is extracted, the following files and directories will be present in the nubit-node-linux-x86_64 directory:

     • bin/: Contains executable files for the node.

       • nubit: The main executable file for the Nubit node.

       • nkey: A utility for key management.

5. Update and Validate Nubit Node:

   • The script includes MD5 checksums for verifying the downloaded files.

   • If the checksums do not match, the script will download the latest version of the Nubit node to ensure optimal performance and access to new features.

   • The script constructs the URL for the appropriate Nubit node package based on the ARCH_STRING, downloads, and extracts it.

6. Download and Extract Light Node Data:

   • The script downloads the light node data from the URL https://nubit.sh/nubit-data/lightnode_data.tgz.

   • It then extracts the data, ensuring the node has the necessary data to start. For specific environment variables, please refer to set environment.

7. Start the Nubit Light Node:

   • The script navigates into the $HOME/nubit-node directory and runs the nubit executable to start the Nubit node with the appropriate parameters for a light node.

8. Initialize the Nubit Light Node:

   • The output includes several initialization messages:

     • The light node store is initialized.

     • A new Nubit address named my_nubit_key is generated, along with its mnemonic phrase (which is displayed once and must be saved securely).

     • The node joins the Nubit Alpha Testnet and starts syncing headers.

     • The script prints various status messages about the initialization process, including accessing the keyring, generating new keys, and starting the node.

9. Configure Node Settings:

   • The config.toml file, which is used by the Nubit node, includes various configurations such as startup timeout, shutdown timeout, P2P settings, RPC settings, and other node-specific configurations. This file ensures the Nubit node operates with the specified settings and parameters.

   • Example configurations in config.toml include:

     • [Node]: Startup and shutdown timeouts.

     • [Core]: IP, RPC port, and GRPC port.

     • [State]: Keyring account name and backend.

     • [P2P]: Listen to addresses, announce addresses, peer settings, etc.

     • [RPC]: Address and port.

     • [Share], [Header], [DASer], [Pruner]: Additional settings for data availability sampling, header synchronization, pruning, etc.

10. Output and Save PUBKEY and AUTHKEY:

    • The script outputs the generated PUBKEY and AUTHKEY, which are essential for node operations and security.

    • Ensure these keys are saved securely.

Save your Nubit Address, MNEMONIC, PUBKEY and AUTH KEY carefully

1. Node Information:

   • The script prints the following information about the node:

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

Started nubit DA node 
node version: 
node type:      light
network:        nubit-alphatestnet-1

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

The p2p host is listening on:
*  /ip4/127.0.0.1/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/tcp/2121/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/udp/2121/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/183.173.124.169/udp/58827/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/183.173.124.169/udp/58827/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/tcp/2121/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/udp/2121/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i

1. Report Metrics and Print Head Information:

   • The script starts the Nubit node with metrics reporting enabled, sending metrics data to the endpoint otel.nubit-alphatestnet-1.com:4318.

   • The script prints information about the network headers and the syncing process, ensuring the node is up-to-date with the latest network state.

---

Process of Running nubit.sh (Subsequent Runs)

Notes:

• Save Keys Securely: Always ensure that the PUBKEY and AUTHKEY are saved securely as they are crucial for node operations.

• No Reinstallation Needed: Since the binaries are already verified, the script skips the reinstallation process, making subsequent runs faster.

• Continued Operation: The node will continue from its previous state, ensuring seamless operation and synchronization with the network.

When you execute the nubit.sh script for the second time or any subsequent times, the process will differ slightly from the initial run. Here is a detailed guide for users executing the script after the first run:

1. Start the Script:

   • The script begins with a message "Starting Nubit node..." to indicate that the process has started.

2. Verify Installation:

   • The script checks the MD5 checksums of the existing nubit and nkey binaries to ensure they are correct.

   • If the checksums pass, the script prints "MD5 checking passed. Start directly" and proceeds without re-downloading the binaries.

3. Output Existing Keys:

   • The script confirms the presence of existing keys generated during the initial run.

   • Reminder: Ensure that the Nubit address, PUBKEY, and AUTHKEY are saved securely as they are crucial for node operations.

Each time you start light node, PUBKEY will be print out

1. Initialize Node:

   • The script accesses the keyring to use the existing keys for node operations and constructs the keyring signer using the stored key information.

   • It initializes and opens the necessary databases using the Badger database, ensuring the node can access its stored data and continue from where it left off.

   • The script loads peers from disk, reconnecting the node with its known peers, joins the appropriate network topics, and starts the P2P client and server.

   • The node begins syncing headers from the network to stay up-to-date.

   • The script starts the DASer (Data Availability Sampler) from the last checkpoint and initializes the RPC server for communication.

2. Node Information:

   • The script also prints the node information as usual:

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

Started nubit DA node 
node version: 
node type:      light
network:        nubit-alphatestnet-1

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

The p2p host is listening on:
*  /ip4/127.0.0.1/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/tcp/2121/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/udp/2121/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/172.22.173.67/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/183.173.124.169/udp/58827/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip4/183.173.124.169/udp/58827/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/tcp/2121/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/udp/2121/quic-v1/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i
*  /ip6/::1/udp/2121/quic-v1/webtransport/certhash/uEiB9lqoC_TeHP9bz4PWEDSUMlRMaOvVPhglAy63LtB-Qnw/certhash/uEiARTDqDNRTvmD7BKvwElMVEsySwmOY8AN6yvCPTs4Dp3w/p2p/12D3KooWSZmZWjyNbjy4t6mADjWzxWRa9KnfbwtTxtWhVh9Pc64i

1. Report Metrics and Print Head Information:

   • The script starts the Nubit node with metrics reporting enabled, sending metrics data to the endpoint otel.nubit-alphatestnet-1.com:4318.

   • The script prints information about the network headers and the syncing process, ensuring the node is up-to-date with the latest network state.

---