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