Join the Network

HyMatrix is a decentralized computing network that allows asynchronous global node participation. Anyone can contribute by running a node to participate in computation, log submission, and economic incentives.

This chapter guides you through connecting your local node to the HyMatrix Testnet, completing identity registration, staking, and validation.

Prerequisites Before Joining

Ensure you meet the following conditions before joining the network:

• ✅ A server with a public IP or domain name — your node must be accessible to other users.
• ✅ Node environment fully deployed and operational.
• ✅ Wallet key securely stored — never expose your private key to logs, public channels, or shared environments.
• ✅ At least 1 tAX test tokens to stake during node registration.

🔐 Node registration involves cryptographic signatures, identity binding, and staking transfers. Keep your private key secure at all times.

---

Step 1: Get tAX Test Tokens

The HyMatrix Testnet uses tAX (Test AX) tokens for staking and registration.

Current options for obtaining tAX:

• Option 1: Request from the HyMatrix team directly.
• Option 2 (coming soon): Claim from the public Faucet Service.

📌 Make sure your wallet holds at least 1 tAX, or registration will fail.

Step 2: Configure Testnet Parameters

Save the following configuration as config.yaml:

# Node Service
port: :80
ginMode: release  # Options: "debug", "release"

# Redis Configuration
redisURL: redis://@localhost:6379/0

# Storage & Network
arweaveURL: https://arweave.net
hymxURL: https://hymatrix.ai  # Main entry point to the network

# Node Identity (Wallet)
# Provide either your Ethereum private key or Arweave wallet path
prvKey: <your private key>
keyfilePath:

# Node Metadata
nodeName: mynode
nodeDesc: join the test network
nodeURL: https://mynode.com     # Must be publicly accessible

# Network Join
joinNetwork: true

📌 Key Field Notes:

Field	Description
nodeURL	Must be a public IP or domain reachable by others
hymxURL	Mainnet entry — currently https://hymatrix.ai
prvKey	Used for registration and signature — secure it
joinNetwork: true	Enables auto-registration to the Testnet

Step 3: Start and Validate Your Node

Once configured, launch the node with:

./hymx --config ./config.yaml

Upon successful startup, your node will:

• Submit registration info to the Registry
• Automatically stake 1 tAX tokens
• Publish your node info to the network for global discovery

✅ To verify registration success:

curl https://mynode.com/info

You should see your configured node name and address in the response.

You can also check the global node list:

curl https://mynode.com/nodes

If your nodeURL appears, the registration has propagated across the network.

⏹️ To stop the node:

• On Linux or Windows: press Ctrl + C
• On macOS: press Command (⌘) + C

Once the node stops, it will automatically release the staked tAX and unregister from the network.