hymx

HyMatrix

HyMatrix is an infinitely scalable decentralized computing network that decouples computation from consensus by anchoring execution logs in immutable storage (Arweave), enabling verifiable, trustless computation anywhere.

• ✅ Trustless Verification - Trust via execution logs, not global consensus
• ⚙️ Multiple Runtimes - Docker and WASM support (EVM coming soon)
• 📦 Open Marketplace - Join by staking AX tokens
• 💡 Enterprise-Ready - Built for AI, DeFi, and large-scale applications

Compute anywhere. Verify everything.

Table of Contents

• Overview
• Version Information
  • Node Version
  • Protocol Version
  • Version Compatibility
• Software Dependencies
• Getting Started
  • Wallet Setup
  • Installation
  • Configuration
  • Running
• Network Participation
• Developer Resources
  • Examples
  • Documentation

Overview

HyMatrix is a decentralized computing network where participants stake AX tokens (or tAX on testnet) to operate nodes and process computation tasks. The network architecture consists of:

Registry Module - The network's global directory that:

• Manages node identity (wallet address)
• Stores node metadata (name, description, URL)
• Tracks supported runtime environments
• Facilitates inter-VM communication

This architecture enables seamless service discovery and cross-VM operations while maintaining a trustless verification model through immutable execution logs.

Version Information

HyMatrix uses two key version identifiers to ensure network compatibility and proper protocol handling:

• Node Version: Core node version, used to identify node functionality and performance
• Protocol Version: Protocol version, used to identify communication protocols between nodes Specific information can be viewed in the /info endpoint

{
  "Protocol": "hymx",
  "Variant": "v0.1.0", // Protocol Version
  "NodeVersion": "v0.1.3",
  ......
}

Software Dependencies

Getting Started

Wallet Setup

Each HyMatrix node requires a unique wallet address that serves as its network identity and economic account for staking, rewards, and other operations.

💡 Tip: For production nodes, use Ethereum wallets for optimal performance.

Installation

Build the HyMatrix node from source:

git clone https://github.com/hymatrix/hymx
cd hymx
go mod tidy
make build

Configuration

Create a config.yaml file with the following settings:

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

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

# Storage & Network
arweaveURL: https://arweave.net
hymxURL: http://127.0.0.1:8080

# Node Identity (Wallet)
prvKey: 0x64dd2342616f385f3e8157cf7246cf394217e13e8f91b7d208e9f8b60e25ed1b
keyfilePath:

# Node Info
nodeName: test1
nodeDesc: first test node
nodeURL: http://127.0.0.1:8080

# Registration & Network Join
joinNetwork: false

Key Configuration Fields:

Running

1. Start Redis - Ensure Redis is running and redisURL in your config is correct

2. Launch the Node - Run the binary with your configuration:

   ./hymx --config ./config.yaml
   

   Successful startup will show:

   INFO[07-25|00:00:01] server is running   module=node-v0.0.1 wallet=0x... port=:8080
   

Join the Network

To join the HyMatrix network as a node operator:

1. Configure your node with joinNetwork: true
2. Stake the required AX tokens
3. Complete the registration process

Participating nodes earn rewards for computation, log submission, and network services.

For detailed instructions, see Join the Network

Developer Resources

Examples

Reference implementations are available in the examples directory.

Documentation

For comprehensive guides, API references, and advanced topics, refer to the official documentation.

• API Reference: HyMatrix HTTP API
• SDK Guide: HyMatrix Go SDK Guide