Skip to main content

Run an Archive Node

Overview

An archive node stores the history of past blocks. Most of the time, an archive node is used as an RPC endpoint. RPC plays a vital role in our network: it connects users and dApps to the blockchain through WebSocket and HTTP endpoints. For example, our public endpoints

node1.mandalachain.io
wss://node1.mandalachain.io

run archive nodes for anyone to connect to the Mandala Chain quickly.

DApp projects must run their own RPC node as an archive to retrieve necessary blockchain data and not rely on public infrastructure. Public endpoints respond slower because of the large amount of users connected and are rate-limited.

CAUTION

Be careful not to confuse with a full node that has a pruned database: a full node only stores the current state and most recent blocks (256 blocks by default) and uses much less storage space.

We maintain two different networks: Madya mainnet and Niskala testnet.

MandalaChainTokenTicker
MadyaKepengKPG
NiskalaKepeng TestnetKPGT

Requirements

Machine

ComponentRequirement
SystemUbuntu 20.04
CPU8 cores
Memory16 GB
Hard Disk500 GB SSD (NVMe preferable)
ComponentRequirement
SystemUbuntu 20.04
CPU4 cores
Memory8 GB
Hard Disk200 GB SSD (NVMe preferable)

Ports

The Mandala Chain node will listen at different ports by default for both the mainnet and the testnet.

DescriptionTestnet PortCustom Port Flag
P2P30333--port
RPC9944--rpc-port
Prometheus9615--prometheus-port

For all types of nodes, ports 30333 and 30334 need to be opened for incoming traffic at the Firewall. Validator nodes should not expose WS and RPC ports to the public.

Installation

There are 2 different ways to run a Mandala Chain node:

Using Binary - run the node from a binary file and set it up as systemd service

Using Docker - run the node within a Docker container