Run a node

Run a KREX Node

Kasparex is a community-powered layer that keeps the dApp Marketplace online, fast, and censorship-resistant.

Kasparex works even if nobody runs a node

Core HTML and APIs are always served by Kasparex. KREX Nodes are optional helpers that reduce hosting costs, increase decentralization, and earn rewards for their operators.

What is a KREX Node?

A KREX Node is a lightweight helper node that you run on your own computer or server. It is not a Kaspa BlockDAG node and does not require heavy hardware.

Pin & Mirror

Downloads dApp metadata from Kasparex and pins files via IPFS / Storacha

Censorship-Resistant

Keeps dApps available even if central servers are down, strengthening the ecosystem

Lightweight

Uses minimal resources (128-256 MB RAM, low CPU) - runs on any machine or Raspberry Pi

Earn Rewards

Earn GRID rewards and benefit from KREX multipliers

Node Types

Light Node

  • Pins IPFS / Storacha CIDs
  • Caches dApp metadata locally
  • Periodically syncs with Kasparex API
  • Ideal for regular community members

Reward: 4x multiplier, 0.1% fee reduction

Mirror Node

Recommended
  • Everything Light Node does, plus:
  • Exposes a small HTTP API (read-only)
  • Can be used as fallback data source
  • Ideal for power users and partners

Reward: 5x multiplier, 0.2% fee reduction

Light Node & Mirror Node

Light Node

Pins IPFS/Storacha CIDs, caches dApp metadata locally, and periodically syncs with the Kasparex API. Ideal for regular community members.

  • Pins CIDs
  • Caches metadata
  • Syncs with API
  • Low resource use
Multiplier 4xFee reduction 0.1%

Mirror Node

Recommended

Everything Light Node does, plus exposes a read-only HTTP API that can serve as a fallback data source. Ideal for power users and partners.

  • All Light features
  • Read-only HTTP API
  • Fallback data source
  • Request serving
Multiplier 5xFee reduction 0.2%

How to Run a KREX Node

1

Install Node.js

Download Node.js (LTS version) from the official site and install it on your machine.

Download Node.js →
2

Download KREX Node

Clone or download the Kasparex KREX Node repository.

git clone https://github.com/Kasparex/kasparex-krex-node.git
3

Install Dependencies

Open a terminal in the node folder and run:

npm install
4

Start the Node

Run the node:

npm start

The node will sync base data from Kasparex, start pinning configured CIDs, and report its status in the terminal.

5

Run as Background Service (Optional)

Advanced users can use tools like pm2 to keep the node running persistently:

npm install -g pm2
pm2 start src/index.js --name krex-node
pm2 save

How Rewards Work

The reward engine works in epochs (for example, once per day). During each epoch, your node sends small status pings to Kasparex API.

GRID Rewards (Global)

  • Base reward per epoch based on uptime
  • Multiplied by pinned files count
  • Multiplied by requests served (Mirror Nodes)
  • Multiplied by KREX holdings tier

XP & Perks

  • Earn XP Points for node activity
  • Unlock perks and badges
  • Multiplied by KREX tier

KREX Multiplier Tiers

0 KREX:1.0x
100k KREX:1.05x
500k KREX:1.1x
1M KREX:1.2x
5M KREX:1.3x
10M+ KREX:1.5x

Is it Safe?

A KREX Node:

  • Does not access your wallets or private keys
  • Does not require your Kasparex account password
  • Only handles public dApp metadata and static files
  • You always control when to start or stop your node

Who is this for?

KREX Holders

Support the ecosystem and earn boosted rewards with KREX multipliers

Technical Users

Enjoy running nodes and contributing to decentralized infrastructure

Partners & Builders

Ensure extra resilience for your dApps and help the entire marketplace

Ready to Get Started?

Join Kasparex and help build a decentralized, censorship-resistant dApp marketplace.