Quase todos os bugs de integração na fronteira dos ativos reduzem-se a uma frase: o protocolo acreditou no número que pediu em vez do número que chegou. O padrão de token faz essa crença parecer segura — chamas transfer com um montante, a chamada tem êxito, logo o montante moveu-se. Na prática o padrão é uma sugestão, e uma grande família de tokens implementados não o respeita da forma que os integradores presumem.

Medido, não nominal: porque é que um protocolo nunca deve confiar no número que passou a um token
Tradução · Em caso de divergência, prevalece a versão em inglês. Ler o original em inglês ›
Uma transferência de 100 não significa que chegaram 100. Os tokens com fee-on-transfer, rebasing e não conformes quebram todos os protocolos que creditam o montante pedido em vez do entregue — e a solução é uma disciplina, não um remendo: medir a variação do saldo e tratá-la como a única verdade.
Known formally as The Asset Boundary in the BlazePhoenix whitepaper.
BlazePhoenix Engineering · article updated 2026-07-29 · site dataset through 2026-11-19 · 10 min · written from the deployed bytecode
| Nome formal | The Asset Boundary |
|---|---|
| Tempo de leitura | 10 min |
| Secções | 5 |
| Fontes citadas | 1 |
| Atualizado | 2026-07-29 |
By Mitra (@Sigmacrit) — anonymous developer of the BlazePhoenix protocol. The code is the résumé.
Quatro maneiras de o número mentir
FEE-ON-TRANSFER. O token deduz uma comissão dentro da transferência, pelo que o destinatário recebe estritamente menos do que foi enviado. Um protocolo que credita o montante pedido fica agora com crédito a mais face às posições reais, e todos os cálculos seguintes herdam o erro. Isto não é teórico: um token com fee-on-transfer foi usado para drenar cerca de meio milhão de dólares de pools cuja contabilidade assumia o valor nominal.
REBASING. Os saldos mudam sem qualquer transferência — a oferta é ajustada e o número de cada detentor mexe. Um protocolo que tira um snapshot de um saldo e assume que ele é estável até agir estará errado no momento em que agir, num sentido ou no outro.
RETORNOS NÃO CONFORMES. Tokens amplamente detidos não devolvem qualquer booleano em transfer, por isso uma integração ingénua reverte ao descodificar; e pelo menos um token proeminente declara um booleano e devolve FALSE numa transferência que na verdade teve êxito. Verificar o valor de retorno de forma ingénua está tão errado como não o verificar.
HOOKS REENTRANTES. Os padrões de token com callbacks de transferência entregam o controlo à contraparte a meio de um movimento, pelo que o estado lido antes da transferência pode estar desatualizado na linha seguinte.
A disciplina: a variação é a única verdade
A solução geral não é uma lista de casos especiais por token — é uma regra aplicada de modo uniforme em cada fronteira: ler o saldo antes, executar o movimento, ler o saldo depois e tratar a DIFERENÇA como o montante. Nunca o argumento que passaste.
Aplicada com consistência, remove toda a família de uma vez. O fee-on-transfer deixa de importar porque a comissão está dentro da variação. O rebasing deixa de importar porque a variação é calculada na mesma janela que o movimento. Um token que mente sobre o seu valor de retorno é apanhado porque o saldo ou se moveu ou não — e, ao contrário de um valor de retorno, um saldo não se pode falsificar sem capital.
A regra estende-se ao lado do pagamento, que os integradores esquecem com mais frequência do que o lado da entrada. Se um protocolo promete a um utilizador uma saída mínima, essa promessa tem de ser aplicada sobre o que o utilizador RECEBEU DE FACTO, e não sobre o montante que o protocolo nominalmente enviou. Caso contrário, um token deflacionário faz o utilizador cair discretamente abaixo do seu próprio limite enquanto o protocolo reporta êxito.
A armadilha de segunda ordem: um guard calibrado sobre ficção
Eis a falha que sobrevive a uma correção ingénua. Imagina que o protocolo adota a regra do delta para a contabilidade, mas mantém uma verificação de segurança — um floor de saída mínima, por exemplo — derivada de uma cotação calculada como se não existisse comissão de transferência. A contabilidade passa a estar correta e o guard passa a estar errado: exige uma saída que o token nunca pode entregar, e por isso rejeita um fill perfeitamente honesto. O protocolo trocou o sobrecrédito silencioso por uma negação de serviço ruidosa.
A resolução é que um guard tem de ser calibrado sobre a mesma realidade medida que a contabilidade. Se uma comissão foi OBSERVADA durante a execução — não declarada por quem chama, não adivinhada a partir de uma lista, mas medida — a componente do floor cega às comissões é o instrumento errado para essa operação e tem de ceder perante os limites calculados a partir de montantes reais. O utilizador continua protegido pelo seu próprio mínimo explícito e por um floor derivado do que genuinamente chegou; nada é relaxado para os tokens honestos, cujo comportamento não muda porque a sua variação medida é sempre igual ao montante nominal.
Porque é que isto é um problema de invariantes, e não de compatibilidade
É tentador arquivar tudo isto em «compatibilidade de tokens» e manter uma allowlist. Essa abordagem falha ao contacto com a realidade: o espaço dos tokens que se portam mal é aberto, sem permissões, e cresce mais depressa do que qualquer lista. Pior, uma allowlist é uma afirmação sobre o mundo e não uma propriedade do código, e as afirmações sobre o mundo são exatamente o que um adversário edita.
A regra do delta medido é diferente em natureza. É um invariante local e verificável que se mantém seja o que for que o token faça, porque observa o resultado em vez de confiar na interface. Um guard de conservação calculado sobre a realidade medida pode então ser honesto: compara a variação real do saldo com a variação real do que o ledger afirma dever, de modo que um token que se comporte de forma estranha produz uma transação rejeitada e não um ledger discretamente sobrecreditado. Essa é a diferença entre um protocolo que espera que os tokens se portem bem e um que não precisa que se portem.
Não confies nesta página — reprodu-la
Cada afirmação acima pode ser verificada na blockchain. Começa aqui:
Take any integration and ask what it credits: the amount it passed, or the amount it measured — then run a fee-on-transfer token through it and compare its ledger to the real balance, because the gap between the two IS the bugCitar este artigo
Licenciado em CC BY-NC-ND 4.0: cite-o com atribuição e uma ligação. O uso comercial e as versões derivadas exigem autorização escrita da BlazePhoenix; as traduções são feitas pela BlazePhoenix. Copy a ready-made citation:
BlazePhoenix (2026). Medido, não nominal: porque é que um protocolo nunca deve confiar no número que passou a um token. BlazePhoenix Engineering. https://blazephoenix.xyz/pt/learn/measured-not-nominal/@misc{blazephoenix_measured_not_nominal,
title = {Medido, não nominal: porque é que um protocolo nunca deve confiar no número que passou a um token},
author = {BlazePhoenix},
year = {2026},
url = {https://blazephoenix.xyz/pt/learn/measured-not-nominal/},
note = {Accessed: reproduce the claim with the command above}
}Writing an answer, a wiki entry or a paper? The claim above is reproducible against the chain before you quote it — which is the only sound basis for citing a technical source at all.
Contracts are verified on every chain we deploy to — addresses in the protocol manifest. Deeper formal treatment: the whitepaper (PDF). Sources cited: EIP-20
Engenharia relacionada
- Invariant-driven design: what a conservation law proves, and the dimension it cannot see ›
- O iron floor: uma saída mínima que o contrato volta a derivar por si ›
- When invariants meet time: the vulnerability class conservation cannot detect ›
- A clean protocol an AI agent can trust: BlazePhoenix over MCP ›
Questions, a partnership or a bug to report? Contact us or email contact@blazephoenix.xyz