Funcionamento dos protocolos
Cotas de cofres: por que o saldo não é o valor disponível para saque
Em poucas palavras
As cotas de um cofre, a estimativa dos ativos subjacentes que elas representam e a quantidade que pode ser resgatada agora são medidas diferentes. No padrão ERC-4626, a prévia de resgate inclui as taxas de saque, mas não verifica os limites de resgate. Consulte a implementação do cofre: nem uma estimativa de conversão nem um nome de método conhecido garantem que toda a posição possa ser retirada agora.
Nesta página
Um saldo de 100 tokens em um cofre não significa necessariamente 100 unidades do ativo subjacente. Ele pode contar cotas de um conjunto de ativos. Mesmo uma estimativa separada em ativos não determina quanto você pode sacar agora. Leia separadamente os números de propriedade, conversão e acesso.
Identifique o que cada número mede
A especificação ERC-4626 define uma interface de cofre para um único ativo subjacente ERC-20. Seus tokens de cotas representam um direito sobre os ativos mantidos pelo cofre. O método balanceOf do cofre informa cotas; asset identifica o token subjacente.
Três outras funções de consulta respondem a perguntas diferentes:
| Consulta | Unidade | O que descreve |
|---|---|---|
| convertToAssets | Ativos subjacentes | Conversão idealizada de uma quantidade informada de cotas, sem taxas nem condições de execução |
| previewRedeem | Ativos subjacentes | Prévia de resgate que incorpora taxas de saque, sem verificar limites de resgate |
| maxRedeem | Cotas | Limite de resgate para o titular especificado, conforme o padrão; pode subestimar a quantidade aceita |
Portanto, uma prévia não é uma autorização para resgatar essa quantidade. Esses são os significados da interface padrão, não evidência de que todo produto chamado cofre os implemente da mesma forma.
Examine um cenário fictício em um único instante
Suponha que você possua 100 cotas de um cofre fictício. Apenas para esta ilustração, cada cota é convertida em 1,20 unidade do ativo subjacente, e uma restrição atual permite resgatar 40 cotas. Considere ausência de taxas e de efeitos de arredondamento, estado inalterado e todos os demais requisitos atendidos. São dados inventados, não uma cotação em tempo real, uma configuração da Morpho nem um cálculo de uma implementação da OpenZeppelin.
| Pergunta | Cálculo | Resultado hipotético |
|---|---|---|
| O que a posição inteira representa pela taxa de conversão assumida? | 100 × 1,20 | 120 unidades de ativo |
| O que a parcela permitida representa? | 40 × 1,20 | 48 unidades de ativo |
| Quantas cotas restam após esse resgate? | 100 − 40 | 60 cotas |
Uma estimativa de 120 unidades de ativo e 48 unidades para a parcela permitida podem coexistir sem erro de cálculo. A diferença decorre da restrição de acesso assumida. As 60 cotas restantes não são outro saque já concluído.
A taxa de conversão de 1,20 não comprova um retorno de 20%: não informamos o custo de aquisição nem uma taxa anterior. O exemplo também não promete que as cotas restantes poderão ser resgatadas depois.
Uma razão não é um certificado de segurança
O guia de implementação da OpenZeppelin explica a conversão de cotas, o arredondamento, a personalização de taxas e os ativos e cotas virtuais. Esses detalhes mostram por que uma razão calculada manualmente, dividindo ativos por cotas, não deve substituir o método de conversão da implementação usada.
Um cofre pode perder ativos; uma quantidade estável de cotas não garante um valor subjacente estável. Uma estimativa de conversão maior também não comprova que existam ativos líquidos prontos para saque imediato. O comportamento do contrato e a liquidez disponível precisam ser examinados separadamente. Este artigo não apresenta previsão de rendimento nem avaliação da segurança de um cofre específico.
Confira as exceções da implementação antes de agir
Há um motivo concreto para ler a documentação atual do produto. O guia do Morpho Vault V2 informa que suas funções max sempre retornam zero e apresenta um procedimento separado para calcular a capacidade. Ele identifica a liquidez disponível para saque e as verificações de permissão como restrições relevantes.
Esse é um comportamento documentado específico do Morpho V2, não uma afirmação de que todos os cofres ERC-4626 retornam zero. Da mesma forma, um zero retornado por essa implementação, por si só, não comprova que todas as formas de saída sejam impossíveis.
Para uma posição existente, registre a rede, o cofre e o ativo subjacente, o saldo de cotas, o horário da observação, o método de conversão ou de prévia, as taxas e as restrições de saque da implementação. Confirme o caminho exato na documentação oficial; não o deduza pelo símbolo do token ou pelo total da carteira. Nossa análise de pontes explica como verificar representações de tokens; permissões de carteiras aborda uma questão separada de autorização.
Nota editorial: A CoinFom preparou esta explicação com pesquisa, redação, tradução e revisão auxiliadas por IA. Fontes consultadas em 21 de outubro de 2026. Nenhuma carteira foi conectada e nenhuma transação foi realizada. Conteúdo educativo, não uma recomendação para depositar ou resgatar. A CoinFom pode receber comissões por indicação em outras partes do site; este artigo não contém link de cadastro. Veja Sobre, política editorial e correções.