Installation
Installezhelius-wallet-kit à partir de npm (Node.js 18+):
react >= 18react-dom >= 18@solana/web3.js ^1.98
next >= 14 est nécessaire pour la configuration de gestionnaire de route recommandée ci-dessous.
Configuration
La configuration recommandée garde votre clé API Helius côté serveur — aucune clé Helius n’est envoyée au navigateur. Vous testez localement ? Passez directement au raccourci de prototypage.1
Enveloppez votre application dans le fournisseur
Ajoutez
HeliusWalletProvider près de la racine de votre application dans un composant client. Omettez la clé API — le gestionnaire de route (étape suivante) la fournit côté serveur. Le SDK résout automatiquement votre id de projet et les URLs RPC sécurisées sans clé.app/providers.tsx
2
Montez le gestionnaire de route
Ajoutez le gestionnaire de route générique à Réglez
/api/helius/[...path]. Il contient HELIUS_API_KEY côté serveur et relaie l’amorçage du portefeuille, le RPC, les envois et l’enregistrement — ainsi, aucune clé Helius n’atteint jamais le navigateur. Cela vous permet d’avoir Landing optimisé pour l’expéditeur et un historique des transactions.app/api/helius/[...path]/route.ts
HELIUS_API_KEY comme une variable d’environnement serveur (non NEXT_PUBLIC_); le gestionnaire l’injecte dans les requêtes transférées.3
Importez les styles
Importez la feuille de style du SDK une fois, dans la mise en page racine :
app/layout.tsx
Raccourci de prototypage
Vous essayez juste localement ? Ignorez le gestionnaire de route et passez directement votre clé API au fournisseur :app/providers.tsx
Prochaines étapes
Configuration
Options de configuration et méthodes de connexion au tableau de bord.
Utiliser le portefeuille
Lire l’état d’authentification, signer, envoyer et lire l’historique.