Solana Web3.js 2.x版本发布：功能拆分与性能优化

2025-07-10 07:22:05

Solana Web3.js 2.x 版本：功能拆分与性能优化

Solana Web3.js 作为一个功能丰富的 JavaScript 库，在 11 月正式发布了 2.x 版本。相较于 1.x 版本，新版本进行了较大幅度的改变。本文将对其主要变化进行概括。

虽然 2.x 版本刚刚发布，使用量尚未普及，许多广泛使用的库也未进行迁移，但了解这些变化对未来的迁移工作将会有所帮助。

版本对比

旧版本的使用相对简单，仅包含一个 @solana/web3.js 包，所有功能都集中在其中。它基于类的设计，封装了大量常用操作。例如，Connection 类提供了数十种方法，几乎涵盖了开发者所需的所有功能。此外，Solana cookbook 中提供的大量示例代码也为开发者提供了便利。

然而，这种设计也带来了一些问题。尽管开发者实际使用的功能可能只占很小一部分，但整个代码库都会被下载到用户设备上，由于库的代码量较大，这可能会耗费一定时间。

2.x 版本采取了不同的策略。官方团队将原有代码库拆分为several个较小的模块，如 @solana/accounts、@solana/codecs、@solana/rpc、@solana/signers、@solana/transactions 等。同时，它放弃了基于类的实现，更多地采用单个函数的方式。这种改变有利于 JavaScript 代码构建时的优化，未使用的代码将被删除，不会被下载到用户设备上。根据官方文档统计，使用新版本的 DApp 基本能获得 30% 的尺寸优化，如果只使用了少量功能，优化比例可能更高。

这种变化对 Solana 团队的文档质量提出了更高要求，如何让开发者快速找到所需功能成为一个重要课题。目前来看，包名具有较好的语义性，从名称上就能大致了解它们的用途，这在某种程度上降低了开发者迁移的难度。

由于新版本刚发布不久，许多项目尚未进行迁移。Solana Cookbook 上关于 2.x 版本的示例也相对较少。此外，新版本倾向于使用运行时内置功能（如生成密钥对），但文档中对此的描述不足，导致某些地方开发者可能感到困惑。

2.x 版本的另一个重要特点是零依赖。这一点对许多用户来说可能不那么重要，但考虑到今年 12 月初发生在 @solana/web3.js 1.95.5 和 1.95.6 版本上的供应链攻击，更多的外部输入和依赖会大幅增加安全事件发生的可能性。随着 2.x 版本的发布，Web3.js 的开发团队决定更多地使用本机功能，取消外部依赖和 Polyfills 的引入。虽然未来可能会有变化，但目前 2.x 版本已经消除了所有外部依赖。

重要变更点

连接

在 1.x 版本中，Connection 类提供了大量方法。其主要功能是通过配置 RPC 请求地址创建一个请求发送器，然后通过它发送各种请求。

2.x 版本采用了更加函数式的方式实现：

javascript import { createSolanaRpc } from "@solana/web3.js";

const rpc = createSolanaRpc("");

当调用 sendAndConfirmTransaction 发送交易时，会自动发起 HTTPS 请求，并建立 WSS 连接订阅交易状态，在交易被确认后返回交易 hash。

密钥对

公钥和私钥相关的部分也有较大变化。1.x 版本中常用的 Keypair 和 PublicKey 类不再存在，被一些函数替代。

例如，可以使用 await generateKeyPair() 生成密钥对，而不是之前的 Keypair.generate()。

新的 generateKeyPair 返回 Promise，这是因为新实现尽可能利用了 JavaScript 的 Web Crypto API，使用了原生的 Ed25519 实现。Web Crypto API 的许多方法都是异步的。不过，这种变化对于熟悉 Promise 的 JavaScript 开发者来说应该不会造成太大困扰。

发送交易

1.x 版本中常用的 Transaction 和 VersionedTransaction 类在 2.x 版本中不再存在。

旧版本中提供的 System Program 相关方法也不再存在，SystemProgram 类上的静态方法需要从其他地方引入。

例如，transfer 指令需要调用 @solana-program/system 中的 getTransferSolInstruction 函数。

由于不再提供 class，Web3.js 提供了函数式编程中常用的 pipe 形式。以下是使用 pipe 函数实现原本 1.x 的转账功能的示例：

javascript import { pipe } from "@solana/functional"; import { getTransferSolInstruction } from "@solana/system"; import { createSolanaRpc, sendTransaction, setTransactionFeePayer, createTransaction, appendTransactionInstruction, } from "@solana/web3.js";

const rpc = createSolanaRpc("");

const transaction = pipe( createTransaction(), setTransactionFeePayer(payer.address), appendTransactionInstruction( getTransferSolInstruction({ fromAddress: payer.address, toAddress: recipient, amount, }) ) );

const signature = await sendTransaction(rpc, transaction, [payer]);

相比 1.x 版本，代码量有所增加，但可定制性更强。

交易通过 HTTPS RPC 发起，然后通过订阅 WSS RPC 来确认交易结果。新的方式对 WSS 的依赖更高，这也对 RPC 供应商的服务稳定性提出了更高要求。