⚡ Por qué usar el SDK
Nuestro SDK es la forma más rápida y fiable de recibir shreds ShredStream.com — en unas pocas líneas de código, en todos tus lenguajes. Esta página explica lo que el SDK hace por ti y por qué es la integración recomendada.
En resumen — ShredStream.com entrega shreds Solana custom por UDP. El SDK se encarga del formato de red para que tú te centres en tu estrategia, no en la fontanería.
🧩 Lo que el SDK gestiona por ti
Nuestro SDK es una capa fina entre la red y tu aplicación. Se encarga de todo lo que tendrías que construir de otro modo:
| Tema | Sin el SDK | Con el SDK |
|---|---|---|
| Socket UDP + buffers del SO | Abres, vinculas, ajustas rmem_max/maxsockbuf, monitorizas drops | Automático en listener.start() |
| Parseo del formato shred | Parseas paquetes binarios de 1203 bytes (variante 0xA5, offsets, tamaño, zero padding) | Parseado en estructuras tipadas |
| Decodificación de transacciones | Decodificas transacciones Solana desde los payloads | Transacciones decodificadas, listas para iterar |
| Ensamblaje de slots | Reordenas shreds por índice dentro de cada slot | Ensamblado por slot automáticamente |
| Shutdown limpio | Drenas sockets y haces flush de buffers | Gestionado en el ciclo de vida del listener |
🌐 En todos tus lenguajes
El SDK está disponible para los cuatro lenguajes más usados por traders Solana, bots, MEV searchers y desarrolladores DeFi — con la misma API en cada uno:
cargo add shredstreamgo get github.com/shredstream/shredstream-sdk-goInstala un paquete, vincula el puerto asignado, itera sobre las transacciones. Las mismas 5 o 6 líneas de código en cada lenguaje.
🚀 Cero penalización de latencia
Una preocupación común: «¿decodificar ralentiza las cosas?» Respuesta corta — no.
- El SDK añade un overhead sub-milisegundo sobre nuestra entrega.
- Sigues por delante de Geyser gRPC incluso con la decodificación activada.
- Las transacciones decodificadas se emiten a medida que llegan los shreds, no al final del slot.
El compromiso entre «raw wire» y «decoded» es una micro-latencia teórica. En la práctica, nuestros benchmarks de SDK muestran una latencia P50 idéntica entre un listener UDP crudo y la salida decodificada del SDK.
🛠️ ¿Puedo construir mi propio receptor?
Sí. Documentamos completamente el formato de paquetes — ver Formato de paquetes. Pero pregúntate: ¿es ahí donde quieres invertir tu tiempo de ingeniería?
Nuestro formato de shred es custom y puede no coincidir con lo que espera tu tooling Solana existente. Si conectas un decodificador de shreds estándar a nuestro flujo UDP, no funcionará out of the box. El SDK existe precisamente para que no tengas que reimplementar parsing, socket tuning y decodificación por tu cuenta.
Si aun así quieres ir en raw:
- Lee Formato de paquetes para la estructura binaria.
- Consulta Configuración de red para ajustar tus buffers de socket.
- Planifica tu propio ensamblaje de slots y decodificación de transacciones.
🎯 Cuándo usar el SDK
Usa el SDK si tú:
- Quieres streamear transacciones en menos de 5 minutos.
- Construyes bots, HFT, MEV, Snipers, DeFi o analytics — y necesitas transacciones decodificadas.
- No quieres mantener un parser custom para un formato binario propietario.
Ve en raw solo si tú:
- Tienes una razón muy específica para hacer parsing custom (profiling, sistemas embebidos, investigación académica).
- Estás cómodo manteniendo un decodificador de shreds alineado con nuestra spec.
En cualquier caso, el SDK es el camino más corto. Recomendamos encarecidamente empezar por él — siempre podrás bajar a UDP crudo más tarde si lo necesitas.
➡️ Próximos pasos
- Inicio rápido SDK — instala y recibe tu primer shred.
- Configuración de red — firewall y tuning del SO.
- Mejores prácticas — monitorización, redundancia, rendimiento.
- Avanzado: Formato de paquetes para receptores custom.