Wenn Sie von @solana/web3.js (Legacy), @solana/wallet-adapter-* oder den
früheren Framework-Kit-Paketen (@solana/client, @solana/react-hooks,
@solana/web3-compat) kommen, empfehlen wir die Migration zu den
@solana/kit-Plugins oder zu @solana/web3.js v3 (oder höher).
Diese Seite ordnet die Ihnen bereits bekannten Konzepte ihren Kit-Entsprechungen zu.
Konzept-Mapping
| web3.js (Legacy) / wallet-adapter | Kit |
|---|---|
new Connection(url) | createSolanaRpc(url), oder .use(solanaRpc({ rpcUrl })) auf einem Client |
PublicKey | Address — String umwandeln mit address("...") |
Keypair | generateKeyPairSigner() oder die @solana/kit-plugin-signer-Plugins |
SystemProgram.transfer(...) | getTransferSolInstruction(...) aus @solana-program/system |
LAMPORTS_PER_SOL-Arithmetik | lamports(...) aus @solana/kit |
Transaction / VersionedTransaction | Transaktionsnachrichten, die vom Transaction Planner erstellt und verpackt werden |
sendAndConfirmTransaction(...) | client.sendTransaction([...]) (Planner signiert, sendet und bestätigt) |
@solana/wallet-adapter-* | @solana/kit-plugin-wallet + Wallet Standard Discovery |
web3.js v3 behält die oben genannten klassenbasierten Namen — Connection, Keypair,
Transaction, PublicKey — als schlanke Wrapper über den Kit-Interna bei, sodass die Kit-Spalte
auch beschreibt, was diese Klassen in v3 unter der Haube tun.
Von web3.js migrieren?
Wenn Sie eine umfangreiche @solana/web3.js-Codebasis (Legacy) pflegen und ein vollständiges Rewrite
auf Kit nicht praktikabel ist, ist web3.js v3 die Brücke. Installieren Sie es mit
@solana/web3.js@3. Es baut die klassische klassenbasierte API — Connection,
Keypair, Transaction, PublicKey — auf den Interna von @solana/kit neu auf.
Da es auf Kit aufsetzt, ist die Interoperabilität eng: PublicKey ist der primäre Adresstyp,
und seine Methode .toBase58() gibt den Branded-Address-String von Kit zurück. Ein v3-Keypair
implementiert den KeyPairSigner von Kit, sodass Sie ihn direkt an Kit-APIs, Plugins und
mit Codama generierte Clients übergeben können.
v1-Transaktionen und web3.js (Legacy)
Wenn Sie v1-Transaktionen mit web3.js senden, müssen Sie v3 oder höher verwenden.
Informationen zur Migration selbst finden Sie im offiziellen Migrationsleitfaden web3.js v1 → v3.
Wallets
Kit verwendet keinen wallet-adapter. @solana/kit-plugin-wallet erkennt Wallet
Standard-Wallets und stellt sie über client.wallet sowie die
React-Hooks bereit. Moderne Wallets (Phantom,
Solflare, Backpack und andere) melden sich selbst über den Wallet Standard an,
sodass kein wallet-spezifisches Adapter-Paket erforderlich ist.
Sie können auch vorgefertigte Tools wie @solana/connector verwenden, das Kit-Primitive direkt zur Verbindung mit Wallets nutzt.
Noch auf wallet-adapter?
Wenn Sie eine App pflegen, die auf @solana/wallet-adapter-* basiert und noch
nicht zur Migration bereit sind, bleibt das wallet-adapter
Repository die Referenz für
diesen Stack. Für alle Neuentwicklungen empfehlen wir das Kit-Wallet-Plugin.
Wie geht es weiter
- Kit-Client — einen Client aus Plugins zusammenstellen.
- React —
@solana/react-Bindings und Wallet- Hooks. - Next.js-Tutorial — eine vollständige App von Anfang bis Ende.
Is this page helpful?