What is Netrum Lite Node CLI?

Users can easily participate in the Netrum decentralized compute network with the help of the Netrum Lite Node CLI, a lightweight command-line tool. It manages every aspect of the node operation with ease: mining NPT tokens, registering the node on the blockchain, securely creating a wallet, connecting to the Netrum network, syncing uptime, and enabling daily token claims all from your terminal. This node is designed for quick setup, total operational transparency, and passive token rewards. It is built to be efficient on VPS and low-resource hardware.

Hardware & Network Requirements

To run the Netrum Lite Node smoothly, make sure your system meets the following minimum requirements:

• Hardware Requirements

Component	Minimum	Recommended
CPU	2 Cores	2+ Cores
RAM	4 GB	6 GB or more
Disk Space	50 GB SSD	100 GB SSD

• Network Requirements

Type	Minimum Speed
Download	10 Mbps
Upload	10 Mbps

Setup Guide

• Follow these steps to install and run the Netrum Lite Node CLI on Ubuntu/Linux:

• Clone the Repository

git clone https://github.com/NetrumLabs/netrum-lite-node.git

• Navigate to Project Directory

cd netrum-lite-node

• Install Required Dependencies

sudo apt update && sudo apt install -y curl bc jq speedtest-cli nodejs npm

• (Recommended) Install Node.js v20

Check your current Node version:

node -v

If not v20.x.x, install it:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash sudo apt install -y nodejs

• Install Project Dependencies

npm install

• Link the CLI Globally

npm link

• Test the CLI

netrum

You should see the Netrum Lite Node CLI interface.


Netrum CLI  Version v2.0.0
Light-weight node & wallet toolkit for the Netrum network.

Available Commands:
netrum-update          Cli Update
netrum-system          System status & logs
netrum-new-wallet      Create / new a wallet
netrum-import-wallet   Create / import a wallet
netrum-wallet          Create / inspect a wallet
netrum-wallet-key      Export private key
netrum-wallet-remove   Delete wallet files
netrum-check-basename  Check basename conflicts
netrum-node-id         Show current Node ID
netrum-node-id-remove  Clear Node ID
netrum-node-sign       Sign a message with node key
netrum-node-register   Register node on-chain
netrum-sync            Sync blockchain data
netrum-sync-log        Node sync logs
netrum-mining          Start mining
netrum-mining-log      Node mining logs
netrum-claim           Claim rewards

Run netrum <command> --help for command-specific options.

How to Use Netrum CLI Commands

• netrum-system
Checks your VPS system status, including CPU, RAM, and internet speed. Use it to ensure your machine meets the basic requirements before setup.
• netrum-new-wallet
Creates a new EVM-compatible wallet directly from the CLI. It generates your public address and private key, which you should store securely.
• netrum-import-wallet
Imports an existing wallet by entering your private key. Useful if you already have a Base domain tied to a wallet you control.
• netrum-check-basename
Checks whether your current wallet has a registered Base domain name. Your Base name will also become your Netrum Node ID.
• netrum-node-id
Displays the current Node ID associated with your wallet. This is your official node identity on the Netrum network.
• netrum-node-sign
Generates a signed identity message using your wallet's private key to verify ownership of the node and wallet.
• netrum-node-register
Registers your node on-chain and with the backend system. Requires a small amount of BASE for gas (0.0002–0.0005 BASE).
• netrum-sync
Starts the syncing process between your node and the Netrum network, keeping your node active and eligible to earn mining rewards.
• netrum-sync-log
Displays real-time logs showing sync status, heartbeat signals, and activity tracking. Use this to confirm your node is working correctly.
• netrum-mining
Begins the mining process for NPT tokens. Your node will start earning rewards based on uptime and active sync.
• netrum-mining-log
Shows live mining logs and confirms whether your node is earning tokens correctly. Useful for monitoring daily activity.
• netrum-claim
Lets you claim mined NPT tokens after 24 hours of uptime. Once claimed, mining restarts automatically. Requires small BASE gas (0.00002–0.00003 BASE).
• netrum-wallet
Displays wallet information including your public address and NPT balance. Use this to confirm mined rewards are received.
• netrum-wallet-key
Reveals both public and private keys of your wallet. Only use in a secure environment and never share your private key.
• netrum-wallet-remove
Deletes your wallet from the local VPS. Back up your private key or seed phrase first, as this action cannot be undone.

Features of Netrum Lite Node

These are the core capabilities of the Netrum Lite Node CLI, designed for speed, simplicity, and transparency.

Secure Wallet Management
You can create a new EVM-compatible wallet or import an existing one directly through the CLI. Wallets are stored locally on your VPS, and your private key is never exposed or sent externally.
Unique Node Identity
Each node generates a unique identity like netrum.lite.base.username, linked to your Base domain. This identity is signed and verified both by Netrum’s backend and the on-chain smart contract.
Server Sync & Uptime Tracking
The node maintains a real-time connection with the Netrum backend to report uptime and status. Your uptime is continuously tracked to determine mining eligibility and is preserved across restarts.
On-Chain Registration
Your node is registered directly on a smart contract, ensuring your wallet and Node ID are verifiably linked. This brings full transparency, decentralized ownership, and traceability to the entire setup.
Live NPT Token Mining
NPT tokens are mined based on your node’s uptime and contribution to the network. There’s no hardware mining involved, just consistent uptime and on-chain proof-of-participation.
Daily Reward Claim
You can claim your mined NPT tokens every 24 hours through a simple one-line command. Each claim is recorded on-chain, and tokens are sent directly to your connected wallet.
Lightweight & Easy to Use
The CLI is fast, intuitive, and optimized for both developers and first-time node runners. It runs smoothly on low-resource VPS machines and can be fully set up in under five minutes.

Support

If you face any errors while setting up your wallet, registering your node, or during mining:

Join the official Netrum Discord for help and community support

Next Steps

Now that you have read everything, here's what you can do next:

Full-Node

Fast Node, Fair Rewards.

Quick Start

Learn the basics and get started quickly.