变更日志

更新日志

此项目所有值得注意的更改都将记录在此文件中。

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

发布渠道有各自的更新日志副本：

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

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

2.3.0 - 未发布

验证器

更改

• 从快照恢复时，不再对 Geyser 的账户通知进行重复数据删除。
• 添加 --no-snapshots 以禁用生成快照。
• --block-production-method central-scheduler-greedy 现在是默认值。
• 默认的完整快照间隔现在是 50,000 个插槽。

弃用

• 使用 --snapshot-interval-slots 0 禁用生成快照现在已被弃用。

平台工具 SDK

更改

• cargo-build-sbf 和 cargo-test-sbf 现在接受 --arch 参数的 v0、v1、v2 和 v3。这些参数指定要构建的 SBPF 版本。
• SBFPv1 和 SBPFv2 也可用于 Anza 的 C 编译器工具链。
• SBPFv3 将仅适用于 Rust 工具链。从 SBPFv3 开始，将不再支持 C 工具链。
• cargo-build-sbf 现在支持 --optimize-size 参数，该参数可以减小程序大小，但可能会增加 CU 使用量。

破坏性更改

• 尽管 solana rust 工具链仍然支持 sbf-solana-solana 目标，但新的 cargo-build-sbf 版本目标默认为 sbpf-solana-solana。生成的程序将在 target/deploy 和 target/sbpf-solana-solana/release 上可用。
• 如果仍然需要 sbf-solana-solana 目标文件夹，请使用 cargo +solana build --triple sbf-solana-solana --release。
• 新的 SBPF 版本的 triple 目标也会发生变化。版本 v1 的 triple 将为 sbpfv1-solana-solana，版本 v2 的 triple 将为 sbpfv2-solana-solana，版本 v3 的 triple 将为 sbpfv3-solana-solana。生成的程序在 target/deploy 文件夹和 target/<triple>/release 文件夹上都可用。target/deploy 中的二进制文件大小更小，因为我们从 target/<triple>/release 中提供的二进制文件中剥离了不必要的部分。
• cargo-build-sbf 不再自动为 solana-sdk 依赖项启用 program 功能。此功能允许 solana-sdk 在链上程序中工作。用户必须显式启用 program 功能或改用 solana-program。此新行为只会破坏使用 solana-sdk v1.3 及更早版本的程序。

CLI

更改

• withdraw-stake 现在接受金额的 AVAILABLE 关键字，允许提取未质押的 lamports (#4483)
• solana-test-validator 现在将默认绑定到 localhost (127.0.0.1)，而不是所有接口，以提高安全性。提供 --bind-address 0.0.0.0 以绑定到所有接口以恢复之前的默认行为。

2.2.0

CLI

更改

• 添加全局 --skip-preflight 选项，用于跳过通过 RPC 发送的所有交易的预检。此标志以及 --use-rpc 可以提高使用公共 RPC 节点进行程序部署的成功率。
• 添加新命令 solana feature revoke 用于撤销待处理的功能激活。激活功能后，可以使用 solana feature revoke <feature-keypair> <cluster> 将帐户取消分配并重新分配给系统程序，从而撤消该操作。这只能在功能激活之前完成。

验证器

破坏性更改

• 区块存储索引列格式更改
  • Blockstore Index 列格式已更新。v2.2 中写入的列格式与 v2.1 兼容，但与 v2.0 及更早版本不兼容。
• 快照格式更改
  • 已修改快照格式以实现 SIMD-215。由于只有相邻版本才能保证保持快照兼容性，这意味着使用 v2.2 创建的快照与 v2.1 兼容，而与 v2.0 及更早版本不兼容。

更改

• 为 --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 这样的不可变环境很有用。

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。
  • 质押：
    • 删除了未发布的 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)
    • Copy 不再在 Rent 和 EpochSchedule 上派生，请切换到使用 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 实现了分区 epoch 奖励。功能门：#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 功能，该功能允许降低投票帐户的佣金，即使在 epoch 的后半段，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] 部分中添加注释。
  • 在 Changes 部分中添加对你的更改的描述。
  • 如果更改可能需要以下操作，请添加升级说明：
    • 验证器或 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 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～