Pontos-chave
- Truffle aparece em projetos que conservam suas migrações e testes originais.
- Sua manutenção exige identificar dependências e versões do ambiente legado.
- Uma migração deve preservar contratos, testes e registros de implantação.
O que é Truffle?
Truffle é um framework de desenvolvimento de contratos EVM presente em projetos legados. Seu fluxo combina compilação, testes, artefatos de contratos e scripts de migração. O Ganache fornecia uma rede local relacionada a esse ecossistema para executar operações durante o desenvolvimento.
A Consensys anunciou a descontinuação do Truffle e do Ganache em 2023. Por isso, esta página trata principalmente da manutenção e migração de aplicações existentes. A escolha de um ambiente para código novo deve considerar ferramentas mantidas e compatibilidade com as necessidades atuais do projeto.
Como funciona
Um projeto Truffle conserva configuração de redes e compiladores, contratos e scripts de migração que descrevem ações de implantação. Os artefatos relacionam ABI, bytecode e endereços por rede. Em um sistema existente, esses arquivos e registros ajudam a reconstruir o que foi implantado e com quais parâmetros.
Antes de trocar de ferramentas, executa-se uma linha de base de testes em um ambiente controlado. Também se inventariam plugins, formatos de números, contas de desenvolvimento e dependências do Ganache. A compatibilidade de uma versão específica não deve ser deduzida apenas do fato de o contrato estar escrito em Solidity.
O que o Truffle oferece
A migração pode ter como destino Hardhat, Foundry ou outro ambiente adequado à equipe. Primeiro se reproduz a compilação e depois se portam testes e scripts, comparando resultados. As opções do otimizador, as bibliotecas vinculadas e a versão EVM influenciam os artefatos e devem ser conservadas ou alteradas deliberadamente.
Um contrato já implantado não precisa ser reimplantado só porque o framework do repositório mudou. O trabalho consiste em manter a capacidade de testá-lo, operá-lo e verificar seu código. Se, além disso, a implementação for modificada, essa mudança tem escopo próprio e exige revisar sua compatibilidade com o estado existente.
Limitações e critérios de escolha
Uma estimativa de migração depende do tamanho e da qualidade dos testes, do uso de plugins e da documentação das implantações. Não há uma duração universal. Convém identificar primeiro quais scripts continuam sendo necessários e quais contêm operações irrepetíveis que não devem ser executadas de novo.
A saída é considerada completa quando a equipe consegue compilar, executar os testes relevantes e operar as redes suportadas com a nova ferramenta. Conservam-se referências históricas para incidentes e auditoria técnica. Trocar comandos sem comprovar a equivalência de comportamento deixa pendente a parte mais importante da migração.
Também conhecido como
- Truffle Suite
- Truffle framework
