Setting Up Modulax Node

Running a Modulax node allows you to participate in the network as a validator, contributor, or developer. The node is modular, lightweight, and written in Golang, making it easy to build, run, and extend.

"Every decentralized network begins with nodes. Running your own node is the foundation of true participation."

Prerequisites

Before installing, ensure you have the following:

  • Operating System: Linux, macOS, or Windows

  • Dependencies: Git, Go (>=1.22), and Make

  • Hardware Requirements:

    • CPU: 4 cores or more

    • RAM: 8 GB minimum

    • Disk: 200 GB SSD recommended

    • Network: Stable broadband connection

Installation

Clone the Modulax repository and build the binary:

 git clone https://github.com/Modulax-Labs/go-modulax.git cd go-modulax go build -o modulax ./cmd/modulax

Check that the build succeeded:

./modulax version

Running a Node

Start on Mainnet

./modulax run --network mainnet

The node will:

Connect to peers using libp2p

Sync blocks from the Modulax chain

Expose a local RPC interface on http://localhost:8545

Start on Testnet

./modulax version

Use the testnet for contract development and experimentation without risking mainnet funds.

Configuration

Nodes can be customized through flags or configuration files.

Examples:

Change data directory:

./modulax run --network mainnet --datadir /custom/path

Set custom p2p port:

./modulax run --network mainnet --p2p-port 30303

Enable verbose logging:

./modulax run --network mainnet --verbosity debug

Validator Setup

Validators secure the network by proposing and attesting to blocks. To run as a validator:

  1. Generate validator keys

  2. Stake MDX tokens through the staking contract

  3. Start the node with validator flags enabled

Example:

./modulax run --network mainnet --validator --keystore /keys/validator.json

Monitoring and Maintenance

  • Best practices for node operators:

  • Use systemd or Docker for process management

  • Monitor logs for peer count, block height, and consensus status

  • Regularly update to the latest release from GitHub

  • Back up validator keys securely and offline

Conclusion

Running a Modulax node is the entry point to contributing to the network’s growth. Whether for validation, development, or research, the node is designed to be simple to set up and powerful enough to scale with the ecosystem.

"Operate a node, secure the network, and be part of building the quantum-resistant future."

Previous⁠Developer GuideNextRPC Access & APIs

Last updated