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 团队的文档编写提出了新的挑战，如何让开发者快速找到所需功能成为一个关键问题。目前看来，包名具有良好的语义性，从名称上就能大致了解其用途，这在一定程度上降低了开发者迁移的难度。

由于新版本刚发布不久，许多项目还未进行迁移。目前，2.x 版本的示例相对较少。此外，由于新版本倾向于使用运行时内置功能（如生成密钥对），文档中缺少相关描述，可能会让一些开发者感到困惑。

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

重要变更点

连接

在 1.x 版本中，Connection 类提供了大量方法。而在 2.x 中，采用了更加函数式的方法来实现：

javascript import { createSolanaRpcApi } from '@solana/web3.js';

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

// 使用 rpc 发送交易 const sendAndConfirmTransaction = rpc.sendAndConfirmTransaction(/* ... */);

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

密钥对

2.x 版本中，1.x 版本常用的 Keypair 和 PublicKey 类不再存在，被一些函数替代。例如，可以使用 await generateKeyPair() 生成密钥对，而不是之前的 Keypair.generate()。

新的 generateKeyPair 返回 Promise，这是因为新实现尽可能利用了 JavaScript 的 Web Crypto API，使用了原生的 Ed25519 实现。Web Crypto API 的许多方法都是异步的。

发送交易

2.x 版本中不再有 Transaction 和 VersionedTransaction 类。System Program 相关方法也不再存在，需要从其他地方引入。例如，transfer 指令需要调用 @solana-program/system 中的 getTransferSolInstruction 函数。

新版本提供了函数式编程中常用的 pipe 形式。以下是使用 pipe 函数实现原本 1.x 的转账功能：

javascript import { pipe } from '@solana/functional'; import { getTransferSolInstruction } from '@solana/system-program'; import { addSignatureToTransaction, createTransaction, sendAndConfirmTransaction, } from '@solana/web3.js';

const transferSol = pipe( // 创建交易 (ix) => createTransaction({ instructions: [ix] }), // 添加签名 (tx) => addSignatureToTransaction(tx, signer), // 发送并确认交易 (signedTx) => sendAndConfirmTransaction(rpc, signedTx) );

const signature = await transferSol( getTransferSolInstruction({ from: sender, to: recipient, amount, }) );

相较于 1.x 版本，代码量有所增加，但可定制性更强。交易通过 HTTPS RPC 发起，然后通过订阅 WSS RPC 来确认交易结果。

React 支持

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

总结

@solana/web3.js 2.x 版本的发布展现了 Solana 团队持续改进的决心。新版本为开发人员提供了一个高效、灵活、可定制的 Solana 网络交互方式，有望推动该平台的采用和发展。