Skip to main content

后向兼容政策

随着Solana开发人员生态系统的发展,围绕打破API和行为更改(影响为Solana构建的应用程序和工具)的明确期望也将越来越高。 在一个完美的世界中,Solana的开发可以以非常快的速度继续进行,而不会给现有开发人员造成任何问题。 但是,将需要做出一些妥协,因此,本文档尝试澄清和整理新发行版的过程。

期望值#

  • Solana软件版本包括API,SDK和CLI工具(带有一些exceptions)。
  • Solana软件版本遵循语义版本控制,更多详细信息请参见下文。
  • 适用于MINOR版本的软件将与同一MAJOR版本上的所有软件兼容。

弃用过程#

  1. 在任何PATCHMINOR版本中,功能、API、端点等都可以标记为已弃用。
  2. 根据代码升级的难度,某些功能将在几个发布周期内被弃用。
  3. 在未来的MAJOR版本中,不赞成使用的功能将以不兼容的方式删除。

发布时间#

Solana RPC API、Rust SDK、CLI工具和BPF程序SDK均已更新并随每个Solana软件版本一起提供,并且应始终在特定MINOR版本的PATCH更新之间兼容。

发布频道#

  • edge软件,其中包含最先进的功能,没有向后兼容策略
  • 在Solana Tour de SOL测试网集群上运行的beta软件
  • 在Solana Mainnet Beta和Devnet集群上运行的stable软件

主要版本(x.0.0)#

MAJOR版本(例如2.0.0)可能包含重大更改并删除了以前不推荐使用的功能。 客户端SDK和工具将开始使用在先前MAJOR版本中启用的新功能和端点。

次要版本(1.x.0)#

新功能和建议实施已添加到new版本的MINOR版本(例如1.4.0)中,并且首先在Solana的Tour de SOL测试网集群上运行。 在测试网上运行时,MINOR版本被认为在beta发布渠道中。 在对这些更改进行了修补并证明是可靠的之后,MINOR版本将升级到stable发布渠道并部署到Mainnet Beta集群。

修补程序版本(1.0.x)#

低风险功能,不间断的更改以及安全性和错误修复作为PATCH版本发行版(例如1.0.11)的一部分提供。 补丁可以同时应用于betastable发布渠道。

RPC API#

补丁发布:

  • Bug修复
  • 安全修复
  • 端点/功能弃用

次要版本:

  • 新的RPC端点和功能

主要版本:

  • 删除过时的功能

Rust Crates#

补丁发布:

  • Bug修复
  • 安全修复
  • 性能提升

次要版本:

  • 新的 API

主要版本:

  • 删除过时的API
  • 向后不兼容的行为更改

CLI 工具#

补丁发布:

  • 错误和安全修复
  • 性能提升
  • 弃用子命令/参数

次要版本:

  • 新的子命令

主要版本:

  • 切换到先前主要版本中引入的新RPC API端点/配置。
  • 删除过时的功能

Runtime功能#

Solana新的runtime功能已进行功能切换并手动激活。 Runtime功能包括:引入新的本机程序,sysvars和syscalls;并改变他们的行为。 功能激活与群集无关,因此可以在Mainnet-beta上激活之前在Testnet上建立置信度。

发布过程如下:

  1. 新版本中包含新的runtime功能,默认情况下已禁用
  2. 一旦有足够的抵押验证程序升级到新版本,就可以通过指令手动激活runtime功能开关
  3. 该功能在下一个纪元开始时生效

基础架构变更#

公共API节点#

Solana提供了公开可用的RPC API节点,供所有开发人员使用。 Solana团队将尽最大努力将任何更改传达给主机,端口,限速行为,可用性等。 但是,我们建议开发人员依靠自己的验证器节点来阻止对Solana操作的节点的依赖。

本地集群脚本和Docker映像#

重大更改将仅限于MAJOR版本更新。 MINORPATCH更新应始终向后兼容。

例外#

Web3 JavaScript SDK#

Web3.JS SDK还遵循语义版本控制规范,但与Solana软件版本分开提供。

攻击向量#

如果在现有代码中发现了新的攻击媒介,则可以根据问题的严重性来规避上述过程,以便快速部署修复程序。