区块链后端【免费下载链接】chia-blockchainChia blockchain python implementation (full node, farmer, harvester, timelord, and wallet)项目地址https://gitcode.com/gh_mirrors/ch/chia-blockchain点击查看免费下载本文是 chia-blockchain 仓库的架构级导读面向首次接触该代码库、需要快速建立全局认知的开发者。全文以 .cursor/context/architecture-overview.md 为主线结合仓库内真实源码与配置文件展开读完你将掌握仓库与外部 Rust 加速包的边界划分、九个节点角色的代码落点、110 余种线协议消息的组织方式以及共识关键类型与序列化机制的实现位置。项目形态Python PoST 区块链且不是 monorepochia-blockchain 是一个基于 Proof of Space and TimePoST共识的区块链 Python 实现。仓库 pyproject.toml 的项目描述写明其定位full node、farmer、timelord 和 wallet 的完整节点实现。架构文档特别强调这个仓库不是 monorepo。chia-blockchain只承载 Python 节点实现本身而密码学、证明与 puzzle 编译等重活被拆分到 Chia 生态的一系列独立包中。这意味着共识、网络、钱包等业务逻辑在 Python 侧BLS 签名、CLVM 执行、序列化、证明求解等计算密集路径由 Rust 原生扩展承接这些外部包以pyproject.toml中的 Poetry 依赖声明接入安装时从https://pypi.chia.net/simple/[[tool.poetry.source]]中声明的 supplemental 源拉取。理解这条边界是阅读本仓库代码的第一把钥匙看到from chia_rs import ...时你面对的是 Rust FFI 类型看到chia/consensus/下的纯 Python 逻辑时你面对的是共识决策本身。外部依赖全景八个 Chia 生态包的分工架构文档给出了一张外部依赖分工表这里结合 pyproject.toml 的实际声明逐一展开包角色仓库内主要使用方pyproject.toml 版本约束chia_rs核心 Rust FFI共识类型、BLS 签名、CLVM 执行、序列化、条件验证、spend bundle 验证、merkle sets、V2 证明求解几乎一切共识、mempool、钱包、类型、solver0.50.0, 0.51minor 范围固定chiaposProof of Space绘图、证明验证、quality 计算chia/plotting/、chia/types/blockchain_format/proof_of_space.py2.0.10chiavdfVDF 计算与证明验证chia/timelord/、chia/types/blockchain_format/vdf.py、chia/simulator/1.1.10clvmPython CLVM 解释器工具链用不参与共识热路径chia/types/blockchain_format/program.py、钱包 puzzle drivers0.9.14clvm_toolsCLVM 工具currying、Program.to()、反汇编钱包 puzzle 构造、测试、调试0.4.9chialispRust ChiaLisp 编译器将.clsp编译为 CLVM 字节码chia/wallet/puzzles/load_clvm.py、puzzle 编译工具0.4.1chia-puzzles-py预编译的标准 puzzle 字节码singleton、CAT、DID、NFT 等钱包 puzzle drivers、pools、data layer0.20.1chiabip158BIP-158 紧凑区块过滤器用于轻量钱包同步区块体验证、mempool manager、钱包同步1.5.2架构文档中的Version pinning结论与仓库实际一致但数值需以当前 pyproject.toml 为准chia_rs固定到 minor 范围当前为0.50.0, 0.51其余 Chia 包采用 minimum-version 固定。这种策略的核心目的是让 Rust 核心库的语义化版本升级不会悄悄破坏 Python 侧对类型与函数的调用假设。模块地图十三大模块与关键程度分级架构文档将仓库划分为以下模块并标注了关键程度Critical / High / Medium / Low这是判断改哪里影响面最大的速查表模块职责关键程度chia/consensus/区块验证、难度调整、分叉选择、VDF iters、区块奖励Criticalchia/full_node/全节点状态、mempool、store、费用预估、weight proofs、RPCCriticalchia/server/网络WebSocket、限流、节点发现、TLSCriticalchia/protocols/各类节点之间的线协议消息定义Criticalchia/wallet/钱包状态、coin selection、spend 构造、子钱包Highchia/farmer/耕种逻辑、signage point 处理、proof 转发Highchia/harvester/图文件管理、PoS 查询Mediumchia/timelord/VDF 计算、infusion point 管理Highchia/types/类型定义区块链格式、mempool 项、generatorHighchia/util/DB wrapper、streamable、keychain、bech32m 等基础设施Mediumchia/simulator/测试用区块链模拟器Lowchia/data_layer/DataLayer数据存储 singletonMediumchia/cmds/CLI 命令处理器Low从源码结构看chia/consensus/与chia/full_node/是共识正确性的双保险前者如 blockchain.py、difficulty_adjustment.py、pot_iterations.py 负责规则后者如 full_node.py、mempool_manager.py、weight_proof.py 负责运行。而 chia/server/ 与 chia/protocols/ 共同决定节点之间如何说话牵一发而动全身。包根三件套进程级入口与命名空间胶水架构文档明确chia/__init__.py、chia/__main__.py与chia/py.typed只是进程级入口和命名空间胶水不是共识、钱包状态、P2P 语义、daemon 权限或 RPC 行为的权威所在。它们各自的作用可以逐一在源码中确认版本解析chia/init.py 通过importlib.metadata.version(chia-blockchain)解析__version__失败时回退为unknown。这个值会出现在 CLI 输出、daemon/RPC 响应、节点握手、farmer pool headers 和日志中。进程级运行时门禁同一文件中有两处 import-time 检查——(1) 断言必须启用assert False检测拒绝-O优化构建否则直接抛异常终止因为共识、网络、store、原生扩展、异步与 DB 逻辑都依赖断言行为(2) 拒绝 CPython free-threading 构建检查sys._is_gil_enabled理由同样是上述运行假设依赖 GIL。CLI 桥接chia/main.py 仅一行核心逻辑from chia.cmds.chia import main; main()把python -m chia转发给 CLI 命令框架。类型声明chia/py.typed 向下游消费者声明本包为 typed。控制台脚本契约pyproject.toml 的[project.scripts]定义了chia、chia_daemon、chia_full_node、chia_farmer、chia_harvester、chia_timelord、chia_solver、chia_data_layer等十余个入口它们必须与 chia/util/service_groups.py、chia start、PyInstaller 可执行名、安装器 payload 及 GUI 期望保持一致。设计约束避免从包根引入重型 service 模块因为根导入发生在 root path、keys root、logging、config、SSL 检查建立之前提前导入会破坏初始化顺序。chia_rs边界最大的外部依赖架构文档的核心洞察之一是几乎所有的核心共识类型都居住在 Rust 侧的chia_rs中Python 侧只是引用与组合。这一条对阅读体验影响极大——你在chia/types/与chia/consensus/中看到的BlockRecord、FullBlock、ConsensusConstants等多数是chia_rs类型的再导出例如 chia/consensus/block_record.py 就只是BlockRecord的 re-export。类型清单BlockRecord、FullBlock、ConsensusConstants、SpendBundleConditions、CoinRecord、SpendBundle、EndOfSubSlotBundle、HeaderBlock、UnfinishedBlock、SubEpochSummary、SubEpochChallengeSegment、Coin、CoinSpend、G1Element、G2Element、AugSchemeMPL、BLSCache、PartialProof。函数清单validate_clvm_and_signature、run_block_generator、run_block_generator2、additions_and_removals、check_time_locks、compute_merkle_set_root、fast_forward_singleton、supports_fast_forward、get_flags_for_height_and_constants、solution_generator_backrefs、get_puzzle_and_solution_for_coin2、is_canonical_serialization、get_conditions_from_spendbundle、get_spends_for_trusted_block、solve_proofV2 图求解。经验法则rule of thumb这也是架构文档最值得记的一条共识关键数学——VDF 迭代次数计算pot_iterations.py、难度调整difficulty_adjustment.py、quality 计算——是Python签名 / CLVM / 序列化验证是RustVDF 证明由chiavdf计算PoS 证明由chiapos计算puzzle 字节码来自chia-puzzles-py的预编译产物。九个 Actor节点角色与代码落点节点角色由 chia/protocols/outbound_message.py 中的NodeType枚举定义FULL_NODE1、HARVESTER2、FARMER3、TIMELORD4、INTRODUCER5、WALLET6、DATA_LAYER7、SOLVER8。每个角色的 P2P API、RPC API 与状态机分别落在不同文件中Full Node中枢P2P APIFullNodeAPI架构文档标注约 2080 行RPC APIFullNodeRpcApi约 1170 行状态机FullNode约 3400 行全节点同时承担共识推进、mempool 维护、区块分发与同步是所有其他角色的事实中心。FarmerAPIFarmerAPI——接收 signage points转发 proofs 给全节点RPCFarmerRpcApi——本地管理面HarvesterAPIHarvesterAPI——接收挑战、检查本地图文件、回传 PoSTimelordAPITimelordAPI——接收 peak产出 VDF状态TimelordStateWalletP2PWalletNodeAPI——coin 状态更新RPCWalletRpcApi约 3600 行最完整的钱包控制面状态WalletStateManager约 3300 行Introducer服务Introducer——引导阶段的节点发现APIIntroducerAPI——对外提供筛选过的 peer 列表Data Layer服务DataLayer——基于 singleton 的数据存储服务RPCDataLayerRpcApiSolver服务Solver——把 V2 图的 partial proof 求解为完整 proof of spaceAPISolverAPI——从 farmer 接收SolverInfopartial proof、plot_id、k-size通过SolverResponse返回完整 proof线协议110 消息类型与关键流向线协议消息的枚举定义在 chia/protocols/protocol_message_types.py 的ProtocolMessageTypes中覆盖 handshake值 1、configure_window_sizes111到 error255总数超过 110 种。消息本身的封套type id data由 chia/protocols/outbound_message.py 中的Message流式类型承载通过make_msg()构造。按消息分组可以看清节点间的数据流Full Node ↔ Full Nodenew_peak、new_transaction、request_block(s)、new_signage_point_or_end_of_sub_slot、request_compact_vdf——区块与挑战信息在全节点网络内扩散Full Node ↔ Walletnew_peak_wallet、send_transaction、coin_state_update、request_puzzle_state、mempool_items_added/removed——钱包跟踪链状态并提交交易Farmer ↔ Full Nodenew_signage_point、declare_proof_of_space、request_signed_values——farmer 发现合格 proof 后交给全节点验证Farmer ↔ Harvesternew_signage_point_harvester、new_proof_of_space、request_signatures——挑战下发给 harvesterpartial proof 上收Full Node ↔ Timelordnew_peak_timelord、new_infusion_point_vdf、new_signage_point_vdf——timelord 接收新 peak 并回送 VDF 输出。每条消息的值、方向与所属协议分组都可以在上述枚举文件中逐条核对是理解谁对谁说什么的第一手资料。关键类型文件与 Streamable 序列化架构文档给出的类型文件索引是深挖数据结构时的导航文件内容chia/types/blockchain_format/coin.pyCoinparent_id、puzzle_hash、amountchia/types/blockchain_format/vdf.pyVDFInfo、VDFProofchia/types/blockchain_format/proof_of_space.pyPoS 验证chia/types/blockchain_format/program.pyCLVM program 封装chia/types/blockchain_format/serialized_program.py惰性 CLVM 反序列化chia/types/mempool_item.pyMempoolItem、BundleCoinSpend、UnspentLineageInfochia/types/generator_types.pyBlockGenerator、NewBlockGeneratorchia/types/validation_state.pyValidationStatechia/types/weight_proof.pyWeightProofchia/consensus/block_record.pyBlockRecord的 chia_rs 再导出chia/consensus/default_constants.pyDEFAULT_CONSTANTS全部参数值这些类型绝大多数是streamable装饰的数据类。序列化机制实现在 chia/util/streamable.pystreamable装饰器streamable()位于该文件约第 616 行配合dataclass(frozenTrue)使用为每个字段生成stream_function、parse_function、convert_function与post_init_function支持定长原始类型如uint8/16/32/64、bytes32的固定大小优化与变长字段的运行时解析。定长原始类型表见该文件_FIXED_SIZE_PRIMITIVES第 107 行附近_element_fixed_size()则用于判断列表元素是否定长。这套机制保证了线协议消息与磁盘存储使用同一套紧凑二进制格式。共识常量从 DEFAULT_CONSTANTS 看主网参数chia/consensus/default_constants.py 中的DEFAULT_CONSTANTS是chia_rs.ConsensusConstants的实例化集中了主网全部共识参数。几个高频使用的关键值区块节奏SLOT_BLOCKS_TARGET32、SUB_SLOT_TIME_TARGET600秒、MIN_BLOCKS_PER_CHALLENGE_BLOCK16、MAX_SUB_SLOT_BLOCKS128、NUM_SPS_SUB_SLOT64难度DIFFICULTY_STARTING7、DIFFICULTY_CONSTANT_FACTOR2^67、DIFFICULTY_CHANGE_MAX_FACTOR3下期难度被截断在[prev/FACTOR, prev*FACTOR]周期结构SUB_EPOCH_BLOCKS384、EPOCH_BLOCKS4608、SIGNIFICANT_BITS8图与过滤NUMBER_ZERO_BITS_PLOT_FILTER_V1/V29、MIN_PLOT_SIZE_V132、MAX_PLOT_SIZE_V150、PLOT_SIZE_V228区块体上限MAX_BLOCK_COST_CLVM11000000000、COST_PER_BYTE12000、MAX_COIN_AMOUNT2^64-1时间安全MAX_FUTURE_TIME2120新块时间戳最多超前最近 11 个块平均 120 秒NUMBER_OF_TIMESTAMPS11安全参数AGG_SIG_*_ADDITIONAL_DATA系列为 replay 攻击防护而设GENESIS_CHALLENGE是主网创世挑战并明确注释分叉项目应修改 AGG_SIG 附加数据以提供重放保护。从源码注释看这些常量之间存在强约束关系如MIN_BLOCKS_PER_CHALLENGE_BLOCK必须小于SLOT_BLOCKS_TARGET的一半、MAX_SUB_SLOT_BLOCKS必须小于SUB_EPOCH_BLOCKS的一半、NUM_SPS_SUB_SLOT必须是 2 的幂测试网常量则依据运行链testnet0、testnet1、mainnet覆盖GENESIS_CHALLENGE等值。阅读路线建议先跑通chia start的进程拓扑对照 pyproject.toml 的[project.scripts]与 chia/util/service_groups.py理解每个可执行文件对应哪个 actor 的服务组装逻辑再读协议层从 chia/protocols/protocol_message_types.py 按分组梳理消息流配合 chia/server/server.py 理解 WebSocket/TLS 传输层然后深入共识以 chia/consensus/blockchain.py 为骨架结合 chia/consensus/default_constants.py 的参数表逐条对照 chia/_tests/blockchain/ 下的测试用例如 test_blockchain.py、test_build_chains.py验证行为最后看类型层遇到任何线上数据结构先确认它是chia_rs类型还是streamablePython 类型再决定去哪一层查找实现。架构文档还提示了一处容易踩的坑不要在包根导入重型 service 模块——包根导入发生在 root path、keys root、logging、config、SSL 检查建立之前任何额外导入都可能破坏初始化顺序。这条约束对仓库的模块依赖可参考根目录 tach.toml 的架构约束配置同样适用。赞分享区块链后端【免费下载链接】chia-blockchainChia blockchain python implementation (full node, farmer, harvester, timelord, and wallet)项目地址https://gitcode.com/gh_mirrors/ch/chia-blockchain点击查看免费下载相关推荐kitti2bag入门教程如何安装和使用这个终极KITTI转换工具kitti2bag入门教程如何安装和使用这个终极KITTI转换工具 kitti2bag是一款简单易用的工具能够帮助用户将KITTI数据集轻松转换为ROS b重新定义旧Mac生命线OpenCore Legacy Patcher终极实践指南重新定义旧Mac生命线OpenCore Legacy Patcher终极实践指南 你是否曾为手中那台性能依旧强劲的Mac被苹果官方抛弃而感到惋惜当系统更操作系统固件驱动开发Chia Timelord 模块深度解析VDF 调度、峰值选择与全节点协议耦合实现指南Chia Timelord 模块深度解析VDF 调度、峰值选择与全节点协议耦合实现指南 导读 本文以 chia blockchain 仓库中 chia/tim区块链后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考