Solana Web3.js 2.x版本：全新函数式编程体验

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版本采用了更加函数式的方式来实现这一功能。例如，当调用sendAndConfirmTransaction发送交易时，会自动发起HTTPS请求，并建立WSS连接订阅交易状态，在交易被确认后返回交易哈希。

密钥对

公钥和私钥相关的部分也发生了重大变化。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两个类在2.x版本中不再存在。

旧版本中提供的System Program相关方法也不再继续存在，因此SystemProgram类上的静态方法都需要从其他地方引入。例如，transfer指令需要调用@solana-program/system中的getTransferSolInstruction函数。

由于不再提供class，Web3.js提供了函数式编程中常用的pipe形式。开发者可以通过pipe函数来实现原本1.x的转账功能。

值得注意的是，交易不再通过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网络交互的方式，有助于推动该平台的采用和发展。