00swapадмин
1Click / NEAR Intents

История и Explorer API

Официальная страница: Explorer API

Два способа смотреть историю#

  1. Статус конкретного свопа — GET /v0/status?depositAddress=... на основном API (https://1click.chaindefuser.com). Подходит, когда у вас на руках депозитный адрес из котировки. Шаблон есть в песочнице.
  2. Историческая выборка транзакций — отдельный сервис Explorer API по адресу https://explorer.near-intents.org. Это программный доступ к истории свопов 1Click: фильтры, пагинация, выгрузки.

Explorer API#

Explorer использует отдельный ключ (не тот же Partner JWT, что для свопов) — детали получения описаны в официальной документации по ссылке выше.

Через прокси портала Explorer API сейчас не подключён: в allowlist прокси входят только эндпоинты основного API. Если понадобится регулярно выгружать историю — это отдельная небольшая доработка (второй прокси-маршрут app/api/proxy/explorer/... с собственным allowlist и переменной окружения для ключа Explorer).

Веб-интерфейс#

Для разовых проверок удобен публичный обозреватель NEAR Intents: explorer.near-intents.org — в нём можно найти своп по хешу транзакции или адресу и посмотреть его путь.

Типичный сценарий админа#

  1. Пользователь жалуется: «отправил, ничего не пришло».
  2. Узнайте у него хеш транзакции депозита или депозитный адрес.
  3. Проверьте GET /v0/status?depositAddress=... в песочнице — статус скажет, на каком этапе своп (ждёт депозит, обрабатывается, завершён, возвращён).
  4. Если статус REFUNDED — средства ушли на refundTo из котировки.
  5. Если непонятно — ищите транзакцию в explorer и сверяйтесь с разделом «Проблемы и FAQ».