bch: bootstrap src/impl/bch skeleton (M2)

src/impl/bch/CMakeLists.txt

@@ -0,0 +1,12 @@
+# c2pool-bch coin module (V36). Built when -DCOIN_BCH=ON.
+# Mirrors src/impl/btc/CMakeLists.txt; emits the c2pool-bch binary.
+# Per-coin binary scheme: project_v36_per_coin_binary_v37_unified_process.
+#
+# TODO(M3): add_library(impl_bch ...) sources, link bitcoin_family shared base,
+# wire embedded BCHN daemon slice under daemon/. Stub only at M2.
+if(COIN_BCH)
+  message(STATUS "c2pool: BCH coin module enabled (skeleton)")
+  # add_subdirectory(coin)
+  # add_subdirectory(daemon)
+  # add_subdirectory(test)
+endif()

src/impl/bch/coin/header_chain.hpp

@@ -0,0 +1,8 @@
+#pragma once
+// BCH header-chain validation. Mirrors src/impl/btc/coin/header_chain.hpp.
+//
+// >>> ASERT INSERTION POINT (M1 §4.3) <<<
+// BCH uses ASERT (aserti3-2d) difficulty adjustment since the Nov 2020
+// upgrade, NOT BTC retarget. Net-new c2pool code (one of two BCH-specific
+// validation slices). TODO(M3): port aserti3-2d target calc + anchor block.
+namespace c2pool::bch { /* TODO(M3): HeaderChain w/ ASERT validate_target() */ }

src/impl/bch/coin/template_builder.hpp

@@ -0,0 +1,13 @@
+#pragma once
+// BCH block-template builder. Mirrors src/impl/btc/coin/template_builder.hpp.
+// Must emit p2pool-merged-v36-compatible templates (V36 master compat).
+//
+// >>> CTOR INSERTION POINT (M1 §4.3) <<<
+// BCH requires CTOR: canonical (lexicographic txid) ordering of mempool txs
+// in the block body, coinbase first. Net-new c2pool code (second BCH slice).
+// TODO(M3): CTOR re-sort pass over selected txs before template assembly.
+//
+// CashTokens (May 2023) awareness: token-bearing outputs must round-trip
+// intact through template assembly. TODO(M3): preserve token prefix bytes.
+// HogEx: NOT applicable (see config_coin.hpp scope note).
+namespace c2pool::bch { /* TODO(M3): TemplateBuilder w/ CTOR re-sort */ }

src/impl/bch/config_coin.hpp

@@ -0,0 +1,23 @@
+#pragma once
+// c2pool-bch :: BCH coin parameters (V36)
+// Skeleton per c2pool-bch-embedded-impl-plan.md (frstrtr/the docs/v36) §3.
+// Embedded daemon forked from Bitcoin Cash Node (BCHN). SHA256d family.
+//
+// SCOPE NOTE (M1 §4.2): HogEx is a SmartBCH sidechain construct, NOT BCH
+// mainchain. It is explicitly OUT OF SCOPE for this template/coin module.
+// Do not add HogEx commitment handling here. See feedback: hogex-not-bch.
+//
+// CashAddr scaffolding: BCH address encoding diverges from BTC base58/bech32.
+// TODO(M3): port CashAddr (prefix "bitcoincash:") encode/decode at vendoring.
+
+namespace c2pool::bch {
+
+struct CoinParams {
+    // TODO(M3): fill from BCHN chainparams at vendoring (confirm commit/tag).
+    static constexpr const char* ticker      = "BCH";
+    static constexpr const char* cashaddr_hrp = "bitcoincash";
+    // ASERT DAA (May 2020) anchor — see coin/header_chain.hpp insertion point.
+    // CTOR (Nov 2018) canonical tx ordering — see coin/template_builder.hpp.
+};
+
+} // namespace c2pool::bch

src/impl/bch/daemon/README.txt

@@ -0,0 +1,5 @@
+Embedded BCHN daemon slice (M3). Forked from Bitcoin Cash Node, lowest
+divergence from Bitcoin Core (same root as c2pool-btc embedded daemon).
+Vendoring policy: NO in-tree vendor of BCHN; reference clone built siblingly,
+artifacts into worktree only (M1 §1.1). Scope: SPV + P2P + mempool + template
+builder. Confirm BCHN commit/tag at vendoring. Stub placeholder at M2.

src/impl/bch/test/README.txt

@@ -0,0 +1,3 @@
+BCH module tests (M3). Mirror src/impl/btc/test: template_parity_test (vs
+p2pool-merged-v36 reference fixtures), share_test. Adds: ASERT vector test,
+CTOR ordering test, CashAddr round-trip. Stub placeholder at M2.