Как Omniston обрабатывает реферальные комиссии для интеграторов
Omniston, протокол агрегации ликвидности TON, позволяет кошелькам, торговым интерфейсам и ботам получать доход со свопов, которые они проводят через него. Интеграторы добавляют реферальный адрес и ставку комиссии к запросу котировки; Omniston закладывает эту комиссию заранее до начала конкуренции резолверов, поэтому ставка фиксируется до того, как трейдер подпишет транзакцию.
Изображение поста
Настройка
За комиссию отвечают два поля: referrer_address (кошелёк TON, которому выплачивается комиссия) и referrer_fee_bps, где 1 б. п. равен 0.01% — 10 б. п. это 0.1%, 50 б. п. это 0.5%. SDK используют referrerAddress/referrerFeeBps; Widget отражает эти поля.
От котировки до расчёта
1. Трейдер выбирает активы и сумму.
2. Приложение запрашивает котировку с добавленными реферальными данными.
3. Резолверы конкурируют, комиссия уже учтена в цене.
4. Трейдер подписывает выигравшую котировку.
5. Выигравший источник ликвидности проводит расчёт комиссии.
Почему важен маршрут
DEX v1 выплачивает фиксированные 0.1% мгновенно в самом свопе. DEX v2 поддерживает 0.01%–1%, но комиссии накапливаются в хранилищах по каждому токену и забираются вручную или через SDK. DeDust, Tonco и CoffeeSwap мгновенно выплачивают TON, но удерживают комиссии jetton в отдельных хранилищах, для которых требуются вызовы в блокчейне. Escrow использует полностью собственные отдельные контракты хранилищ.
Гибкие комиссии
flexible_referrer_fee, отключённая по умолчанию, позволяет Omniston только снижать, но никогда не повышать вашу комиссию, чтобы маршрут v1 с лучшей ценой всё ещё мог победить, когда запрошенная вами ставка превышает лимит v1 в 10 б. п.
Отслеживание дохода
Одних только балансов кошелька недостаточно, чтобы увидеть комиссии, хранящиеся в хранилищах. API STON.fi покрывает только хранилища DEX v2; комиссии DeDust, Tonco, CoffeeSwap и Escrow требуют проверок в блокчейне или собственного индексирования, пока не появится единый API.
Настоящий выбор
Строгая ставка даёт предсказуемый доход, но может исключить лучший маршрут v1. Гибкие комиссии защищают качество исполнения, при этом всё равно выплачивая максимум, доступный для маршрута. Строгая ставка или гибкая комиссия — что лучше служит вашим пользователям?
#BTC $BTC $BASE
Omniston, протокол агрегации ликвидности TON, позволяет кошелькам, торговым интерфейсам и ботам получать доход со свопов, которые они проводят через него. Интеграторы добавляют реферальный адрес и ставку комиссии к запросу котировки; Omniston закладывает эту комиссию заранее до начала конкуренции резолверов, поэтому ставка фиксируется до того, как трейдер подпишет транзакцию.
Изображение поста
Настройка
За комиссию отвечают два поля: referrer_address (кошелёк TON, которому выплачивается комиссия) и referrer_fee_bps, где 1 б. п. равен 0.01% — 10 б. п. это 0.1%, 50 б. п. это 0.5%. SDK используют referrerAddress/referrerFeeBps; Widget отражает эти поля.
От котировки до расчёта
1. Трейдер выбирает активы и сумму.
2. Приложение запрашивает котировку с добавленными реферальными данными.
3. Резолверы конкурируют, комиссия уже учтена в цене.
4. Трейдер подписывает выигравшую котировку.
5. Выигравший источник ликвидности проводит расчёт комиссии.
Почему важен маршрут
DEX v1 выплачивает фиксированные 0.1% мгновенно в самом свопе. DEX v2 поддерживает 0.01%–1%, но комиссии накапливаются в хранилищах по каждому токену и забираются вручную или через SDK. DeDust, Tonco и CoffeeSwap мгновенно выплачивают TON, но удерживают комиссии jetton в отдельных хранилищах, для которых требуются вызовы в блокчейне. Escrow использует полностью собственные отдельные контракты хранилищ.
Гибкие комиссии
flexible_referrer_fee, отключённая по умолчанию, позволяет Omniston только снижать, но никогда не повышать вашу комиссию, чтобы маршрут v1 с лучшей ценой всё ещё мог победить, когда запрошенная вами ставка превышает лимит v1 в 10 б. п.
Отслеживание дохода
Одних только балансов кошелька недостаточно, чтобы увидеть комиссии, хранящиеся в хранилищах. API STON.fi покрывает только хранилища DEX v2; комиссии DeDust, Tonco, CoffeeSwap и Escrow требуют проверок в блокчейне или собственного индексирования, пока не появится единый API.
Настоящий выбор
Строгая ставка даёт предсказуемый доход, но может исключить лучший маршрут v1. Гибкие комиссии защищают качество исполнения, при этом всё равно выплачивая максимум, доступный для маршрута. Строгая ставка или гибкая комиссия — что лучше служит вашим пользователям?
#BTC $BTC $BASE
