Кросчейн-свопи з TON у BNB Chain: як це працює

Агент, якому доручили «обміняти GRAM на BNB і заплатити контрагенту в мережі BNB Chain», впирається у стіну вже на першому кроці. Він не має способу безпечно перенести цінність між двома блокчейнами, які нічого не знають один про одного. Класичний шлях — централізований міст або біржа: закинь монети, довірся, чекай і сподівайся, що кошти не застрягнуть між мережами. Для автономного ШІ-агента це неприйнятно: він не може «довіряти» кастодіану, не має права віддавати чужі ключі третій стороні й не має рук, щоб вручну владнати завислу транзакцію.

Потрібен спосіб перемістити цінність із TON у BNB Chain так, щоб або все пройшло повністю, або все повернулося назад — без посередника, який тримає гроші. Саме це робить кросчейн-своп через атомарний HTLC-ескроу. Нижче розберемо, як він влаштований, якими п'ятьма MCP-інструментами TONNode агент проводить угоду і чому сервер при цьому жодного разу не торкається ваших коштів.

Що таке кросчейн-своп TON → BNB Chain і навіщо він агенту

Кросчейн-своп — це обмін активу в одній мережі на актив в іншій без спільного реєстру між ними. TON і BNB Chain — дві незалежні мережі зі своїми віртуальними машинами; у них немає спільного «банку», який просто переписав би баланс. Отже, потрібен протокол, який синхронізує два незалежні перекази так, щоб вони стали нерозривними.

У TONNode кросчейн завжди йде з TON як джерела в цільову EVM-мережу — у нашому випадку BNB Chain. Зворотного напрямку і «BNB як джерела» немає: TON — завжди відправна точка. Ви блокуєте GRAM або жетон на боці TON, а отримуєте актив на боці BNB Chain.

GRAM — це перейменований у червні 2026 року Toncoin. Мережа й далі називається TON, змінилася лише назва монети.

Навіщо це агенту? Бо реальні завдання рідко замикаються всередині однієї мережі. Агент-скарбник тримає скарбницю в GRAM, але постачальнику треба заплатити в BNB Chain. Торговий бот бачить арбітраж між DEX у TON і в BNB. Асистент виконує доручення «перекажи еквівалент 50 GRAM контрагенту в BSC». У всіх випадках потрібен спосіб перетнути кордон мереж — детерміновано, без кастодіана і без ручного втручання.

Як працює атомарний HTLC-ескроу: секрет, хеш і таймлок

HTLC розшифровується як Hashed Timelock Contract — контракт із хеш-замком і таймлоком. Звучить складно, але аналогія проста.

Уявіть дві сейфові комірки: одна в TON, друга в BNB Chain. Обидві замикаються одним і тим самим замком, який відкривається єдиним секретним ключем — випадковим числом, «секретом» S. У блокчейн потрапляє не сам секрет, а його хеш H = hash(S) — наче відбиток замка. Будь-хто може перевірити, що ключ пасує до замка, але за відбитком сам ключ не відновити.

Комірку на BNB Chain наповнюєте не ви: зустрічну ногу виставляє контрагент — резолвер (маркетмейкер), який блокує BNB під тим самим хешем H, розраховуючи забрати ваші GRAM на боці TON тим самим секретом. Саме тому угода симетрична: обидві сторони замкнені одним замком.

Далі працюють дві умови:

• Хеш-замок. Забрати кошти з комірки можна, лише пред'явивши секрет, що збігається з опублікованим хешем. Щойно секрет розкрито на одному боці, він стає видимим і на іншому — і друга нога угоди виконується тим самим ключем. Хто забирає кошти, зобов'язаний пред'явити S у відкритому вигляді ончейн.
• Таймлок. У кожної комірки є таймер. Якщо угода не завершилася до спливу таймлоку, кошти повертаються початковому власнику. Таймлоки виставлені так, що сторона, яка розкриває секрет першою, не може обдурити зустрічну сторону.

Підсумок — атомарність: або виконуються обидві ноги, або повертаються обидві. Проміжного стану, де ви віддали GRAM, а BNB не прийшли, фізично не існує. Жодної третьої сторони, яка «гарантує» угоду, тут немає — гарантію дає математика хеш-функції та логіка таймлоків у контрактах. Це той самий механізм, що стоїть за атомарними свопами і Lightning-платежами, тільки адаптований під TON та EVM.

П'ять інструментів угоди: котирування, збірка, трекінг, розкриття, рефанд

Весь життєвий цикл кросчейн-свопу в TONNode покривають п'ять MCP-інструментів. Агент викликає їх по черзі — як щаблі однієї угоди.

get_crosschain_quote — котирування

Повертає котирування угоди TON → BNB Chain: скільки ви віддаєте на боці TON і скільки отримуєте на боці BNB Chain. Із цього починається будь-який своп — агент показує цифри користувачеві до того, як щось блокується.

build_crosschain_swap_tx — збірка транзакції + секрет

Віддає непідписану HTLC-ескроу транзакцію плюс секрет. Транзакцію підписує гаманець користувача через TonConnect, а не сервер. Секрет S генерується тут-таки і залишається в користувача/агента — саме ним пізніше розблоковується друга нога. Сервер згенерував транзакцію і хеш, але підпис і володіння секретом залишаються в користувача.

track_crosschain_swap — трекінг фаз

Показує фази угоди в обох мережах — і в TON, і в BNB Chain: чи заблокована нога в TON, чи з'явилася зустрічна нога в BNB Chain, чи розкрито секрет, чи завершено розрахунок. Це очі агента: без трекінгу він не знає, коли безпечно розкривати секрет і чи не час робити рефанд.

disclose_crosschain_secret — розкриття секрету

Розкриває секрет для розрахунку — але лише після перевірки готовності ончейн. Інструмент не віддасть S наосліп: спершу він переконується, що зустрічна нога в BNB Chain справді на місці й умови виконані. Це захищає від ситуації, коли ви розкрили секрет, а отримувати з того боку нічого.

build_crosschain_refund — повернення з ескроу

Збирає транзакцію повернення коштів з ескроу, якщо угода зависла, — після спливу таймлоку. Теж непідписана транзакція для TonConnect. Страхувальний трос, до якого ми повернемося наприкінці.

Чому це некастодіально: сервер не підписує і не зберігає ключі

Тут проходить головна лінія TONNode. Інструменти свопу, кросчейну і гаманця строго некастодіальні. Сервер НІКОЛИ не підписує і не зберігає кошти та приватні ключі — він повертає лише непідписані TonConnect-повідомлення, які підписує гаманець користувача.

Розберемо на кросчейні конкретно:

• build_crosschain_swap_tx віддає транзакцію без підпису. Підпис ставить гаманець користувача — Tonkeeper, MyTonWallet, будь-який TonConnect-сумісний. Доки користувач не підтвердить транзакцію, нічого не блокується.
• Секрет S потрапляє на клієнт. Сервер не може нишком забрати кошти з ескроу: для цього потрібен підпис власника, а його сервер не має.
• Навіть рефанд — це непідписана транзакція: повернення ініціює користувач, а не сервер.

Практичний висновок: скомпрометований сервер не призводить до крадіжки коштів — там нема чого красти: ні ключів, ні підписів, ні контролю над ескроу. Максимум, що може «зламатися», — відмова в обслуговуванні (агент не отримає котирування), але не втрата грошей.

Порівняйте це з кастодіальною моделлю, де агент-гаманець тримає operator-ключ і підписує сам. Обидві моделі мають право на життя, але для кросчейну через дві незалежні мережі некастодіальність особливо важлива — ви не хочете, щоб посередник контролював гроші, які зависли між блокчейнами. Докладний розбір двох підходів — у статті Кастодіальний чи некастодіальний MCP, а як це виглядає для звичайного свопу всередині TON — у Некастодіальний своп для агента.

Які мережі підтримано (і чому TRON поки немає)

Кросчейн у TONNode завжди йде з TON у цільову EVM-мережу. Підтримувані цілі:

• Ethereum
• Arbitrum
• Base
• BNB Chain (наш випадок)
• Polygon
• Avalanche

TRON поки НЕ підтримується. Причина технічна: атомарний HTLC-ескроу вимагає, щоб цільова мережа однаково трактувала хеш-таймлок-контракти в межах обраного протоколу ескроу. Перелічені шість мереж EVM-сумісні і вкладаються в цю модель; TRON, попри зовнішню схожість, живе за власною моделлю і потребує окремої реалізації ескроу. Поки її немає — немає й TRON у списку, і ми не видаємо бажане за факт.

Про найпопулярнішу пару — TON → Ethereum — є окремий розбір: Кросчейн-своп TON → Ethereum. Механіка та сама, змінюється лише цільова мережа.

Покроковий прогін свопу TON → BNB через MCP

Спершу підключимо TONNode до агента. Локальний публічний конфіг @tonnode/mcp безкоштовний і дає повний набір інструментів читання — але тільки читання. Пакет — open source (MIT), працює за нативним ADNL-протоколом TON, без HTTP-прошарків:

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

Важливе уточнення: п'ять кросчейн-інструментів через локальний публічний npx недоступні — там лише читання. Кросчейн-угода йде через hosted-ендпоінт зі своїм ключем, і для неї достатньо безкоштовного ключа Hobby:

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": {
        "Authorization": "Bearer tn_live_…"
      }
    }
  }
}

На hosted-ключі всі 16 інструментів — включно з п'ятьма кросчейн-інструментами — доступні на будь-якому тарифі, починаючи з безкоштовного Hobby. Платите ви лише за пропускну здатність (Hobby — безкоштовно, 60 запитів/хв; Pro — $29/міс, 300 запитів/хв; Scale — $199/міс, 1200 запитів/хв). Кросчейн не захований за старшим тарифом — але локальний npx для нього не годиться, потрібен hosted-ключ.

Тепер сам прогін. Промпт агенту може бути максимально людським:

«Обміняй 50 GRAM з мого TON-гаманця на BNB Chain на адресу 0x…. Спочатку покажи котирування, потім збери транзакцію — підпишу сам.»

Що відбувається під капотом:

1. Котирування. Агент викликає get_crosschain_quote (джерело TON, ціль BNB Chain, сума 50 GRAM) і показує, скільки прийде на боці BNB Chain.
2. Збірка. Після вашого «ок» агент викликає build_crosschain_swap_tx. Отримує непідписану HTLC-ескроу транзакцію і секрет S. Транзакцію ви підтверджуєте у своєму гаманці через TonConnect. Кошти блокуються в ескроу на боці TON під хеш H.
3. Трекінг. Агент періодично викликає track_crosschain_swap і стежить за фазами в обох мережах: чи заблокована TON-нога, чи піднялася зустрічна нога в BNB Chain (її виставляє резолвер під тим самим хешем H).
4. Розкриття і розрахунок. Щойно track_crosschain_swap показує готовність, агент викликає disclose_crosschain_secret. Інструмент перевіряє готовність ончейн і розкриває S — секрет стає видимим у BNB Chain, обидві ноги виконуються, BNB приходять на вашу адресу.
5. Підтвердження. Фінальний track_crosschain_swap показує, що обидві сторони розраховані. Угоду закрито.

Уся суть у тому, що ви будь-якої миті бачите стан угоди у двох мережах і підписуєте лише те, що бачите. Якщо вам цікава загальна філософія першого переміщення цінності з TON через MCP — вона розібрана в Перший кросчейн-переказ цінності з TON.

Якщо угода зависла: повернення коштів з ескроу

Кросчейн — це дві незалежні мережі, і часом зустрічна нога не піднімається: у контрагента проблеми, мережа перевантажена, щось пішло не так. У кастодіальній моделі тут починається листування з підтримкою. У HTLC — просто чекаємо, доки спливе таймлок.

Кошти заблоковані не назавжди. Щойно таймлок сплив, а угода не завершилася, агент викликає build_crosschain_refund і отримує непідписану транзакцію повернення з ескроу. Ви підписуєте її своїм гаманцем через TonConnect — і заблоковані GRAM повертаються вам. Жодних «кошти зависли назавжди»: це гарантія, вбудована в сам контракт, а не обіцянка сервісу.

Промпт може бути таким:

«Мій кросчейн-своп на BNB Chain не завершився. Перевір статус і, якщо таймлок сплив, поверни мої кошти.»

Агент викличе track_crosschain_swap, переконається, що розрахунок не пройшов і таймлок позаду, потім збере повернення через build_crosschain_refund і віддасть вам транзакцію на підпис.

Ключовий момент безпеки: секрет через disclose_crosschain_secret розкривається лише після перевірки готовності ончейн. Агент не опиниться в пастці, де секрет уже розкрито, а отримувати нічого. Або розрахунок проходить атомарно, або за таймлоком спрацьовує рефанд. Третього не дано — це і є сенс слова «атомарний».

---

Забрати безкоштовний ключ і підключити кросчейн

П'ять кросчейн-інструментів входять до стандартного набору з 16 — їх не треба докуповувати. Візьміть безкоштовний ключ Hobby (60 запитів/хв, без картки, видається одразу після входу) і підключіть TONNode до свого агента: tonnode.io/dashboard?plan=hobby.

Хочете спершу подивитися весь набір із 16 інструментів та їхні параметри — сторінка інструментів: tonnode.io/mcp.

Кросчейн із TON у BNB Chain перестає бути завданням «довірся мосту» і стає звичайним викликом інструменту — атомарним, некастодіальним і з гарантованим поверненням, якщо щось піде не так.