Skip to main content

Installation

Installez helius-wallet-kit à partir de npm (Node.js 18+):
Dépendances homologues requises :
  • react >= 18
  • react-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 à /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
Réglez 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
Vous choisissez les méthodes de connexion que vos utilisateurs voient dans le tableau de bord — voir Configurer les méthodes de connexion.

Raccourci de prototypage

Vous essayez juste localement ? Ignorez le gestionnaire de route et passez directement votre clé API au fournisseur :
app/providers.tsx
Cela envoie la clé dans votre bundle de navigateur, donc c’est uniquement pour tests locaux — passez à la configuration du gestionnaire de route ci-dessus avant de déployer. Limitez la clé au domaine en attendant (voir Sécuriser votre clé) : elle ne peut toucher ni les portefeuilles ni les fonds, mais une clé publique peut toujours être utilisée pour dépenser vos crédits.

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.