更新日志

变更日志

本项目的全部显著变更都将记录在此文件中。

请在进行更改时遵循本文档底部的指南 格式基于 Keep a Changelog。 本项目遵循 语义化版本控制 并遵循 向后兼容性策略

发布渠道有其自身的变更日志副本：

• edge - v2.3
• beta - v2.2
• stable - v2.1

<a name="edge-channel"></a>

2.3.0 - 未发布

2.2.0

• 破坏性更改：
  • Blockstore Index 列格式更改
  • Blockstore Index 列格式已更新。v2.2 中写入的列格式与 v2.1 兼容，但与 v2.0 及更早版本不兼容。
  • 快照格式更改
  • 快照格式已修改以实现 SIMD-215。由于仅相邻版本保证保持快照兼容性，这意味着使用 v2.2 创建的快照与 v2.1 兼容，但与 v2.0 及更早版本不兼容。
• 更改
  • CLI：
  • 添加全局 --skip-preflight 选项，用于跳过通过 RPC 发送的所有交易的预检检查。此标志与 --use-rpc 一起使用，可以提高使用公共 RPC 节点进行程序部署的成功率。
  • 添加新命令 solana feature revoke，用于撤销挂起的特性激活。当特性被激活时，可以使用 solana feature revoke <feature-keypair> <cluster> 来释放并将账户重新分配给系统程序，从而撤销操作。这只能在特性变为活动状态之前完成。
  • 为 --block-production-method 添加新的变体 central-scheduler-greedy。这是一个简化的调度器，比更严格的 central-scheduler 变体具有更好的性能。
  • 取消隐藏 agave-validator 和 agave-ledger-tool 的 --accounts-db-access-storages-method，并将默认值更改为 file
  • 从 banking-trace 中删除追踪器统计信息。首次在 v2.2 上重启时，应清除 banking-trace 目录。如果不清除，不会中断，但该文件将是新/旧格式的混合。（#4043）
  • 添加 --snapshot-zstd-compression-level 以设置使用 zstd 归档快照时的压缩级别。
  • 弃用 --tower-storage 和所有 --etcd-* 参数
  • SDK：
  • cargo-build-sbf：添加 --skip-tools-install 标志以避免下载平台工具，并添加 --no-rustup-override 标志以在调用 cargo 时不使用 rustup。对于像 Nix 这样的不可变环境很有用。
  • --block-production-method central-scheduler-greedy 现在是默认值。

2.1.0

• 破坏性更改：
  • SDK：
  • cargo-build-bpf 和 cargo-test-bpf 已被弃用两年，现在已完全移除。 请改用 cargo-build-sbf 和 cargo-test-sbf。
  • 依赖项：curve25519-dalek 升级到新的主要版本 4 (#1693)。这会导致混合使用 v2.0 和 v2.1 Solana crate 时出现中断，因此请确保使用其中一个版本的全部内容。请仅使用与 v2.1 兼容的 crate。
  • Stake：
  • 删除了未发布的 redelegate 指令处理器和 CLI 命令 (#2213)
  • Banks-client：
  • 放宽函数以使用 &self 而不是 &mut self (#2591)
  • agave-validator：
  • 删除 --rocksdb-shred-compaction 的已弃用值 fifo (#3451)
• 更改
  • SDK：
  • 删除了 respan 宏。这被标记为“仅供内部使用”，并且不再在内部使用。
  • 添加 entrypoint_no_alloc!，这是一个性能更高的程序入口点，可以避免分配，从而为每个唯一帐户节省 20-30 个 CU
  • cargo-build-sbf：工作区或包级别的 Cargo.toml 可以指定 tools-version，以便在构建链上程序时覆盖默认平台工具版本。例如：

    [package.metadata.solana]
    tools-version = "1.43"

    或

    [workspace.metadata.solana]
    tools-version = "1.43"

    所选工具版本的优先级顺序为：--tools-version 参数、包版本、工作区版本，最后是默认版本。

  • package-metadata：在 Cargo.toml 中指定程序的 id，以便下游用户和使用 solana-package-metadata 的工具轻松使用 (#1806)。例如：

    [package.metadata.solana]
    program-id = "MyProgram1111111111111111111111111111111111"

    可以在程序 crate 中使用：

    solana_package_metadata::declare_id_with_package_metadata!("solana.program-id");

    这等效于编写：

    solana_pubkey::declare_id!("MyProgram1111111111111111111111111111111111");

  • agave-validator：更新 PoH 速度检查以与来自 Bank 的当前哈希率进行比较 (#2447)
  • solana-test-validator：添加 --clone-feature-set 标志以模拟来自目标集群的特性 (#2480)
  • solana-genesis：--cluster-type 参数现在克隆来自目标集群的特性集 (#2587)
  • 将 unified-scheduler 作为 --block-verification-method 的默认选项 (#2653)
  • 警告 --block-production-method 的 thread-local-multi-iterator 选项已弃用 (#3113)

2.0.0

• 破坏性
  • SDK：
  • 移除对 Borsh v0.9 的支持，请使用 v1 或 v0.10 (#1440)
  • 不再在 Rent 和 EpochSchedule 上派生 Copy，请切换到使用 clone() (solana-labs#32767)
  • solana-sdk：已移除已弃用的符号
  • solana-program：已移除已弃用的符号
  • RPC：已移除过时已弃用的 v1 端点。这些端点是： confirmTransaction, getSignatureStatus, getSignatureConfirmation, getTotalSupply, getConfirmedSignaturesForAddress, getConfirmedBlock, getConfirmedBlocks, getConfirmedBlocksWithLimit, getConfirmedTransaction, getConfirmedSignaturesForAddress2, getRecentBlockhash, getFees, getFeeCalculatorForBlockhash, getFeeRateGovernor, getSnapshotSlot getStakeActivation
  • 已弃用的方法已从 RpcClient 和 RpcClient::nonblocking 中移除
  • solana-client：已移除已弃用的重新导出；请直接导入 solana-connection-cache、solana-quic-client 或 solana-udp-client
  • 已弃用的参数已从 agave-validator 中移除：
  • --enable-rpc-obsolete_v1_7 (#1886)
  • --accounts-db-caching-enabled (#2063)
  • --accounts-db-index-hashing (#2063)
  • --no-accounts-db-index-hashing (#2063)
  • --incremental-snapshots (#2148)
  • --halt-on-known-validators-accounts-hash-mismatch (#2157)
• 更改
  • 将 central-scheduler 作为 --block-production-method 的默认选项 (#34891)
  • solana-rpc-client-api：RpcFilterError 依赖于 base64 版本 0.22，因此用户可能需要升级到 base64 版本 0.22
  • 将 --health-check-slot-distance 的默认值从 150 更改为 128
  • CLI：可以在程序部署期间指定 --with-compute-unit-price、--max-sign-attempts 和 --use-rpc
  • RPC 的 simulateTransaction 现在在响应中返回一个额外的 replacementBlockhash 字段，当 replaceRecentBlockhash 配置参数为 true 时 (#380)
  • SDK：cargo test-sbf 接受 --tools-version，就像 build-sbf 一样 (#1359)
  • CLI：可以指定 --full-snapshot-archive-path (#1631)
  • transaction-status：SPL Token amountToUiAmount 指令将金额解析为字符串而不是数字 (#1737)
  • 按照 SIMD-0118 实现了分区纪元奖励。特性门控：#426。具体更改包括：
  • 扩展 EpochRewards 系统变量并使其持久化 (#428, #572)
  • 现在允许在分配期间使用 Stake Program 点数 (#631)
  • 更新了 Bank::epoch_rewards_status 中的类型 (#1277)
  • 从快照启动时重新计算分区 (#1159)
  • 从快照中删除了 epoch_rewards_status (#1274)
  • 为 --block-verification-method 添加了 unified-scheduler 选项 (#1668)
  • 弃用 --rocksdb-shred-compaction 的 fifo 选项 (#1882)
  • fifo 将在 v2.0 中保持支持，并计划在 v2.1 中完全移除

1.18.0

• 更改
  • 添加了 github 检查以支持 changelog 标签
  • --use-snapshot-archives-at-startup 的默认值现在为 when-newest (#33883)
  • 但是，solana-ledger-tool 的默认值仍然为 always (#34228)
  • 为 --block-production-method 添加了 central-scheduler 选项 (#33890)
  • 更新到 Borsh v1
  • 添加了 allow_commission_decrease_at_any_time 特性，该特性将允许降低投票帐户上的佣金，即使在 epochs 的后半部分，commission_updates_only_allowed_in_first_half_of_epoch 特性也会阻止它
  • 更新本地账本存储，以便 RPC 端点 getSignaturesForAddress 始终按块包含顺序返回签名字
  • RPC 的 simulateTransaction 现在将 innerInstructions 作为 json/jsonParsed 返回 (#34313)。
  • Bigtable 上传现在包括每个槽的条目摘要数据，存储在 新的 entries 表中
  • 禁止为 --signer CLI 标志使用多个值，强制用户指定多个 --signer，每个签名一个
  • 新的程序部署默认使用程序的精确大小，而不是 两倍大小。如果程序账户需要容纳更大的程序，则必须在使用 solana program extend 进行扩展 才能升级。
  • gossip_service::get_client() 的接口已更改。gossip_service::get_multi_client() 已被移除。
  • CLI：可以在程序部署期间指定 --with-compute-unit-price、--max-sign-attempts 和 --use-rpc
• 升级说明
  • solana-program 和 solana-sdk 默认为支持 Borsh v1，对 v0.10 和 v0.9 具有 有限的向后兼容性。请升级到 Borsh v1。
  • 运行自己的 bigtable 实例的运营商需要在升级其仓库节点之前创建 entries 表

1.17.0

• 更改
  • 添加了变更日志。
  • 添加了 --use-snapshot-archives-at-startup 以加快验证器重启
• 升级说明

添加到此变更日志

受众

• 此日志中的条目旨在易于贡献者、 共识验证器运营商、rpc 运营商和 dapp 开发人员理解。

值得注意

• 如果更改满足以下条件，则值得注意：
  • 添加特性门控，或
  • 实现 SIMD，或
  • 修改公共 API，或
  • 更改正常的验证器/ rpc 运行配置，或
  • 更改命令行参数，或
  • 修复了已引起公众关注的错误，或
  • 显著提高了性能，或
  • 由外部贡献者编写。

说明

• 在实现更改的同一拉取请求中更新此日志。如果 更改分布在多个拉取请求中，请在使特性代码完整的拉取请求中更新此日志。
• 在你合并到的每个分支的 [Unreleased] 部分中添加注释。
  • 在“更改”部分中添加对你所做更改的描述。
  • 如果更改可能需要以下操作，请添加“升级说明”：
  • 验证器或 rpc 运营商更新其配置，或
  • dapp 或客户端开发人员进行更改。
• 链接到任何相关的特性门控问题或 SIMD。
• 如果你在多个分支上添加条目，请尽可能使用相同的措辞。 这简化了在日志版本之间进行比较的过程。

维护此变更日志

创建新的发布分支时：

• 提交到 master 以更新变更日志：
  • 更新 edge、beta 和 stable 链接
  • 创建新节：vx.y+1.0 - Unreleased
  • 从 vx.y.0 节中删除 Unreleased 注释。
• 创建从该提交开始的 vx.y 分支
• 将该提交标记为 vx.y.0

创建新的补丁版本时：

• 提交到发布分支以更新变更日志：
  • 从 vx.y.z 节中删除 Unreleased 注释
  • 在顶部添加一个新节，用于 vx.y.z+1 - Unreleased
• 将该新提交标记为新版本

• 原文链接： github.com/anza-xyz/agav...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～