Si vous venez de @solana/web3.js (legacy), @solana/wallet-adapter-*,
ou des anciens packages framework-kit (@solana/client, @solana/react-hooks,
@solana/web3-compat), nous vous encourageons à migrer vers les plugins @solana/kit ou
vers @solana/web3.js v3 (ou version supérieure).
Cette page fait correspondre les concepts que vous connaissez déjà à leurs équivalents Kit.
Correspondance des concepts
| web3.js (legacy) / wallet-adapter | Kit |
|---|---|
new Connection(url) | createSolanaRpc(url), ou .use(solanaRpc({ rpcUrl })) sur un client |
PublicKey | Address — convertir une chaîne avec address("...") |
Keypair | generateKeyPairSigner() ou les plugins @solana/kit-plugin-signer |
SystemProgram.transfer(...) | getTransferSolInstruction(...) de @solana-program/system |
LAMPORTS_PER_SOL math | lamports(...) de @solana/kit |
Transaction / VersionedTransaction | Messages de transaction construits et empaquetés par le planificateur de transactions |
sendAndConfirmTransaction(...) | client.sendTransaction([...]) (le planificateur signe, envoie et confirme) |
@solana/wallet-adapter-* | @solana/kit-plugin-wallet + découverte via Wallet Standard |
web3.js v3 conserve les noms basés sur des classes ci-dessus — Connection, Keypair,
Transaction, PublicKey — sous forme de fines surcouches au-dessus des composants internes de Kit, de sorte que la colonne
Kit décrit également ce que font ces classes en coulisses dans la v3.
Vous venez de web3.js ?
Si vous maintenez une grande base de code @solana/web3.js (legacy) et qu'une réécriture complète
vers Kit n'est pas envisageable, web3.js v3 fait office de passerelle. Installez-le avec
@solana/web3.js@3. Il reconstruit l'API classique basée sur des classes — Connection,
Keypair, Transaction, PublicKey — au-dessus des composants internes de @solana/kit.
Comme il repose sur Kit, l'interopérabilité est étroite : PublicKey est le type d'adresse
principal et sa méthode .toBase58() renvoie la chaîne Address typée (branded) de Kit, et un Keypair v3
implémente le KeyPairSigner de Kit, ce qui vous permet de le passer directement aux API Kit,
aux plugins et aux clients générés par Codama.
Transactions v1 et web3.js (legacy)
Si vous envoyez des transactions v1 avec web3.js, vous devez utiliser la v3 ou une version ultérieure.
Pour la migration proprement dite, consultez le guide de migration de web3.js v1 vers v3 officiel.
Portefeuilles
Kit n'utilise pas wallet-adapter. @solana/kit-plugin-wallet découvre les
portefeuilles compatibles Wallet Standard et les expose via client.wallet et
les hooks React. Les portefeuilles modernes
(Phantom, Solflare, Backpack, et autres) s'annoncent via Wallet Standard, donc
aucun package adaptateur par portefeuille n'est requis.
Vous pouvez également utiliser des outils prêts à l'emploi comme @solana/connector, qui utilise directement les primitives de Kit pour se connecter aux portefeuilles.
Vous utilisez encore wallet-adapter ?
Si vous maintenez une application construite sur @solana/wallet-adapter-* et
que vous n'êtes pas prêt à migrer, le dépôt wallet-adapter
reste la référence pour cette
stack. Pour tout nouveau projet, privilégiez le plugin de portefeuille Kit.
Où aller ensuite
- Client Kit — assemblez un client à partir de plugins.
- React — liaisons
@solana/reactet hooks de portefeuille. - Tutoriel Next.js — une application complète de bout en bout.
Is this page helpful?