Que sont les webhooks Solana ?
Les webhooks Solana sont des notifications HTTP en temps réel envoyées à votre application lorsque des événements on-chain se produisent. Au lieu de sonder continuellement la blockchain, Helius pousse les données de transaction analysées directement à votre point de terminaison chaque fois qu’un portefeuille transfère des fonds, qu’un NFT est vendu, ou qu’un type de transaction surveillé est déclenché. Utilisez les webhooks pour alimenter les bots de trading, les tableaux de bord d’analyse, les pipelines de conformité, et l’automatisation pilotée par les événements. Nous proposons une interface conviviale, une API programmatique, et un accès au SDK pour créer et gérer facilement les webhooks. Pour les questions fréquemment posées, consultez la FAQ Webhooks. Pour les nouveaux projets qui nécessitent des transactions analysées en temps réel, envisagez d’utiliser Parsed Streams. Cette solution succède à Enhanced Transaction Webhooks, décode chaque instruction à l’aide du catalogue IDL, applique un filtrage côté serveur par programme, compte et nom d’instruction, et est facturée au même tarif de 1 crédit par événement pour tous les forfaits.Tarification
Les événements de webhook sont facturés 1 crédit lorsque Helius traite et envoie l’événement à votre point de terminaison. Vous êtes facturé, que votre point de terminaison traite correctement le webhook ou non. La modification, l’ajout ou la suppression d’un webhook via l’API coûte 100 crédits/requête.Types de webhooks
Nous proposons actuellement plusieurs types de webhooks adaptés à différents besoins :Enhanced Transaction Webhooks
Fournissent des données analysées et lisibles par l’utilisateur pour des types de transactions spécifiques (par exemple, les ventes de NFT) liés aux adresses que vous surveillez. Cette option est idéale si vous souhaitez obtenir des informations filtrées et exploitables.Raw Transaction Webhooks
Cette option fournit les données de transaction brutes pour toutes les transactions impliquant les adresses que vous surveillez. Elle ne permet pas de filtrer par type de transaction.Raw Transaction Webhooks offre une latence plus faible, car ce type de webhook n’analyse pas les types d’événements.
Webhooks Discord
Diffusez les mises à jour concernant des types de transactions spécifiques directement dans un canal Discord désigné, sous forme de messages mis en forme. Pour utiliser cette option, vous devez fournir l’URL de votre webhook Discord.Exemple de charge utile d’événement
Enhanced
Enhanced
Raw
Raw
Bien démarrer
Webhooks Quickstart
Créez votre premier webhook via le tableau de bord, l’API REST ou le SDK officiel TypeScript / Rust.
Désactivation automatique des webhooks défaillants
Helius surveille l’état des points de terminaison des webhooks et désactive automatiquement les webhooks dont les livraisons échouent systématiquement. Cela évite les tentatives de livraison inutiles vers des points de terminaison inaccessibles ou défaillants.Fonctionnement
- Forfaits payants (Dev et supérieurs) : les webhooks présentant un taux d’échec ≥ 95 % sur 7 jours sont automatiquement désactivés.
- Forfait gratuit : les webhooks sont évalués sur une période de 24 heures avec le même seuil d’échec.
Notifications par e-mail
Les utilisateurs du forfait Dev ou supérieur reçoivent une notification par e-mail lorsqu’un webhook est automatiquement désactivé.Réactivation d’un webhook désactivé
1
Fix your endpoint
Résolvez le problème à l’origine des échecs de livraison (par exemple, indisponibilité du serveur, URL incorrecte ou erreurs du point de terminaison).
2
Log in to the Helius Dashboard
Accédez au tableau de bord Helius.
3
Re-enable the webhook
Recherchez le webhook désactivé et réactivez-le.
Après sa réactivation, le webhook bénéficie d’une période de grâce de 24 heures pendant laquelle il ne sera pas automatiquement désactivé à nouveau. Vous disposez ainsi du temps nécessaire pour vérifier que votre point de terminaison fonctionne correctement.
Exemples d’utilisation
Bots
- Lorsqu’un NFT est mis en vente sur la place de marché X, déclenchez une action « acheter le NFT ».
- Lorsqu’une position sur marge présente un risque, déclenchez une action de « liquidation ».
Surveillance et alertes
- Lorsqu’un programme émet un journal spécifique, cela déclenche l’intégration PagerDuty.
- Lorsque le solde d’un compte de jetons varie de plus de X %, utilisez Dialect pour envoyer un avertissement.
Indexation pilotée par les événements
- Lorsqu’une transaction se produit pour un programme donné, envoyez-la directement à votre base de données ou à votre backend.
Notifications et suivi de l’activité
- Lors d’un transfert du portefeuille X vers le portefeuille Y, envoyez une notification Slack ou un e-mail.
Analyses et journaux
- Lorsque l’événement X se produit, envoyez-le à un pipeline ETL ou conservez-le directement sur Helius afin d’observer les tendances au fil du temps.
Automatisation des workflows
- Lorsque l’événement X se produit, déclenchez n’importe quel ensemble d’actions.