> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciar Posições

> Revise e gerencie posições de liquidez, faixas, alocação e taxas com checagens de execução on-chain e gates de política institucional.

A página Posições é o espaço operacional para **posições de liquidez por faixa** criadas via Invest. Ela
consolida a faixa, valor, alocação e acúmulo de taxas de cada posição, e oferece ações de ciclo de vida como
ajustar liquidez e coletar taxas.

***

## O que usuários finais podem fazer

* Revisar todas as posições por pool e rede.
* Abrir uma posição para inspecionar status de faixa, preço atual e alocação.
* Adicionar ou remover liquidez de uma posição existente.
* Coletar taxas de LP acumuladas quando disponíveis.
* Usar identificadores de posição e hashes de transação para reconciliação.

***

## Lista de posições

A lista de Posições resume todas as posições visíveis para a conta selecionada.

Cada card de posição normalmente inclui:

* **Mercado + rede:** O par do pool (`Token0 / Token1`) e a chain onde a posição está mantida.
* **ID da posição:** Um identificador estável usado para investigação e suporte.
* **Status de faixa:** Um estado visível **In Range** quando o preço do pool está dentro da banda selecionada.
* **Valor da posição:** Uma valoração indicativa na moeda de exibição do venue.
* **Ganhos:** Taxas não coletadas estimadas quando disponíveis.
* **Limites da faixa:** Rótulos de preço Mín e Máx para a banda da posição.
* **Ação Gerenciar:** Abre a visão detalhada da posição para ações de ciclo de vida.

***

## Visão detalhada da posição

Selecionar **Gerenciar** abre uma visão detalhada da faixa, alocação e status de taxas da posição.

### Cabeçalho e gráfico de faixa

O cabeçalho e a área do gráfico normalmente mostram:

* **Par, chain e ID da posição** para identificação precisa.
* **Badges de status de faixa** como **In Range** e **Full Range**.
* **Visualização de preço** com marcadores para preço atual, Preço Mín e Preço Máx.
* **Controles de janela de tempo** (por exemplo, 1D, 7D, 1M, 1Y, ALL) que ajustam a janela visível do gráfico.
* **Leituras de preço Mín/Máx/mercado** para o período selecionado.

### Painel de resumo da posição

O painel à direita normalmente inclui:

* **Valor da posição** na moeda de exibição do venue.
* **Alocação** com montantes por token e uma barra de divisão proporcional.
* Ações **Add Liquidity** e **Remove Liquidity**.
* **Fees Earned** com valor disponível e detalhamento por token.
* **Collect Fees** para reivindicar taxas de LP acumuladas.
* **Collected History** para históricos de coletas de taxa quando presentes.

***

## Status e comportamento de taxas

* Uma posição está **ativa** quando o preço do pool está dentro da faixa selecionada.
* **Taxas de LP acumulam** apenas enquanto a posição está ativa e swaps executam dentro da faixa.
* Se o pool usa **taxas de LP dinâmicas**, a taxa efetiva pode variar conforme a lógica configurada do pool, para proteger o provedor de liquidez contra perdas impermanentes.
* Veja mais informações e como taxas dinâmicas são calculadas em: [Taxas Dinâmicas](/pt/architecture#integridade-de-precos-guiada-por-oraculos-e-taxas-dinamicas)

<Note>
  Valores exibidos na interface são indicativos. O registro autoritativo de propriedade, liquidez e taxas é o estado
  on-chain e os recibos de transação.
</Note>

***

## Gerenciar uma posição

<Steps>
  <Step title="Abra a posição">
    Vá para **Posições**, localize o card alvo e selecione **Gerenciar**. Confirme o par, a chain e o ID da posição.
  </Step>

  <Step title="Revise faixa e alocação">
    Verifique o preço Mín/Máx, o preço de mercado atual e se a posição está **In Range**. Revise a alocação de tokens
    e o valor da posição.
  </Step>

  <Step title="Adicione ou remova liquidez">
    Use **Add Liquidity** ou **Remove Liquidity** e insira os valores pretendidos. Tokens ERC-20 exigem aprovações antes
    da execução, e a carteira deve estar conectada na chain do pool.
  </Step>

  <Step title="Colete taxas">
    Quando **Fees Earned** mostrar um valor disponível, selecione **Collect Fees** para reivindicar as taxas de LP acumuladas da posição.
  </Step>

  <Step title="Confirme o recibo on-chain">
    Confirme a transação na sua carteira e retenha o hash da transação para reconciliação e fluxos de auditoria.
  </Step>
</Steps>

***

## Pré-requisitos de execução e gates de política

Ações de ciclo de vida de liquidez são aplicadas on-chain e podem ser bloqueadas se qualquer condição falhar.

* **Conexão de carteira e alinhamento de chain:** ações executam apenas na rede do pool.
* **Checagens de permissão:** permissões de liquidez, papéis exigidos pelo pool e gates de política institucional são aplicados no momento da execução.
* **Verificação de propriedade:** modificações da posição verificam o proprietário autorizado do token da posição.
* **Controles de pausa:** estados de pausa global ou por pool interrompem ações de liquidez.
* **Limites e deadlines:** atualizações de liquidez validam valores mínimos e limites de tempo; falhas revertem.

<Callout type="info" title="Para administradores da instituição">
  Ações de usuários finais nesta página mapeiam para chamadas on-chain de ciclo de vida de liquidez (increase, decrease, collect, close) e são
  rejeitadas quando permissões, papéis ou controles de pausa não permitem execução.
</Callout>

***

## Solução de problemas

<CardGroup cols={2}>
  <Card title="Ação desabilitada" icon="ban">
    Normalmente causado por carteira desconectada, rede errada ou um gate de política que bloqueia ações de liquidez.
  </Card>

  <Card title="Aprovação necessária" icon="key">
    Mudanças de liquidez em ERC-20 exigem aprovações. Muitas implantações usam allowances Token → Permit2 e Permit2 → Position Manager
    antes que a execução possa prosseguir.
  </Card>

  <Card title="Transação revertida" icon="triangle-exclamation">
    Reversões podem resultar de saldo insuficiente, limites inválidos (deadlines ou valores mínimos) ou checagens de política on-chain
    falhando no momento da execução.
  </Card>

  <Card title="Taxas não acumulando" icon="percent">
    Taxas de LP acumulam apenas quando a posição está in-range e swaps executam. Posições fora da faixa ou baixa atividade podem mostrar
    zero taxas.
  </Card>
</CardGroup>

<Card title="Rede incompatível" icon="link">
  Ações de liquidez executam apenas na chain do pool. Troque a carteira para a rede do pool e tente novamente.
</Card>

***

## Propriedade e auditabilidade

* Posições de liquidez são representadas on-chain como **tokens ERC-721 intransferíveis (soulbound)** vinculados ao
  proprietário verificado.
* Estado da posição, atualizações de liquidez e reivindicações de taxas são registrados como eventos on-chain que podem ser reconciliados por
  hash de transação.
