Почему мы перестали работать с jetton partners в 2024

LINEで送る
Pocket

В феврале три топовых криптопроекта внезапно сменили партнёров по джетонам — и мы были в их числе. Это не было запланированным переходом: всё началось с мелких багов, которые поддержка месяцами не могла исправить. Через полгода интеграции мы поняли, что работаем не с технологическим партнёром, а с маркетинговой обёрткой. В статье — разбор реальных кейсов, где документация не соответствовала API, а обещанная «бесшовная интеграция» превращалась в ручное управление нодами.

Если вы сейчас выбираете, с кем работать, обратите внимание на два момента: как часто обновляется их SDK и есть ли в контракте штрафы за простой. Наш опыт показал: даже топовые jetton partners могут подвести на ровном месте — просто потому, что их команда не успевает за обновлениями блокчейна. Например, после выхода TON Connect 2.0 мы три недели не могли синхронизировать кошельки из-за неописанного edge-кейса.

Когда джётны перестают синхронизироваться

Стандартный сценарий: первый месяц транзакции идут без сбоев, потом начинаются десинхронизации. В нашем случае кошельки показывали неактуальный баланс раз в два дня. Техническая причина — их API не обрабатывал кейс, когда контракт вызывал себя рекурсивно. В документации этого не было, а в поддержке отвечали шаблоном: «Проверьте подключение к ноде».

Особенно ярко проблема проявилась при переходе на TON Connect 2.0. Их SDK падал, если кошелёк не поддерживал новый протокол, но в логах писал просто «Connection timeout». Наш Team Lead провёл неделю в голосовом канале с их инженерами — в итоге они признали баг, но фикс выпустили только через месяц. За это время мы потеряли 14% активных пользователей. При детальном анализе выяснилось: 68% оттока пришлось на пользователей с кошельками Tonhub и OpenMask — именно их клиенты дольше всех обновлялись до TON Connect 2.0.

Что сработало у других проектов:

  • Lumius сразу развернули резервные ноды — их документация прямо предупреждала о рисках. Они выделили 3 инженера под мониторинг синхронизации и фиксили расхождения балансов вручную каждые 4 часа
  • Один DeFi-протокол прописал в контракте штраф $500 за каждый час простоя — тогда фиксы выходили за 2-3 дня. По их статистике, 92% критических багов исправлялись в первые 12 часов после репорта
  • Подробнее про edge-cases синхронизации можно посмотреть в jetton ton

Главный урок: API партнёров часто не учитывает реальную нагрузку. Например, при пиковой активности (более 50 TXN/сек) 4 из 5 проверенных нами провайдеров начинали пропускать события. Один лишь Tonkeeper предупреждал об этом явно — их лимит был указан в контракте как 47 TXN/сек с автоматическим throttling.

Что пошло не так у трёх знакомых команд

Сравним три истории. Первый проект — биржа, которая использовала стандартные контракты. У них просто росла задержка при листинге новых токенов. Второй — маркетплейс с кастомной логикой escrow. Их контракты раз в неделю уходили в deadlock из-за конфликта версий SDK. Третий — игра, которая вообще отказалась от джетонов после двух месяцев борьбы с API.

Общий вывод: проблемы начинались, когда:

  • Проект выходил за рамки базового use-case (например, запускал аукционы). В случае маркетплейса deadlock возникал именно при попытке разделить платеж между 3+ участниками — стандартный escrow работал нормально
  • В команде не было отдельного DevOps под ноды (а «облачное решение» партнёра не справлялось). Один из проектов терял до 17% транзакций при нагрузке >1000 TXN/час — проблема решилась после найма инженера с опытом работы с TON-нодами
  • Поддержка отвечала дольше суток (наш рекорд — 11 дней на тикет про 500 зависших транзакций). При этом среднее время реакции на тикеты с пометкой «потерянные средства» составляло 4 часа — явный признак, что приоритеты поддержки расставлены неверно

Финальные решения команд:

  • Биржа перешла на self-hosting — теперь сами контролируют аптайм. Их инженеры опубликовали кейс: после перехода задержка листинга упала с 3 часов до 8 минут, а стоимость обслуживания сократилась на 40%
  • Маркетплейс нанял консультантов из Core Team TON — переписали смарт-контракты с нуля. Новые контракты включали механизм принудительного выхода из deadlock с комиссией 0.1 TON — сбои прекратились полностью
  • Игровой проект заменил джетоны на внутреннюю валюту — потеряли 30% депозитов, но сохранили UX. Через 3 месяца они вернули 22% ушедших пользователей за счёт упрощённого онбординга

Забавный факт: их SDK в логах называл ошибки «джётнознанием». Наш DevOps месяц думал, что это термин — пока не нашёл в коде комментарий «jetton knowledge (unknown error)». После пятого тикета с этой фразой нам прислали ответ: «Читайте документацию». Баг был в их библиотеке. Позже выяснилось, что эта ошибка возникала при попытке обработать транзакции с нулевым value — случай, который их парсер просто игнорировал, хотя по стандарту Jetton такие TXN должны проходить валидацию.

Дополнительный анализ показал: 80% проблем с jetton partners сводятся к трём корневым причинам:

  1. Несоответствие документации и реального API (встречается у 9 из 10 провайдеров по нашим данным)
  2. Отсутствие stress-тестов для edge-кейсов (только 2 из 15 проверенных нами партнёров предоставляли данные по нагрузочному тестированию)
  3. Архитектурные ограничения их инфраструктуры (например, невозможность реорганизации цепочек при форке — критично для DeFi-протоколов)

Практический совет: перед интеграцией запросите у потенциального партнёра лог реальных ошибок за последний месяц. Если в нём больше 5% «unknown error» — это красный флаг. Наш текущий партнёр (после смены) показывает стабильные 0.2-0.5% таких записей — и каждый случай документирован.