Solana Web3.js 2.x版本：功能豐富的JavaScript庫重大升級

Solana Web3.js作爲一個功能強大的JavaScript庫，於今年11月正式發布了2.x版本。這次升級帶來了顯著的變化，我們來簡要概括一下主要的更新內容。

雖然2.x版本剛剛推出，使用率尚未普及，許多廣泛使用的庫也未進行遷移。但是，提前了解這些變化對未來的升級準備大有裨益。

版本對比

不可否認，舊版本在使用上更爲簡單直接。1.x版本只包含一個@solana/web3.js包，所有功能都集中其中。它基於類的設計，封裝了大量常用操作。例如，Connection類提供了數十種方法，幾乎涵蓋了開發者所需的所有功能。此外，Solana cookbook中還提供了豐富的示例代碼，方便開發者查找所需的功能。

然而，這種設計也帶來了一些問題。盡管開發者實際使用的功能可能只是其中的一小部分，但整個代碼庫都會被下載到用戶設備上，由於庫的代碼量較大，這可能會消耗一定的時間。

相比之下，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 { createSolanaRpc } from "@solana/web3.js";

const rpc = createSolanaRpc("");

當我們調用"sendAndConfirmTransaction"發送交易時，會自動發起HTTPS請求，並建立WSS連接，訂閱交易狀態，在交易被確認後返回交易hash。

密鑰對

公鑰和私鑰相關的部分也發生了重大變化。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"兩個類，最初了解Solana時，它們之間的關係可能會讓人感到困惑。

在2.x版本中，這兩個類同樣不再存在。

舊版本中提供的System Program相關方法也不再存在，因此"SystemProgram"類上的靜態方法都需要從其他地方引入。

例如"transfer"指令，需要調用"@solana-program/system"中的"getTransferSolInstruction"函數。

由於不再提供class，Web3.js提供了函數式編程中常用的"pipe"形式。以下是通過pipe函數實現原本1.x的轉帳功能的示例：

javascript import { pipe } from "@solana/web3.js"; import { getTransferSolInstruction } from "@solana/system-program";

const transaction = pipe( createTransaction({ version: 0 }), addInstruction(getTransferSolInstruction({ from: senderPublicKey, to: recipientPublicKey, amount: lamports, })), setComputeUnitLimit(200_000), addSignature(senderSignature) );

const signature = await sendAndConfirmTransaction(rpc, transaction);

可以發現，交易不再通過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網路進行交互的方式，有助於推動該平台的採用和發展。