Appearance

Connecting to the Testnet Network ​

After successfully setting up the xosd executable, it's time to integrate your node with the XOS Testnet ecosystem. This comprehensive guide outlines the process of node initialization, genesis configuration, peer discovery, and network synchronization.

Before You Begin ​

Important: Ensure you've properly completed the node installation procedure before attempting these steps.

Network Integration Process ​

Follow this sequential procedure to establish your node within the Testnet environment.

1. Hardware Preparation ​

Ensure your server infrastructure meets or exceeds the recommended specifications for optimal performance.

2. Software Deployment ​

Verify that the xosd binary is correctly installed according to the deployment instructions.

3. Node Initialization ​

Create the initial configuration structure for your node. Substitute <moniker> with a unique identifier for your node and use the appropriate Testnet chain identifier.

bash
xosd init <moniker> --chain-id <testnet-chain-id>

4. Keyring Configuration ​

Establish the security backend for key management operations. Select the appropriate security level from os, file, or test based on your operational requirements.

bash
xosd config set client keyring-backend <os|file|test>

5. Key Management Setup ​

For nodes intended to participate in validation or transaction signing, establish appropriate cryptographic credentials:

bash
xosd keys add <key_name> --keyring-backend <os|file|test>

6. Genesis Configuration ​

Acquire and implement the canonical genesis state document for the Testnet:

bash
wget https://raw.githubusercontent.com/xos-labs/networks/refs/heads/main/testnet/genesis.json -O ~/.xosd/config/genesis.json

7. Peer Discovery Configuration ​

Establish network connectivity by integrating trusted peer information into your node's configuration:

bash
PEERS=`curl -sL https://raw.githubusercontent.com/xos-labs/networks/main/testnet/peers.txt | sort -R | head -n 10 | awk '{print $1}' | paste -s -d, -`
sed -i.bak -e "s/^seeds *=.*/seeds = \"$PEERS\"/" ~/.xosd/config/config.toml
cat ~/.xosd/config/config.toml | grep seeds

8. Final Configuration Verification ​

If necessary, perform additional initialization with the finalized genesis state and configuration parameters.

9. Node Activation ​

Launch your node and observe the synchronization process through the generated logs:

bash
xosd start

10. Synchronization Monitoring ​

Allow your node to achieve full synchronization with the Testnet blockchain. Monitor the synchronization status using:

bash
xosd status

11. Ongoing Maintenance ​

  • Implement software updates promptly when new versions become available
  • Apply appropriate customizations to your node's operational parameters
  • Review advanced configuration options for performance optimization