Интеграция Alchemy Account Kit: смарт-аккаунты за 2 недели

Проблема: пользователь платит газ из своего кошелька — барьер для массового принятия

Каждый раз, когда новый пользователь хочет mint NFT или обменять токен в вашем dApp, он должен иметь ETH на кошельке для gas. Это отсекает до 80% аудитории, которая не хочет заморачиваться с покупкой нативного токена. Alchemy Account Kit решает эту задачу через Account Abstraction (ERC-4337): пользователь может платить за газ в токенах, или вы спонсируете gas через Paymaster.

Мы внедрили Account Kit для нескольких DeFi-протоколов и игр. Результат: onboarding сокращается с 5 до 1 клика, а конверсия регистраций растёт на 35-40%. Ниже разберём, как мы это делаем — с кодом, таблицами и типичными подводными камнями.

Компоненты Alchemy Account Kit

Light Account — минималистичная реализация ERC-4337. Дешевле в деплое и использовании, чем Safe. Поддерживает: single owner, session keys, EIP-1271.

Modular Account — расширяемый аккаунт на базе ERC-6900 (Modular Smart Account). Позволяет добавлять плагины: multisig, spending limits, социальное восстановление.

Gas Manager (Paymaster) — спонсирование газа с политиками: по сумме, по числу операций, по whitelist адресов контрактов.

Alchemy Bundler — встроенный bundler с SLA 99.9% и поддержкой всех major EVM цепей.

Что выбрать: Light Account или Modular Account?

Почему стоит использовать встроенный Alchemy Bundler?

Бандлер — самый критичный компонент: он агрегирует user operations, подписывает и отправляет в сеть. Alchemy запускает собственный bundler с SLA 99.9% и поддержкой всех major L2 (Polygon, Arbitrum, Optimism, Base). После настройки синхронизация с сетью занимает минуты, а не дни. Для продакшена мы рекомендуем именно его — так вы получаете гарантию uptime и приоритетную поддержку.

Как настроить Gas Manager (Paymaster)?

Gas Manager позволяет спонсировать газ с помощью политик. В Alchemy Dashboard вы создаёте policy, задаёте лимиты и получаете policyId. Пример конфигурации:

import { createModularAccountAlchemyClient } from "@alchemy/aa-alchemy";
import { LocalAccountSigner, sepolia } from "@alchemy/aa-core";
import { http } from "viem";

const client = await createModularAccountAlchemyClient({
  apiKey: "YOUR_ALCHEMY_API_KEY",
  chain: sepolia,
  signer: LocalAccountSigner.privateKeyToAccountSigner(privateKey),
  gasManagerConfig: {
    policyId: "YOUR_GAS_POLICY_ID",
  },
});

// Отправка user operation без ETH на кошельке
const { hash } = await client.sendUserOperation({
  uo: {
    target: contractAddress,
    data: encodeFunctionData({ abi, functionName: "mint", args: [] }),
    value: 0n,
  },
});

await client.waitForUserOperationTransaction({ hash });

После интеграции пользователь не замечает, что транзакция платная — всё оплачивается за счёт dApp. Наши клиенты экономят до 40% на газе благодаря оптимальным политикам.

React хуки

Account Kit предоставляет @alchemy/aa-alchemy/react с готовыми хуками:

import {
  AlchemyAccountProvider,
  useSmartAccountClient,
  useSendUserOperation,
} from "@alchemy/aa-alchemy/react";

function MintButton() {
  const { client } = useSmartAccountClient({ type: "ModularAccount" });
  const { sendUserOperation, isSendingUserOperation } = useSendUserOperation({
    client,
    waitForTxn: true,
  });

  return (
    <button
      onClick={() =>
        sendUserOperation({
          uo: { target: NFT_ADDRESS, data: mintCalldata, value: 0n },
        })
      }
      disabled={isSendingUserOperation}
    >
      {isSendingUserOperation ? "Minting..." : "Mint NFT"}
    </button>
  );
}

Session Keys

Account Kit поддерживает session keys — временные ключи с ограниченными правами. Пользователь один раз подтверждает создание session key, затем приложение может выполнять транзакции без каждый раз запрашивая подпись:

const sessionKey = await client.createSessionKey({
  expirationTime: Math.floor(Date.now() / 1000) + 3600, // 1 час
  permissions: [
    {
      type: "contract",
      address: GAME_CONTRACT,
      functionSelectors: [MOVE_SELECTOR, ATTACK_SELECTOR], // только конкретные функции
    },
  ],
  spendingLimit: parseEther("0.01"), // максимум 0.01 ETH за сессию
});

Это особенно ценно для игр и приложений с частыми мелкими транзакциями.

Как мы интегрируем Account Kit: пошаговый процесс

Весь цикл занимает 1-2 недели. Включаем документацию с примерами кода и обучение команды.

Что входит в услугу

• Выбор и кастомизация smart account (Light или Modular) — под ключ
• Настройка Gas Manager с политиками спонсирования
• Интеграция с существующим auth (email, social, Web3)
• Адаптация React UI под хуки Account Kit
• Тестирование на testnet и mainnet
• Документация и сторибук компонентов

Мы выполнили десятки интеграций для DeFi-протоколов и NFT-маркетплейсов. Alchemy Account Kit — зрелый инструмент, но требует глубокого понимания ERC-4337. Оценим ваш проект бесплатно — напишите нам.

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

При интеграции важно избегать: использование LocalAccountSigner в production небезопасно — замените на Web3Auth или WalletConnect; не забывайте про nonce management, отличный от EOA; обязательно тестируйте политики газ-менеджера, чтобы избежать превышения бюджета. Мы учитываем эти моменты в каждом проекте.

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

Мы разрабатываем криптокошельки под ключ — от 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.

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