⥠Pourquoi utiliser le SDK
Notre SDK est la voie la plus rapide et la plus fiable pour recevoir des shreds ShredStream.com â en quelques lignes de code, dans tous vos langages. Cette page explique ce que le SDK fait pour vous et pourquoi c'est l'intĂ©gration recommandĂ©e.
En bref â ShredStream.com livre des shreds Solana custom en UDP. Le SDK gĂšre le format rĂ©seau pour que vous vous concentriez sur votre stratĂ©gie, pas sur la plomberie.
𧩠Ce que le SDK gÚre pour vous
Notre SDK est une couche fine entre le réseau et votre application. Il prend en charge tout ce que vous auriez à construire sinon :
| Sujet | Sans le SDK | Avec le SDK |
|---|---|---|
| Socket UDP + buffers OS | Vous ouvrez, bindez, tunez rmem_max/maxsockbuf, surveillez les drops | Automatique au listener.start() |
| Parsing du format shred | Vous parsez des paquets binaires de 1203 octets (variant 0xA5, offsets, taille, zero padding) | Parsé en structures typées |
| DĂ©codage des transactions | Vous dĂ©codez les transactions Solana depuis les payloads | Transactions dĂ©codĂ©es, prĂȘtes Ă itĂ©rer |
| Assemblage des slots | Vous réordonnez les shreds par index dans chaque slot | Assemblé par slot automatiquement |
| Shutdown propre | Vous drainez les sockets et flushez les buffers | Géré dans le cycle de vie du listener |
đ Dans tous vos langages
Le SDK est livrĂ© pour les quatre langages les plus utilisĂ©s par les traders Solana, bots, MEV searchers et dĂ©veloppeurs DeFi â avec la mĂȘme API dans chacun :
npm install shredstreampip install shredstreamcargo add shredstreamgo get github.com/shredstream/shredstream-sdk-goInstallez un package, bindez le port qui vous est assignĂ©, itĂ©rez sur les transactions. Les mĂȘmes 5 Ă 6 lignes de code dans chaque langage.
đ ZĂ©ro pĂ©nalitĂ© de latence
Une inquiĂ©tude courante : « est-ce que le dĂ©codage ralentit les choses ? » RĂ©ponse courte â non.
- Le SDK ajoute un overhead sub-milliseconde au-dessus de notre livraison.
- Vous restez devant Geyser gRPC mĂȘme avec le dĂ©codage activĂ©.
- Les transactions décodées sont émises au fur et à mesure que les shreds arrivent, pas à la fin du slot.
Le compromis entre « raw wire » et « décodé » est une micro-latence théorique. En pratique, nos benchmarks SDK montrent une latence P50 identique entre un listener UDP brut et la sortie décodée du SDK.
đ ïž Puis-je construire mon propre rĂ©cepteur ?
Oui. Nous documentons entiĂšrement le format des paquets â voir Format des paquets. Mais posez-vous la question : est-ce lĂ que vous voulez passer votre temps d'ingĂ©nierie ?
Notre format de shred est custom et peut ne pas correspondre à ce qu'attend votre outillage Solana existant. Si vous branchez un décodeur de shreds standard sur notre flux UDP, ça ne marchera pas out of the box. Le SDK existe précisément pour que vous n'ayez pas à réimplémenter parsing, socket tuning et décodage de votre cÎté.
Si vous voulez quand mĂȘme passer en raw :
- Lisez Format des paquets pour la structure binaire.
- Consultez Configuration réseau pour tuner vos buffers socket.
- Prévoyez votre propre assemblage de slots et décodage de transactions.
đŻ Quand utiliser le SDK
Utilisez le SDK si vous :
- Voulez streamer des transactions en moins de 5 minutes.
- Construisez des bots, HFT, MEV, Snipers, DeFi ou analytics â et avez besoin de transactions dĂ©codĂ©es.
- Ne voulez pas maintenir un parser custom pour un format binaire propriétaire.
Partez en raw uniquement si vous :
- Avez une raison trÚs spécifique de faire un parsing custom (profiling, systÚmes embarqués, recherche académique).
- Ătes Ă l'aise avec le maintien d'un dĂ©codeur de shreds alignĂ© sur notre spec.
Dans les deux cas, le SDK est le chemin le plus court. Nous recommandons fortement de commencer par lui â vous pourrez toujours descendre en UDP brut plus tard si besoin.
âĄïž Ătapes suivantes
- SDK Quick Start â installez et recevez votre premier shred.
- Configuration rĂ©seau â firewall et tuning OS.
- Bonnes pratiques â monitoring, redondance, performance.
- Avancé : Format des paquets pour les récepteurs custom.