docs: add FAQ.md (merged mining, address autoconversion, payouts, dashboard) - #678
Merged
Conversation
…hboard) Answers common operator questions surfaced by a downstream pool operator: - adding merged coins via --merged COIN:chain_id:host:port:user:pass (LTC/DOGE embedded SPV; others via external AuxPoW daemon) - DGB-Scrypt as a merged child under LTC (daemon) vs the planned embedded-SPV DGB parent (--net digibyte) - payout model: no wallet in c2pool; coinbase pays the miner's own address; single primary address auto-derives merged payouts (conditional on p2pkh/ p2wpkh/p2sh; not p2wsh/p2tr) with explicit slash/separator overrides - dashboard is built in and served at :8080 (web-static/); optional explorer Links the missing docs/DASHBOARD_INTEGRATION.md to tracking issue #677. Adds a FAQ pointer to README.
…d child DGB has no AuxPoW chain ID and cannot be merge-mined under LTC. It secures its own chain via MultiAlgo (Scrypt, SHA-256d, Qubit, Skein, Odocrypt), each mined directly on the DGB main chain with independent difficulty. --merged is AuxPoW-only (DOGE/PEP/BELLS/LKY/JKC/SHIC). In c2pool DGB-Scrypt is its own parent chain (--net digibyte), in development — never an aux child.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
docs/FAQ.mdanswering common operator questions raised by a downstream pool operator running./c2pool, plus a FAQ pointer in the README.Questions covered (code-verified answers)
Adding merged coins — runtime flag, not code. LTC + DOGE are embedded SPV (daemonless, DOGE auto-on); other aux chains via
--merged COIN:chain_id:host:port:user:pass(AuxPoWcreateauxblock/submitauxblock). Registry: DOGE 98, PEP 63, BELLS 16, LKY 8211, JKC 8224, SHIC 74.DigiByte — DGB is MultiAlgo (Scrypt, SHA-256d, Qubit, Skein, Odocrypt), secures its own chain directly, has no AuxPoW chain ID, and cannot be merge-mined as a child of LTC (
--mergedis AuxPoW-only). In c2pool DGB-Scrypt is its own parent chain (--net digibyte), in development — not embedded-SPV-under-LTC, not a merged child.Payouts / funds under SPV — c2pool holds no wallet; coinbase pays the miner's own address. Documents the conditional address autoconversion: a single primary address auto-derives every merged-chain payout from the shared
hash160for p2pkh / p2wpkh / p2sh, but not p2wsh / p2tr. Covers swap auto-correction, reverse-derivation, and explicit/chain_id:ADDR/ separator /mining.set_merged_addressesoverrides. Mode-by-mode payout table.Dashboard — built in, served at
http://localhost:8080/(web-static/); optionalexplorer/explorer.pyon :9090. References the missing-doc tracking issue.Related
docs/DASHBOARD_INTEGRATION.mdREADME link tracked in docs: README links docs/DASHBOARD_INTEGRATION.md but the file is missing (broken link) #677.Verification
Checked against source —
src/core/stratum_server.cpp(MERGED_CHAINS + address parse/auto-derive/swap/Case-5),src/c2pool/merged/merged_mining.cpp(aux daemon RPC),src/c2pool/main_dgb.cpp(DGB parent, in-dev), README defaults. DGB AuxPoW correction per maintainer. Docs-only — no code paths touched.