Zap

Zap — вход одним токеном

Обычное создание двусторонней лестницы требует на кошельке оба токена пары. Zap снимает это требование: вы даёте только стейблкоин, а контракт в одной транзакции сам свапает нужную часть через DEX-агрегатор и минтит сразу всю лестницу.

Что происходит внутри одной транзакции: списание стейбла → свап части в волатильный токен → минт всех позиций лестницы → возврат остатков на кошелёк.

Кнопка «Zap In» появляется на странице Create, когда Zap включён в Настройках. Требуется двусторонний режим (Two-sided).

Сколько денег уходит

Zap и обычное создание используют одну и ту же модель ввода суммы — те же поля, тот же переключатель распределения между токенами. Разница только в том, что делает приложение: обычный Create вносит оба токена прямо с кошелька, а Zap доводит состав до нужного свапом.

Отдельного поля «сколько потратить на свап» нет и не будет: свап укладывается в тот же бюджет, а не добавляется к нему сверху.

Единственное исключение — mint headroom: небольшой запас стейбла поверх суммы, чтобы транзакция пережила сдвиг цены на тонком пуле. На балансе нужно иметь сумма × (1 + headroom); неиспользованный остаток возвращается в той же транзакции.

В платной версии зап комиссии не берёт. В бесплатной создание лесенки через Zap стоит 0.1% — их удерживает сам контракт, с котируемой части входа (стейбл / WETH / WBNB), а лесенка считается уже за вычетом этой доли, так что держать что-то сверху бюджета не нужно.

Создание пула прямо из запа

Если пула для пары ещё нет, Zap умеет создать и проинициализировать его в той же транзакции. В запросе появляется стартовая цена, а на экране подтверждения — цена, по которой пул реально будет создан.

Откуда берётся эта цена, решает настройка «Стартовая цена нового пула»:

  • «Ввести вручную» (по умолчанию) — пул инициализируется по цене, которую вы ввели.
  • «Взять из котировки агрегатора» — пул инициализируется по реализованному курсу свопа, а введённая вами цена превращается в сверку на здравый смысл: она отклонит котировку, невыгодную для вас за широким порогом, но выгодную пропустит всегда.
⚠️

Создание пула — единственный момент, когда вы назначаете цену. Ошибка здесь не отменяется: первый же чужой своп заберёт разницу. Проверяйте цену на экране подтверждения, а не в поле ввода.

Существование пула проверяется fail-closed: если прочитать состояние пула не удалось, приложение вернёт ошибку, но никогда не сделает вывод «пула нет». Молча создать второй пул поверх существующего невозможно.

Создание пула несовместимо с тремя вещами, и приложение откажет заранее, а не ревертом на цепи: с режимом dual, с режимом свопа exactOut и с Market APE (пересчёт от живой цены).

Если вас опередили

Между расчётом и подписью кто-то может создать тот же пул раньше вас. Приложение это распознаёт и показывает отдельный экран с фактической ценой созданного пула и кнопкой пересчёта.

🚫

Пересчёт — единственный правильный выход. Слепой повтор той же транзакции запрещён намеренно: пул уже существует и уже имеет цену, а ваш запрос всё ещё просит его создать. Согласие на создание пула при пересчёте не переносится — его нужно дать заново.

Нативные V4-пулы

Пулы, где одна из сторон — сам ETH или BNB, а не обёрнутый токен (currency0 равен нулевому адресу), поддержаны только на Uniswap V4. На V3 и на PancakeSwap V4 такой зап будет отклонён с объяснением.

Доступность приходит с сервера — приложение не угадывает её на своей стороне.

Ошибки, которые видит пользователь

Реверты контракта расшифровываются в понятный текст. Самые частые:

Что произошлоЧто делать
Своп слишком малУвеличьте сумму: у свопа есть минимальный размер
Цена вне полосыКотировка агрегатора разошлась с вашей ценой — обновите расчёт
Отклонение слишком великоСтартовая цена пула слишком далека от рыночной
Пул уже созданВас опередили — нажмите пересчёт, см. выше
Перерасход при минтеПоднимите Zap slippage: пул тоньше, чем ожидалось
Хук пула забирает средстваВход в такой пул запрещён — см. Создание позиций

Когда крутить параметры

Значения по умолчанию рассчитаны на обычные пулы. Менять их стоит только в двух случаях:

  • Тонкий или очень волатильный пул — поднимите Zap slippage до 5–10% и при необходимости mint headroom до 2–5%.
  • Быстро движущаяся цена — stale-quote порог блокирует подпись, если цена ушла дальше него. Это защита, а не помеха: обновите расчёт вместо того, чтобы поднимать порог.

Переключатель Normal / Extreme над кнопкой Zap In разом применяет повышенный набор значений — их отдельно настраивают в Настройках.