28. Смарт-кошельки и Account Abstraction
Опыт eBattery в Web3 нацелен на то, чтобы инвестор мог безопасно управлять своими экономическими правами, не вникая в технические детали блокчейна. Участие в проекте станции, получение ежемесячной доли прибыли или передача инвестиционных единиц должны быть понятными, проверяемыми операциями под контролем пользователя.
При использовании традиционного кошелька от пользователя могут ожидать, что он будет защищать приватные ключи, выбирать сеть, держать отдельный актив для оплаты комиссии за операции и разбирать технические сообщения для подписи. Возложение всех этих обязанностей на пользователя в неизменном виде создаёт серьёзное препятствие для платформы, нацеленной на широкую аудиторию.
Подход eBattery к умному кошельку этот опыт Account Abstraction — абстракция аккаунта со своей архитектурой. Подтверждение операций по счёту, границы полномочий, способ оплаты комиссий и правила восстановления реализуются в программируемой структуре. Пока пользователь работает в привычном ему приложении, сохраняются авторизация и порядок учёта, которых требуют инвестиционные операции.
Этот раздел описывает архитектуру смарт-аккаунтов и принципы безопасности, которые eBattery принимает за основу для этапа Web3. Цель этой структуры не только в сокращении числа транзакций. Чтобы пользователь мог понимать, что он разрешает, ограничивать предоставленные полномочия и сохранять контроль над своей учётной записью является основой проекта.
28.1 Переход от аккаунта Web2 к доступу Web3
Аккаунт пользователя eBattery — общая точка доступа к карте, планированию маршрутов, сообществу и другим модулям Web2. Доступ к Web3 связывается с этим аккаунтом; однако регистрация в приложении сама по себе не означает открытия инвестиционного счёта или предоставления полномочий на финансовые операции.
Когда пользователь переходит в область Web3, устанавливаются три различных отношения:
| Уровень | Основная функция |
|---|---|
| Учётная запись пользователя eBattery | Управление сессией приложения и пользовательскими настройками |
| e-ID инвестора | Связывание личности, соответствия инвестора и условий доступа к проекту |
| Смарт-кошелёк | Управление ончейн-активами и авторизованными операциями |
Это различие важно как для пользовательского опыта, так и для безопасности. Вход человека в приложение не означает, что он вправе участвовать в конкретном инвестиционном проекте. Точно так же завершение проверки личности само по себе не разрешает совершать операции с кошелька.
Переход к Web3 проходит так: пользователь изучает условия соответствующей услуги, выполняет необходимые шаги проверки соответствия и настраивает способ авторизации своего смарт-аккаунта. Подключение кошелька связывается с личностью пользователя и инвестора через верифицированную операцию.
Пользователю, который хочет продолжать пользоваться Web2, участие в Web3 не обязательно. Доступ к карте, сообществу или игровой зоне не привязан к открытию инвестиционного счёта, приобретению цифрового актива или подписи кошельком.
Игровые баллы, зарядные кредиты, платёжные балансы и инвестиционные активы также не конвертируются друг в друга при этом переходе. Общая учётная запись пользователя не означает объединения разных экономических функций под одним балансом.
28.2 Структура смарт-аккаунта на основе ERC-4337
Архитектура смарт-кошелька eBattery в поддерживаемых сетях EVM подход к смарт-аккаунтам на основе ERC-4337 лежит в основе.
ERC-4337 позволяет определять логику проверки транзакций аккаунта кодом смарт-контракта. Транзакция пользователя передаётся через структуру, называемую UserOperation. Bundler'ы надлежащим образом доставляют эти операции в блокчейн, а контракт EntryPoint выступает центральным компонентом протокола в процессе проверки и исполнения. Необязательный paymaster может оплатить комиссию за транзакцию от имени пользователя.
С точки зрения eBattery компоненты этой архитектуры позиционируются следующим образом:
| Компонент | Роль в eBattery |
|---|---|
| Смарт-аккаунт | Применение правил подписи, полномочий и исполнения пользователя |
| UserOperation | Техническое представление операции, подтверждённой пользователем |
| Bundler | Проверка транзакции и отправка её в блокчейн через поддерживаемый EntryPoint |
| EntryPoint | Выполнение проверки аккаунта и, при наличии, paymaster |
| Paymaster | Покрытие сетевого сбора в рамках установленной политики |
| Компонент создания аккаунта | Настройка нового смарт-аккаунта с правильными начальными полномочиями |
Смарт-аккаунт не обязан быть привязан к единственному способу подписи. Экосистема ERC-4337 предлагает структуру, способную поддерживать разные способы подписи, программируемые правила аккаунта и сценарии абстракции комиссий. Однако поведение таких функций, как passkey, сеансовые ключи или восстановление, проектируется отдельно в используемой реализации аккаунта.
При создании аккаунта eBattery совместно проверяются право подписи, схема восстановления и активные модули. Модель старта, при которой аккаунт создаётся с неверными или временными полномочиями и исправляется позже, не используется.
Подпись операции связывается с контекстом соответствующей учётной записи и сети. ERC-4337 требует, чтобы подпись была привязана к идентификатору сети и адресу EntryPoint для защиты от атак повторного воспроизведения. Кроме того, eBattery проверяет тип операции, пределы полномочий и условия действительности на уровне приложения.
Архитектура продумана так, чтобы не создавать лишней зависимости от одного сервиса-бандлера. Одна и та же транзакция, повторно отправленная через альтернативный сервис, не создаёт второй экономической операции. Контроль последовательности операций аккаунта и защита от повторного использования сохраняются.
28.3 Вход с помощью Passkey и подтверждение операций
Passkey — это подход, при котором пользователь проходит аутентификацию с помощью криптографических учётных данных вместо пароля. Для пользователя это может выглядеть как распознавание лица, отпечаток пальца или другой локальный способ проверки, поддерживаемый устройством.
В подходе FIDO passkey используют аутентификацию с открытым ключом, специфичным для сервиса. Существуют типы, привязанные к устройству, и типы, синхронизируемые между устройствами через подходящего провайдера. При использовании биометрической проверки биометрические данные не становятся учётными данными, передаваемыми сервису, как пароль.
В eBattery passkey рассматривается в двух отдельных контекстах использования:
Вход в аккаунт, позволяет пользователю открыть сеанс в приложении или в вебе.
Подтверждение финансовой операцииавторизует конкретную ончейн-операцию.
Хотя эти две операции находятся в рамках одного пользовательского опыта, они служат разным целям. Ответ проверки, созданный для входа, нельзя использовать как разрешение на покупку инвестиционной единицы или изменение полномочий кошелька.
WebAuthn связывает ответ аутентификации с контекстом сервиса и представленным запросом на проверку. При подтверждении операций в eBattery этот запрос привязывается к содержимому операции, аккаунту, сети и сведениям о сроке действия. Соответствующие проверки RP ID, origin и верификации пользователя применяются в зависимости от поддерживаемых контекстов мобильного и веб-каналов.
Чтобы смарт-аккаунт мог принять подпись passkey, нужен подходящий компонент проверки. Документация OpenZeppelin по смарт-аккаунтам WebAuthn предлагает пример подхода к проверке ответов WebAuthn в смарт-контрактах. При техническом выборе eBattery совместно учитывается, поддерживаются ли используемый алгоритм подписи и путь проверки в целевой сети, а также их стоимость и свойства безопасности.
Простота использования Passkey не делает сводку операции лишней. Перед подтверждением пользователь видит, что он покупает, какая сумма будет потрачена и какие полномочия будут предоставлены. Окно биометрической проверки устройства не считается экраном договора, автоматически показывающим все финансовые условия.
Поэтому eBattery рассматривает соответствие между сводкой операции, показанной пользователю, и содержимым подписываемой операции как часть дизайна безопасности.
28.4 Общий доступ к аккаунту через мобильное приложение и веб
Пользователь eBattery может получить доступ к одному и тому же инвесторскому аккаунту через поддерживаемые мобильные приложения и веб-интерфейсы. Общий доступ не основан на том, что устройства загружают один и тот же закрытый ключ с сервера приложения.
Непрерывность аккаунта обеспечивается через подтверждённую связь между учётной записью пользователя, электронным идентификатором инвестора (e-ID), адресом смарт-аккаунта и данными уполномоченной идентификации. Когда пользователь входит с другого устройства, он может видеть свой портфель и историю операций; для финансовой операции ему также необходим доступ к уполномоченному способу подписи.
Доверительные отношения между мобильными приложениями и веб-доменом устанавливаются с помощью механизмов соответствующих платформ. На стороне Apple это связывание associated domains и webcredentials; на стороне Android — настройка Digital Asset Links. Это технические элементы связи учётных данных между приложением и доменом сервиса.
В модели совместного доступа применяются следующие принципы:
Вход с нового устройства не приравнивается к предоставлению новых полномочий на операции.
Поддерживаемые доменные имена и идентификаторы приложений проверяются.
Добавление нового подписанта утверждается в рамках действующей политики безопасности.
Право просматривать аккаунт отделено от права совершать операции с активами.
Операции с разных устройств одного и того же пользователя обрабатываются через общую очередь аккаунта.
Возможность использовать passkey на другом устройстве зависит от поставщика учётных данных и поддерживаемых функций синхронизации или кросс-устройственной аутентификации. Поэтому автоматическая и безусловная переносимость ключей между всеми операционными системами не предполагается.
Точно так же то, что аккаунт пользователя может обращаться к нескольким сетям, не означает, что в каждой сети существует один и тот же адрес смарт-аккаунта или одна и та же конфигурация аккаунта. Связи сетей и аккаунтов наглядно показываются пользователю; автоматического моста между активами не создаётся.
28.5 Спонсирование gas и политика Paymaster
Спонсирование газа снижает необходимость для пользователя отдельно приобретать нативный актив сети для определённых транзакций. Для пользователя операция выглядит проще, а сетевые расходы покрывает другая сторона в рамках применимой политики.
Подход eBattery к paymaster, — это спонсирование операций с определённым объёмом и бюджетом. Спонсируемая операция не означает экономически бесплатную операцию; меняется лишь то, кто несёт расходы.
Операции, подходящие для спонсирования, определяются потоком действий пользователя. Такие операции, как активация смарт-аккаунта или допустимый запрос на долю прибыли, могут рассматриваться в рамках соответствующей политики. Поддержка, применимая к каждой операции, показывается на экране подтверждения.
Политика Paymaster управляет следующими областями:
| Область контроля | Цель |
|---|---|
| Разрешённые типы договоров и операций | Предотвращение использования спонсорства не по назначению |
| Соответствие требованиям пользователя и аккаунта | Определение аккаунтов, которые могут воспользоваться поддержкой |
| Предел затрат на одну операцию | Ограничение непредвиденных сетевых комиссий |
| Периодический лимит использования | Устойчивое управление бюджетом спонсора |
| Повторные и подозрительные запросы | Снижение автоматизированных злоупотреблений |
| Срок действия | Предотвращение повторного использования старых подтверждений спонсора |
Безопасность Paymaster рассматривается совместно с проверкой, симуляцией операций и контролем злоупотреблений. В документации ERC-4337 защита ресурсов paymaster от злоупотреблений и попыток отказа в обслуживании также выделена в отдельную область безопасности.
Одобрение спонсора не заменяет подпись пользователя. Paymaster может покрыть сетевую комиссию; это не даёт полномочий покупать инвестиции или передавать активы от имени пользователя.
Если спонсорство применить нельзя, операция не продолжается автоматически со списанием платы с баланса пользователя. Пользователю показывается новая стоимость и запрашивается необходимое подтверждение. Технически поддерживаемая альтернатива с оплатой пользователем предлагается с той же ясностью.
Бюджет спонсора не покрывается без пояснений за счёт резервов на обслуживание станций или невостребованных долей прибыли инвесторов. Определяется, к какому сервисному бюджету относятся соответствующие расходы.
28.6 Ключи сеанса и ограниченные полномочия
Сессионные ключи позволяют пользователю предоставить полномочия, ограниченные по сроку и объёму, для определённых транзакций. Цель — реже использовать основной способ подписи при повторяющихся операциях, сохраняя контроль над аккаунтом.
Эти полномочия не являются готовой функцией, самостоятельно определённой в ERC-4337. Они реализуются в логике проверки аккаунта или в модулях авторизации. В соответствующей документации ERC-4337 также указано, что сессионные ключи контролируются правилами, специфичными для кошелька.
Полномочия сессий eBattery управляются через явную запись о согласии. Эта запись может включать следующие ограничения:
Сеть и смарт-аккаунт, к которым это относится.
Разрешённые контракты.
Типы действий, которые можно вызвать.
Допустимые активы.
Лимит на одну операцию и в целом.
Фиксированные адреса получателей или адреса из списка разрешённых.
Время начала и окончания.
Количество использований и условия отмены.
Например, пользователь может предоставить ограниченные полномочия только для получения своей доли прибыли по конкретному договору распределения на собственный указанный счёт. Эти полномочия не распространяются на продажу инвестиционных единиц, изменение адреса получателя или разрешение на расходование средств по другому договору.
Для таких действий, как просмотр портфеля, чтение отчётов или получение уведомлений, право на перемещение активов не предоставляется. Удобство чтения не строится на ненужном праве подписи.
Ограниченные полномочия защищаются не только списком разрешений, хранящимся на сервере приложения. Соответствующая ончейн-операция должна удовлетворять области разрешений при проверке аккаунта. В пакетных операциях также проверяется каждая вложенная операция; выход за пределы ограничений через вызовы общего назначения предотвращается.
Пользователь может просматривать и отзывать действующие разрешения сессий. Чтобы отзыв в блокчейне вступил в силу, соответствующая транзакция должна быть завершена; одного выхода из приложения недостаточно, чтобы считать, что все разрешения в блокчейне сняты.
Разрешения на расходование токенов также отслеживаются отдельно от сессионных ключей. Отзыв сессионного полномочия не всегда автоматически отменяет разрешение на расходование, ранее выданное другому контракту. Экран безопасности показывает эти два типа полномочий раздельно.
28.7 Подтверждение пользователем инвестиционных операций
В инвестиционных операциях eBattery строит подтверждение пользователя на сводке операции с понятным экономическим смыслом. Снижение технической сложности не делает решение невидимым.
Перед операцией пользователю показывается следующая информация:
| Операция | Основная информация на экране подтверждения |
|---|---|
| Участие в Launchpad | Проект, количество единиц, общая стоимость, сборы и условия финансирования |
| Вторичная покупка | Цена единицы, общий платёж, периодические права и условия обмена |
| Вторичная продажа | Проданные единицы, цена продажи, комиссия 1% и чистая сумма |
| Заявка на долю прибыли | Период, валовое начисление, удержания, чистая выплата и получатель |
| Разрешение на расходы | Авторизованный контракт, актив, лимит и объём |
| Изменение безопасности | Подписанты, которых нужно добавить или удалить, и изменяемые полномочия |
Операции со значительными экономическими последствиями не выполняются только на основании открытого сеанса приложения. Для таких действий, как покупка, продажа, новое разрешение на расходы, смена подписанта и настройка восстановления, применяется повторная верификация соответствующего уровня.
Технически несколько шагов могут выполняться в одной группе транзакций. Например, необходимое разрешение на платёж и вызов покупки могут быть подготовлены вместе. Пользователю показывается совокупный эффект этих шагов; скрытые и неограниченные полномочия по одному подтверждению не предоставляются.
Для поддерживаемых подписанных сообщений могут использоваться подходы со структурированными данными, такие как EIP-712. Этот стандарт позволяет подписывать данные с контекстом типа и полей, но сам по себе не гарантирует ни защиту от повторного использования, ни понятность пользовательского интерфейса. Порядок операций, срок действия, целевой контракт и сценарий использования проверяются отдельно.
При проверке подписей смарт-аккаунта другими контрактами платформы оценивается совместимость с ERC-1271. Благодаря этому аккаунт может предлагать проверку подписи на основе контракта, не завися только от систем, ожидающих традиционную подпись закрытым ключом.
Симуляция перед транзакцией помогает показать ожидаемые движения активов и возможные ошибки. Однако цена, допустимость или состояние контракта могут измениться до попадания транзакции в сеть. Поэтому принятые пользователем цена, сумма и границы срока действия проверяются и во время исполнения.
28.8 Восстановление кошелька и смена устройства
Смена устройства, восстановление учётной записи приложения и восстановление права подписи смарт-кошелька — разные процессы. eBattery не объединяет эти случаи в одном действии «я забыл пароль».
Подход к восстановлению различает три основных сценария:
Получение пользователем доступа к другому действительному способу подписи: Новое устройство или новые учётные данные можно добавить в аккаунт с помощью уже авторизованного способа.
Возможность использовать синхронизированный passkey на новом устройстве: При соблюдении условий поддерживаемого провайдера и устройства к тому же учётному ключу можно получить доступ повторно. При этом создание нового подписанта в аккаунте может не потребоваться.
Потеря доступа ко всем обычным способам подписи: Применяется независимый механизм восстановления, определённый при создании аккаунта.
Конструкция восстановления доступа в eBattery рассматривается так, чтобы поддерживать такие механизмы, как резервный способ подписи, заранее уполномоченные стороны восстановления или подходящая схема множественного подтверждения. Кто и при каких условиях может заменить подписантов при выбранном способе, объясняется пользователю при создании аккаунта.
Запрос на восстановление не создаёт обычных полномочий на перевод. Запрос проходит необходимые проверки; применяются механизмы ожидания и возражения; уведомления отправляются по существующим каналам безопасности. Если у пользователя всё ещё есть действующий способ подписи, он должен иметь возможность вмешаться в несанкционированную попытку восстановления.
Доступ к адресу электронной почты или предоставление службе поддержки документа, удостоверяющего личность, сами по себе не считаются полномочием перемещать ончейн-активы. Проверка личности может быть лишь одним из компонентов заранее определённой политики восстановления.
Учитывается также, что синхронизированный passkey может представлять одни и те же учётные данные на нескольких устройствах. Выход потерянного устройства из сеансов приложения не обязательно аннулирует в блокчейне подписывающие учётные данные, которыми это устройство может пользоваться. При необходимости подписант аккаунта заменяется, а соответствующие полномочия сеансов отзываются.
После восстановления инвестиционные единицы и прошлые права могут сохраняться на том же счёте. Если необходимо использовать новый адрес, экономические права и записи о соответствии проходят через процесс контролируемой передачи. Прошлые доли прибыли или записи на конец периода не дублируются на том основании, что открыт новый счёт.
Если не осталось ни одной действительной подписи или применимого полномочия на восстановление, одного лишь доступа к аккаунту приложения недостаточно, чтобы восстановить кошелёк. Поэтому настройка порядка восстановления — основная часть безопасности аккаунта перед инвестированием.
28.9 Контроль над активами и модель хранения
Основной принцип проектирования умного кошелька eBattery — инвестор должен иметь реальный контроль над движением активов. Этот контроль не оценивается только по надписи «владелец кошелька», отображаемой в интерфейсе.
Вопросы, определяющие реальную структуру контроля, таковы:
Кто может создать подпись транзакции?
Кто может добавить в аккаунт нового подписанта?
Кто может завершить процесс восстановления?
Кто может изменять код аккаунта или модули верификации?
Кто может снять лимиты расходов?
Кто может переводить активы на другой адрес?
Ответы на эти вопросы лежат в основе модели хранения. То, что аккаунт требует подписи пользователя, само по себе не является достаточным признаком контроля, если другая сторона может изменить это условие через широкие полномочия по обновлению или восстановлению.
В модели eBattery полномочия управлять сессиями приложения, обеспечивать спонсорство paymaster или проверять допуск инвестора не превращаются автоматически в полномочия снимать активы с кошелька пользователя.
| Полномочие или услуга | Его охват |
|---|---|
| Управление учётной записью пользователя | Доступ к приложению и настройки |
| Проверка соответствия инвестора требованиям | Доступ к отдельным инвестиционным операциям |
| Сервис Bundler | Отправка авторизованной транзакции в сеть |
| Сервис Paymaster | Покрытие сетевых расходов по допустимой операции |
| Полномочия подписи кошелька | Подтверждение операций в рамках правил аккаунта |
| Полномочия по восстановлению | Перестройка доступа при заранее определённых условиях |
Если смарт-аккаунт обновляемый или модульный, влияние этих полномочий на безопасность показывается отдельно. Обновления, меняющие контроль над аккаунтом, не рассматриваются как обычное обновление приложения. Такие меры, как подтверждение пользователя, мультиподпись или временная задержка, чётко определяются в соответствии с используемой моделью аккаунта.
Кошелёк инвестора, эскроу-структура Launchpad и пул распределения также являются отдельными структурами. Деньги, удерживаемые в эскроу-контракте во время финансирования, не являются балансом кошелька, которым пользователь может свободно распоряжаться напрямую. Так же и невостребованная доля прибыли — это экономическое право в соответствующем механизме распределения.
Правила разрешённой передачи единиц RWA — это уровень, отдельный от управления кошельком. Даже если пользователь является подписантом своего кошелька, инвестиционная единица может быть передана только соответствующим получателям и на поддерживаемых условиях. Эта особенность не означает, что всеми активами аккаунта свободно распоряжается платформа.
Описание хранения, показываемое пользователю, отражает используемую техническую и правовую структуру полномочий. Выражение «смарт-кошелёк» само по себе не используется как утверждение о полном контроле пользователя, институциональном хранении или автоматическом восстановлении.
28.10 История операций и уведомления о безопасности
Заключительный уровень работы со смарт-кошельком — понятное отслеживание операций и изменений безопасности. Пользователь должен видеть не только свой баланс, но и события, влияющие на этот баланс и на полномочия его учётной записи.
История операций объединяет следующую информацию:
Тип операции и соответствующий проект станции.
Используемые сеть и смарт-аккаунт.
Актив, количество и контрагент.
Условия оплаты, одобренные пользователем.
Стоимость сети, которая спонсируется, и стоимость, покрываемая пользователем.
Ссылка на UserOperation.
Ссылка на onchain-транзакцию, если она есть.
Фактический результат выполнения.
Соответствующий отчёт, запись о продаже или о доле прибыли.
Отслеживание статуса различает такие этапы, как подготовка, ожидание подписи, отправлено, исполнено, не удалось и окончательно подтверждено. То, что Bundler принял запрос, не означает, что финансовая операция состоялась.
Поскольку одна ончейн-транзакция может содержать несколько пользовательских операций, записи транзакции верхнего уровня недостаточно. eBattery проверяет результат собственной операции пользователя и ожидаемые движения активов. Если при неудачном исполнении всё же возникли сетевые расходы, они не показываются как выполненная инвестиционная покупка или комиссия за продажу.
История безопасности, в свою очередь, отслеживается отдельно от финансовых операций:
Вход с нового устройства.
Добавление нового passkey или подписанта.
Отзыв права подписи.
Создание и отзыв ключей сеанса.
Предоставление или изменение разрешения на расходы.
Открытие запроса на восстановление.
Изменение модуля аккаунта или политики безопасности.
Попытки подозрительных операций.
Выход из устройства лишь сообщает пользователю, что сеанс в приложении завершён. Если необходимо отозвать onchain-разрешения, это показывается отдельно, а их окончательное подтверждение отслеживается.
Уведомления направляют пользователя к деталям операции и подходящему шагу безопасности. Конфиденциальные данные, такие как полный закрытый ключ, секрет passkey или права восстановления, не запрашиваются в уведомлении, сообщении поддержки или электронном письме.
Благодаря такой целостности смарт-кошелёк eBattery уменьшает технические детали, но сохраняет видимыми экономические обязанности и обязанности по безопасности. Различая доступ к приложению, право на инвестиции, подпись транзакций и полномочия по восстановлению аккаунта, пользователь может управлять сервисами Web3 в едином интерфейсе.
