@@ -11,7 +11,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯一的定制是 * * `-DWITH_MERGE_MINING_DONATION=OFF` **(禁用合并挖矿捐赠),不改源码。
p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯一的定制是 * * `-DWITH_MERGE_MINING_DONATION=OFF` **(禁用合并挖矿捐赠),不改源码。
> **与同目录 `gitea-xxxig` / `gitea-xxxig-proxy` / `gitea-mond` 的关系**:四者共享同一套 CI / build-deb / debian 打包骨架,且均为 **musl fully-static** 构建。差异:xxxig 系是 XMRig 换名仓库源码;mond 克隆 Monero 官方靠 init.sh 现场换名;p2pool 直接构建官方源码、不换名,版本号纯数字(`4.16 `,上游 git tag 带 v、构建时补回)。
> **与同目录 `gitea-xxxig` / `gitea-xxxig-proxy` / `gitea-mond` 的关系**:四者共享同一套 CI / build-deb / debian 打包骨架,且均为 **musl fully-static** 构建。差异:xxxig 系是 XMRig 换名仓库源码;mond 克隆 Monero 官方靠 init.sh 现场换名;p2pool 直接构建官方源码、不换名,版本号纯数字(`4.17 `,上游 git tag 带 v、构建时补回)。
## 整体架构:单二进制
## 整体架构:单二进制
@@ -32,7 +32,7 @@ p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯
- **WITH_GRPC=ON(支持 Tari 合并挖矿,勿改回 OFF)**:上游 CMake 默认即 ON(官方 alpine static job 为省体积改 OFF,本项目恢复 ON)。ON 时 `cmake/grpc.cmake` 用 `add_subdirectory(external/src/grpc)` 自动静态编译 grpc/protobuf/abseil/re2/cares,并 `add_subdirectory(external/src/Tari)` 编 checked-in 的 Tari proto( `.pb.cc` ,不需运行时 protoc),链接 `Tari_gRPC grpc grpc++ libprotobuf` 。这样 `tari://` 主机走 `MergeMiningClientTari` ( gRPC)而非 `MergeMiningClientJSON_RPC` ( JSON-RPC,与 Tari 不兼容、报 `empty response` )。代价:二进制 ~5MB→~15MB(`-Wl,-s --gc-sections` 剔除未用 grpc/xDS 代码后远小于全量)、构建 +约 15min/arch。曾为省体积误用 `WITH_GRPC=OFF` 致无法与 Tari 合并挖矿,**已改回 ON,勿回退**。
- **WITH_GRPC=ON(支持 Tari 合并挖矿,勿改回 OFF)**:上游 CMake 默认即 ON(官方 alpine static job 为省体积改 OFF,本项目恢复 ON)。ON 时 `cmake/grpc.cmake` 用 `add_subdirectory(external/src/grpc)` 自动静态编译 grpc/protobuf/abseil/re2/cares,并 `add_subdirectory(external/src/Tari)` 编 checked-in 的 Tari proto( `.pb.cc` ,不需运行时 protoc),链接 `Tari_gRPC grpc grpc++ libprotobuf` 。这样 `tari://` 主机走 `MergeMiningClientTari` ( gRPC)而非 `MergeMiningClientJSON_RPC` ( JSON-RPC,与 Tari 不兼容、报 `empty response` )。代价:二进制 ~5MB→~15MB(`-Wl,-s --gc-sections` 剔除未用 grpc/xDS 代码后远小于全量)、构建 +约 15min/arch。曾为省体积误用 `WITH_GRPC=OFF` 致无法与 Tari 合并挖矿,**已改回 ON,勿回退**。
- **boringssl 来源**: `WITH_GRPC=ON` 时由 grpc 子模块(`third_party/boringssl-with-bazel` )提供,grpc.cmake 走此分支、**不再** `add_subdirectory(cmake/ssl)` (那是 `elseif (WITH_TLS)` 分支);p2pool 主体 TLS 与下方 curl 共用这一份 boringssl。
- **boringssl 来源**: `WITH_GRPC=ON` 时由 grpc 子模块(`third_party/boringssl-with-bazel` )提供,grpc.cmake 走此分支、**不再** `add_subdirectory(cmake/ssl)` (那是 `elseif (WITH_TLS)` 分支);p2pool 主体 TLS 与下方 curl 共用这一份 boringssl。
- **curl 用 boringssl TLS(保留 rpc-ssl,勿改回 no-SSL) **:完整照搬官方 `c-cpp.yml` 的 curl flags——`P2POOL_BORINGSSL=ON` (上游给 curl 的独立 boringssl 后端补丁,与 `CURL_ENABLE_SSL=OFF` 共存、不走 curl 标准 SSL 路径)+ 一整套 `CURL_DISABLE_*` (尤其 `SRP` /`AWS` /`*_AUTH` )。后者跳过会引用 `OpenSSL::SSL` imported target 的 `curl_openssl_check_exists` 符号检测(新版 cmake 在 `try_compile` 阶段校验该 target 必失败,**少一个 disable 都会触发**)。curl 与 p2pool 主体共用同一 boringssl, `json_rpc_request` 的 `CURLOPT_SSL_CTX_FUNCTION` 才能接管证书指纹校验——**`--rpc-ssl` /`--rpc-ssl-fingerprint` 连外部 SSL monerod 的能力得以保留**(已实测连真实 SSL 节点用 `--rpc-ssl` 拿到链上高度)。曾误用 no-SSL curl 会断此能力,勿回退。
- **curl 用 boringssl TLS(保留 rpc-ssl,勿改回 no-SSL) **:完整照搬官方 `c-cpp.yml` 的 curl flags——`P2POOL_BORINGSSL=ON` (上游给 curl 的独立 boringssl 后端补丁,与 `CURL_ENABLE_SSL=OFF` 共存、不走 curl 标准 SSL 路径)+ 一整套 `CURL_DISABLE_*` (尤其 `SRP` /`AWS` /`*_AUTH` )。后者跳过会引用 `OpenSSL::SSL` imported target 的 `curl_openssl_check_exists` 符号检测(新版 cmake 在 `try_compile` 阶段校验该 target 必失败,**少一个 disable 都会触发**)。curl 与 p2pool 主体共用同一 boringssl, `json_rpc_request` 的 `CURLOPT_SSL_CTX_FUNCTION` 才能接管证书指纹校验——**`--rpc-ssl` /`--rpc-ssl-fingerprint` 连外部 SSL monerod 的能力得以保留**(已实测连真实 SSL 节点用 `--rpc-ssl` 拿到链上高度)。曾误用 no-SSL curl 会断此能力,勿回退。
- **版本号约定**:包版本硬编码在 ci.yaml 的 `PACKAGE_VERSION: "4.16 "` (**纯数字、无 v**,符合 Debian 版本规范)。**关键分界**:上游 p2pool git tag 带 `v` ,故 build job 用 `P2POOL_VERSION="v${PACKAGE_VERSION}"` 补回 v 传给 Dockerfile `git checkout` ; tar.gz / deb / registry 路径 / Release 标题等包版本一律直接用 `${PACKAGE_VERSION}` ; release job 用 `VERSION="${TAG#v}"` 归一(tag 带不带 v 都兼容,唯 Release 的 `tag_name` 用 git tag 原值)。CI 触发条件 `tags: ['*']` ,发版改 `PACKAGE_VERSION` 并打对应 tag(纯数字,如 `4.16 ` )。
- **版本号约定**:包版本硬编码在 ci.yaml 的 `PACKAGE_VERSION: "4.17 "` (**纯数字、无 v**,符合 Debian 版本规范)。**关键分界**:上游 p2pool git tag 带 `v` ,故 build job 用 `P2POOL_VERSION="v${PACKAGE_VERSION}"` 补回 v 传给 Dockerfile `git checkout` ; tar.gz / deb / registry 路径 / Release 标题等包版本一律直接用 `${PACKAGE_VERSION}` ; release job 用 `VERSION="${TAG#v}"` 归一(tag 带不带 v 都兼容,唯 Release 的 `tag_name` 用 git tag 原值)。CI 触发条件 `tags: ['*']` ,发版改 `PACKAGE_VERSION` 并打对应 tag(纯数字,如 `4.17 ` )。
- 架构映射:Dockerfile 内 `arm64→ARCH_ID=aarch64` 、`amd64→ARCH_ID=x86_64` (传给 p2pool cmake,控制 RandomX 优化)。
- 架构映射:Dockerfile 内 `arm64→ARCH_ID=aarch64` 、`amd64→ARCH_ID=x86_64` (传给 p2pool cmake,控制 RandomX 优化)。
- tar.gz 下载 URL 形如 `https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/{version}/p2pool-{arch}-linux-static-{version}.tar.gz` ( version 为纯数字)。
- tar.gz 下载 URL 形如 `https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/{version}/p2pool-{arch}-linux-static-{version}.tar.gz` ( version 为纯数字)。
@@ -41,7 +41,7 @@ p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯
``` bash
``` bash
# 本地编译某架构的二进制(输出到 ./output/linux_<arch>/p2pool)
# 本地编译某架构的二进制(输出到 ./output/linux_<arch>/p2pool)
docker buildx build --platform linux/amd64 \
docker buildx build --platform linux/amd64 \
--build-arg P2POOL_VERSION = v4.16 \
--build-arg P2POOL_VERSION = v4.17 \
--output type = local,dest= ./output \
--output type = local,dest= ./output \
-f docker/Dockerfile .
-f docker/Dockerfile .
@@ -49,7 +49,7 @@ docker buildx build --platform linux/amd64 \
ldd output/linux_amd64/p2pool
ldd output/linux_amd64/p2pool
# 用已有 tar.gz 打 .deb 包(第三个参数是 tar.gz)
# 用已有 tar.gz 打 .deb 包(第三个参数是 tar.gz)
./debian/build-deb.sh amd64 4.16 p2pool-amd64-linux-static-4.16 .tar.gz
./debian/build-deb.sh amd64 4.17 p2pool-amd64-linux-static-4.17 .tar.gz
```
```
无单元测试;CI 唯一冒烟是解包后跑 `p2pool --help` ( musl 纯静态可在 glibc runner 直接运行),并用 `ldd` 校验为纯静态。
无单元测试;CI 唯一冒烟是解包后跑 `p2pool --help` ( musl 纯静态可在 glibc runner 直接运行),并用 `ldd` 校验为纯静态。