NFT позиции Uniswap v3: как проверить активы за ним

NFT прямой позиции Uniswap v3 подтверждает владение позицией ликвидности, а не коллекционным предметом с постоянным количеством токенов. Чтобы понять, чем вы владеете сейчас, проверьте активы внутри позиции и несобранные комиссии. Наличие NFT в кошельке, его картинка или минимальная цена NFT не подтверждают эту стоимость.

Начните с сети, контракта менеджера позиций и ID токена NFT. Затем проверьте текущие количества токенов, статус диапазона и несобранные комиссии и учтите актив один раз. Если идентичность или какая-либо сумма не выяснены, отметьте их как непроверенные вместо догадок о стоимости.

Эта инструкция помогает проверить существующую прямую позицию v3. Она не предлагает выводить ликвидность, передавать NFT или выбирать пул. Если позицию держит хранилище (vault) или другой контракт хранения, понадобятся и записи этого сервиса.

Почему ваш вклад отображается как NFT

Объяснение владения от Uniswap различает токены ликвидности UNI-V2 и NFT позиций v3. В v3 у позиции своя пара токенов и выбранный ценовой диапазон. NFT обозначает эту позицию; внесённые активы находятся в позиции пула, а не остаются теми же доступными для расходования остатками кошелька.

Поэтому строка NFT и строка позиции протокола могут описывать один актив. Это не обязательно два актива, которые нужно сложить. И наоборот, отсутствие NFT на панели не доказывает исчезновение позиции. Панель может не распознать её контракт, сеть или владельца.

Обычный интерфейс Uniswap также может оставить NFT после вывода ликвидности. Знакомая миниатюра не доказывает, что основной капитал остался. Прежде чем назначать стоимость, проверьте текущую запись.

Определите позицию до проверки стоимости

Начните с собственной записи о внесении ликвидности, например с известной вам транзакции. Не переходите по ссылке из неожиданного NFT, личного сообщения или описания токена. Проверяйте публичные записи блокчейна без ввода фразы восстановления или приватного ключа.

Запишите идентификаторы до сравнения балансов:

Проверка	Что записать
Сеть	Сеть, в которой внесена ликвидность
Контракт позиции	Развёрнутый менеджер позиций v3 в этой сети
ID позиции	ID токена NFT вместе с его контрактом
Текущий держатель	Владелец из текущей записи контракта
Активы	Адреса контрактов обоих токенов

Сам по себе ID токена не уникален во всех сетях и контрактах. Ни тот же адрес кошелька в другой сети, ни совпадающее название NFT не определяют эту позицию. Сверьте адрес менеджера с официальными сведениями протокола о развёртывании v3 в этой сети. Если известная транзакция указывает держателем vault или контракт стейкинга, перестаньте считать список NFT вашего кошелька полной записью владения. Проверьте сервис, который держит позицию, и ваше право требования к нему.

Это проверка идентичности, а не рекомендация подключать кошелёк. Если интерфейс требует подключения для показа позиции, сначала подтвердите официальный сайт и разберитесь в запросе. Чтение записей не требует подписи перевода или нового разрешения на расходование.

Отдельно проверьте количества, диапазон и комиссии

Документация экрана позиции разделяет количества активов в позиции, несобранные комиссии и выбранные ценовые границы. Записывайте эти поля отдельно:

1. Проверьте текущее количество каждого токена внутри позиции. Сверяйте адреса токенов, а не только тикер.
2. Запишите выбранный диапазон и текущую цену пула. Отметьте, активна ли ликвидность.
3. Запишите несобранные комиссии в каждом токене. Не считайте, что они уже входят в основную стоимость позиции.
4. Запишите время проверки цифр и наличие котировки в обычной валюте. Неизвестная цена остаётся неизвестной, а не нулевым балансом.

Состав прямой позиции v3 меняется при движении цены через диапазон. Вне него позиция содержит один токен и перестаёт зарабатывать комиссии обмена до возвращения цены в диапазон. Это не обязательно означает вывод. Обзор ликвидности Uniswap также объясняет, что накопленные комиссии собирают отдельно: они не добавляются автоматически к обычным позициям для дальнейшего начисления. Управляемый vault может работать иначе, поэтому не переносите этот учёт без изменений на его долю.

Текущие количества могут отличаться от первоначального вклада. При сверке двух инструментов сравнивайте текущие записи, а не нынешнюю позицию пула со старой квитанцией вклада. Эта проверка не рассчитывает прибыль, убыток или выгодность предоставления ликвидности.

Учитывайте позицию один раз

Допустим, в условном примере учёта протокол показывает $400 как текущую стоимость активов в позиции и $7 несобранных комиссий. Если $400 явно не включают эти комиссии, общий итог при этой котировке и на этот момент равен $407. Если панель уже включает комиссии в показанный итог, повторное добавление тех же комиссий завысит его.

Аналогично, сумма позиции на $400 и её NFT-представления на $400 даёт ошибочные $800 до комиссий. Сначала выясните состав каждой строки. Держите ID позиции рядом с записью учёта, чтобы связать NFT и данные протокола с одним активом.

Отделяйте токены, уже возвращённые в кошелёк, от сумм внутри позиции. После вывода или сбора комиссий обновите обе записи перед сверкой. Устаревшая страница протокола может показывать сумму, уже перемещённую в кошелёк. В этом примере транзакции не выполняются.

Что подтверждает трекер портфеля

В коде релиза Owlio 1.1.0 указано, что диапазоны ликвидности v3 не считываются. Его представление DeFi по токенам не восстанавливает позицию Uniswap. Установка трекера не превращает отсутствующие диапазон, количества активов и комиссии в полную оценку ликвидности.

Используйте отслеживание публичных адресов для поддерживаемых активов кошелька и держите рядом проверенную позицию протокола. Если итоги расходятся, инструкция по сверке баланса помогает отличить отсутствие поддержки от устаревших данных. Ни список NFT, ни внешне исправный источник данных не закрывают пробел в охвате.

Проверка завершена, когда сеть, контракт, ID токена и держатель соответствуют нужной позиции, а у вас есть текущие количества активов, статус диапазона и отдельные записи комиссий. Нерешённое поле отметьте как непроверенное. Изменение ликвидности или способа хранения - отдельное решение со своими проверками транзакции.