Migration zu Kit

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 @solana/kit-Plugins oder zu @solana/web3.js v3 (oder höher).

Diese Seite ordnet die Konzepte, die Sie bereits kennen, ihren Kit-Äquivalenten zu.

Konzept-Mapping

web3.js (Legacy) / wallet-adapterKit
new Connection(url)createSolanaRpc(url), oder .use(solanaRpc({ rpcUrl })) auf einem Client
PublicKeyAddress — String umwandeln mit address("...")
KeypairgenerateKeyPairSigner() oder die @solana/kit-plugin-signer-Plugins
SystemProgram.transfer(...)getTransferSolInstruction(...) aus @solana-program/system
LAMPORTS_PER_SOL-Arithmetiklamports(...) aus @solana/kit
Transaction / VersionedTransactionTransaktionsnachrichten, 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 dünne Wrapper über den Kit-Interna bei, sodass die Kit- Spalte auch beschreibt, was diese Klassen in v3 im Hintergrund tun.

Von web3.js migrieren?

Wenn Sie eine umfangreiche @solana/web3.js-(Legacy-)Codebasis pflegen und eine vollständige Umstellung 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 Kits Branded-Address-String zurück. Ein v3-Keypair implementiert Kits KeyPairSigner, sodass Sie ihn direkt an Kit- APIs, Plugins und von Codama generierte Clients übergeben können.

v1-Transaktionen und web3.js (Legacy)

Wenn Sie v1-Transaktionen mit web3.js senden, müssen Sie v3+ verwenden.

Informationen zur Migration selbst finden Sie im offiziellen web3.js v1 → v3 Migrationsleitfaden.

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?

Inhaltsverzeichnis

Seite bearbeiten
© 2026 Solana Foundation. Alle Rechte vorbehalten.