Внедрение Pimlico для ERC-4337: Bundler и Paymaster под ключ

Внедрение Pimlico для ERC-4337: Bundler и Paymaster под ключ

Мы часто сталкиваемся с ситуацией: клиент хочет внедрить Account Abstraction (ERC-4337), но запуск собственного bundler и написание контракта paymaster отнимает месяцы и требует редкой компетенции. Pimlico решает эту проблему «из коробки» — managed инфраструктура, которая берёт на себя валидацию, упаковку и отправку UserOperations, а также спонсирование газа. Наш опыт (5+ лет в блокчейн-разработке) показывает, что интеграция Pimlico сокращает time-to-market с полугода до пары недель. Pimlico — одна из самых надёжных платформ с заявленным uptime 99.9%.

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

Газовая сложность для пользователей. Без paymaster каждый юзер должен иметь ETH на оплату газа, что убивает UX. Pimlico поддерживает два режима: verifying paymaster (подписанное разрешение на спонсирование) и ERC-20 paymaster (оплата газа в USDC). Второй вариант позволяет удержать пользователя в привычных токенах.

Необходимость синхронизации с сетью. Собственный bundler требует понимания мемпула ERC-4337, обработки бандлов и повторных попыток. Pimlico абстрагирует это через простой REST API — вы просто отправляете UserOperation, а остальное делает провайдер.

Риски централизации. Если вы не хотите зависеть от одного провайдера, Pimlico предлагает Alto — open-source bundler, который можно развернуть самостоятельно. Мы помогаем настроить как managed, так и self-hosted сценарий.

Почему Pimlico выгоднее собственного bundler?

Разработка собственного bundler обходится в $50 000–100 000 без учёта поддержки. Pimlico снижает эти затраты до $200–500 в месяц в зависимости от нагрузки. При этом вы получаете SLA 99.9% и готовую инфраструктуру.

Как мы настраиваем Pimlico

Мы используем стандартный стек: permissionless.js (TypeScript-библиотека для AA), viem для работы с блокчейном и Pimlico API. Ниже — пример создания smart account на базе Safe с paymaster-спонсированием:

import { createSmartAccountClient } from "permissionless";
import { createPimlicoBundlerClient, createPimlicoPaymasterClient } from "permissionless/clients/pimlico";
import { createPublicClient, http } from "viem";
import { sepolia } from "viem/chains";

const publicClient = createPublicClient({
  chain: sepolia,
  transport: http("https://rpc.ankr.com/eth_sepolia"),
});

const bundlerClient = createPimlicoBundlerClient({
  transport: http(`https://api.pimlico.io/v2/sepolia/rpc?apikey=${PIMLICO_API_KEY}`),
  entryPoint: ENTRYPOINT_ADDRESS_V07,
});

const paymasterClient = createPimlicoPaymasterClient({
  transport: http(`https://api.pimlico.io/v2/sepolia/rpc?apikey=${PIMLICO_API_KEY}`),
  entryPoint: ENTRYPOINT_ADDRESS_V07,
});

Создание smart account и отправка спонсированной транзакции:

import { signerToSafeSmartAccount } from "permissionless/accounts";

const safeAccount = await signerToSafeSmartAccount(publicClient, {
  signer: walletClient,
  entryPoint: ENTRYPOINT_ADDRESS_V07,
  safeVersion: "1.4.1",
});

const smartAccountClient = createSmartAccountClient({
  account: safeAccount,
  entryPoint: ENTRYPOINT_ADDRESS_V07,
  chain: sepolia,
  bundlerTransport: http(`https://api.pimlico.io/v2/sepolia/rpc?apikey=${API_KEY}`),
  middleware: {
    sponsorUserOperation: paymasterClient.sponsorUserOperation,
  },
});

const txHash = await smartAccountClient.sendTransaction({
  to: "0xTarget",
  value: 0n,
  data: "0xCalldata",
});

Какие типы paymaster поддерживает Pimlico?

Pimlico поддерживает два основных типа paymaster:

ERC-20 paymaster требует получения курса токена (getTokenQuotes) и approve токена на контракт paymaster. Pimlico предоставляет готовые методы для этого.

Процесс интеграции

1. Анализ — выбираем имплементацию smart account (Safe, Kernel, Biconomy) и тип paymaster.
2. Проектирование — проектируем архитектуру: какие операции спонсировать, лимиты, fallback.
3. Реализация — подключаем permissionless.js, настраиваем Bundler и Paymaster, пишем тесты.
4. Тестирование — разворачиваем на Sepolia/Goerli, проверяем все сценарии (revert, нехватка газа, спам).
5. Деплой — переключаем на mainnet, настраиваем мониторинг (Tenderly, Etherscan).

Как настроить Paymaster для спонсирования газа?

Для sponsored-транзакций paymaster подписывает разрешение на конкретный UserOperation. В permissionless.js это делается через middleware:

const sponsorResult = await paymasterClient.sponsorUserOperation({
  userOperation: userOp,
});
// Возвращает paymasterAndData (V0.6) или paymaster + paymasterData + gas лимиты (V0.7)

Что входит в работу

• Готовая интеграция Bundler и Paymaster Pimlico.
• Выбор и настройка smart account (Safe или Kernel).
• Настройка политик спонсирования (лимиты, whitelist контрактов).
• Тестирование на testnet с покрытием кейсов.
• Документация по интеграции для вашей команды.
• Гарантия: 2 недели пост-релизной поддержки.

Сроки и стоимость

Интеграция базового AA флоу с Pimlico, как правило, занимает от 1 до 2 недель. Стоимость рассчитывается индивидуально — зависит от сложности paymaster-политик, количества поддерживаемых чейнов и требований к документации. Закажите настройку Pimlico сегодня и получите консультацию по выбору оптимального тарифа.

Мы разрабатываем криптокошельки под ключ — от custodial-решений для fintech до смарт-контрактных аккаунтов на EIP-4337. 5+ лет на рынке блокчейн-разработки, 40+ реализованных проектов. Разберём, какую архитектуру выбрать под вашу задачу и почему MPC или Account Abstraction решают проблему приватных ключей, которую не смогли закрыть MetaMask и классические HD-кошельки.

Почему классические кошельки опасны для бизнеса?

Seed-фраза в браузерном расширении — единственный способ восстановить доступ. Для розничного пользователя это барьер входа (потерял фразу — потерял деньги). Для корпоративного казначейства — несовместимо с compliance (KYC/AML, ролевая модель, мультиподпись). Любая утечка одного ключа компрометирует все средства. Эти риски заложены в архитектуру, а не в плохой UX.

Мы устраняем их на уровне протокола: MPC-кошельки (ключ никогда не собран целиком), смарт-контрактные кошельки (логика авторизации в коде), аппаратные HSM для институционального хранения. Ниже — детали.

Custodial vs Non-custodial: в чём реальная разница

Custodial — провайдер хранит приватный ключ. Пользователь аутентифицируется через email/password/OAuth. Восстановление тривиально, KYC/AML встроены. Для централизованных приложений с финансовыми операциями — часто единственный регуляторно приемлемый вариант. Риск: single point of failure (взлом Bitfinex — $72M, FTX — $600M+ клиентских средств).

Non-custodial — ключи у пользователя. Провайдер не имеет доступа к средствам. Ответственность за хранение ложится на пользователя. Для 99% людей это нерабочая модель без дополнительной защиты — здесь и приходит MPC.

MPC-кошельки: ключ, которого нет

Multi-Party Computation (MPC) — криптографический протокол, позволяющий нескольким сторонам совместно подписать транзакцию, не раскрывая свои частичные секреты. Приватный ключ никогда не существует в собранном виде.

Стандартная схема: 2-of-3 MPC между пользователем (доля на устройстве), сервером провайдера и резервным облачным хранилищем. Транзакция подписывается двумя любыми из трёх сторон. Телефон потерян — восстановление через сервер + облако. Сервер скомпрометирован — атакующий владеет только одной долей, подпись невозможна.

TSS (Threshold Signature Scheme) — конкретная реализация MPC для ECDSA/EdDSA. Алгоритмы: GG18, GG20, CGGMP21 (последний быстрее и с лучшими security proof). Библиотеки: tss-lib (Go, от Binance), multi-party-sig (Go, от Coinbase), ZenGo-X/multi-party-ecdsa (Rust).

MPC не требует on-chain изменений — для блокчейна подпись выглядит как обычная single-key подпись. Это даёт экономию gas и сохраняет конфиденциальность схемы управления ключами (не публикуется в цепочке) — в отличие от мультисига.

Account Abstraction (EIP-4337): смарт-контракт как кошелёк

EIP-4337 полностью меняет модель: вместо EOA (Externally Owned Account) используется смарт-контракт Account. Логика авторизации — в коде контракта, не в криптографии протокола. Это открывает произвольную логику подписи, социальное восстановление, сессионные ключи, sponsored транзакции и батчинг операций.

Как работает стек EIP-4337:

User → UserOperation → Bundler → EntryPoint contract → Account contract
                                          ↑
                                    Paymaster (optional, pays gas)

UserOperation — новый тип объекта (не L1-транзакция). Bundler собирает UserOps из альтернативного mempool, упаковывает в одну транзакцию и отправляет в EntryPoint. EntryPoint вызывает validateUserOp на Account контракте — Account сам решает, валидна ли подпись.

Практические возможности:

Социальное восстановление. Контракт хранит список guardian'ов (другие адреса или сервис). Потеря ключа — guardians голосуют за замену. Argent использует схему с 2020 года.

Сессионные ключи. Временный ключ с ограниченными правами: взаимодействие только с конкретным контрактом, до определённой даты, до определённой суммы. Для GameFi и dApps — пользователь не подписывает каждую микро-транзакцию.

Paymaster. Сторонний контракт платит газ за пользователя. Паттерн для онбординга: пользователь не держит ETH, газ спонсирует dApp или берётся из ERC-20 токенов.

Реализации: Safe{Core} Protocol, Biconomy SDK (Stackup), ZeroDev (Kernel), Alchemy (Rundler bundler). На Ethereum mainnet, Polygon, Arbitrum, Optimism EntryPoint v0.6/v0.7 задеплоен и активен. Гарантируем совместимость с последними версиями контрактов.

Hardware Security Module для корпоративных кошельков

Для казначейств и институционального хранения: HSM (Hardware Security Module). Ключ генерируется и никогда не покидает защищённый чип. Подпись — внутри HSM. Поддерживается аппаратная аттестация. Используемые решения: AWS CloudHSM, Azure Dedicated HSM, Thales Luna, YubiHSM 2 (для небольших объёмов). Интеграция через PKCS#11 или cloud-specific API.

Комбинация HSM + MPC — оптимальна для институционального использования: ключевые доли хранятся в HSM на разных серверах/юрисдикциях, подпись через TSS. Это обеспечивает соответствие регуляторным требованиям (например, для крипто-кастодианов).

Интеграция с dApps: WalletConnect и стандарты

Любой кошелёк должен уметь взаимодействовать с dApps. Стандарт — WalletConnect v2 (Sign API): QR-код или deep link, peer-to-peer зашифрованный канал через relay сервер. Для браузерных расширений — EIP-1193 (Ethereum Provider API).

На фронтенде используем wagmi + viem — один интерфейс для MetaMask, WalletConnect, Coinbase Wallet, injected providers. Для Account Abstraction — EIP-5792 (wallet capabilities) и EIP-7677 (paymaster service).

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

1. Threat model — кто пользователь (B2C, B2B, institutional), какие операции, каков допустимый risk model. От этого зависит архитектура.
2. Выбор и проектирование схемы хранения ключей — MPC, HSM, мультисиг или их комбинация.
3. Разработка Account контракта (если EIP-4337) или интеграция MPC-библиотеки.
4. Backend — MPC-координация, управление сессиями, paymaster-сервис (если нужен).
5. Мобильное/браузерное приложение — UI с интеграцией WalletConnect, биометрии, QR.
6. Интеграция с dApps — EIP-1193, WalletConnect v2.
7. Аудит контрактов и криптографических реализаций — обязательный этап. MPC-библиотеки имеют известные уязвимости (GG18 подвержен атаке при malicious participant без abort protocol). Используем библиотеки с актуальными security review (CGGMP21). Опыт прохождения аудитов у Certik, Hacken, Trail of Bits — подтверждаем сертификатами.

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

• Исходные коды смарт-контрактов (Solidity/Rust) с документацией
• Backend-сервис MPC-координации (на Go или Rust) с API
• Мобильное приложение (iOS/Android) или браузерное расширение
• Интеграция с WalletConnect, Ledger/Trezor (по необходимости)
• Подготовка к аудиту безопасности (отчёт со списком уязвимостей)
• Документация администратора и пользователя
• Доступ к репозиторию, CI/CD, мониторинг (Tenderly, Etherscan API)
• Обучение вашей команды (2-3 сессии)
• Поддержка после запуска — 1 месяц

Сроки и стоимость

Стоимость рассчитывается индивидуально под ваш проект. Оценим за 1 день — напишите на почту или в Telegram. Предоставляем гарантию на код и timeline.

Типичные ошибки при разработке криптокошельков (и как их избежать)

• Использование устаревших MPC-библиотек — GG18 без abort protocol. Выбираем CGGMP21 или tss-lib с актуальными audit report.
• Жёсткая привязка к одному блокчейну — не закладывают абстракцию под L2/сайдчейны. Используем viem/wagmi для кросс-чейн.
• Игнорирование MEV-атак — при использовании мультисига без таймлоков. Добавляем tx simulation (Tenderly) и sandwitching protection.
• Отсутствие fallback-механизма восстановления — для Account Abstraction не настраивают social recovery. Закладываем с первого релиза.

Устраняем эти грабли на этапе проектирования — под каждый проект составляем threat model и security checklist.

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