Декодування свопів SCW
З гаманцями на смарт-контрактах (SCW) свопи проходять зовсім інакше, ніж із традиційними гаманцями Ethereum/EVM. Ця різниця може збивати з пантелику, особливо коли щось іде не так. Але щойно ви зрозумієте ключових учасників цього процесу — і як покроково читати, що сталося в застосунку та в експлорері, — усе починає ставати на свої місця.
Давайте розберемо це разом.
Від одного натискання до виконання в ланцюзі: що насправді відбувається
Коли ви натискаєте «Swap» у застосунку, це здається однією дією. Насправді ви запускаєте багаторівневий процес, побудований поверх абстракції акаунта Ethereum (ERC-4337). Ваша транзакція не йде прямо в блокчейн, як у звичайному гаманці. Натомість вона робить обхідний шлях:
Ми будуємо маршрут. Ми звертаємося до рушія маршрутизації (наприклад, 1inch), щоб знайти найкращий шлях для вашого свопу, і симулюємо його, щоб переконатися, що все працює. Ми оцінюємо газ, перевіряємо, що у вас є токени, і упаковуємо інструкції в спеціальний формат:
UserOperation.Один
бандлервтручається. Це позаланцюговий учасник, відповідальний за надсилання UserOperations до блокчейна. Він перевіряє вашу операцію, переконується, що вона дійсна, і авансує за вас газ (потім йому це відшкодовується).Ваш UserOp потрапляє в блокчейн через
EntryPointсмарт-контракт. Уявіть EntryPoint як одні ворота, через які проходять усі транзакції SCW. EntryPoint виконує фінальні перевірки, і якщо все виглядає добре…EntryPoint каже вашому гаманцю на смарт-контракті (SCW) виконати своп. Ваш SCW викликає роутер (наприклад, 1inch), роутер викликає пули, токени рухаються, а результат повертається у ваш гаманець.
Отже, підсумуємо: ви натискаєте swap → ми симулюємо → бандлер надсилає → EntryPoint перевіряє → ваш SCW виконує.
Давайте подивимося на реальний приклад
Тепер, коли ми зрозуміли загальний процес, давайте подивимося, як це відбувається в реальному свопі: спочатку в застосунку, а потім у ланцюзі:

Ось що ми бачимо:
Ми обміняли 1 USDC на 0.765 KTA.
Своп було виконано в Base (зверніть увагу на значок Base на символах монет).
Ми заплатили:
$0.03 за газ (в ETH)
Комісію за своп 0.22% на користь goodcryptoX
Комісію роутера 0.05% на користь 1inch
Маршрут був простим: 100% через пул Uniswap v4.
Бандлер: Alchemy (див. крок 2 вище для нагадування)
Посилання на експлорер з’являються, якщо транзакція досягла блокчейна і була записана в блок (навіть якщо вона завершується помилкою)
Поки що все добре. Далі натиснімо посилання BaseScan, щоб подивитися, як ця транзакція виглядає в ланцюзі:

Від: це не ваш гаманець — це бандлер Alchemy. Це очікувано, адже бандлер надіслав транзакцію.
До: EntryPoint (v0.6.0). Знову ж таки, це очікувано — усі транзакції SCW проходять саме тут.
Внутрішні транзакції: показує потоки нативних токенів (ETH у Base) всередині транзакції. Ось що ми бачимо:
Наш гаманець (…0A5) надіслав ETH до EntryPoint для сплати комісії за газ.
EntryPoint відшкодував бандлеру фактичну вартість газу (оскільки бандлер оплатив газ за вас наперед; див. крок 2 вище). Увесь ETH, що залишився, лишився в EntryPoint як ваш депозит для майбутніх транзакцій.
Перекази ERC-20: показує фактичний рух токенів:
Наш гаманець не надсилав USDC напряму. Натомість контракт токена USDC (…2A8) обробив і відправив перекази. Це нормально: у ланцюгах EVM перекази токенів обробляються самим контрактом токена після отримання інструкції від вашого гаманця на смарт-контракті.
Контракт USDC розділив наш 1 USDC на три перекази:
0.0022 USDC до гаманця комісій нашого протоколу (…608A)
0.0005 USDC до гаманця комісій 1inch (…1DE5)
Залишок 0.9973 USDC до роутера Uniswap v4 (…Universal Router)
Роутер Uniswap v4 передав його до менеджера пулів Uniswap v4 (єдиний контракт, що обслуговує всі пули v4).
Менеджер пулів виконав своп: USDC на вході → KTA на виході.
KTA було спрямовано назад через Aggregation Router 1inch, який переслав його до нашого гаманця (…0A5).
🧩 Як розшифрувати невдалу транзакцію SCW
Тепер, коли ми розуміємо, як працюють свопи в гаманцях на смарт-контрактах (SCW) — і вже пройшли успішну угоду — давайте використаємо ті самі інструменти, щоб розшифрувати невдалу.
Ми скористаємося ще одним реальним кейсом: свопом ETH → токен в Ethereum, який зірвався в контракті EntryPoint, бо не вистачило ETH, щоб покрити і своп, і комісію за газ.
Гаразд, тож ви бачите "Error" як статус свопу в застосунку або отримуєте push-сповіщення, що ваш своп не відбувся. Що робити?
Крок 1 — Перевірте деталі ордера в goodcryptoX
Ось що ви бачите в цьому випадку:

Використовуючи систему, яку ми розробили раніше, ви швидко помічаєте:
Статус свопу
Помилка(збій?)Немає повідомлення про помилку (це незвично)
Є комісія за газ (досягло блокчейна?)
Показано маршрут (симуляція пройшла добре?)
Є посилання на блокчейн-експлорери (я можу перевірити tx у блокчейні!).
Перевірмо вашу інтуїцію:
Токен
Помилкастатус означає, що своп не вдавсяМає бути і зрозуміле для людини повідомлення про помилку (перекладене з сирого), і сире повідомлення. Відсутність повідомлення про помилку точно означає, що сталося щось незвичне
Справді, комісія за газ означає, що транзакція досягла блокчейна і відбулася якась ончейн-активність (що спожила газ)
Маршрут підтверджує, що симуляція транзакції пройшла успішно і дала чіткий шлях до виконання
Посилання на експлорери підтверджують, що транзакція досягла блокчейна — навіть якщо вона зазнала невдачі. Нам точно слід відкрити одне з них і розібратися далі
Крок 2 – Відкрийте транзакцію в блокчейн-експлорері
Ви натискаєте посилання Etherscan, щоб подивитися, що сталося:

На перший погляд усе стає ще заплутанішим:
Статус каже ✅ Success — зачекайте, що?!
Але ми вже знаємо, що своп не пройшов
Під полем «To» (EntryPoint) є невелике жовте повідомлення:
“Хоча сталася одна або кілька помилок [execution reverted] Виконання контракту завершено”
То що тут насправді відбувається?
Пам’ятаєте потік транзакції SCW, який ми розглядали раніше:
бандлер загортає ваш своп у
UserOperation(пакет даних з логікою вашого свопу)потім надсилає його до смарт-контракту EntryPoint
EntryPoint перевіряє його (перевіряючи баланс, підпис і nonce)
якщо все гаразд, він виконує ваш намір — викликає роутери, пули та переміщує токени.
З точки зору блокчейна, однак, усе це виглядає просто як "бандлер надсилає дані до EntryPoint".
У термінах SCW цей крок називається зовнішньою транзакцією.
І ця транзакція справді успішно виконалась: дані були доставлені, і EntryPoint почав виконувати свою внутрішню логіку. Звідси й ✅ Success угорі.
Але експлорер, проявляючи ввічливість, все одно повідомляє вам, що щось не вдалося всередині EntryPoint за цією маленькою жовтою приміткою. Для експлорера цієї внутрішньої помилки недостатньо, щоб позначити транзакцію як невдалу.
Тепер ще одна деталь впадає в око на вкладці Overview:
Приблизно $6 вартості ETH було надіслано з вашого гаманця до EntryPoint (аванс на газ).
Лише $2.3 вартості ETH було відшкодовано бандлеру.
А комісія за транзакцію, показана вгорі, ще нижча — приблизно $2.15.
На перший погляд, ці числа не сходяться. Давайте спершу розберемося з цим, перш ніж продовжити розслідування
Крок 3 – Розуміння розбіжності в газі
Ось розбивка:
SCW → EntryPoint (~$6): Це аванс на газ. EntryPoint завжди збирає більше, ніж потрібно, щоб переконатися, що ваш UserOp зможе виконатися.
EntryPoint → Бандлер (~$2.3): Це фактичне відшкодування газу. Це реальна сума, яку ви сплатили за цю невдалу спробу.
Комісія за транзакцію (~$2.15): Це те, що витратив бандлер, щоб надіслати ваш UserOp до EntryPoint. Сума нижча, бо сам EntryPoint використав додатковий газ під час перевірки та відшкодування бандлеру — цю додаткову вартість поклали на вас.
Загальне правило:
👉 Ваші реальні витрати на газ завжди дорівнюють відшкодуванню EntryPoint ➜ Бандлер (а не «Transaction Fee», показаній угорі)
А різниця між тим, що ви авансували ($6), і тим, що було відшкодовано ($2.3), не зникла. Вона залишилася в EntryPoint як ваш депозит, який автоматично буде застосовано до вашої наступної транзакції.
Крок 4 – Перевірте вкладку AA Transactions
В експлорері ви бачите вкладку AA Transactions (AA = Account Abstraction). Тут і живе активність гаманців на смарт-контрактах, оскільки SCW працюють на Account Abstraction (ERC-4337).
Перемкнімося на цю вкладку з Overview:

Тут ви нарешті бачите наш UserOperation, перелічений як окремий запис усередині зовнішньої транзакції бандлера:
Поле «From» тепер показує адресу нашого гаманця, підтверджуючи, що це наша операція.
Є окремий хеш AA Txn, відмінний від хеша зовнішньої транзакції. Чому?
Зовнішній хеш Txn належить транзакції Bundler->EntryPoint, що містила ваш UserOp (і могла містити кілька UserOp від різних користувачів).
Хеш AA Txn — це унікальний ідентифікатор вашого UserOperation у цьому пакеті.
Оце й є ключова ідея бандлування:
Бандлер може пакувати багато UserOp в одну транзакцію.
Кожен UserOp отримує власний хеш AA Txn, тож його можна відстежувати окремо всередині пакета.
У нашому випадку, оскільки це стара транзакція (понад 400 днів тому), SCW тоді ще були рідкістю, і пакет містив лише наш UserOp — тому вкладка показує «AA Transactions (1).» У новіших транзакціях ви часто побачите кілька UserOp, згрупованих в один пакет.
У цьому поданні ви також помітите (!) іконку біля вашого хеша AA Txn — підтвердження того, що ваш своп не було виконано.
Наступний крок — натиснути на хеш AA Txn. Це відкриє спеціальну сторінку UserOperation, де ви побачите всі деталі нашої спроби свопу — комісію, перекази й місце, де все зламалося.
Крок 5 – Відкрийте сторінку з деталями AA Transaction
Натискання на хеш AA Txn переводить вас на спеціальну сторінку з деталями вашої UserOperation:

Тут ви нарешті можете чітко побачити нашу фактичну спробу свопу:
Статус: x Невдача (цього разу без двозначності)
Від: адреса вашого гаманця на смарт-контракті
Комісія за AA-транзакцію: ~0.00231 ETH ($2.31). Це реальна вартість газу, яку ви сплатили — відшкодування, надіслане бандлеру.
Внутрішня транзакція: один переказ ~0.00145 ETH ($6.36) з вашого SCW до EntryPoint (аванс на газ). Жодних інших переказів не відбулося, що підтверджує: сам своп так і не виконався.
Хеш Bundle Txn: також показано, щоб можна було перейти назад до зовнішньої транзакції бандлера.
Ця сторінка нарешті відповідає вашій інтуїції: це й є справжня транзакція — UserOperation, що представляла вашу спробу свопу.
Майже закінчили наше розслідування. Але раз уже ми так далеко зайшли, давайте також натиснемо на Внутрішні Txns.
Крок 6 – Перевірте вкладку Internal Transactions
Перемкніться на вкладку Internal Txns у вікні AA Transaction:

Тут ви бачите покрокові дії, які EntryPoint намагався виконати від вашого імені:
✅ Переказ з вашого SCW → EntryPoint (~0.00145 ETH, ~$6.36) = аванс на газ. Це вдалося.
❌ Виконання з вашого SCW → Uniswap Universal Router (~0.002 ETH) = спроба свопу. Вона зазнала невдачі.
Цей розбір пояснює причину збою:
Ви успішно надіслали ETH до EntryPoint як аванс на газ.
Але коли EntryPoint спробував переслати ETH до Uniswap для свопу, спроба провалилася.
Для найдетальнішого розбору відкрийте вкладку Logs.
Крок 7 – Перевірте вкладку Logs
Натисніть Logs (3):

Тут ви знайдете три ключові події:
Депоновано → підтверджує, що ваш аванс на газ було отримано EntryPoint.
Перед виконанням → показує, що EntryPoint почав обробку вашої UserOperation.
Подія UserOperation →
успіх: False— канонічний ончейн-запис того, що ваш UserOp не вдався.
Що насправді сталося (якщо звести все докупи)
Такий тип збою характерний саме для свопів зі SCW в EVM, де вхідним активом є нативний токен (ETH, BNB, MATIC…).
Проблема в тому, що ні бандлер, ні EntryPoint не перевіряють, чи достатньо у вас нативного токена щоб одночасно покрити і аванс на газ, і сам своп. Вони перевіряють це окремо — «достатньо для газу?» і «достатньо для свопу?». Саме тому симуляція пройшла успішно.
Ми вбудували в застосунок захист від таких випадків і попередили вас в інтерфейсі, що газу може не вистачити. Але оскільки симуляція виглядала нормально, ви все одно могли пройти далі.
Після вашого підтвердження бандлер надіслав вашу UserOperation до EntryPoint.
EntryPoint забрав близько $6 в ETH як аванс.
Коли він спробував виконати своп, залишку ETH уже не вистачило, щоб одночасно покрити і своп та і аванс.
Свопова виклик було відхилено всередині EntryPoint.
Ви все одно сплатили близько $2.3 за газ (відшкодування бандлеру).
Невикористані близько $3.7 залишилися в EntryPoint як ваш депозит, який буде автоматично використано у вашій наступній транзакції.
Останнє оновлення