Tokens LP Uniswap v2: confira os ativos por trás do saldo

Um saldo de tokens LP Uniswap v2 descreve uma participação em um pool específico, não uma quantidade de qualquer um dos dois tokens dentro dele. Para um retrato contábil somente de leitura, divida seu saldo LP pela oferta total de LP do par e aplique essa fração a cada reserva registrada. Associe cada reserva ao endereço do token e à sua escala decimal.

Isso permite descrever uma posição existente. Não é um valor de saque garantido, um cálculo de lucro ou uma instrução para remover liquidez. Uma linha da carteira identificada como UNI-V2 é apenas um ponto de partida: muitos pares diferentes usam essa identificação.

Encontre o par antes de interpretar seu saldo LP

A explicação dos pools v2 da Uniswap descreve os tokens de liquidez emitidos para provedores. A implementação oficial do token LP usa o mesmo nome e símbolo em diferentes pares. Portanto, o símbolo sozinho não identifica quais ativos uma posição representa.

Comece pela rede e pelo endereço completo do contrato do par, obtidos de uma transação de liquidez conhecida ou da interface do protocolo em que você já confia. Confirme a factory na lista oficial de implantações v2 e confira se os tokens desejados correspondem ao par dessa factory. Um nome copiado ou um contrato que exponha métodos conhecidos não comprova uma implantação oficial.

Nessa implementação v2, o contrato do par também é o contrato do token LP. Leia seus endereços token0() e token1() antes de usar os números das reservas. reserve0 pertence a token0; reserve1 pertence a token1. Não atribua as duas quantidades pela ordem dos símbolos em outra tela.

Restrinja este procedimento a pares comuns da Uniswap v2. Um fork, um cofre gerenciado ou uma posição concentrada pode usar outra contabilidade. Um NFT de posição Uniswap v3 precisa do próprio registro da posição em vez desse cálculo pela oferta de LP.

Reúna um conjunto consistente de quantidades

Para uma posição LP mantida diretamente, obtenha estas leituras dos contratos verificados do par e dos tokens:

Leitura ou campo	Significado	Unidade a preservar
balanceOf(account) do par	Tokens LP mantidos por esta conta	Unidades LP
totalSupply() do par	Todos os tokens LP emitidos	As mesmas unidades LP
getReserves() do par	Reservas registradas de cada lado	Inteiros brutos dos tokens
token0() e token1() do par	Endereços dos dois ativos	Endereços completos
Decimais de cada token	Escala de sua reserva bruta	Sua própria escala

Prefira um bloco comum para todas as leituras. Se a ferramenta oferecer apenas chamadas separadas ao estado mais recente, salve os horários e marque a comparação como potencialmente inconsistente. Uma negociação, um depósito ou um saque entre chamadas pode alterar os dados de entrada.

O saldo LP e a oferta total devem usar a mesma escala. Dividir dois inteiros LP brutos é válido para obter a fração, assim como dividir duas quantidades LP corretamente formatadas. Misturar um inteiro bruto com um número formatado não é válido. Para as reservas, use os decimais de cada token subjacente de forma independente; o guia de casas decimais dos tokens explica essa conversão. Metadados desconhecidos ficam sem resolução, em vez de assumir 18 por padrão.

Não subtraia tokens LP bloqueados ou inacessíveis da oferta total informada para aumentar sua porcentagem. Este cálculo usa a oferta emitida do contrato, não uma oferta circulante presumida. Se a oferta for zero ou uma leitura essencial falhar, interrompa o cálculo e registre o dado ausente.

Calcule um retrato com unidades identificadas

Considere um par hipotético cujos números já estão formatados em unidades legíveis. Ele tem 500 tokens LP emitidos, e sua conta mantém diretamente 5 tokens LP. As reservas registradas são 80 unidades do token A e 24000 unidades do token B. São quantidades inventadas, não um pool ao vivo nem uma cotação de preço.

A fração LP é 5 / 500 = 0.01, ou 1%. Aplicada às reservas registradas, resulta em:

• Token A: 80 * 0.01 = 0.8 unidade.
• Token B: 24000 * 0.01 = 240 unidades.

O registro resultante é uma posição LP com um equivalente baseado nas reservas de 0,8 A e 240 B naquele instante. Não são 5 A mais 5 B, e as quantidades de reserva não são preços em dólares. Não é necessário supor que B seja uma stablecoin.

Não some o valor exibido do token LP com o valor dessas mesmas quantidades subjacentes como duas posições distintas. Tokens mantidos de forma independente fora do pool são outro saldo. Quando um painel já decompõe o token LP em seus ativos subjacentes, determine o que está incluído antes de adicionar algo manualmente.

Isso também difere de medir desempenho. Sua participação atual nas reservas não informa as quantidades depositadas originalmente, os fluxos posteriores, os custos ou quanto valeria simplesmente manter os ativos iniciais. A comparação entre perda impermanente e manter os ativos trata dessa outra questão.

Entenda por que isso não promete um valor de resgate

A implementação do par registra as reservas separadamente dos seus saldos reais de tokens. Seu cálculo de queima usa os saldos e pode emitir tokens LP de taxas do protocolo antes de selecionar a oferta total. A divisão inteira também arredonda os valores calculados. Portanto, uma fração de reservas registradas anteriormente não deve ser apresentada como a quantidade exata que uma transação de remoção de liquidez entregará.

A transação pode ocorrer em um estado diferente daquele observado. Regras de transferência específicas de cada token também podem afetar as quantidades recebidas. Se você decidir separadamente realizar uma transação, use a estimativa atual de remoção e as condições do protocolo; não envie tokens LP diretamente ao par nem chame sua função de queima de baixo nível como parte desta inspeção.

As quantidades de reserva já refletem o estado registrado do pool. Acrescentar uma estimativa extra de receita de taxas pode contar o mesmo valor duas vezes. Este guia não calcula um pagamento de taxas, rendimento futuro nem uma taxa atual do protocolo.

A custódia cria outro limite. Se os tokens LP foram colocados em staking ou depositados em um cofre, o balanceOf direto da carteira pode ser zero enquanto o serviço registra um direito para você. Examine o depósito conhecido e a contabilidade do próprio serviço. Não atribua à sua conta todo o saldo LP do serviço nem reutilize o cálculo simples da carteira para um token de recibo de cofre sem suas regras de conversão.

Salve um registro que possa conferir novamente

Estas etapas se baseiam na documentação pública e no código-fonte examinados em 28 de outubro de 2026. Não foram testadas com uma carteira ou um pool ao vivo para este artigo.

1. Verifique a posição. Registre a rede, o par, a factory, a conta e os endereços dos dois tokens subjacentes por meio de registros confiáveis do protocolo.
2. Determine onde os tokens LP estão. Diferencie a propriedade direta da carteira dos registros de staking, cofre ou outras formas de custódia.
3. Colete um retrato consistente. Salve o saldo LP, a oferta LP emitida, ambas as reservas, sua associação aos tokens e as escalas decimais, com um bloco ou os horários de observação.
4. Calcule apenas com dados utilizáveis. Divida unidades LP equivalentes e depois aplique a fração separadamente às duas reservas. Preserve precisão suficiente; não arredonde a fração para zero antes de multiplicar.
5. Identifique o resultado e concilie uma vez. Marque-o como estimativa contábil baseada em reservas, mantenha as notas de custódia e dados ausentes e confira se outra linha do portfólio já representa a mesma posição.

Estas leituras públicas não exigem assinatura da carteira, autorização de gasto nem frase de recuperação. Um pedido para mover fundos está fora deste procedimento. Você tem um resultado útil quando consegue explicar qual par mantém, o que suas quantidades de reserva representam e por que o retrato difere de uma cotação de saque. Deixe campos não resolvidos como desconhecidos em vez de transformar uma lacuna de exibição em um saldo preciso.