Инструменты транзакций возвращают одноразовую HTTPS-страницу подтверждения. Бэкенд готовит и проверяет запрос; вы просматриваете его и подписываете через свой кошелёк.
Процесс подтверждения
- Агент запрашивает точное поддерживаемое действие.
- Инструмент возвращает
confirmationUrlи сведения об операции. - Откройте этот URL в браузере, проверьте действие и при необходимости подключите нужный кошелёк.
- Выберите Подтвердить в кошельке, затем одобрите или отклоните в обычном интерфейсе кошелька.
- Проверьте результат операции и затронутый ресурс.
Агент должен показать возвращённый URL без изменений. Его секрет находится во фрагменте и не должен попадать в логи или переноситься в другой URL. Намерения обычно истекают через пять минут.
Что доказывает каждый этап
| Этап | Подтверждение |
|---|---|
| Подготовлено | Бэкенд создал запрос; ничего не подписано |
| Ожидает одобрения | Пользователю ещё нужно одобрить или отклонить |
| Отправлено | Наблюдалась отправка кошельком; окончательное состояние может ещё ожидаться |
| Проверенный результат | Соответствующий инструмент чтения операции/ресурса наблюдает ожидаемое состояние |
Истёкшие или неопределённые результаты
Если намерение истекло до отправки, проверьте текущее состояние перед подготовкой нового. Если отправка неоднозначна, не повторяйте транзакцию автоматически. Старое одобрение ещё может исполниться.
Обновление или отзыв доступа MCP может сделать подготовленное подтверждение недействительным. Повторно проверьте нужное действие и ресурс, прежде чем запрашивать новый URL.
Повторное чтение нужного ресурса
Используйте domains.records для своего корневого имени и subdomains.get_item для своего дочернего имени. Для сайтов используйте sites.list_releases и sites.list_domains. Для Storage сохраните идентификатор операции провайдера, возвращённый этим процессом; он не взаимозаменяем с общим ID операции MCP.
Передача NFT
| Актив | Инструмент |
|---|---|
Корневое .ton или .t.me | dns.send_transfer_tx с domain и newOwner |
| Дочерний NFT | subdomains.transfer_item_tx с itemAddress и newOwner |
После передачи инструменты, доступные только владельцу, могут перестать возвращать NFT. Для корневого .ton используйте dns.lookup, чтобы проверить нового владельца. Для имени пользователя или дочернего имени проверьте через кошелёк получателя или подходящий инструмент чтения блокчейна.