Пользователь нажимает «Mint» в вашем dApp — и видит MetaMask с запросом 0.003 ETH на газ. У него нет ETH, только NFT и USDC. Конверсия падает. Это не гипотетический сценарий: именно это убивает onboarding в большинстве Web3 приложений для массовой аудитории. Biconomy решает это через аккаунт-абстракцию. Мы внедряем Biconomy SDK в ваш проект под ключ, чтобы пользователи забыли про газ.
Что такое Biconomy и как это работает
Biconomy — это реализация ERC-4337 (Account Abstraction) с собственной инфраструктурой: bundler, Paymaster, и Smart Account контракты. Пользователь не подписывает Ethereum транзакцию — он подписывает UserOperation (структурированный объект), bundler упаковывает несколько UserOperation в одну транзакцию и отправляет в mempool. Paymaster оплачивает газ.
Для разработчика это означает: backend или Paymaster-контракт платит за газ вместо пользователя, пользователь только подписывает intent. Конверсия растёт на 30–50% — реальные цифры из наших проектов.
Три ключевых компонента интеграции
Smart Account
Smart Account — это смарт-контракт, который является кошельком пользователя. В отличие от EOA, он может:
- Объединять несколько вызовов в одну транзакцию (batch)
- Поддерживать сессионные ключи (пользователь подписывает один раз, следующие N транзакций — без подписи)
- Иметь логику восстановления аккаунта
- Верифицировать подписи через кастомную логику (WebAuthn, passkey)
Biconomy предоставляет Modular Smart Account (v3), который совместим со стандартом ERC-7579 (модульные аккаунты). Деплой Smart Account для нового пользователя происходит автоматически при первом использовании через counterfactual deployment — контракт деплоится только при первой транзакции, а адрес вычисляется детерминированно заранее.
Paymaster
Paymaster — это контракт, который берёт на себя оплату газа. Biconomy предоставляет Sponsorship Paymaster (спонсируемые транзакции) и Token Paymaster (пользователь платит токенами вместо ETH).
Для Sponsorship Paymaster нужно:
- Зарегистрировать проект в Biconomy Dashboard
- Пополнить баланс MATIC/ETH для покрытия газа
- Настроить whitelist контрактов и функций, которые спонсируются
Token Paymaster позволяет пользователю платить USDC, DAI, или любым ERC-20, поддерживаемым Paymaster. Конвертация в нативный токен для оплаты газа происходит внутри UserOperation.
Bundler
Bundler — это нода, которая принимает UserOperation от пользователей, валидирует их, упаковывает в batch и отправляет в сеть. Biconomy предоставляет hosted bundler через API. Для production важен выбор bundler по следующим параметрам:
- Latency (время от UserOperation до включения в транзакцию)
- Поддерживаемые чейны
- Rate limits и надёжность
Как проходит интеграция Biconomy в dApp?
Интеграция начинается с аудита вашего смарт-контракта на совместимость с аккаунт-абстракцией. Мы проверяем, нет ли блокировок вроде tx.origin == msg.sender, и подбираем оптимальную конфигурацию Paymaster.
Стек: @biconomy/sdk v4, viem, wagmi.
import { createSmartAccountClient } from "@biconomy/sdk";
import { createWalletClient, custom } from "viem";
import { polygon } from "viem/chains";
// Создаём Smart Account для пользователя
const walletClient = createWalletClient({
chain: polygon,
transport: custom(window.ethereum),
});
const smartAccount = await createSmartAccountClient({
signer: walletClient,
bundlerUrl: "https://bundler.biconomy.io/api/v2/137/nJPK7B3ru...",
paymasterUrl: "https://paymaster.biconomy.io/api/v1/137/Tpk8nuCU...",
paymasterTokens: [{ address: USDC_ADDRESS, decimal: 6, symbol: "USDC" }],
});
// Batch транзакция: approve + deposit за одну подпись
const txs = [
{ to: TOKEN_ADDRESS, data: approveCalldata },
{ to: PROTOCOL_ADDRESS, data: depositCalldata },
];
const userOpResponse = await smartAccount.sendTransaction(txs, {
paymasterServiceData: { mode: PaymasterMode.SPONSORED },
});
const { transactionHash } = await userOpResponse.waitForTxHash();
Сессионные ключи
Сессионные ключи — одна из наиболее мощных возможностей Smart Account. Пользователь подписывает политику один раз: «разрешить адресу X вызывать функцию Y контракта Z с суммой не более N токенов в течение 24 часов». После этого сессионный ключ выполняет транзакции без участия пользователя — идеально для игр, автоматических стратегий, подписок.
const sessionModule = await createSessionKeyManagerModule({
moduleAddress: SESSION_KEY_MANAGER_MODULE_ADDRESS,
smartAccountAddress: smartAccount.accountAddress,
});
// Создаём сессию с ограничениями
const sessionData = await createSession(
smartAccount,
[{ sessionValidationModule: ERC20_SESSION_VALIDATION_MODULE, sessionKeyData }],
null, // хранение в памяти или IPFS
{ paymasterServiceData: { mode: PaymasterMode.SPONSORED } }
);
Поддерживаемые сети
| Сеть | Bundler | Paymaster | Gas token |
|---|---|---|---|
| Ethereum Mainnet | Да | Да | ETH, ERC-20 |
| Polygon | Да | Да | MATIC, USDC |
| Arbitrum One | Да | Да | ETH |
| Optimism | Да | Да | ETH |
| Base | Да | Да | ETH |
| BSC | Да | Да | BNB |
| Avalanche | Да | Да | AVAX |
Типичные проблемы при интеграции
UserOperation reverts без понятной ошибки. Biconomy bundler валидирует UserOperation перед отправкой, но ошибки из calldata (например, revert в целевом контракте) возвращаются в hex без decode. Используем ethers.utils.parseError() или cast для decode revert reason.
Несовместимость контракта с Smart Account. Некоторые контракты проверяют msg.sender == tx.origin для защиты от контрактных вызовов. Smart Account — это контракт, поэтому tx.origin != msg.sender всегда. Такие проверки блокируют gasless транзакции. Нужно либо убирать проверку в контракте, либо использовать EntryPoint как trusted forwarder.
Counterfactual адрес не совпадает с ожидаемым. Smart Account адрес зависит от версии фабрики, salt, и signerAddress. При смене сети или версии SDK адрес может измениться. Всегда используем smartAccount.getAccountAddress() как единственный источник правды.
Что входит в работу по интеграции Biconomy
- Аудит существующих контрактов на совместимость с ERC-4337
- Настройка Paymaster (Sponsorship и/или Token)
- Разработка слоя UserOperation на фронтенде (SDK + viem)
- Реализация сессионных ключей, если требуется
- Тестирование в Testnet и Mainnet (включая fuzzing)
- Документация по эксплуатации и поддержка 30 дней
Мы работаем с Biconomy с 2022 года — 5+ успешных интеграций в DeFi и NFT проектах. Наши инженеры в курсе последних обновлений SDK и стандартов.
Сравнение: Biconomy vs самостоятельная реализация ERC-4337
| Параметр | Biconomy | Самостоятельно |
|---|---|---|
| Время настройки | 1-3 дня | 2-4 недели |
| Поддержка сетей | 7+ сетей | только одна |
| Мониторинг | Dashboard | самописный |
| Безопасность | Аудированный codebase | свой аудит |
Готовы оценить ваш проект? Свяжитесь — за 1 день сделаем анализ и прикинем сроки. Базовая интеграция занимает от 1 до 3 рабочих дней, с сессионными ключами — до 5 дней. Стоимость рассчитывается индивидуально и зависит от сложности контрактов и необходимых доработок.
Не теряйте конверсию из-за газа — внедрите gasless-транзакции уже сейчас.