用途:protocol-curr 子系统收录 stellar-core 当前协议的规范 XDR(External Data Representation)类型定义,即 .x 文件,用于声明 Stellar 网络上链上与落盘的全部数据结构。对应 .h 文件由 xdrpp 代码生成器从 .x 自动生成,不可直接编辑 .h,应始终修改 .x 源文件;该目录是指向官方 Stellar XDR 仓库的 git 子模块。
主要能力:.x 文件通过 %#include 构成依赖 DAG。Stellar-types.x 为基础类型(无依赖),提供 Hash、uint256、TimePoint、Duration、ExtensionPoint、CryptoKeyType、PublicKey、SignerKey、AccountID、ContractID、PoolID、Signature、ClaimableBalanceID、SerializedBinaryFuseFilter 等。其下依次是 Stellar-SCP.x(共识协议类型,如 SCPBallot、SCPStatement、SCPEnvelope、SCPQuorumSet,法定切片嵌套最深 4 层)、Stellar-contract.x(Soroban 值类型,如 SCVal、SCError、SCErrorCode、UInt128Parts 等大整数、ContractExecutable、SCAddress、SCContractInstance)、Stellar-contract-config-setting.x(Soroban 网络配置,ConfigSettingID、计算/账本成本/带宽/执行通道/状态归档/SCP 时序等设置,以及 ContractCostType 85 种成本类型)、Stellar-ledger-entries.x(账本条目:账户、信任线、报价、数据、可领取余额、流动性池、合约数据/代码、TTL,以及 LedgerKey、Bucket 类型)、Stellar-transaction.x(约 2100 行,交易结构与 27 种操作类型及结果类型、MuxedAccount、交易信封层级、前置条件、Memo、Soroban 资源与授权、HostFunction、HashIDPreimage、TransactionSignaturePayload)、Stellar-ledger.x(账本头、StellarValue、升级、交易集与并行执行阶段、TransactionMeta v0-v4、LedgerCloseMeta、历史条目)、Stellar-overlay.x(P2P 消息,24 种 MessageType、握手、调查、流控、洪泛)、Stellar-internal.x(仅内部持久化类型)、Stellar-exporter.x(账本导出批次类型)、Stellar-contract-env-meta.x(环境元数据)、Stellar-contract-meta.x(合约元数据)、Stellar-contract-spec.x(合约 ABI)。
使用方式与适用场景:阅读本技能可快速了解各 XDR 文件职责与依赖关系,便于修改协议类型、理解链上数据结构和生成 C++ 头文件。原文未提供具体命令或安装步骤。限制:.h 文件为自动生成,不应手动编辑;原文中 Stellar-contract-spec.x 的 SCSpecType 枚举说明不完整,其余细节以官方 XDR 仓库为准。