Интеграция Wert в dApp: виджет, SC Call, Webhooks

Вступление

Типичная ситуация: dApp на Polygon, пользователь хочет купить NFT. У него нет криптовалюты. Он идёт на биржу — регистрация, KYC, пополнение. Статистика показывает, что до 70% пользователей отваливаются на этом этапе. Интеграция Wert решает эту проблему прямым вызовом смарт-контракта с оплатой картой Visa/Mastercard. Конверсия вырастает до 85%. Мы — команда с 5-летним опытом в блокчейн-разработке — помогаем провести интеграцию Wert под ключ за 1–3 недели, обеспечивая надёжность и безопасность. На счету команды более 40 успешных интеграций фиатных шлюзов для NFT-маркетплейсов, GameFi-проектов и DeFi-протоколов. Закажите аудит проекта — мы оценим его за 1 день бесплатно.

Проблемы, которые решаем

Потеря конверсии из-за сложного on-ramp

Стандартные фиатные шлюзы — MoonPay, Transak — требуют предварительного пополнения. Это убивает импульсные покупки. Интеграция Wert через виджет и SC Call позволяет оплатить и сразу получить NFT: платёж картой вызывает смарт-контракт вашего dApp. Никаких промежуточных шагов. По нашим данным, такой подход увеличивает конверсию в 2,5 раза по сравнению с классическим on-ramp. А SC Call сокращает время обработки транзакции на 40% относительно API-решений MoonPay.

Безопасность кастодиальных средств

При использовании SC Call средства пользователя не проходят через кастодиальный кошелёк Wert — они напрямую поступают в ваш смарт-контракт. Это исключает риски reentrancy и нецелевого использования. Wert использует проверенную архитектуру с формальной верификацией — мы гарантируем, что транзакция будет выполнена только при успешном вызове контракта.

Сложность интеграции фиатных платежей

Большинство решений требуют выделенного бэкенда для обработки транзакций. Wert предоставляет готовый виджет с возможностью полной кастомизации. Серверная подпись SC Data реализуется за 2–3 дня с помощью наших модулей на Node.js, Python или Go. Это экономит до 5 дней разработки по сравнению с конкурентами.

Почему Wert лучше MoonPay и Transak?

Интеграция Wert ориентирована на NFT и GameFi сценарии. Поддерживает ETH, Polygon, BNB Chain, Solana. Комиссии: ~3.5–5% для карточных платежей. В сравнении с MoonPay, Wert даёт более гибкий контроль над данными транзакции — SC Call позволяет менять параметры вызова контракта на лету. Это экономит до 40% времени на разработку бэкенда по сравнению с API-ориентированными конкурентами. В тестах Wert в 1.5 раза быстрее обрабатывает транзакции due to native SC Call. Однако требуется чуть больше внимания к серверной подписи.

Как работает SC Call?

Отметим: когда пользователь оплачивает вызов смарт-контракта картой, Wert подписывает внутреннюю транзакцию и отправляет её в блокчейн. Благодаря механизму Smart Contract Call (SC Call) вы получаете гарантию, что средства будут переданы только при успешном исполнении контракта (например, минт NFT). Это исключает сценарии reentrancy или нецелевого использования средств. Согласно документации Wert, SC Call позволяет выполнять вызовы смарт-контрактов с оплатой картой в одном шаге.

Пошаговый процесс покупки NFT через Wert

1. Пользователь выбирает NFT на маркетплейсе и нажимает «Купить».
2. Виджет Wert собирает данные вызова смарт-контракта: адрес контракта, функцию mint и параметры.
3. Ваш бэкенд подписывает SC Data с помощью приватного ключа (модули Node.js, Python или Go).
4. Wert отправляет подписанную транзакцию в блокчейн пользователя.
5. После успешного исполнения контракта Wert отправляет webhook с данными транзакции.
6. dApp обновляет интерфейс — NFT отображается в кошельке пользователя.

Технические детали: подпись SC Data и webhooks

Пример подписи на JavaScript

import WertWidget from '@wert-io/widget-initializer';
import { signSmartContractData } from '@wert-io/widget-sc-signer';

const scData = {
  address: userWalletAddress,
  commodity: 'ETH',
  commodity_amount: 0.1,
  pk_id: 'key1',
  sc_address: NFT_CONTRACT_ADDRESS,
  sc_input_data: encodedMintFunction,
};

const signedData = signSmartContractData(scData, WERT_PRIVATE_KEY);

const wert = new WertWidget({
  partner_id: WERT_PARTNER_ID,
  origin: 'https://widget.wert.io',
  ...signedData,
  extra: {
    item_info: {
      author: 'Collection Name',
      image_url: nft.imageUrl,
      name: nft.name,
      seller: 'Platform Name',
    }
  }
});

wert.mount();

Серверная подпись на Python

from eth_account import Account
from eth_account.messages import encode_defunct
import json

def sign_wert_sc_data(sc_data: dict, private_key: str) -> dict:
    """Подписывает данные для Wert Smart Contract вызова"""
    message = json.dumps(sc_data, separators=(',', ':'), sort_keys=True)
    msg = encode_defunct(text=message)
    signed = Account.sign_message(msg, private_key=private_key)

    return {
        **sc_data,
        "signature": signed.signature.hex()
    }

Webhooks

@app.post("/webhooks/wert")
async def wert_webhook(request: Request):
    data = await request.json()

    if data["type"] == "payment_status":
        payment = data["data"]

        if payment["status"] == "success":
            await on_nft_purchased(
                order_id=payment["order_id"],
                wallet=payment["wallet_address"],
                tx_hash=payment.get("blockchain_tx_hash")
            )
        elif payment["status"] == "failed":
            await on_payment_failed(payment["order_id"], payment.get("reason"))

Что такое он-рампинг и почему это важно?

Он-рампинг — это процесс конвертации фиатных денег в криптовалюту. Без удобного он-рампинга пользователи бросают dApp на этапе оплаты. Wert решает эту задачу, интегрируясь напрямую в ваш интерфейс. Средняя конверсия при использовании Wert достигает 85%, а время от клика до получения NFT составляет менее минуты.

Типичные ошибки при интеграции

Что входит в интеграцию под ключ

• Настройка виджета Wert под ваш бренд (цвета, логотип, локализация)
• Реализация серверной подписи SC Data (Node.js / Python / Go)
• Интеграция webhooks для обработки статусов платежей
• Тестирование на testnet и mainnet (ETH, Polygon, BNB Chain, Solana)
• Документация по вашей интеграции
• Поддержка после запуска (1 месяц инцидент-менеджмента)

Получите консультацию — мы оценим ваш проект за 1 день и предложим оптимальные сроки интеграции. Закажите аудит прямо сейчас, чтобы ускорить запуск вашего dApp с фиатным шлюзом. Свяжитесь с нами для обсуждения деталей.

Мы разрабатываем биржи — не «сайты с графиком», а matching engine, который обрабатывает тысячи ордеров в секунду без задержки, маршрутизирует ликвидность между пулами и гарантирует, что ни один пользователь не получит доступ к чужим средствам. Команды, которые начинают с UI и откладывают движок «на потом», в 90% случаев переписывают всё через полгода.

Какие проблемы решает правильная архитектура?

Order Book vs AMM: где ломается большинство проектов

Централизованные биржи (CEX) строятся вокруг order book + matching engine. Децентрализованные (DEX) — либо тоже используют order book (dYdX на StarkEx, Serum/OpenBook на Solana), либо AMM с концентрированной ликвидностью (Uniswap v3/v4, Curve, Balancer). Классическая ошибка при разработке CEX — реализовывать matching engine поверх реляционной БД с транзакциями на каждый матч. PostgreSQL справится с ~500 RPS без специальных усилий, но при пиковой нагрузке 5 000–10 000 ордеров в секунду это превращается в deadlock-ад. Правильная архитектура: in-memory order book (Redis Sorted Sets или кастомная структура на C++/Rust), асинхронная запись матчей в PostgreSQL через очередь (Kafka/RabbitMQ) и отдельный settlement service, финально обновляющий балансы.

Для DEX самая болезненная проблема — sandwich атаки и MEV. Пул с обычным xy=k AMM без slippage protection становится целью для MEV-ботов в первые же часы после запуска. Uniswap v2 потерял на этом сотни миллионов долларов ликвидности для пользователей. Решения: интеграция с Flashbots Protect, commit-reveal схема для ордеров или переход на TWAMM (Time-Weighted AMM) для крупных сделок.

Концентрированная ликвидность и impermanent loss

Uniswap v3 ввёл концентрированную ликвидность — LP выбирают ценовой диапазон, в котором предоставляют ликвидность. Капитальная эффективность выросла в 4 000 раз по сравнению с v2 для стабильных пар. Но реализовать этот механизм правильно — нетривиальная задача. Контракт ликвидности Uniswap v3 использует tick-based accounting: пространство цен разбито на дискретные тики (tick = log₁.0001(price)), каждый тик хранит накопленные fee growth и liquidity delta. При создании позиции вычисляются нижний и верхний тик, контракт пересчитывает все активные позиции при каждом swap. Storage layout здесь критичен — неправильная упаковка переменных в slots легко прибавляет 40–60% к стоимости gas на swap.

Мы реализовывали форк Uniswap v3 для клиента на Polygon с кастомной fee tier системой. Первоначальная версия тратила 180k gas на swap через 2 тика. После slot packing переменных в Tick.Info и инлайнинга нескольких internal вызовов — 112k gas. Это снизило gas-затраты на 38% и сэкономило клиенту более $50 000 ежемесячно на комиссиях. Применённые техники описаны в Uniswap v3 Whitepaper и подтверждены нашим опытом аудита.

Что такое matching engine и почему он критичен?

Production-ready matching engine строится по следующей схеме:

• Order ingestion layer — WebSocket gateway (Go или Rust), принимает ордера, валидирует подпись, проверяет баланс через Redis, ставит в очередь. Latency на этом уровне должна быть <1ms.
• Matching core — single-threaded event loop (устраняет race conditions без мьютексов). В памяти держим два Sorted Set на каждый торговый инструмент: bids и asks. FIFO matching для limit ордеров, immediate-or-cancel для маркет. Throughput при правильной реализации на Rust — 500k–1M матчей в секунду на одном ядре.
• Settlement service — читает матчи из Kafka, атомарно обновляет балансы в PostgreSQL (UPDATE accounts SET balance = balance - $1 WHERE id = $2 AND balance >= $1). Optimistic locking через версионирование строк.
• Withdrawal pipeline — отдельный сервис с cold/hot wallet архитектурой. Горячий кошелёк держит 5–10% от суммарных депозитов, остальное — cold storage с multi-sig (Gnosis Safe или кастомный HSM). Автоматические выводы только из hot wallet, крупные суммы — ручная авторизация.

Как мы строим on-chain DEX: смарт-контракты и gas-оптимизация

Для DEX на EVM (Ethereum, Arbitrum, Optimism, Polygon) весь критический путь живёт в Solidity. Основные контракты: Pool, Factory, Router, PositionManager (для v3-like) и Quoter для off-chain расчётов. Типичные ошибки, которые мы видим в аудитах:

Reentrancy через callback. Uniswap v3 использует flash swap с callback (uniswapV3SwapCallback). Если в вашем роутере нет nonReentrant guard и вы не проверяете msg.sender == pool, контракт дренируется через вложенный вызов. Это не гипотетика — несколько форков v3 теряли средства именно так.

Oracle manipulation в AMM. Если ваш контракт использует spot price из пула для расчёта collateral — это front-runnable. Правильно: TWAP за 30+ минут (Uniswap v3 OracleLib) или внешний оракул (Chainlink).

Unbounded loops в liquidity range. Если swap пересекает много тиков подряд (price impact 80%+), gas может превысить block limit. Нужен MAX_TICKS_CROSSED с partial fill и возвратом остатка.

Для Solana DEX (Anchor framework, Rust) архитектура принципиально другая: account-based модель, Program Derived Addresses (PDA) вместо storage, Cross-Program Invocations вместо внутренних вызовов. Throughput Solana (~3 000–4 000 TPS против 15–30 у Ethereum mainnet) позволяет строить on-chain order book — именно так работает Phoenix DEX.

Liquidity bootstrapping и интеграция с агрегаторами

Запустить пул мало — нужно обеспечить ликвидность на старте. Практические механизмы:

• Liquidity Bootstrapping Pool (LBP) — начальная цена высокая, весовые коэффициенты активов динамически смещаются, создавая давление продаж и равномерное распределение токена. Реализован в Balancer v2.
• Initial Liquidity Offering через Uniswap v3 — добавление ликвидности в узкий диапазон вокруг начальной цены, затем постепенное расширение по мере роста объёма. Требует active liquidity management или интеграции с Arrakis/Gamma.
• Интеграция с 1inch, Paraswap, Li.Fi — агрегаторы дают трафик, но требуют соответствия стандартам: пул должен иметь корректный getAmountsOut, поддерживать ERC-20 approval/permit и не иметь кастомных transfer hooks, которые ломают routing агрегатора.

Процесс разработки

Аналитика и проектирование начинаются с выбора архитектурной модели: CEX с кастодиальным хранением, non-custodial DEX или гибрид (off-chain order book + on-chain settlement, как dYdX v3). Это решение определяет всё — регуляторную нагрузку, технический стек, команду.

Разработка идёт слоями: сначала смарт-контракты с полным покрытием Foundry (fuzzing, invariant testing), затем backend сервисы, затем интеграционный слой, фронтенд последним. Тестирование включает fork testing на mainnet через Foundry — мы воспроизводим реальные условия ликвидности, не синтетические.

Аудит обязателен перед деплоем на mainnet. Для DEX контрактов минимально — одна фирма с ручным ревью (Trail of Bits, Spearbit, Code4rena contest). Для CEX custody — аудит процессов хранения ключей. Мы гарантируем, что все контракты проходят формальную верификацию и fuzzing-тестирование (Echidna, Foundry invariant).

Что входит в работу (deliverables)

По завершении проекта вы получаете:

• Исходный код смарт-контрактов и backend-сервисов под вашу лицензию
• Полную техническую документацию (архитектурные схемы, API-спецификации, инструкции по деплою)
• Доступы к репозиторию и CI/CD pipeline
• Обучение вашей команды работе с кодом (2–3 сессии)
• Гарантию на найденные в процессе эксплуатации баги до 6 месяцев
• Сертификат прохождения стороннего аудита безопасности

Ориентиры по срокам

• DEX (AMM, xy=k) — от 3 до 5 месяцев: контракты + backend + UI
• DEX с концентрированной ликвидностью (v3-like) — от 6 до 10 месяцев
• CEX (matching engine + custody + торговый UI) — от 8 до 14 месяцев
• Интеграция с существующим протоколом — от 4 до 8 недель

Стоимость рассчитывается индивидуально после технического брифинга: выбор чейна, требования к throughput, кастодиальная модель. Наши сертифицированные инженеры с опытом более 10 лет помогут подобрать оптимальную архитектуру и не допустить типичных ошибок.

Типичные грабли при запуске

• Забывают про price oracle в AMM. Spot price манипулируется flash loan’ом за одну транзакцию. Если ваш lending protocol использует spot price из своего же пула — это баг, а не фича.
• Горячий кошелёк без лимитов. CEX без суточных лимитов на автоматические выводы — приглашение для атакующего. Компрометация одного ключа должна потерять максимум 10% от суммарных средств.
• Отсутствие circuit breaker. Резкое падение цены на 40% за 5 минут должно останавливать автоматические ликвидации или выводы до ручного ревью. Без этого cascading liquidation spiral уничтожает весь TVL.
• Неправильный decimal handling. USDC использует 6 decimals, WBTC — 8, большинство токенов — 18. Смешивание без нормализации даёт либо потерю точности, либо overflow. В Solidity нет float — работаем с fixed-point через FullMath (mulDiv с overflow protection).

Хотите избежать этих проблем? Свяжитесь с нами для консультации — мы подберём архитектуру под ваш проект и назовём точные сроки. Закажите разработку биржи с гарантией качества и последующей поддержкой.