NFT de posição Uniswap v3: confira os ativos por trás dele

Um NFT de posição direta Uniswap v3 representa a propriedade de uma posição de liquidez, não um colecionável com saldo fixo de tokens. Para entender o que você possui agora, confira os ativos dentro da posição e suas taxas não coletadas. A presença na carteira, a imagem ou o preço mínimo de um NFT não estabelecem esse valor.

Comece pela rede, pelo contrato do gerenciador de posições e pelo ID do token NFT. Depois consulte as quantidades atuais, o estado da faixa e as taxas não coletadas, e conte a posição uma única vez. Se a identidade ou algum valor não estiver resolvido, marque como não verificado em vez de adivinhar um valor.

Este guia serve para inspecionar uma posição direta v3 existente. Ele não pede retirada de liquidez, transferência do NFT nem escolha de um pool. Uma posição mantida em um cofre (vault) ou outro contrato de custódia também exige os registros desse serviço.

Por que seu depósito aparece como NFT

A explicação de propriedade do Uniswap distingue tokens de liquidez UNI-V2 dos NFTs usados nas posições v3. Em v3, a posição tem seu próprio par de tokens e uma faixa de preços escolhida. O NFT identifica essa posição; os ativos depositados pertencem à posição do pool e não continuam como os mesmos saldos disponíveis para gastar na carteira.

Uma linha de NFT e uma linha de posição do protocolo podem, portanto, descrever o mesmo ativo. Elas não são automaticamente dois ativos para somar. Da mesma forma, a ausência de uma linha de NFT no painel não prova que a posição desapareceu. O painel pode não reconhecer o contrato, a rede ou o proprietário.

A interface normal do Uniswap também pode deixar um NFT depois da retirada de liquidez. Uma miniatura conhecida não prova que ainda há capital. Verifique o registro atual antes de atribuir um valor.

Identifique a posição antes de consultar o valor

Comece pelo seu próprio registro do aporte de liquidez, como uma transação que você já conhece. Evite links fornecidos por NFT inesperado, mensagem privada ou descrição de token. Inspecione os registros públicos da blockchain sem informar frase de recuperação nem chave privada.

Anote estes identificadores antes de comparar saldos:

Conferência	O que anotar
Rede	A rede em que a liquidez foi adicionada
Contrato da posição	O gerenciador de posições v3 implantado nessa rede
ID da posição	O ID do token NFT junto com seu contrato
Detentor atual	O proprietário indicado pelo registro atual do contrato
Ativos	Os endereços dos contratos dos dois tokens

Um ID de token sozinho não é globalmente único. Nem o mesmo endereço de carteira em outra rede nem um nome de NFT igual identificam essa posição. Compare o endereço do gerenciador com as informações oficiais de implantação v3 do protocolo nessa rede. Se a transação conhecida aponta um vault ou contrato de staking como detentor, pare de tratar a lista de NFTs da carteira como registro completo de propriedade. Consulte o serviço que mantém a posição e seu direito sobre ela.

Esta é uma checagem de identidade, não uma recomendação para conectar a carteira. Se uma interface exige conexão para mostrar sua posição, confirme primeiro o site oficial e entenda a solicitação. Ler registros não exige assinar uma transferência nem conceder nova permissão de gasto.

Leia quantidades, faixa e taxas separadamente

A documentação dos detalhes da posição separa os valores mantidos na posição das taxas não coletadas e dos limites de preço escolhidos. Use esses campos como registros distintos:

1. Confira a quantidade atual de cada token subjacente. Verifique os endereços dos tokens em vez de confiar apenas no símbolo.
2. Anote a faixa escolhida e o preço atual do pool. Indique se a liquidez está ativa.
3. Anote as taxas não coletadas em cada token. Não suponha que já estejam incluídas no valor principal da posição.
4. Anote quando leu os números e se há cotação em moeda fiduciária. Preço ausente continua desconhecido; não é saldo zero.

Em uma posição direta v3, a composição muda conforme o preço percorre a faixa. Fora dela, a posição contém só um token e deixa de gerar taxas de swap até o preço voltar à faixa. Isso não significa necessariamente uma retirada. A visão geral de liquidez do Uniswap também explica que as taxas acumuladas são coletadas separadamente, em vez de reinvestidas automaticamente nas posições comuns. Um vault gerenciado pode funcionar de outro modo; não aplique esta contabilidade sem mudanças a uma participação em vault.

As quantidades atuais podem diferir do depósito original. Ao conciliar duas ferramentas, compare registros atuais, não a posição atual do pool com um recibo antigo de depósito. Esta inspeção não calcula lucro, prejuízo nem se fornecer liquidez foi um bom investimento.

Conte a posição uma única vez

Suponha, em um exemplo contábil hipotético, que um protocolo mostre $400 como valor atual dos ativos na posição e $7 de taxas não coletadas. Se os $400 excluem explicitamente essas taxas, o total nessa cotação e nesse momento é $407. Se um painel já inclui as taxas no total exibido, somar as mesmas taxas novamente inflaria o resultado.

Da mesma forma, somar uma posição de $400 e sua representação NFT de $400 produz $800 incorretos antes das taxas. Primeiro determine o que cada linha inclui. Mantenha o ID da posição ao lado do lançamento contábil para vincular o NFT e os detalhes do protocolo a um único ativo.

Separe os tokens já devolvidos à carteira dos valores ainda na posição. Depois de uma retirada ou coleta de taxas, atualize ambos os registros antes de conciliá-los. Uma página desatualizada do protocolo pode continuar mostrando um valor já transferido para a carteira. Nenhuma transação é realizada neste exemplo.

O que um rastreador de portfólio pode confirmar

O código da versão do Owlio 1.1.0 informa que as faixas de liquidez v3 não são lidas. Sua visão DeFi baseada em tokens não reconstrói uma posição Uniswap. Instalar o rastreador não faz a faixa, as quantidades subjacentes ou as taxas ausentes aparecerem como uma avaliação completa de liquidez.

Use o acompanhamento de endereços públicos para os ativos de carteira suportados e mantenha a posição verificada do protocolo ao lado. Se os totais diferirem, o guia de conciliação de saldos ajuda a distinguir falta de cobertura de dados desatualizados. Nem uma lista de NFTs nem uma fonte de dados aparentemente saudável elimina uma lacuna de cobertura.

A inspeção está concluída quando rede, contrato, ID do token e detentor correspondem à posição que você pretendia conferir, e você tem quantidades atuais, estado da faixa e registros separados de taxas. Se algum campo não estiver resolvido, marque essa parte como não verificada. Mudar a liquidez ou a custódia é uma decisão separada com suas próprias verificações de transação.