现已推出：Solana JavaScript SDK 2.0 - Anza

今天我们已经从 @solana/web3.js v2.0.0 中移除了 Release Candidate 标签。我们现在建议它用于一般用途。

感谢

Release Candidate 计划于八月开始。来自各行各业的开发者，尤其是一些来自 Tensor、Triton One 和 Orca 的开发者，对这个新库进行了测试，发现了错误并提出了建议。今天发布的 2.0.0 版本因而变得更好，我们想要表彰那些在前沿与我们一起玩耍的人。

有什么变化？

@solana/web3.js 的 2.0.0 版本提供了一个与 Solana 交互的新 API。由于它与 1.x 版本的 API 不兼容，我们将在未指定版本的情况下延迟将其设置为默认（即将 npm 标签设为 latest）。

如果你编写了自动安装 @solana/web3.js 的开发者内容或 shell 脚本，你有两个选择：

1. 将你的软件迁移到新的 v2.0 API

2. 通过明确指定版本锁定到 v1.x（阅读方法）

在未来，你可以期待 npm install 的行为如下。

在 2024 年 12 月 16 日之前：

npm install @solana/web3.js         # 安装 v1.x
npm install @solana/web3.js@latest  # 安装 v1.x
npm install @solana/web3.js@1       # 安装 v1.x
npm install @solana/web3.js@2       # 安装 v2.x

之后的某个时间（推迟到另行通知）：

npm install @solana/web3.js         # 安装 v2.x
npm install @solana/web3.js@latest  # 安装 v2.x
npm install @solana/web3.js@1       # 安装 v1.x
npm install @solana/web3.js@2       # 安装 v2.x

我该如何尝试？

• 首先阅读 Release Candidate 计划博客文章。

• 克隆代码库，然后阅读并运行 示例。

• 阅读 QuickNode 的指南 来了解如何使用 2.0 编程。

• 阅读自动生成的 TypeDoc 文档 获取完整 API 的信息。别忘了查看每个包内详细的 README。

• 尝试在 CodeSandbox 上的示例（使用你自己的 devnet RPC URL 以避免速率限制）。

它能与 X 一起工作吗？

一些 SDK 已经被迁移以与 2.0.0 版本兼容，比如 Tensor 的 Toolkit、Orca 的 ts-sdk、Lighthouse SDK 等。如果你的应用程序依赖于尚未迁移的 SDK，你有几个选择。

• 如果你能消除该 SDK，请这样做。寻找另一种方式来实现相同的目标可以帮助你减小应用程序的大小，并减少构建所依赖的外部包的数量。

• 如果它是内置 Solana 程序的传统程序客户端（例如 @solana/spl-token 或 SystemProgram），请使用在 @solana-program GitHub 组织中发布的新客户端。

• 如果依赖是 @solana/wallet-adapter，请查看 React 示例应用，了解与浏览器钱包交互的新方式。

• 如果依赖是 Anchor 程序客户端或用 Shank 宏标注的程序，使用 Codama 生成一个新的程序客户端。

• 否则，鼓励 SDK 的开发者发布一个与 2.0 兼容的版本。告诉他们我们会在迁移的每一步上提供帮助。可以在 Stack Exchange 上获得帮助，并且 可以在 GitHub 上提交错误报告。

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