Cygnus Node Installer for LINUX

Please note: the windows one can be seen here https://github.com/CryptoDevelopmentServices/node/blob/main/README_Windows.md

This repository contains a complete installer for running a Cygnus blockchain node. It builds the Cygnus Geth binary, sets up your datadir, static peers, mining options, and systemd services for automatic startup.

GitHub URL: https://github.com/cygnus-chain/node

---

Features

• Builds and installs Cygnus core v1.11.33.2 with dapp/defi support activation at block 100,000 .
• Automatically initializes the chain using genesis.json.
• Static peer configuration for consistent P2P connectivity.
• Optional CPU or external mining setup.
• Systemd service for automatic node startup.
• Peer healthcheck timer to auto-connect to bootnodes.
• Safe upgrade path — preserves existing blockchain data.

---

Prerequisites

• Ubuntu / Debian Linux (supported versions only).
• At least 2 GB RAM recommended.
• Internet access for downloading Go and source code.

---

Installation

1. Clone the repository:

git clone https://github.com/cygnus-chain/node.git
cd node

2. Run the installer:

chmod +x installer.sh
./installer.sh

3. Installer steps:

• Installs build dependencies and Go if missing.
• Downloads and builds the Cygnus Geth binary.
• Copies genesis.json to your data directory (~/cygnus_data).
• Initializes the chain if this is a fresh node.
• Configures static peers and optional mining settings.
• Installs a cygnusd wrapper script and systemd service.
• Installs a cygnus-peercheck timer for automatic peer connection.

---

Running the Node

After installation, the node runs automatically via systemd:

sudo systemctl status cygnusd
sudo journalctl -u cygnusd -f

Check peer connectivity:

geth attach ipc:~/cygnus_data/geth.ipc
> admin.peers

Check current block and coinbase balance:

> eth.blockNumber
> web3.fromWei(eth.getBalance(eth.coinbase), "ether")

---

Mining Options

During installation, you can choose:

1. CPU mining

   • Enter your Cygnus wallet address for rewards.
   • Set number of CPU threads to use.

2. No mining

   • Node will just sync and serve the network.

---

Upgrading Existing Nodes

1. Backup your existing datadir:

cp -r ~/cygnus_data ~/cygnus_data-backup

2. Stop the current node:

sudo systemctl stop cygnusd

3. Run installer.sh — it will detect the existing chain and preserve all blocks.

4. Start the upgraded node:

sudo systemctl start cygnusd

---

Static Peers / Bootnodes

• Main node enode:

enode://404245728d5d24c06b58c5e809809a30302c8560aff1f9adfacedb3c50dafae1f417b459e190110ca797eda564a3f9dee1a79385bb467d5a481d685ff70aaa3f@88.99.217.236:30303

• Can be added manually in static-nodes.json:

[
  "enode://404245728d5d24c06b58c5e809809a30302c8560aff1f9adfacedb3c50dafae1f417b459e190110ca797eda564a3f9dee1a79385bb467d5a481d685ff70aaa3f@88.99.217.236:30303"
]

• Any node using this installer will auto-connect to the main node.

---

Connecting via IPC

geth attach ipc:~/cygnus_data/geth.ipc

• This allows you to run commands in the Geth JS console.
• Examples:

> eth.blockNumber
> admin.peers
> eth.getBalance(eth.coinbase)

---

Systemd Services

• cygnusd.service → runs the node continuously and auto-restarts.
• cygnus-peercheck.timer → runs every 2 minutes to reconnect peers if disconnected.

Check status:

sudo systemctl status cygnusd
sudo systemctl status cygnus-peercheck.timer

---

Notes

• All nodes using this installer will automatically peer with the main bootnode.
• The installer script can be safely run multiple times — it detects existing chains and preserves them.