diff --git a/CLAUDE.md b/CLAUDE.md index 50b3658..0f88034 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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`**(禁用合并挖矿捐赠),不改源码。 -> **与同目录 `gitea-xxxig` / `gitea-xxxig-proxy` / `gitea-mond` 的关系**:四者共享同一套 CI / build-deb / debian 打包骨架,且均为 **musl fully-static** 构建。差异:xxxig 系是 XMRig 换名仓库源码;mond 克隆 Monero 官方靠 init.sh 现场换名;p2pool 直接构建官方源码、不换名,版本号纯数字(`4.18`,上游 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.18.1`,上游 git tag 带 v、构建时补回)。 ## 整体架构:单二进制 @@ -29,10 +29,10 @@ Gitea Actions 拆成两条独立流水线: - **为何用 musl 而非 glibc**:musl 的 `getaddrinfo` 自带实现,全静态也能解析 DNS;glibc 静态会因 NSS 运行时 `dlopen` 失败。与 `gitea-xxxig`/`gitea-xxxig-proxy`/`gitea-mond` 一致。曾用的 `Dockerfile.ubuntu`(glibc 动态)与 `Dockerfile.alpine`(动态链 system 库)均已删除。 - **依赖处理(关键,勿乱改)**: - external 依赖**子模块自带源码**,逐个编静态(`BUILD_SHARED_LIBS=OFF` 等)。拉 8 个常规子模块 + grpc 及其 **6 个必需 third_party**(`abseil-cpp`/`boringssl-with-bazel`/`cares`/`protobuf`/`re2`/`zlib`);其余 9 个 grpc 子模块(benchmark/googletest/envoy/googleapis/xds 等测试或 xDS 依赖,已 `GRPC_NO_XDS`)**跳过**省体积/时间。 - - **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,勿回退**。上游 v4.18.1 换用新 Tari 数据格式,合并挖矿需 Tari 节点 v6.0.0+。 - **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 会断此能力,勿回退。 -- **版本号约定**:根目录 [VERSION](VERSION) 是唯一版本来源,内容为纯数字、无 `v`(当前 `4.18`,兼容两段或三段版本号)。上游 p2pool git tag 带 `v`,构建时补回后传给 Dockerfile;tar.gz、DEB 和 Registry 路径使用纯数字版本。发布 tag 可带或不带 `v`,归一后必须与 VERSION 完全一致。 +- **版本号约定**:根目录 [VERSION](VERSION) 是唯一版本来源,内容为纯数字、无 `v`(当前 `4.18.1`,兼容两段或三段版本号)。上游 p2pool git tag 带 `v`,构建时补回后传给 Dockerfile;tar.gz、DEB 和 Registry 路径使用纯数字版本。发布 tag 可带或不带 `v`,归一后必须与 VERSION 完全一致。 - 架构映射: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 为纯数字)。 @@ -49,7 +49,7 @@ docker buildx build --platform linux/amd64 \ ldd output/linux_amd64/p2pool # 用已有 tar.gz 打 .deb 包(第三个参数是 tar.gz) -./debian/build-deb.sh amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz +./debian/build-deb.sh amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz ``` CI 对二进制执行 `p2pool --version`、`p2pool --help` 和内置 `p2pool --test`,用 `ldd` 校验为纯静态,并检查 DEB 内的二进制、默认配置和 systemd 服务。 diff --git a/README.md b/README.md index 2bc37ee..9820005 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ P2Pool 是 [SChernykh/p2pool](https://github.com/SChernykh/p2pool) 的定制打 支持架构 `amd64` / `arm64`;musl 纯静态,任意 Linux 发行版(Debian/Ubuntu/Alpine/CentOS 等)开箱即跑。静态构建仍保留 `--rpc-ssl`(连外部 SSL monerod 节点)与内置 gRPC(`--merge-mine tari://...` 与 Tari 合并挖矿)。 -P2Pool v4.18 要求连接 **Monero daemon v0.18.5.1 或更高版本**。 +P2Pool v4.18.1 要求连接 **Monero daemon v0.18.5.1 或更高版本**;与 Tari 合并挖矿要求 **Tari 节点 v6.0.0 或更高版本**(v4.18.1 换用新的 Tari 数据格式)。 ## 安装 @@ -48,7 +48,7 @@ sudo apt-get update && sudo apt-get install p2pool ```bash curl -fSL -o p2pool.tar.gz \ - https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/4.18/p2pool-amd64-linux-static-4.18.tar.gz + https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/4.18.1/p2pool-amd64-linux-static-4.18.1.tar.gz tar -xzf p2pool.tar.gz ./p2pool --params-file params.conf # 配置模板见仓库 conf/params.conf.example ``` @@ -73,15 +73,15 @@ docker buildx build --platform linux/amd64 \ ldd output/linux_amd64/p2pool # 用产物 tar.gz 打 .deb -./debian/build-deb.sh amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz +./debian/build-deb.sh amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz ``` ## 版本号约定 - 根目录 [VERSION](VERSION) 是唯一版本来源,使用不带 `v` 的版本号。 -- **上游源码 git tag** 带 `v`(如 `v4.18`),CI 构建时自动补回。 -- **包版本**(tar.gz / deb / registry 路径)一律用数字(如 `4.18`),符合 Debian 版本规范。 -- 发布 tag 可写成 `4.18` 或 `v4.18`,去掉 `v` 后必须与 VERSION 一致。 +- **上游源码 git tag** 带 `v`(如 `v4.18.1`),CI 构建时自动补回。 +- **包版本**(tar.gz / deb / registry 路径)一律用数字(如 `4.18.1`),符合 Debian 版本规范。 +- 发布 tag 可写成 `4.18.1` 或 `v4.18.1`,去掉 `v` 后必须与 VERSION 一致。 发版时先更新 VERSION 并提交,再创建同版本 tag。 diff --git a/VERSION b/VERSION index fdaefe3..cc84ce7 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -4.18 +4.18.1 diff --git a/conf/params.conf.example b/conf/params.conf.example index fd09199..e74ae28 100644 --- a/conf/params.conf.example +++ b/conf/params.conf.example @@ -85,6 +85,7 @@ local-api = true # Merge Mining (Optional) # ============================================================================= # Tari merge mining (this build includes gRPC, so tari:// is supported) +# v4.18.1+: requires Tari node v6.0.0 or newer (new Tari merge mining data format). # Format: tari://: # merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS # diff --git a/debian/build-deb.sh b/debian/build-deb.sh index 9698d4a..b8db032 100755 --- a/debian/build-deb.sh +++ b/debian/build-deb.sh @@ -4,7 +4,7 @@ set -e # 参数检查 if [ $# -ne 3 ]; then echo "Usage: $0 " - echo "Example: $0 amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz" + echo "Example: $0 amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz" exit 1 fi