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

> ## Agent Instructions
> Pages whose paths begin with /zh-Hans/, /ja/, /ko/, /vi/, /id/, /hi/, /pt-BR/ or /es/ are machine translations of the English pages, provided for convenience only. They may contain errors or omissions and have no legal effect, and where one differs from the English page, the English page prevails. For anything that will be relied on, read and cite the English page at the same path without the language prefix.

# Verificação formal

> 87 propriedades de segurança dos contratos da Tori são provadas por execução simbólica a cada alteração no código. O que está provado, dentro de quais limites, o que não está e o que o trabalho encontrou.

Uma auditoria é uma revisão feita em um momento específico. A verificação formal é um tipo diferente de checagem: uma
propriedade do código, como "só o minter pode aumentar a oferta de trUSD", é enunciada com precisão e, em seguida, uma
ferramenta procura qualquer entrada que a viole. Se nenhuma existir dentro dos limites estabelecidos, a propriedade
está provada. Isso é mais forte do que um teste, que experimenta as entradas em que alguém pensou, e mais forte do que
o fuzzing, que experimenta muitas entradas aleatórias.

Os contratos da Tori têm 87 propriedades desse tipo. Elas são verificadas com o
[Halmos](https://github.com/a16z/halmos), uma ferramenta de execução simbólica para Solidity, e voltam a ser executadas
a cada alteração nos contratos. As propriedades e o workflow que as executa são públicos no
[repositório dos contratos](https://github.com/Tori-Finance/tori-contracts/tree/main/test/halmos).

## O que está coberto

| Contratos | Propriedades | Do que tratam |
| - | - | - |
| trUSD | 11 | Quem pode fazer mint, quem pode movimentar um saldo, quem pode fazer upgrade |
| Vault strUSD | 21 | Os limites da carência, a blacklist, a liberação gradual (vesting) das recompensas, o limite diário de perdas, o controle de acesso, a oferta mínima de cotas |
| Mint e resgate | 19 | Limites por bloco, assinaturas de ordens, nonces, destinatários, o roteamento para custódia, o desligamento de emergência |
| Timelock | 10 | O prazo de espera e seus limites, a divisão de papéis, quem pode enfileirar, cancelar e executar |
| PendleYTLock | 13 | Saques pausados, o lastro do principal e do rendimento, o modo sem rendimento, o controle de acesso |
| Silo e distribuidor de recompensas | 7 | Quem pode movimentar fundos, a cobertura das solicitações de unstake em aberto |
| strUSD via bridge | 6 | O controle da oferta e a blacklist no token transferido por bridge |

## Exemplos do que está provado

Cada linha abaixo vale para qualquer chamador e qualquer argumento, dentro dos limites descritos na próxima seção.

**trUSD**

* Ninguém além do minter pode aumentar a oferta total.
* Um saldo só diminui por uma chamada do próprio detentor ou de um endereço que o detentor aprovou.
* Só o timelock pode fazer upgrade do contrato. O admin não pode assumir o papel do timelock nem alterar o minter.

**strUSD**

* Uma recompensa não altera o preço da cota no bloco em que chega, por isso não pode ser capturada por quem deposita logo antes dela.
* A carência nunca pode ser definida acima de 90 dias, e nenhuma solicitação de unstake pode terminar mais de 90 dias à frente.
* Uma solicitação de unstake não pode ser resgatada antes do fim da sua carência.
* O silo sempre mantém pelo menos a soma de todas as solicitações de unstake em aberto.
* Um endereço na blacklist não pode enviar nem receber cotas.
* Um relato de perda acima de 5% dos ativos do vault é recusado, assim como um segundo relato dentro de 24 horas.

**Mint e resgate**

* Dois mints no mesmo bloco nunca excedem o limite global nem o limite por ativo. O mesmo vale para os resgates.
* Uma ordem só é executada com a assinatura do remetente sobre exatamente aquela ordem. Alterar qualquer campo, ou a rede, altera o que precisa ser assinado.
* Um nonce já usado nunca pode ser usado de novo.
* O trUSD e a garantia vão apenas para o remetente ou para um destinatário que o remetente aprovou on-chain. A garantia de um mint vai apenas para custodiantes registrados.
* Depois que o Controlador de Acesso aciona o desligamento de emergência, nenhum mint ou resgate é bem-sucedido. O Controlador de Acesso pode retirar poderes e nunca concedê-los.

**Timelock**

* Nenhuma operação é executada antes de decorrido o prazo de espera desde que foi enfileirada.
* O prazo de espera sempre fica entre 1 e 30 dias, seja qual for a operação que a governança execute.
* Um custodiante só pode ser incluído no mint por uma operação que aguardou todo o prazo de espera.

**PendleYTLock**

* Enquanto os saques estiverem pausados, ninguém pode sacar nem resgatar.
* O YT bloqueado sempre cobre o total de ativos do lock.
* Um lock configurado sem distribuição de rendimento não pode tê-la ativada depois, e toda função de rendimento é revertida nele.

**Tokens via bridge**

* Só um minter autorizado, que é o pool de token da bridge, pode aumentar a oferta de strUSD via bridge, e nunca acima da sua oferta máxima.
* Um saldo na blacklist em uma rede de destino da bridge só pode ser movimentado pelo proprietário.

## Como ler "provado"

Uma prova vale dentro de limites, e os limites importam tanto quanto o resultado.

| Limite | O que significa |
| - | - |
| Uma chamada por propriedade | Cada propriedade é verificada para qualquer chamada isolada. Sequências são cobertas onde importam: dois mints em um bloco, enfileirar e depois executar, depositar e depois fazer o harvest. |
| Listas de até dois elementos | Funções em lote são cobertas para zero, uma ou duas entradas. Os loops são percorridos três vezes. |
| Assinaturas | A ferramenta não consegue raciocinar sobre assinaturas de curva elíptica. As propriedades provam que uma ordem precisa da assinatura do remetente sobre exatamente o seu próprio hash, e que o hash cobre todos os campos. Que uma assinatura não pode ser forjada é a premissa padrão do ECDSA. |
| Aritmética | Multiplicar e dividir dois números desconhecidos de 256 bits está além da capacidade dos solvers. Quando uma propriedade depende desse tipo de aritmética, um dos lados vem de um conjunto fixo de valores, e a propriedade é marcada como limitada. |
| Preços de mint | As propriedades de ordens são provadas para ordens com preço na paridade. Limites, nonces, assinaturas e destinatários não dependem do preço. |

Das 87 propriedades, a maioria vale para todas as entradas dentro dos três primeiros limites. As demais têm um limite
adicional do tipo descrito nas duas últimas linhas.

## O que não está provado

A verificação formal não substitui as outras camadas. Estas propriedades estão hoje fora da suíte e são cobertas, em
vez disso, por testes de invariantes e de fuzz:

* O arredondamento no vault strUSD: que as conversões arredondam a favor do vault e que um depósito seguido de um resgate nunca gera lucro.
* O preço da cota dentro da janela de liberação gradual de 8 horas, e uma perda reportada enquanto as recompensas ainda estão sendo liberadas.
* Mint e resgate a um preço diferente da paridade.
* A reserva de rendimento do PendleYTLock após uma chamada arbitrária. O caminho de depósito está provado.

A suíte verifica a lógica dos próprios contratos. Ela não cobre os pools de token CCIP da Chainlink, a Pendle nem
nenhum outro contrato de terceiros, e não diz nada sobre os sistemas off-chain.

## Versões

A suíte é executada contra o código-fonte das versões implantadas: strUSD 1.1.0, PendleYTLock 4.0.0 (os locks com vencimento em fevereiro de 2027) e o timelock atual. Os dois locks que vencem em 26 de novembro de 2026 usam versões anteriores do PendleYTLock e não estão cobertos.

## O que foi encontrado

Escrever as propriedades revelou dois problemas. Nenhum deles pode ser usado por uma parte externa.

| Achado | Gravidade | Status |
| - | - | - |
| O proprietário do strUSD pode colocar a si mesmo na blacklist por meio da função genérica de papéis, embora as funções dedicadas da blacklist recusem isso. Só o proprietário pode fazer isso, e isso pode ser desfeito em uma única transação. | Baixa | Registrado |
| Um detentor de papel do timelock podia renunciar ao próprio papel. Como o timelock não tem admin, um papel renunciado nunca mais poderia ser concedido, o que travaria todas as operações protegidas pelo timelock. Isso exige uma transação do Safe proponente ou do próprio executor. | Média | Corrigido. O timelock foi substituído por uma versão que recusa a chamada, e os papéis foram transferidos para ela. |

## Verificação contínua

Cada propriedade é executada a cada alteração nos contratos, antes que a alteração possa ser incorporada. Um
contraexemplo faz a execução falhar. O mesmo acontece com um timeout do solver ou com uma propriedade cujos caminhos
são todos revertidos, de modo que uma propriedade não pode passar sem provar nada.

Cada propriedade também foi executada contra uma cópia propositalmente quebrada do código, com uma proteção removida
ou um limite alterado, e precisou falhar nela. Uma propriedade que continua passando em código quebrado não está
verificando o que afirma verificar.

A verificação formal funciona ao lado das [auditorias e do bug bounty](https://docs.tori.finance/pt-BR/security/audits.md), não no lugar
deles.

> [!NOTE]
>
> **Tradução automática:** esta página é uma tradução automática do original em inglês, fornecida apenas por conveniência. Ela pode conter erros ou omissões e não tem efeito jurídico. Se houver divergência entre esta página e a versão em inglês, prevalece a versão em inglês. Leia o [original em inglês](https://docs.tori.finance/security/formal-verification.md) antes de se basear em qualquer informação desta página.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.