⚡ Почему стоит использовать SDK
Наш SDK — это самый быстрый и надёжный способ получать shreds ShredStream.com — всего несколько строк кода, на всех ваших языках. Эта страница объясняет, что SDK делает за вас и почему это рекомендуемая интеграция.
Вкратце — ShredStream.com доставляет custom-shreds Solana по UDP. SDK берёт на себя сетевой формат, чтобы вы могли сосредоточиться на стратегии, а не на инфраструктуре.
🧩 Что SDK делает за вас
Наш SDK — это тонкий слой между сетью и вашим приложением. Он берёт на себя всё, что иначе пришлось бы строить самим:
| Тема | Без SDK | С SDK |
|---|---|---|
| UDP-сокет + буферы ОС | Вы открываете, биндите, тюните rmem_max/maxsockbuf, отслеживаете drops | Автоматически при listener.start() |
| Парсинг формата shred | Вы парсите бинарные пакеты 1203 байт (вариант 0xA5, offsets, size, zero padding) | Распаршено в типизированные структуры |
| Декодирование транзакций | Вы декодируете транзакции Solana из payload'ов | Транзакции декодированы, готовы к итерации |
| Сборка slot'ов | Вы переупорядочиваете shreds по индексу в каждом slot'е | Собрано по slot'ам автоматически |
| Корректный shutdown | Вы drain'ите сокеты и flush'ите буферы | Обрабатывается в жизненном цикле listener'а |
🌐 На всех ваших языках
SDK поставляется для четырёх языков, наиболее используемых трейдерами Solana, ботами, MEV searcher'ами и DeFi-разработчиками — с одним и тем же API в каждом:
cargo add shredstreamgo get github.com/shredstream/shredstream-sdk-goУстановите пакет, забиндите назначенный порт, итерируйте по транзакциям. Те же 5–6 строк кода на каждом языке.
🚀 Ноль штрафа по задержке
Частое опасение: «а не замедляет ли декодирование?» Короткий ответ — нет.
- SDK добавляет sub-миллисекундный overhead поверх нашей доставки.
- Вы остаётесь впереди Geyser gRPC даже с включённым декодированием.
- Декодированные транзакции выдаются по мере прибытия shreds, а не в конце slot'а.
Компромисс между «raw wire» и «декодированием» — это теоретическая микро-задержка. На практике наши SDK-бенчмарки показывают идентичную P50 latency между сырым UDP-listener'ом и декодированным выводом SDK.
🛠️ Могу ли я построить свой приёмник?
Да. Мы полностью документируем формат пакетов — см. Формат пакетов. Но спросите себя: действительно ли это то, где вы хотите тратить инженерное время?
Наш формат shred — custom и может не совпадать с тем, что ожидает ваш существующий Solana-инструментарий. Если подключить стандартный декодер shred к нашему UDP-потоку, он не заработает out of the box. SDK существует как раз для того, чтобы вам не пришлось реализовывать парсинг, socket tuning и декодирование самим.
Если вы всё же хотите идти в raw:
- Прочитайте Формат пакетов для бинарной структуры.
- См. Настройка сети для тюнинга socket-буферов.
- Спланируйте собственную сборку slot'ов и декодирование транзакций.
🎯 Когда использовать SDK
Используйте SDK, если вы:
- Хотите начать стримить транзакции менее чем за 5 минут.
- Строите ботов, HFT, MEV, Snipers, DeFi или analytics — и нуждаетесь в декодированных транзакциях.
- Не хотите поддерживать custom-парсер для проприетарного бинарного формата.
Идите в raw только если вы:
- Имеете очень конкретную причину для custom-парсинга (профилирование, встраиваемые системы, академическое исследование).
- Комфортно поддерживать декодер shred, выровненный с нашей спецификацией.
В любом случае SDK — кратчайший путь. Настоятельно рекомендуем начать с него — при необходимости всегда можно спуститься к сырому UDP позже.
➡️ Следующие шаги
- Быстрый старт SDK — установите и получите первый shred.
- Настройка сети — firewall и тюнинг ОС.
- Лучшие практики — мониторинг, избыточность, производительность.
- Продвинутое: Формат пакетов для custom-приёмников.