Кальтер / Блог

Sweep токенов из treasury-кошельков: газ, статусы и журнал

Учебная схема трёх source wallets, одного sponsor и treasury: проверка gas, delegation и transfer отдельно.

Материал подготовлен с помощью ИИ; источники проверены редакцией ZASLON. Все цифры и сценарии, если не указано иное, учебные и не описывают клиентский результат или реальную операцию.

Сбор токенов в treasury
Редакционная схема: Сбор токенов в treasury. Условные обозначения; не реальные данные, результат теста или клиента.

Массовый 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 вслепую: исходный запрос мог исполниться, а ответ потеряться.

Контроль перед запуском

  1. Утверди отдельный allowlist source wallets, token contracts, сети и treasury receiver.
  2. Рассчитай количество операций и проверь, какой кошелёк платит gas; не придумывай фиксированную комиссию без актуальных данных сети.
  3. Пройдите maker-checker согласование; критические поля показывай согласующему отдельно от инициатора.
  4. Начни с одного условно малого тестового объёма только если это разрешено внутренней процедурой; здесь тест не выполняется.
  5. Для каждого источника веди authorization/delegation и transfer как разные записи, если обе стадии применяются.
  6. После завершения сверяй сумму на treasury по token contract и сетью, а не только агрегированный статус интерфейса.

Если баланс заморожен, token contract или chain не совпадает, gas sponsor недоступен, либо конечный статус неясен — останови соответствующую строку batch. Не повторяй транзакцию и не меняй адрес назначения, пока владелец процесса не выяснит состояние исходного действия. Журнал должен объяснить, что уже создано, что подтверждено, и какие остатки требуют отдельного решения.

Если операция требует разрешения токена, отдельно проверь лимиты ERC-20 allowance. Подтверждение разрешения не заменяет сверку самого перевода.