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 網路交互的方式，有助於推動該平台的採用和發展。