Массовый sweep — это серия отдельных действий, а не одна команда «перевести всё». Для каждого source wallet проверь token balance, сеть, доступный native gas, возможную необходимость отдельного разрешения и финальный transfer. Документация Utila описывает конкретный sweep workflow; применяй его только после сверки с актуальной конфигурацией своего продукта (гайд Utila). Не включай автоматическую подпись всех кошельков как универсально безопасную настройку.
Синтетическая схема
Все суммы и роли ниже условные; адресов нет, реальные транзакции не выполнялись. Казначейство хочет собрать условный USDC из трёх source wallets в один treasury. Отдельный sponsor wallet может оплатить gas, если используемый механизм этого требует. Само наличие sponsor не означает, что он может перемещать токены без нужной авторизации.
| Кошелёк | Учебный токен-баланс | Перед действием сверить | Отдельные статусы журнала |
|---|---|---|---|
| Source A | 2 500 USDC | Сеть, token contract, владелец, адрес treasury, gas path | authorization/delegation → transfer → receipt |
| Source B | 700 USDC | Те же поля; проверить, требуется ли отдельная подпись/разрешение | authorization/delegation → transfer → receipt |
| Source C | 0 USDC | Нужен ли sweep вообще; не тратить средства на пустой источник | not-applicable с причиной |
| Sponsor | Баланс газа не указывается | Поддерживает ли процесс оплату газа для нужной сети и операции | funding transaction отдельно от token transfer |
| Treasury | Получатель | Совпадает ли сеть и адрес из утверждённого списка | входящий transfer и фактический token balance |
Имена статусов в следующих таблицах — наш условный журнал, а не точный перечень API Utila. В интеграции нужно хранить исходный статус провайдера отдельно: например, MINED_FAILED у Utila ещё не терминальный FAILED. При загрузке кошельков учитывай пагинацию; исключай замороженные и нулевые остатки, treasury и sponsor из списка источников.
Журнал на одну операцию
Создай уникальный batch_id, а для каждого источника — отдельный item_id. Сохраняй только нужные для операционного контроля поля: сеть, кошельки с безопасной маскировкой, token contract, запрошенную сумму, инициатора и согласующего, время, hash транзакции, provider request ID, статус и ссылку на проверенную запись. Не записывай seed-фразы или приватные ключи.
| Этап | Пример статуса | Критерий перехода |
|---|---|---|
| Подготовка | READY_FOR_REVIEW |
Проверены сеть, токен, получатель, лимит и наличие gas path |
| Разрешение | DELEGATION_CREATED |
Есть отдельный идентификатор/transaction hash разрешения; это ещё не перевод токенов |
| Перевод | TRANSFER_CREATED |
Создан запрос/транзакция transfer; не считать завершённым до подтверждённого результата |
| Завершение | CONFIRMED |
Receipt/провайдер подтверждает операцию и сверка treasury показывает ожидаемое зачисление |
| Ошибка | FAILED или UNKNOWN |
Сохранить код/ID и выяснить финальный on-chain статус до повтора |
Надпись CREATED означает, что действие создано в системе, а не обязательно включено и подтверждено сетью. Если API завершился timeout, сначала запроси исходное действие по request ID/idempotency key или проверь цепочку по hash. Не отправляй новый transfer вслепую: исходный запрос мог исполниться, а ответ потеряться.
Контроль перед запуском
- Утверди отдельный allowlist source wallets, token contracts, сети и treasury receiver.
- Рассчитай количество операций и проверь, какой кошелёк платит gas; не придумывай фиксированную комиссию без актуальных данных сети.
- Пройдите maker-checker согласование; критические поля показывай согласующему отдельно от инициатора.
- Начни с одного условно малого тестового объёма только если это разрешено внутренней процедурой; здесь тест не выполняется.
- Для каждого источника веди authorization/delegation и transfer как разные записи, если обе стадии применяются.
- После завершения сверяй сумму на treasury по token contract и сетью, а не только агрегированный статус интерфейса.
Если баланс заморожен, token contract или chain не совпадает, gas sponsor недоступен, либо конечный статус неясен — останови соответствующую строку batch. Не повторяй транзакцию и не меняй адрес назначения, пока владелец процесса не выяснит состояние исходного действия. Журнал должен объяснить, что уже создано, что подтверждено, и какие остатки требуют отдельного решения.
Если операция требует разрешения токена, отдельно проверь лимиты ERC-20 allowance. Подтверждение разрешения не заменяет сверку самого перевода.
