From 3e49825cd71a498b612b3d7cce7fc86acff5b5d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:26:50 +0300
Subject: [PATCH 01/13] docs: polish README for QoreChain light node fork
---
README.md | 160 ++++++++++++++++++++++++++++++++++++++++++------------
1 file changed, 126 insertions(+), 34 deletions(-)
diff --git a/README.md b/README.md
index 561c2ca..31417ca 100644
--- a/README.md
+++ b/README.md
@@ -1,76 +1,168 @@
-# QoreChain Light Node
+# 🐙 QoreChain Light Node
-**v3.1.1** — aligned with `qorechain-core@v3.0.2`. Adds a PQC regression test suite (keygen, sign, verify, and tamper-detection) that guards the v3.0.2 signature-verification fix, and runs it in CI. No runtime behaviour change from v3.1.0.
+> Community-maintained fork by **Satoshi-Qore** for exploring, running, and supporting QoreChain light node infrastructure.
-Light node client for the QoreChain network. Provides two editions:
+
+
+
+
-- **SX (Server eXperience)** — headless daemon with CLI for server deployments
-- **UX (User eXperience)** — embedded web dashboard with CLI for desktop use
+---
-## Features
+## 🚀 Overview
+
+QoreChain Light Node is a lightweight client for the QoreChain network.
+
+It is designed for users who want to contribute to network infrastructure without running a full validator. A light node can relay traffic, serve light client queries, contribute uptime, and participate in the QoreChain ecosystem.
+
+This fork is focused on:
+
+- Helping new users understand light node setup
+- Testing the SX and UX editions
+- Documenting community installation steps
+- Supporting QoreChain node operators
+- Tracking useful commands and troubleshooting notes
+
+---
+
+## 🧩 Editions
+
+QoreChain Light Node provides two editions:
+
+| Edition | Name | Best For |
+|---|---|---|
+| **SX** | Server eXperience | VPS / server deployments |
+| **UX** | User eXperience | Dashboard-based desktop or web use |
+
+---
+
+## ✨ Key Features
- Header verification via skipping verification light client
- Delegated staking with multi-validator split
- Auto-compound rewards with configurable intervals
- Reputation-aware validator rebalancing
-- Real-time network telemetry (validators, consensus, bridge, tokenomics)
+- Real-time network telemetry
- On-chain registration with heartbeat liveness proofs
- 3% block reward eligibility for active light nodes
-- Post-quantum cryptography support (Dilithium-5)
-- **Interactive onboarding wizard** that runs a PQC self-test, accepts the chain RPC endpoint, and imports or generates a Dilithium-5 validator key
-- **Local-only mode** so the node can prove its PQC stack works even before the chain itself is deployed
-- **Live PQC self-test** — `lightnode-sx selftest` runs keygen → sign → verify → tamper-detection in under a second
+- Post-quantum cryptography support
+- Interactive onboarding wizard
+- Local-only mode for pre-mainnet testing
+- Live PQC self-test command
-## Quick Start
+---
-### First-time setup
+## ⚡ Quick Start
+
+### 1. Build SX edition
```bash
-# 1. Build (or pull the Docker image)
CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
+```
+
+### 2. Run onboarding
-# 2. Run the onboarding wizard — PQC self-test + endpoint + key prompts
+```bash
build/lightnode-sx onboard
+```
+
+During onboarding, the wizard asks for:
-# 3. Start the daemon
+- Chain RPC endpoint
+- Private key or new key generation
+- Node configuration preferences
+
+### 3. Start the node
+
+```bash
build/lightnode-sx start
```
-The wizard asks for:
-- **Chain RPC endpoint** — paste the URL (e.g. `https://rpc.qorechain.io:26657`), or leave blank to run in local-only mode while the chain itself is still being deployed.
-- **Private key** — paste a hex-encoded Dilithium-5 key, or type `g` to generate a fresh one on this node.
+---
-If you leave the endpoint blank the daemon will start in **local-only mode** — the PQC stack is fully exercised and the web dashboard shows a banner explaining the state. Re-run `onboard` once the chain is live to point at a real RPC.
+## 🐳 Docker Usage
-### Build from Source
+```bash
+docker compose up lightnode-sx
+```
+
+For the UX dashboard edition:
```bash
-# SX edition (server daemon)
-CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
+docker compose up lightnode-ux
+```
+
+---
-# UX edition (dashboard + daemon)
-CGO_ENABLED=1 go build -o build/lightnode-ux ./cmd/lightnode-ux/
+## 🛡️ Verify PQC Stack
+
+Run the self-test command anytime:
+
+```bash
+lightnode-sx selftest
```
-### Docker
+This checks:
+
+- Key generation
+- Sign operation
+- Valid signature verification
+- Rejection of tampered signatures
+- Rejection of tampered messages
+
+---
+
+## 🛠️ Useful VPS Commands
+
+Check running containers:
```bash
-docker compose up lightnode-sx # server edition
-docker compose up lightnode-ux # dashboard edition (port 8080)
+docker ps
```
-### Verify the PQC stack any time
+Start services:
```bash
-lightnode-sx selftest
+docker compose up -d
+```
+
+View logs:
+
+```bash
+docker compose logs -f
```
-Runs 5 checks: keygen, sign, verify-valid, reject-tampered-sig, reject-tampered-msg.
+Restart services:
-## Configuration
+```bash
+docker compose restart
+```
+
+---
+
+## 📌 Community Notes
+
+This repository is part of my QoreChain learning and community support work.
+
+I use this fork to:
+
+- Test light node setup flows
+- Collect useful commands
+- Help community members with node questions
+- Improve my understanding of post-quantum blockchain infrastructure
+
+---
+
+## 🔗 Official Repository
+
+Original project:
+
+```text
+https://github.com/qorechain/qorechain-lightnode
+```
-See `config.example.toml` for all available options.
+---
-## License
+## 📄 License
Apache 2.0
From 4d64dd795892358fb985f7af90439a1c9f399e6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:32:43 +0300
Subject: [PATCH 02/13] docs: add repository banner
---
assets/qorechain-lightnode-banner.svg | 80 +++++++++++++++++++++++++++
1 file changed, 80 insertions(+)
create mode 100644 assets/qorechain-lightnode-banner.svg
diff --git a/assets/qorechain-lightnode-banner.svg b/assets/qorechain-lightnode-banner.svg
new file mode 100644
index 0000000..168099d
--- /dev/null
+++ b/assets/qorechain-lightnode-banner.svg
@@ -0,0 +1,80 @@
+
From a782828470e5c63e5a401824df8bdbb6455756e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:33:38 +0300
Subject: [PATCH 03/13] docs: add banner to README
---
README.md | 121 +++---------------------------------------------------
1 file changed, 5 insertions(+), 116 deletions(-)
diff --git a/README.md b/README.md
index 31417ca..d130e35 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+
+
+
+
# 🐙 QoreChain Light Node
> Community-maintained fork by **Satoshi-Qore** for exploring, running, and supporting QoreChain light node infrastructure.
@@ -50,119 +54,4 @@ QoreChain Light Node provides two editions:
- Local-only mode for pre-mainnet testing
- Live PQC self-test command
----
-
-## ⚡ Quick Start
-
-### 1. Build SX edition
-
-```bash
-CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
-```
-
-### 2. Run onboarding
-
-```bash
-build/lightnode-sx onboard
-```
-
-During onboarding, the wizard asks for:
-
-- Chain RPC endpoint
-- Private key or new key generation
-- Node configuration preferences
-
-### 3. Start the node
-
-```bash
-build/lightnode-sx start
-```
-
----
-
-## 🐳 Docker Usage
-
-```bash
-docker compose up lightnode-sx
-```
-
-For the UX dashboard edition:
-
-```bash
-docker compose up lightnode-ux
-```
-
----
-
-## 🛡️ Verify PQC Stack
-
-Run the self-test command anytime:
-
-```bash
-lightnode-sx selftest
-```
-
-This checks:
-
-- Key generation
-- Sign operation
-- Valid signature verification
-- Rejection of tampered signatures
-- Rejection of tampered messages
-
----
-
-## 🛠️ Useful VPS Commands
-
-Check running containers:
-
-```bash
-docker ps
-```
-
-Start services:
-
-```bash
-docker compose up -d
-```
-
-View logs:
-
-```bash
-docker compose logs -f
-```
-
-Restart services:
-
-```bash
-docker compose restart
-```
-
----
-
-## 📌 Community Notes
-
-This repository is part of my QoreChain learning and community support work.
-
-I use this fork to:
-
-- Test light node setup flows
-- Collect useful commands
-- Help community members with node questions
-- Improve my understanding of post-quantum blockchain infrastructure
-
----
-
-## 🔗 Official Repository
-
-Original project:
-
-```text
-https://github.com/qorechain/qorechain-lightnode
-```
-
----
-
-## 📄 License
-
-Apache 2.0
+---
\ No newline at end of file
From 38faf4df7af56b59bbdafdf1f098fb0e9bab5302 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:37:38 +0300
Subject: [PATCH 04/13] docs: add installation guide
---
INSTALLATION_GUIDE.md | 132 ++++++++++++++++++++++++++++++++++++++++++
1 file changed, 132 insertions(+)
create mode 100644 INSTALLATION_GUIDE.md
diff --git a/INSTALLATION_GUIDE.md b/INSTALLATION_GUIDE.md
new file mode 100644
index 0000000..f64c2e6
--- /dev/null
+++ b/INSTALLATION_GUIDE.md
@@ -0,0 +1,132 @@
+# QoreChain Light Node Installation Guide
+
+This guide explains the basic setup flow for running a QoreChain Light Node from this fork.
+
+> Maintained by **Satoshi-Qore** as part of QoreChain community support and infrastructure learning.
+
+---
+
+## 1. Requirements
+
+Before starting, make sure your system has:
+
+- Linux VPS or local Linux environment
+- Go installed
+- Docker and Docker Compose installed
+- Git installed
+- Basic terminal access
+
+For VPS usage, Ubuntu is recommended for beginners.
+
+---
+
+## 2. Clone the Repository
+
+```bash
+git clone https://github.com/satoshi-Qore/qorechain-lightnode.git
+cd qorechain-lightnode
+```
+
+---
+
+## 3. Build the Light Node
+
+### SX Edition
+
+The SX edition is designed for server / VPS usage.
+
+```bash
+CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
+```
+
+### UX Edition
+
+The UX edition includes a dashboard experience.
+
+```bash
+CGO_ENABLED=1 go build -o build/lightnode-ux ./cmd/lightnode-ux/
+```
+
+---
+
+## 4. Run Onboarding
+
+```bash
+build/lightnode-sx onboard
+```
+
+The onboarding wizard may ask for:
+
+- Chain RPC endpoint
+- Private key or new key generation
+- Node configuration details
+
+If the network endpoint is not available yet, local-only mode can be used for testing.
+
+---
+
+## 5. Start the Node
+
+```bash
+build/lightnode-sx start
+```
+
+---
+
+## 6. Docker Setup
+
+Start the SX edition:
+
+```bash
+docker compose up lightnode-sx
+```
+
+Start the UX edition:
+
+```bash
+docker compose up lightnode-ux
+```
+
+Run in background:
+
+```bash
+docker compose up -d
+```
+
+---
+
+## 7. Check Logs
+
+```bash
+docker compose logs -f
+```
+
+---
+
+## 8. Restart Services
+
+```bash
+docker compose restart
+```
+
+---
+
+## 9. Verify PQC Self-Test
+
+```bash
+lightnode-sx selftest
+```
+
+This verifies that the post-quantum cryptography stack is working correctly.
+
+---
+
+## 10. Notes
+
+This guide is intended for community learning and support. Always check the official QoreChain documentation and repository for the latest production instructions.
+
+Official repository:
+
+```text
+https://github.com/qorechain/qorechain-lightnode
+```
From 1cfb43fd338c50a3d2c4237aa958bde20fe17035 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 18:23:58 +0300
Subject: [PATCH 05/13] docs: add community FAQ
---
FAQ.md | 32 ++++++++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
create mode 100644 FAQ.md
diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 0000000..8521e80
--- /dev/null
+++ b/FAQ.md
@@ -0,0 +1,32 @@
+# FAQ
+
+## Why is my balance still zero after a faucet claim?
+
+Possible reasons:
+- Synchronization delay
+- Dashboard cache
+- Transaction indexing not completed yet
+
+## Why does a light node require 1000 QOR?
+
+The stake helps:
+- Prevent Sybil attacks
+- Align operators with network success
+- Support responsible participation
+
+The stake is locked while operating and can be recovered when the node is shut down.
+
+## Why is X verification failing?
+
+Common causes:
+- Verification performed too late
+- Post not indexed yet
+- Verification steps completed out of order
+
+## Dashboard not loading?
+
+Check:
+- Port 8420 accessibility
+- Container status
+- Firewall configuration
+- Docker logs
From 3b16b94bedb76ae44e61cadb0fc84a3425f457db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 18:24:12 +0300
Subject: [PATCH 06/13] docs: add community notes
---
COMMUNITY_NOTES.md | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
create mode 100644 COMMUNITY_NOTES.md
diff --git a/COMMUNITY_NOTES.md b/COMMUNITY_NOTES.md
new file mode 100644
index 0000000..fa2a55d
--- /dev/null
+++ b/COMMUNITY_NOTES.md
@@ -0,0 +1,23 @@
+# Community Notes
+
+## Frequently Observed Issues
+
+### Synchronization Delays
+
+Observed cases where faucet transactions appear in history before balances are reflected on the dashboard.
+
+### Dashboard Cache
+
+Refreshing the dashboard may be required after transactions are processed.
+
+### X Verification
+
+Users should complete posting and verification steps in the correct order and allow time for indexing.
+
+### Support Requests
+
+Useful information when reporting issues:
+- Wallet address
+- Username
+- Screenshots
+- Error messages
From 9053c17ab2599771179b481ab962fd09eb431b8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Wed, 3 Jun 2026 18:24:26 +0300
Subject: [PATCH 07/13] docs: add operator journal
---
OPERATOR_JOURNAL.md | 29 +++++++++++++++++++++++++++++
1 file changed, 29 insertions(+)
create mode 100644 OPERATOR_JOURNAL.md
diff --git a/OPERATOR_JOURNAL.md b/OPERATOR_JOURNAL.md
new file mode 100644
index 0000000..fd42be2
--- /dev/null
+++ b/OPERATOR_JOURNAL.md
@@ -0,0 +1,29 @@
+# Operator Journal
+
+## VPS Deployment Notes
+
+### Environment
+
+- DigitalOcean VPS
+- Ubuntu Linux
+- Docker & Docker Compose
+
+### Initial Deployment
+
+Status: Successful
+
+Observations:
+- Containers started successfully
+- Dashboard reachable on configured port
+- Node services operating normally
+
+## Lessons Learned
+
+- Verify open ports before troubleshooting
+- Check container status first
+- Keep configuration backups
+- Monitor logs regularly
+
+## Future Notes
+
+This file will be updated with operational experiences, infrastructure observations, and deployment lessons.
From 12b8a1daece9ba9d6049dc35f7f5bca2d727bbf8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 06:03:12 +0300
Subject: [PATCH 08/13] Add config example for light node setup
---
config.example.toml | 15 +++++++++++++++
1 file changed, 15 insertions(+)
create mode 100644 config.example.toml
diff --git a/config.example.toml b/config.example.toml
new file mode 100644
index 0000000..9ec44e8
--- /dev/null
+++ b/config.example.toml
@@ -0,0 +1,15 @@
+# QoreChain Light Node example configuration
+
+[network]
+# Replace with the official QoreChain RPC endpoint when available.
+rpc_endpoint = "https://rpc.qorechain.io:26657"
+
+# Leave empty or adjust according to the active network.
+chain_id = ""
+
+[node]
+# Use "sx" for server deployments or "ux" for dashboard mode.
+edition = "sx"
+
+[logging]
+level = "info"
From 9869d1163e77f3e612f2e97dc659942cd7dd9d6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:35:16 +0300
Subject: [PATCH 09/13] Neutralize light node README for upstream PR
---
README.md | 107 ++++++++++++++++++++++++++++++++++--------------------
1 file changed, 67 insertions(+), 40 deletions(-)
diff --git a/README.md b/README.md
index d130e35..83b95cb 100644
--- a/README.md
+++ b/README.md
@@ -1,57 +1,84 @@
-
-
-
+# QoreChain Light Node
-# 🐙 QoreChain Light Node
+**v3.1.1** — aligned with `qorechain-core@v3.0.2`. Adds a PQC regression test suite (keygen, sign, verify, and tamper-detection) that guards the v3.0.2 signature-verification fix, and runs it in CI. No runtime behaviour change from v3.1.0.
-> Community-maintained fork by **Satoshi-Qore** for exploring, running, and supporting QoreChain light node infrastructure.
+Light node client for the QoreChain network. Provides two editions:
-
-
-
-
+- **SX (Server eXperience)** — headless daemon with CLI for server deployments
+- **UX (User eXperience)** — embedded web dashboard with CLI for desktop use
----
+## Features
-## 🚀 Overview
+- Header verification via skipping verification light client
+- Delegated staking with multi-validator split
+- Auto-compound rewards with configurable intervals
+- Reputation-aware validator rebalancing
+- Real-time network telemetry (validators, consensus, bridge, tokenomics)
+- On-chain registration with heartbeat liveness proofs
+- 3% block reward eligibility for active light nodes
+- Post-quantum cryptography support (Dilithium-5)
+- **Interactive onboarding wizard** that runs a PQC self-test, accepts the chain RPC endpoint, and imports or generates a Dilithium-5 validator key
+- **Local-only mode** so the node can prove its PQC stack works even before the chain itself is deployed
+- **Live PQC self-test** — `lightnode-sx selftest` runs keygen -> sign -> verify -> tamper-detection in under a second
-QoreChain Light Node is a lightweight client for the QoreChain network.
+## Quick Start
-It is designed for users who want to contribute to network infrastructure without running a full validator. A light node can relay traffic, serve light client queries, contribute uptime, and participate in the QoreChain ecosystem.
+### First-time setup
-This fork is focused on:
+```bash
+# 1. Build (or pull the Docker image)
+CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
-- Helping new users understand light node setup
-- Testing the SX and UX editions
-- Documenting community installation steps
-- Supporting QoreChain node operators
-- Tracking useful commands and troubleshooting notes
+# 2. Run the onboarding wizard — PQC self-test + endpoint + key prompts
+build/lightnode-sx onboard
----
+# 3. Start the daemon
+build/lightnode-sx start
+```
-## 🧩 Editions
+The wizard asks for:
+- **Chain RPC endpoint** — paste the official RPC URL when available, or leave blank to run in local-only mode while the chain itself is still being deployed.
+- **Private key** — paste a hex-encoded Dilithium-5 key, or type `g` to generate a fresh one on this node.
-QoreChain Light Node provides two editions:
+If you leave the endpoint blank the daemon will start in **local-only mode** — the PQC stack is fully exercised and the web dashboard shows a banner explaining the state. Re-run `onboard` once the chain is live to point at a real RPC.
-| Edition | Name | Best For |
-|---|---|---|
-| **SX** | Server eXperience | VPS / server deployments |
-| **UX** | User eXperience | Dashboard-based desktop or web use |
+### Build from Source
----
+```bash
+# SX edition (server daemon)
+CGO_ENABLED=1 go build -o build/lightnode-sx ./cmd/lightnode-sx/
-## ✨ Key Features
+# UX edition (dashboard + daemon)
+CGO_ENABLED=1 go build -o build/lightnode-ux ./cmd/lightnode-ux/
+```
-- Header verification via skipping verification light client
-- Delegated staking with multi-validator split
-- Auto-compound rewards with configurable intervals
-- Reputation-aware validator rebalancing
-- Real-time network telemetry
-- On-chain registration with heartbeat liveness proofs
-- 3% block reward eligibility for active light nodes
-- Post-quantum cryptography support
-- Interactive onboarding wizard
-- Local-only mode for pre-mainnet testing
-- Live PQC self-test command
+### Docker
+
+```bash
+docker compose up lightnode-sx # server edition
+docker compose up lightnode-ux # dashboard edition (port 8080)
+```
+
+### Verify the PQC stack any time
+
+```bash
+lightnode-sx selftest
+```
+
+Runs 5 checks: keygen, sign, verify-valid, reject-tampered-sig, reject-tampered-msg.
+
+## Additional Documentation
+
+- [Installation Guide](./INSTALLATION_GUIDE.md)
+- [FAQ](./FAQ.md)
+- [Community Notes](./COMMUNITY_NOTES.md)
+- [Operator Journal](./OPERATOR_JOURNAL.md)
+- [Example Configuration](./config.example.toml)
+
+## Configuration
+
+See `config.example.toml` for available example options. Always verify network values against current official QoreChain sources before using them in production.
+
+## License
----
\ No newline at end of file
+Apache 2.0
From db91c67a49b159793acfcee08eb13f1295200dc8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:35:20 +0300
Subject: [PATCH 10/13] Make installation guide upstream neutral
---
INSTALLATION_GUIDE.md | 18 +++++++-----------
1 file changed, 7 insertions(+), 11 deletions(-)
diff --git a/INSTALLATION_GUIDE.md b/INSTALLATION_GUIDE.md
index f64c2e6..9732555 100644
--- a/INSTALLATION_GUIDE.md
+++ b/INSTALLATION_GUIDE.md
@@ -1,8 +1,8 @@
# QoreChain Light Node Installation Guide
-This guide explains the basic setup flow for running a QoreChain Light Node from this fork.
+This guide explains the basic setup flow for running a QoreChain Light Node.
-> Maintained by **Satoshi-Qore** as part of QoreChain community support and infrastructure learning.
+> This is a community documentation contribution. Always check official QoreChain sources and current announcements for production instructions.
---
@@ -16,17 +16,19 @@ Before starting, make sure your system has:
- Git installed
- Basic terminal access
-For VPS usage, Ubuntu is recommended for beginners.
+For VPS usage, Ubuntu is commonly used by beginners.
---
## 2. Clone the Repository
```bash
-git clone https://github.com/satoshi-Qore/qorechain-lightnode.git
+git clone https://github.com/qorechain/qorechain-lightnode.git
cd qorechain-lightnode
```
+If you are testing changes from a fork, replace the repository URL with the fork URL.
+
---
## 3. Build the Light Node
@@ -123,10 +125,4 @@ This verifies that the post-quantum cryptography stack is working correctly.
## 10. Notes
-This guide is intended for community learning and support. Always check the official QoreChain documentation and repository for the latest production instructions.
-
-Official repository:
-
-```text
-https://github.com/qorechain/qorechain-lightnode
-```
+This guide is intended for learning and operator onboarding. Network-specific values such as RPC endpoints, chain IDs, ports, and production settings should be verified against current official QoreChain sources before use.
From f3765bf4783fff24107fc846339f35506bdeffbc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:35:24 +0300
Subject: [PATCH 11/13] Make FAQ safer for pre-mainnet state
---
FAQ.md | 21 ++++++++++++++-------
1 file changed, 14 insertions(+), 7 deletions(-)
diff --git a/FAQ.md b/FAQ.md
index 8521e80..35e348d 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -7,14 +7,13 @@ Possible reasons:
- Dashboard cache
- Transaction indexing not completed yet
-## Why does a light node require 1000 QOR?
+Wait a short time, refresh the dashboard, and verify the transaction status using the currently recommended explorer or official community instructions.
-The stake helps:
-- Prevent Sybil attacks
-- Align operators with network success
-- Support responsible participation
+## Where can I find the correct RPC endpoint?
-The stake is locked while operating and can be recovered when the node is shut down.
+Use the official QoreChain documentation, repository notes, or current team announcements for the latest RPC endpoint and chain configuration values.
+
+Avoid relying on old screenshots, cached messages, or unverified third-party endpoint lists.
## Why is X verification failing?
@@ -22,11 +21,19 @@ Common causes:
- Verification performed too late
- Post not indexed yet
- Verification steps completed out of order
+- Account or post visibility settings preventing verification
+
+Repeat the steps carefully and allow time for indexing before retrying.
## Dashboard not loading?
Check:
-- Port 8420 accessibility
+- Expected dashboard port
- Container status
- Firewall configuration
- Docker logs
+- Whether the node is running in local-only mode
+
+## Should I use these notes for production setup?
+
+Treat this FAQ as community onboarding help. For production or mainnet-sensitive steps, confirm all values with official QoreChain sources first.
From e35dde975e5cfa4e818080914c6cfa291c1917b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:35:28 +0300
Subject: [PATCH 12/13] Use placeholder RPC endpoint in example config
---
config.example.toml | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/config.example.toml b/config.example.toml
index 9ec44e8..92e6e04 100644
--- a/config.example.toml
+++ b/config.example.toml
@@ -1,10 +1,10 @@
# QoreChain Light Node example configuration
[network]
-# Replace with the official QoreChain RPC endpoint when available.
-rpc_endpoint = "https://rpc.qorechain.io:26657"
+# Replace this placeholder with the current official QoreChain RPC endpoint.
+rpc_endpoint = ""
-# Leave empty or adjust according to the active network.
+# Set this according to the active network configuration.
chain_id = ""
[node]
From 210e2f29d73ce3c533bb51288eba391a0d994b03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Satoshi=20Qore=20=E2=9A=9B?=
<98336779+satoshi-Qore@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:36:04 +0300
Subject: [PATCH 13/13] Remove personal banner from upstream PR
---
assets/qorechain-lightnode-banner.svg | 80 ---------------------------
1 file changed, 80 deletions(-)
delete mode 100644 assets/qorechain-lightnode-banner.svg
diff --git a/assets/qorechain-lightnode-banner.svg b/assets/qorechain-lightnode-banner.svg
deleted file mode 100644
index 168099d..0000000
--- a/assets/qorechain-lightnode-banner.svg
+++ /dev/null
@@ -1,80 +0,0 @@
-
+