Solana Web3.js 2.x版本重大升级：模块化设计提升性能与安全

2025-07-29 22:55:36

Solana Web3.js 2.x版本：功能丰富的JavaScript库重大升级

Solana Web3.js作为一个功能强大的JavaScript库，于今年11月正式发布了2.x版本。这次升级带来了显著的变化，我们来简要概括一下主要的更新内容。

虽然2.x版本刚刚推出，使用率尚未普及，许多广泛使用的库也未进行迁移。但是，提前了解这些变化对未来的升级准备大有裨益。

版本对比

不可否认，旧版本在使用上更为简单直接。1.x版本只包含一个@solana/web3.js包，所有功能都集中其中。它基于类的设计，封装了大量常用操作。例如，Connection类提供了数十种方法，几乎涵盖了开发者所需的所有功能。此外，Solana cookbook中还提供了丰富的示例代码，方便开发者查找所需的功能。

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

相比之下，2.x版本采取了模块化的设计思路。官方团队将原有的代码库拆分成多个小型模块，如@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的许多方法都是异步的。不过这一点变化并非不能接受，在即将结束的2024年，JavaScript开发者们已经非常熟悉Promise了。

发送交易

1.x的用户应该很熟悉"Transaction"和"VersionedTransaction"两个类，最初了解Solana时，它们之间的关系可能会让人感到困惑。

在2.x版本中，这两个类同样不再存在。

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

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

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

javascript import { pipe } from "@solana/web3.js"; import { getTransferSolInstruction } from "@solana/system-program";

const transaction = pipe( createTransaction({ version: 0 }), addInstruction(getTransferSolInstruction({ from: senderPublicKey, to: recipientPublicKey, amount: lamports, })), setComputeUnitLimit(200_000), addSignature(senderSignature) );

const signature = await sendAndConfirmTransaction(rpc, transaction);

可以发现，交易不再通过Connection发起，而是通过我们定义的RPC Provider生成一个特有的函数，然后调用该函数来发起交易。相对1.x版本而言，代码量有所增加，但优点是可定制性更强了。

交易通过HTTPS RPC发起，然后通过订阅WSS RPC来确认交易结果。可以感受到新的方式非常依赖WSS，相信未来WSS的应用将会越来越广泛，这也确实对RPC供应商的服务稳定性提出了更高的要求。