Пользователи DeFi сталкиваются с проблемой: для оплаты газа нужен ETH, но в смарт-кошельке только USDC. Решение — Account Abstraction по ERC-4337, позволяющее спонсировать газ токенами. Однако разработка собственного bundler и paymaster требует месяцев. Мы используем StackUp — готовую инфраструктуру, включающую hosted bundler, paymaster API и SDK userop.js. За 5+ лет в Web3 мы внедрили AA в 20+ проектах на EVM. Экономия на разработке — до 40% (до $15,000 в год) по сравнению с самостоятельным решением.
Как работает интеграция с userop.js?
userop.js — это TypeScript SDK для работы с UserOperations. Он абстрагирует создание, подписание и отправку UserOperations через Bundler. StackUp предоставляет готовый хост для bundler и paymaster, а userop.js — удобную обёртку. Вот типовой код подключения:
import { Client, Presets } from "userop"; // Создание AA клиента const client = await Client.init( `https://api.stackup.sh/v1/node/${STACKUP_API_KEY}`, { entryPoint: "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", } ); // Создание SimpleAccount (простейшая реализация AA wallet) const simpleAccount = await Presets.Builder.SimpleAccount.init( signer, // ethers Signer `https://api.stackup.sh/v1/node/${STACKUP_API_KEY}`, { paymasterMiddleware: Presets.Middleware.verifyingPaymaster( `https://api.stackup.sh/v1/paymaster/${STACKUP_API_KEY}`, { type: "payg" } // pay-as-you-go спонсирование ), } ); // Отправка транзакции const response = await client.sendUserOperation( simpleAccount.execute( "0xTargetAddress", ethers.utils.parseEther("0"), "0xCalldata" ) ); const receipt = await response.wait(); console.log(`Transaction included in block ${receipt.receipt.blockNumber}`); Почему выбирают StackUp вместо самописного решения?
Самописный bundler требует поддержки мемпула, симуляции и безопасности от MEV-атак. StackUp берёт это на себя: их bundler написан на Go, открыт под лицензией Apache 2.0, и уже протестирован в мейннете. Paymaster StackUp использует модель Verifying Paymaster с подписью, что защищает от повторного использования (replay). Экономия времени на разработку — около 4-6 недель, снижение операционных затрат на 30%.
Какие компоненты включает инфраструктура?
Bundler — принимает UserOperations, симулирует их (проверяет валидность без on-chain транзакции), формирует bundle и отправляет в EntryPoint контракт. StackUp поддерживает EntryPoint v0.6 и v0.7.
Paymaster — спонсирование gas. StackUp предоставляет Verifying Paymaster, который подписывает разрешение оплатить газ за конкретный UserOperation. Средства спонсора хранятся на paymaster контракте, пополняются через депозит.
Пошаговая интеграция с StackUp
- Регистрация в StackUp и получение API-ключа.
- Инициализация клиента userop.js с указанием endpoint и API-ключа.
- Создание смарт-аккаунта (SimpleAccount или Safe) с подписантом.
- Настройка paymaster middleware (verifyingPaymaster с URL).
- Построение UserOperation с нужным calldata и отправка через клиент.
- Обработка симуляции и ожидание receipt.
- Тестирование на тестнете, затем деплой на мейннет.
Частая ошибка — "AA21: didn't pay prefund". Она возникает, когда paymaster не перевёл достаточно средств на EntryPoint. Решение: проверить баланс paymaster и убедиться, что депозит покрывает газ для всех ожидающих UserOperations. StackUp предоставляет API для мониторинга депозита.
Что входит в интеграцию?
- Документация: описание архитектуры, схемы потоков UserOperation, настройка paymaster.
- Код: интеграция userop.js с вашим фронтендом, конфигурация API-ключа, обработка ошибок симуляции.
- Поддержка: помощь в деплое на тестнет/мейннет, мониторинг работы bundler, обновление контрактов при хардфорках.
- Обучение: разбор типовых ошибок (revert в симуляции, неверный nonce, превышение gas limit).
Сравнение StackUp и Pimlico
| Аспект | StackUp | Pimlico |
|---|---|---|
| SDK | userop.js | permissionless.js |
| Open-source bundler | stackup-bundler | Alto |
| ERC-20 paymaster | Через кастомный paymaster | Встроенная поддержка |
| Smart account поддержка | SimpleAccount, Safe | Safe, Kernel, Biconomy |
| Документация | Хорошая | Отличная |
| Ценообразование | Pay-as-you-go | Фикс + переменная |
Выбор между ними на практике определяется SDK и поддерживаемыми смарт-аккаунтами. Если ваш проект использует Safe — Pimlico удобнее. Для SimpleAccount и кастомных решений — StackUp быстрее. Закажите консультацию для оценки вашей архитектуры.
Типичный таймлайн интеграции
| Этап | Длительность |
|---|---|
| Анализ и подбор конфигурации | 2-3 дня |
| Настройка bundler и paymaster | 3-5 дней |
| Интеграция userop.js с фронтендом | 3-5 дней |
| Тестирование на тестнете | 2-3 дня |
| Деплой на мейннет и мониторинг | 1-2 дня |
Собственный bundler через stackup-bundler
Для проектов, требующих независимости от внешней инфраструктуры, StackUp предоставляет open-source bundler на Go:
# Запуск через Docker docker run -e ERC4337_BUNDLER_ETH_CLIENT_URL=https://mainnet.infura.io/v3/KEY \ -e ERC4337_BUNDLER_PRIVATE_KEY=0x... \ -p 4337:4337 stackupwallet/stackup-bundler:latest Bundler подключается к Ethereum ноде, управляет mempool UserOperations, выполняет simulation перед включением в bundle.
Какой стек используется?
- Ethereum L1/L2: Ethereum, Polygon, Arbitrum, Optimism, Base.
- Языки: Solidity 0.8.x, TypeScript.
- Инструменты: Foundry (тесты контрактов), Tenderly (отладка), Slither (аудит).
Сколько времени занимает интеграция?
Стандартный AA флоу — 1-2 недели. Если нужен кастомный paymaster или поддержка нескольких сетей — до 3 недель. Стоимость рассчитывается индивидуально после анализа проекта. Свяжитесь с нами для оценки вашего проекта — мы подберём оптимальную конфигурацию paymaster и bundler. Получите консультацию по интеграции StackUp в ваш проект. Закажите оценку вашей архитектуры.