Начните с точного BagID и желаемого результата: бесплатная копия на платформе, хранение у платных провайдеров, привязка DNS, пополнение, остановка провайдера или вывод средств.
Чтение текущего состояния
Используйте storage.bag_details и при необходимости storage.providers. Проверьте размер, полноту, текущий набор провайдеров и состояние контракта. Телеметрия поиска и оценочные цены носят справочный характер.
В процессе финансирования сохраняйте возвращённые входные данные сессии или снимка состояния. storage.provider_funding_session, storage.provider_funding_preview и storage.provider_quote предназначены для разных этапов; не считайте оценку подписанной суммой транзакции.
Подготовка платежа
Используйте текущее предложение и точные аргументы, требуемые storage.send_provider_tx. Целевая длительность, допускающая null, может означать минимальное финансирование активации; не придумывайте срок, которого пользователь не запрашивал.
Покрытие при пополнении — это целевой оставшийся срок. Например, 30 дней — это 2 592 000 секунд оставшегося покрытия, а не автоматически 30 дополнительных дней сверх существующего баланса контракта.
Если сервис сообщает, что финансирование не изменилось или требуется свежее предложение, следуйте этому результату, а не навязывайте ещё один платёж.
Отслеживание операции
Сохраните возвращённый providerOperationId и используйте storage.provider_operation для этого процесса работы с провайдером. Общий ID операции транзакции MCP — другой идентификатор.
Используйте руководство по прогрессу провайдера, чтобы проверить, когда файлы сохранены.
Остановка или вывод
Остановка выбирает управляемого провайдера. Отсутствие выбора однозначно только при наличии ровно одного подходящего управляемого провайдера. Не трактуйте это как остановку всех. Для провайдеров, настроенных вне приложения, может потребоваться другой способ управления.
Выводите средства только когда в контракте не осталось провайдеров и пользователь запросил вывод. Удаление ссылки на бесплатный Bag платформы не разрешает ни остановку провайдеров, ни вывод средств.
Точные параметры см. в разделах платные провайдеры и схемы инструментов.