Skip to content

docs: add FAQ.md (merged mining, address autoconversion, payouts, dashboard) - #678

Merged
frstrtr merged 2 commits into
masterfrom
docs/faq-merged-mining-payouts
Jul 12, 2026
Merged

docs: add FAQ.md (merged mining, address autoconversion, payouts, dashboard)#678
frstrtr merged 2 commits into
masterfrom
docs/faq-merged-mining-payouts

Conversation

@frstrtr

@frstrtr frstrtr commented Jul 12, 2026

Copy link
Copy Markdown
Owner

What

Adds docs/FAQ.md answering common operator questions raised by a downstream pool operator running ./c2pool, plus a FAQ pointer in the README.

Questions covered (code-verified answers)

  1. 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 (AuxPoW createauxblock/submitauxblock). Registry: DOGE 98, PEP 63, BELLS 16, LKY 8211, JKC 8224, SHIC 74.

  2. 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 (--merged is AuxPoW-only). In c2pool DGB-Scrypt is its own parent chain (--net digibyte), in development — not embedded-SPV-under-LTC, not a merged child.

  3. 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 hash160 for p2pkh / p2wpkh / p2sh, but not p2wsh / p2tr. Covers swap auto-correction, reverse-derivation, and explicit /chain_id:ADDR / separator / mining.set_merged_addresses overrides. Mode-by-mode payout table.

  4. Dashboard — built in, served at http://localhost:8080/ (web-static/); optional explorer/explorer.py on :9090. References the missing-doc tracking issue.

Related

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.

frstrtr added 2 commits July 12, 2026 15:53
…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.
@frstrtr
frstrtr merged commit 945e1b3 into master Jul 12, 2026
28 checks passed
@frstrtr
frstrtr deleted the docs/faq-merged-mining-payouts branch July 12, 2026 12:23
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.

1 participant