Solana Web3.js 2.x 版本：功能强大的 JavaScript 库重大更新

Solana Web3.js 作为一个功能丰富的 JavaScript 库，在今年 11 月正式发布了 2.x 版本。相较于 1.x 版本，新版本带来了显著的变化。本文将对其主要改动进行概括性介绍。

虽然 2.x 版本刚刚发布，使用量尚未普及，许多广泛使用的库也尚未迁移，但提前了解这些变化对未来的升级准备无疑是有益的。

版本对比

不可否认，旧版本在使用上更为简单直接。1.x 版本只需一个包 @solana/web3.js 就包含了所有功能，基于类的设计封装了大量常用操作。例如 Connection 类提供了数十种方法，几乎涵盖了开发者所需的全部功能。

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

相比之下，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 { createSolanaRpcApi, createSolanaRpcSubscriptionsApi } from '@solana/web3.js';

const rpc = createSolanaRpcApi({ httpEndpoint: ' wsEndpoint: 'wss://api.mainnet-beta.solana.com', });

const { sendAndConfirmTransaction } = rpc;

在这段代码中，当我们调用 sendAndConfirmTransaction 发送交易时，会自动发起 HTTPS 请求，并建立一个 WSS 连接，订阅交易状态，在交易被确认后返回交易哈希。

密钥对

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

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

值得注意的是，新的 generateKeyPair 返回了 Promise，而不是直接返回密钥对。这是因为新的实现尽可能利用了 JavaScript 的 Web Crypto API，使用了原生的 Ed25519 实现。Web Crypto API 的许多方法都是异步的。不过，这种变化并不难接受，在 2023 年即将结束的今天，JavaScript 开发者们已经非常熟悉 Promise 了。

发送交易

1.x 版本的用户应该很熟悉 Transaction 和 VersionedTransaction 两个类。在 2.x 版本中，这两个类不再存在。

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

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

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

javascript import { pipe } from '@solana/functional'; import { getTransferSolInstruction } from '@solana/system-program'; import { addSignatureToTransaction, createTransaction, getBase58SignerFromPrivateKey, getSignatureFromSignedTransaction, getTransactionMessage, signTransaction, } from '@solana/transactions';

const transaction = pipe( createTransaction(), addSignatureToTransaction(getTransferSolInstruction({})), );

const signedTransaction = signTransaction(transaction, [signer]); const signature = getSignatureFromSignedTransaction(signedTransaction); const message = getTransactionMessage(signedTransaction);

const txid = await sendAndConfirmTransaction({ signedTransaction });

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

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

React

值得一提的是，@solana/web3.js 项目中还包含了一个名为 @solana/react 的库，提供了一些 React Hook，内置了诸如 signIn 等功能。

总结

@solana/web3.js 2.x 版本的发布充分体现了 Solana 团队对不断发展和改进的承诺。它为开发人员提供了一个高效、灵活、可定制的与 Solana 网络交互的方式，有助于推动该平台的采用和发展。