Користувачі DeFi стикаються з проблемою: для оплати газу потрібен ETH, але в смарт-гаманці лише USDC. Рішення — Account Abstraction за ERC-4337 (EIP-4337), що дозволяє спонсорувати газ токенами. Однак розробка власного bundler та paymaster потребує місяців. Ми використовуємо StackUp — готову інфраструктуру, що включає hosted bundler, paymaster API та SDK userop.js. За 5+ років на ринку Web3 ми впровадили AA у 20+ успішних проєктах на EVM. Економія на розробці — до 40% (до $20,000 на рік) порівняно з самостійним рішенням. Гарантія якості підтверджена сертифікатами аудиту смарт-контрактів.
Як працює інтеграція з userop.js?
userop.js — це TypeScript SDK для роботи з UserOperations. Він абстрагує створення, підписання та відправлення UserOperations через Bundler. StackUp надає готовий хост для bundler та paymaster, а userop.js — зручну обгортку. Ось типовий код підключення:
Код інтеграції з 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 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" } ), } ); // Відправлення транзакції 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 замість самописного рішення?
StackUp інтегрується у 2 рази швидше, ніж самописне рішення. Самописний 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 — спонсорування газу. 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 | Фікс + змінна |
StackUp економить до 30% витрат на газ порівняно з Pimlico завдяки pay-as-you-go моделі. Вибір визначається SDK та підтримуваними смарт-акаунтами: для Safe — Pimlico зручніше, для SimpleAccount — StackUp швидше. Зв'яжіться з нами — команда з 10+ сертифікованих інженерів підбере оптимальну конфігурацію.
Типовий таймлайн інтеграції
| Етап | Тривалість |
|---|---|
| Аналіз та підбір конфігурації | 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 тижнів. Вартість інтеграції — від $5,000. Гарантія якості: ми надаємо безкоштовний аудит після деплою. Отримайте консультацію з інтеграції StackUp у ваш проєкт — оцінка архітектури безкоштовно.