Skip to content

Implement Falcon-based authentication and Implement SOLO Localhost mining#25

Open
NamecoinGithub wants to merge 2417 commits into
Nexusoft:masterfrom
NamecoinGithub:MINER
Open

Implement Falcon-based authentication and Implement SOLO Localhost mining#25
NamecoinGithub wants to merge 2417 commits into
Nexusoft:masterfrom
NamecoinGithub:MINER

Conversation

@NamecoinGithub

Copy link
Copy Markdown

This is a PR request targeting Testnet, so it can possibly be integrated with Upstream Codebase bringing New Upgraded Features in the Future, alongside the reliable and good designed Base Architecture.

I built a Nexus Interface .deb for Linux with the Stateless Mining Server NODE built in.

The testing should allow the GUI to Stake and Mine at the same time. However the Command Line LLL-TAO is a better/required option for real Pool Nodes, but the GUI is good for someone who can Stake and Mine at the same time using CPU. GPU testing and support for Miner will come later!

CPU Mining is Solid without any errors for weeks of Mining. Although it's just CPU mining available in the build, it's the PROCESS that is in a near term Refined finished state.

UPGRADED FALCON 512 TO == FALCON 1024 default keys for Signing are still Falcon512, but default keys for MINER-NODE handshake is Falcon1024. Whatever the MINER keys in will also be the same size for it's Block Found Submit Disposable Falcon Size either Falcon512 or Falcon1024.

Legacy Server 8 Bit OPCODES and Stateless Server is 16 Bit Opcodes

CREATE NEW TRITIUM POW STATELESS MINING SERVER with FALCON AUTH ++++++++ FALCON 1024 Bit DEFAULT for DISPOSABLE FALCON

MINIMAL NON-TESTED Remote Node POOL DISCOVERY BUILT IN

MINIMAL SOLO MINING WORKING/POLISHED BUT COLIN CANTRELL WILL INSERT/DELETE TO FIT THE PURPOSE, 95% OF THE TOTAL WORK/CODING IS FINISHED/ Nexusoft/LLL-TAO#1 I STAYED IN MY LANE OF DEALING WITH ONLY MINING INFRASTRUCTURE CODE WITHIN NODE. AND CREATED MY OWN STATELESS MINING UTILITY WORKSHOP, AND MANY CONSTANTS UTILITIES ALONG WITH AAD, OPENSSL EVP DOMAINS, MANY AWESOME OTHER UPGRADES.

FULL DOCUMENTATION SECTIONS, STILL NEEDS FINAL POLISH, WORK. MOST OF THE CODE IS FROM A WHOLE HOST OF TRIAL AND ERROR TO LEARN ABOUT NEXUS CODEBASE. BUT I LEARNED THE HARD WAY, SO NO ONE ELSE HAS TO FIGURE IT OUT THEMSELVES. FOR THIS I CREATED A HUGE REPOSITORY OF DOCUMENTS WITH CROSS-REFERENCED LINKS, FOR BOTH CONFIG OPTIONS AND NEXUSMINER TIE-INS FOR CODE KEYWORDS.

NexusMiner TOML config is a incredible upgrade over JSON Miner Parsing.

The Release Miner has the cpu.config file included.

Command Line Linux is Capitalization sensitive.

Open Terminal where the Miner is located AFTER the Nexus NODE is started with Autologin.

Miner Directory
start the miner=

./NexusMiner cpu.config

Screenshot from 2026-06-16 13-02-20

This pull request introduces a comprehensive developer experience overhaul for the Nexus LLL-TAO project, focusing on modernizing the build, development, and CI/CD infrastructure. The main changes include adding DevContainer support, improved build and test documentation, streamlined CI workflows for both Linux and Windows, and explicit dependency management. These updates make it much easier for developers (and GitHub Copilot agents) to set up, build, test, and contribute to the project in a reproducible way.

Key changes by theme:

DevContainer and Local Development Environment:

  • Added a complete .devcontainer/devcontainer.json for VSCode DevContainer support, specifying Ubuntu 22.04, required features, port forwarding, and recommended VSCode extensions/settings. This enables one-command reproducible development environments.
  • Introduced .devcontainer/setup.sh to automate dependency installation, environment validation (including Berkeley DB check), workspace permissions, and provide clear post-setup instructions.

Build and Dependency Documentation:

  • Added .github/copilot-instructions.md with detailed build, dependency, and testing instructions, including troubleshooting and code modification guidelines for both Linux and macOS.
  • Added .github/copilot-instructions.yml to explicitly declare build/test requirements and dependencies for Copilot agents and CI.

Continuous Integration and Validation Workflows:

  • Added .github/workflows/devcontainer-validate.yml to automatically build, test, and validate the project in a CI environment, ensuring that the codebase is always buildable and testable from a clean state.
  • Added .github/workflows/copilot-setup-steps.yml for dependency installation validation, supporting both manual and PR-triggered runs.
  • Added .github/workflows/release-windows-node.yml to build, package, and upload a portable Windows node binary using MSYS2/MinGW, facilitating cross-platform releases.

Project Metadata and Templates:

  • Added a LICENSE file (MIT License) for clear open-source licensing.
  • Added .github/PULL_REQUEST_TEMPLATE_AGENT.md to standardize PR descriptions for coding agents, improving reviewability and clarity.

Cleanup:

  • Removed the old Dockerfile for the previous Debian-based build, as the new DevContainer setup supersedes it.

These changes collectively modernize the developer workflow, improve onboarding, and ensure robust, repeatable builds and tests across platforms.

Working Releases for Localhost CPU mining without any bugs 2 full weeks of Continuous Mining, only STALE blocks are rejected.

https://github.com/NamecoinGithub/NexusMiner/releases

https://github.com/NamecoinGithub/LLL-TAO/releases

Merging isn't required for me to keep developing, but Months of Review is expected!

Thanks!

NamecoinGithub and others added 30 commits April 16, 2026 01:10
…from NamecoinGithub/copilot/fix-read-idle-timeout-and-cache-limit

Implement Phase 5-6 acceptance coverage and harden SessionBinding/session-loss flow
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/a63cea55-2189-40f8-81d0-f31f6bd20111

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/a63cea55-2189-40f8-81d0-f31f6bd20111

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/25bad752-d73b-4f95-9bd2-5d3d5e451a45

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/9f31a8c5-6d48-48c1-b12a-644f8103c1a9

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/7d46f3ec-7ec4-4413-972c-89b6abfad3c8

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/db4a0ac3-3d42-4df1-9fc6-d92b14c537fa

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/2d66c240-fdbf-4a18-a33e-318ef3317fe6

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…d lane #637 from NamecoinGithub/copilot/refactor-lane-connection-flows

Align NodeSession and failover semantics to a single active configured lane
…time+push-silence guard

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/cf4e0a94-0919-4f8b-bd41-e3e07f199590

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…time+push-silence guard #638 from NamecoinGithub/copilot/fix-unanswered-rounds-counter

Fix phantom GET_ROUND shadow-ban: move counter to post-transmit, add time+push-silence guard
…parser, fix auth transmit check, fix mock interface

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/0d02f082-3a46-433c-850e-28b7a12eb850

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…nify RX parser, harden auth transmit #639 from NamecoinGithub/copilot/task-130555019-1094756333-c001ba24-6c29-45f6-ad2c-2fec2ae85eb3

NodeSession: remove stale Session_lane block left by PR #637 merge, unify RX parser, harden auth transmit
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/eeb86ddf-77d9-43b7-abaf-ed033793ea34

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…n; add 5 regression tests

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/386a2516-b77b-4e81-87c4-c126a4d2af46

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…+ log-level hardening) #640 from NamecoinGithub/copilot/fix-malformed-packet-logs

Fix malformed-packet burst after stateless block acceptance (framing + log-level hardening)
…ative-local-recovery-mismatch

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/d8e487eb-b88b-41e9-bee6-beea926ed4c9

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…e from template refresh #641 from NamecoinGithub/copilot/fix-authoritative-local-recovery-mismatch

Make session recovery authoritative-first and separate session restore from template refresh
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/4906ce01-4185-4dc8-8a1c-c16011844ace

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…#642 from NamecoinGithub/copilot/fix-recovery-logic-degraded-mode

Align branch with PR #641 and harden Copilot setup cache path handling
…essions

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/e5591947-c39c-4574-8345-49bdccb6066f

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/5fb75219-b06e-451e-96e4-b6d56357606b

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…ntation #643 from NamecoinGithub/copilot/audit-gpu-workers-classes

Harden GPU worker correctness and align GPU support docs with implementation
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/71e1dbdf-8f92-42f1-8cd0-3a69846cc61c

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Copilot AI and others added 28 commits May 10, 2026 05:40
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/e9305d2a-4e7c-49a8-a4e9-ef3d382c3611

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
… when recent PUSH already implies BLOCK_DATA in flight #696 from NamecoinGithub/copilot/fix-redundant-get-block-issue

Suppress redundant GET_BLOCK on GET_ROUND stake/cross-channel advance when recent PUSH already implies BLOCK_DATA in flight
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/d346c7bf-09dd-4916-8b28-68ca4be72c47

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/3a3ba2fe-8538-46e7-a3ab-8fa9382ae88a

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/3a3ba2fe-8538-46e7-a3ab-8fa9382ae88a

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…IME backend/toolchain fixes #697 from NamecoinGithub/copilot/research-linux-cross-compilation

Add Windows release pipeline and MinGW cross-compilation path with PRIME backend/toolchain fixes
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/7949c134-effa-4fe8-965c-04c82021153e

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…ilot/research-miner-bug-investigation

Throttle miner GET_BLOCK recovery storms
…inGithub/revert-698-copilot/research-miner-bug-investigation

Revert PR #698 "Throttle miner GET_BLOCK recovery storms"
…+ NEW_ROUND×PUSH race guard

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/76d93072-67c0-4e83-9f97-c4d7128bcdf2

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…D×PUSH race guard #701 from NamecoinGithub/copilot/research-codebase-bug-fixes

Fix BLOCK_DATA/GET_BLOCK storm: single recovery chokepoint + NEW_ROUND×PUSH race guard
Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/9d3bc407-e8ef-4a4f-b453-c3a6125f72a3

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…#702 from NamecoinGithub/copilot/fix-push-staleness-telemetry

Make recovery epoch escalation reason-aware for soft GET_BLOCK retries
…sit guard

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/091e7d65-302a-4b19-acfd-53907a02897c

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…clarity

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/091e7d65-302a-4b19-acfd-53907a02897c

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
… adoption on Prime #703 from NamecoinGithub/copilot/fix-soft-duplicate-block-data

Eliminate residual soft duplicate GET_BLOCK/BLOCK_DATA after template adoption on Prime
…uce duplicate template churn #704 from NamecoinGithub/copilot/fix-dupe-block-data-traffic

Tune NEW_ROUND recovery debounce and GET_ROUND polling cadence to reduce duplicate template churn
…e time

Agent-Logs-Url: https://github.com/NamecoinGithub/NexusMiner/sessions/0201af9c-d4ec-4229-b8b8-2f4c23158ea5

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…s in transit #705 from NamecoinGithub/copilot/research-push-cancellation-logic

Solo: suppress NEW_ROUND recovery GET_BLOCK at timer fire when PUSH is in transit
…length helper

Extend PrimeMiningEngine::run_pool_thread rebind gate to also fire when
session->nbits changes without a base_hash change (rare singleflight
waiter race at difficulty retarget).  Without this, the sieve continues
with the previous target_length and silently drops candidates.

Add a reason= field to the rebind diagnostic log so operators can grep
for the nbits-only case.

Centralise the ceil(nbits/1e7) derivation into
mining::derive_target_length() so CPU and GPU cannot drift apart.

Co-authored-by: NamecoinGithub <130555019+NamecoinGithub@users.noreply.github.com>
…m NamecoinGithub/copilot/a44e71ef-3448-4cb2-80a9-f38bed797e7c

Fix stale target_length when nbits changes on same base_hash
Copilot AI review requested due to automatic review settings June 16, 2026 13:06

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants