Ganache

O que é Ganache?

Ganache é um simulador local de blockchain que permite aos desenvolvedores criar, implantar, testar e depurar contratos inteligentes compatíveis com Ethereum sem usar criptomoedas reais.

Ele cria um ambiente privado de blockchain no computador do desenvolvedor e imita muitos comportamentos importantes da Ethereum Virtual Machine, geralmente chamada de EVM.

Os desenvolvedores podem usar o Ganache para criar contas de teste, implantar contratos Solidity, enviar transações, inspecionar blocos, medir o uso de gas e observar alterações no estado da blockchain.

A documentação oficial arquivada do Ganache descreve o Ganache como uma blockchain pessoal para o desenvolvimento rápido de aplicativos descentralizados em um ambiente seguro e determinístico.

O Ganache era popular porque permitia que os desenvolvedores começassem a testar imediatamente, sem executar um nó completo de uma blockchain pública nem obter criptomoedas de teste.

As transações podiam ser confirmadas instantaneamente, as contas podiam começar com grandes saldos simulados de ETH e toda a blockchain podia ser redefinida sempre que necessário.

O Ganache estava disponível como aplicativo desktop com interface gráfica, interface de linha de comando e pacote JavaScript que podia ser integrado aos fluxos de trabalho de desenvolvimento.

Ganache não é uma criptomoeda, blockchain pública, carteira, token nem plataforma de negociação descentralizada.

É um software de desenvolvimento projetado para simular o comportamento de uma blockchain em uma rede local controlada.

O Ganache ainda recebe manutenção?

O Ganache não recebe mais manutenção ativa.

A Consensys anunciou o encerramento do Ganache e do pacote de desenvolvimento Truffle em 21 de setembro de 2023.

O anúncio oficial do encerramento do Ganache informou que o código continuaria disponível publicamente após o período de transição.

O repositório do código-fonte do Ganache foi arquivado em 26 de fevereiro de 2024 e agora está em modo somente leitura.

Um software arquivado pode continuar funcionando em um ambiente compatível com suas dependências e com as regras esperadas da Ethereum.

No entanto, softwares arquivados normalmente não recebem novos recursos, patches de segurança, atualizações de dependências, correções de bugs nem suporte a atualizações posteriores da rede.

Essa limitação é importante porque a Ethereum continua introduzindo novos opcodes, formatos de transação, regras de gas, recursos de conta e alterações de execução.

Um contrato Solidity moderno pode usar instruções que uma versão antiga do Ganache não reconhece.

Além disso, um contrato aprovado em todos os testes no Ganache pode se comportar de outra forma em uma blockchain pública atual se o Ganache simular regras antigas do protocolo.

Por isso, o Ganache deve ser considerado um software legado de desenvolvimento para Ethereum, não um padrão atual para testes de produção.

Como o Ganache funciona?

O Ganache inicia um processo isolado de blockchain controlado pelo desenvolvedor.

O processo mantém contas locais, saldos, blocos, transações, código de contratos inteligentes, armazenamento, logs e outros dados da blockchain.

Ele disponibiliza um endpoint JSON-RPC compatível com Ethereum ao qual scripts de desenvolvimento, carteiras, aplicativos de navegador e ferramentas de teste podem se conectar.

A documentação JSON-RPC da Ethereum explica a interface padrão usada pelos aplicativos para se comunicar com clientes de execução da Ethereum.

Quando uma transação é enviada ao Ganache, o simulador valida a solicitação, executa as instruções EVM relevantes, altera o estado local e retorna um recibo da transação.

O Ganache pode criar um novo bloco imediatamente após receber uma transação ou minerar blocos em um intervalo de tempo configurado.

Como o desenvolvedor controla a blockchain, não é necessário competir com usuários alheios pelo espaço em blocos públicos.

O desenvolvedor também pode reiniciar a rede, alterar sua configuração, substituir as contas ou apagar o histórico.

Esses controles tornam o Ganache rápido e previsível, mas também o diferenciam fundamentalmente de uma blockchain pública descentralizada.

O que é uma blockchain pessoal?

Uma blockchain pessoal é um ambiente privado de blockchain usado para desenvolvimento, educação ou testes.

Ao contrário da mainnet da Ethereum, ela não é protegida por um conjunto distribuído de validadores economicamente independentes.

Quem executa a blockchain controla seu estado inicial, as contas, o comportamento da mineração, os timestamps e as configurações da rede.

Em geral, o operador pode redefinir ou reescrever o ambiente local sem obter a aprovação de outros participantes da rede.

Essa flexibilidade permite que os desenvolvedores repitam os mesmos testes em condições idênticas.

Isso também significa que uma blockchain pessoal não reproduz a segurança econômica, a descentralização, o congestionamento, a ordem das transações nem a atividade adversarial de uma rede cripto pública.

O Ganache é mais bem descrito como um simulador de blockchain pessoal do que como uma blockchain de produção.

Contas do Ganache e ETH simulado

Uma sessão normal do Ganache cria várias contas de teste quando a blockchain local é iniciada.

Em geral, cada conta recebe um grande saldo de ETH simulado.

Esse ETH pode ser usado para pagar taxas de gas simuladas, implantar contratos, transferir valor e interagir com aplicativos descentralizados dentro do Ganache.

O ETH do Ganache não tem valor de mercado, pois existe apenas no banco de dados da blockchain local.

Ele não pode ser transferido diretamente para a mainnet da Ethereum nem trocado por criptomoedas reais por meio do protocolo da blockchain.

O Ganache pode derivar suas contas de uma frase mnemônica determinística.

Usar a mesma frase mnemônica, o mesmo caminho de derivação e a mesma configuração pode reproduzir os mesmos endereços e chaves privadas em outra sessão do Ganache.

As contas determinísticas são úteis porque os testes automatizados podem saber quais endereços e saldos estarão disponíveis antes do início do teste.

As chaves privadas ficam acessíveis intencionalmente, pois essas contas são destinadas ao desenvolvimento.

Frases de recuperação de carteiras reais e chaves privadas de produção nunca devem ser inseridas no Ganache.

Uma chave de desenvolvimento também nunca deve ser reutilizada em um endereço que manterá criptomoedas valiosas em uma rede pública.

Interface gráfica do Ganache

A interface gráfica do Ganache oferecia uma forma visual de criar e inspecionar uma blockchain pessoal.

A tela de contas exibia endereços locais, saldos, contagens de transações e chaves privadas.

As telas de blocos e transações permitiam que os desenvolvedores analisassem a atividade minerada localmente.

As páginas relacionadas a contratos podiam exibir contratos implantados, eventos, informações de armazenamento e detalhes de execução quando as informações do projeto estavam disponíveis.

A interface tornava o Ganache acessível a desenvolvedores que ainda estavam aprendendo a usar ferramentas de blockchain na linha de comando.

Os usuários podiam criar espaços de trabalho com diferentes configurações de contas, mineração, rede e fork.

O guia de início rápido arquivado do Ganache explica o processo histórico para criar uma blockchain pessoal pelo aplicativo desktop.

A interface gráfica agora é um software legado e não se deve esperar que ofereça suporte aos recursos atuais da Ethereum.

Interface de linha de comando do Ganache

A interface de linha de comando do Ganache permitia que os desenvolvedores iniciassem e configurassem uma blockchain local pelo terminal.

Uma instalação legada geralmente podia ser iniciada com um comando como

.

O uso pela linha de comando era útil para testes automatizados, scripts, servidores de desenvolvimento e ambientes de integração contínua.

Os desenvolvedores podiam configurar contas, saldos, frases mnemônicas, identificadores de cadeia, limites de gas, intervalos de mineração, logs, bancos de dados, portas de servidor e forks de rede.

A referência arquivada de opções da CLI do Ganache documenta as categorias históricas de configuração disponíveis para os desenvolvedores de Ethereum.

O programa de linha de comando também podia ser iniciado em modo desacoplado, mantendo a blockchain local em execução separadamente do comando original no terminal.

Como o pacote está arquivado, instalá-lo em um ambiente de software moderno pode gerar problemas de compatibilidade com dependências, sistemas operacionais ou ambientes de execução.

Espaços de trabalho do Ganache

Um espaço de trabalho do Ganache armazenava a configuração de um projeto específico de blockchain local.

Um espaço de trabalho podia definir contas, frase mnemônica, configurações da cadeia, comportamento da mineração, caminho do banco de dados e projeto de contrato inteligente vinculado.

Os espaços de trabalho persistentes permitiam que o histórico da blockchain e o estado dos contratos implantados continuassem disponíveis após o fechamento do aplicativo.

Um espaço de trabalho efêmero podia começar com o estado limpo sempre que o Ganache fosse reiniciado.

O estado local persistente era conveniente durante o desenvolvimento, mas também podia gerar diferenças confusas de nonce, implantação ou saldo entre execuções de teste.

Os testes automatizados geralmente se beneficiam de um ambiente determinístico limpo, em vez de um banco de dados local antigo com transações anteriores.

Mineração instantânea no Ganache

O Ganache podia confirmar transações instantaneamente ao minerar um bloco assim que uma transação era recebida.

A mineração instantânea permitia que conjuntos de testes de contratos inteligentes fossem executados muito mais rapidamente do que em uma blockchain pública.

Os desenvolvedores podiam implantar um contrato e interagir com ele sem esperar pelo intervalo entre blocos de uma rede pública.

O Ganache também podia ser configurado para minerar blocos em intervalos regulares.

Os controles de mineração manual permitiam que os testes criassem transações pendentes antes de decidir quando um bloco deveria ser produzido.

Esses recursos eram úteis para testar aplicativos blockchain, mas a mineração instantânea podia ocultar problemas de produção relacionados a atrasos, competição por taxas, transações substitutas e mudanças no estado.

Um aplicativo descentralizado nunca deve presumir que uma transação real será confirmada imediatamente só porque foi confirmada instantaneamente no Ganache.

Snapshots e reversões no Ganache

O Ganache oferecia suporte a snapshots que registravam o estado atual da blockchain local.

Um desenvolvedor podia criar um snapshot, executar várias transações e, depois, reverter a blockchain ao estado salvo.

Esse recurso permitia que os testes começassem repetidamente com os mesmos saldos de conta, armazenamento de contratos, timestamps e histórico de blocos.

Os snapshots reduziam a necessidade de reimplantar cada contrato antes de cada teste individual.

Eles também ajudavam os desenvolvedores a reproduzir bugs a partir de um estado conhecido da blockchain.

Um snapshot do Ganache era apenas um recurso de teste local e não tinha efeito em uma blockchain pública.

Os usuários não podem reverter transações finalizadas na mainnet da Ethereum usando um comando de snapshot do Ganache.

Manipulação do tempo no Ganache

O Ganache permitia que os desenvolvedores avançassem o tempo da blockchain e controlassem os timestamps dos blocos produzidos localmente.

Esse recurso era útil para testar vesting de tokens, cronogramas de staking, períodos de governança, leilões, prazos de empréstimos, sistemas de assinatura e contratos com bloqueio por tempo.

Um desenvolvedor podia simular a passagem de vários meses sem esperar o tempo real passar.

Os testes também podiam analisar o comportamento imediatamente antes e depois de um prazo de expiração.

Os timestamps públicos da Ethereum são produzidos de acordo com as regras da rede e não são controlados pelo desenvolvedor do aplicativo.

Por isso, os contratos devem ser testados com variações realistas de timestamp, em vez de apenas valores locais perfeitamente previsíveis.

Fork de rede no Ganache

O Ganache podia criar um fork local de uma rede pública compatível com Ethereum.

Um fork começa com as contas, os saldos, o código dos contratos e o armazenamento disponíveis em um bloco remoto selecionado.

A partir desse ponto inicial, as novas transações são executadas localmente e não modificam a blockchain pública original.

O fork permitia que os desenvolvedores testassem interações com tokens existentes, protocolos descentralizados ou sistemas de contratos implantados.

Ele também podia ajudar a reproduzir um bug histórico em condições de blockchain semelhantes às existentes quando o problema ocorreu.

Normalmente, era necessário um endpoint JSON-RPC remoto para recuperar o estado copiado da blockchain.

O Ganache podia solicitar informações adicionais ao nó remoto quando uma transação executada localmente acessava um estado que ainda não havia sido baixado.

Testar com um fork não concede permissão para controlar ativos reais, pois os saldos e o estado dos contratos copiados existem apenas dentro do simulador.

Uma versão arquivada do Ganache pode não conseguir criar corretamente um fork de uma rede atual ao encontrar blocos, transações, opcodes ou alterações de protocolo sem suporte.

Impersonação de contas em um fork do Ganache

O Ganache podia desbloquear ou simular localmente endereços de blockchain selecionados em um ambiente com fork.

Isso permitia que um teste enviasse uma transação como se ela viesse de um detentor específico de tokens, administrador, participante de governança ou conta de contrato.

A impersonação não revelava a chave privada real do endereço.

Ela também não concedia controle sobre o endereço na rede pública original.

O recurso só funcionava porque o desenvolvedor controlava o simulador local e podia alterar suas regras de autorização.

A impersonação de contas era útil para testar cenários difíceis, mas as transações de produção ainda exigem autorização válida segundo as regras da rede real.

Ganache e implantação de contratos inteligentes

Os desenvolvedores podiam implantar contratos Solidity compilados no Ganache enviando transações de criação de contrato ao endpoint JSON-RPC local.

A transação continha o bytecode de criação e quaisquer parâmetros de construtor codificados.

O Ganache executava o construtor e armazenava o bytecode de execução resultante em um endereço de contrato local.

Em seguida, scripts, carteiras, aplicativos de navegador ou outros contratos locais podiam chamar o contrato.

Uma implantação bem-sucedida no Ganache não implantava o contrato na mainnet da Ethereum nem em uma testnet pública.

Cada blockchain tem seu próprio estado de contratos e histórico de transações.

Ao passar dos testes locais para uma rede pública, é necessária uma transação de implantação separada e o pagamento de uma taxa de rede.

Testes de tokens de criptomoedas com Ganache

O Ganache permitia que os desenvolvedores criassem e testassem tokens fungíveis locais, NFTs, tokens de governança, sistemas de valor estável, contratos de staking e outros aplicativos cripto.

Um desenvolvedor podia testar transferências, saldos, permissões de gasto, aprovações, emissão, queima, propriedade, controles de acesso e logs de eventos.

Contas locais podiam receber tokens simulados sem nenhum custo financeiro.

Uma carteira conectada ao Ganache podia exibir um token local após a inclusão do endereço correto do contrato local.

O token existia apenas naquela blockchain específica do Ganache.

Redefinir a blockchain podia remover o token, seus saldos e todo o seu histórico de transações.

Um token local com o nome ou símbolo de uma criptomoeda real ainda era apenas uma simulação.

A blockchain e o endereço do contrato são identificadores de token mais confiáveis do que o nome ou ticker exibido.

Taxas de gas no Ganache

O Ganache simulava o gas da EVM para que os desenvolvedores pudessem observar o custo de execução de implantações de contratos e chamadas de funções.

Gravações de armazenamento, calldata, logs de eventos, criação de contratos, chamadas externas e operações computacionais podiam contribuir para o uso de gas exibido.

A taxa simulada era paga com o saldo local de ETH da conta de teste.

Nenhum ETH real era consumido na execução de uma transação local normal no Ganache.

Os desenvolvedores podiam configurar preços de gas, limites de gas por bloco, limites de transação e outras configurações relacionadas a taxas.

Essa flexibilidade era útil para testar falhas por falta de gas e funções de contrato dispendiosas.

No entanto, as medições de gas do Ganache podem não representar com precisão a Ethereum atual quando o simulador usa uma EVM antiga ou uma tabela de gas desatualizada.

Os benchmarks de gas devem ser refeitos em um ambiente com manutenção ativa que ofereça suporte à atualização exata da rede e ao alvo de compilação pretendidos para a implantação.

Ganache e testes determinísticos

Testes determinísticos significam que as mesmas condições iniciais e entradas de transação devem produzir os mesmos resultados esperados.

O Ganache oferecia suporte a contas, saldos, produção de blocos, identificadores de cadeia e sequências de implantação determinísticos.

Um conjunto de testes podia iniciar o Ganache com uma frase mnemônica conhecida, implantar contratos em uma ordem fixa e prever os endereços locais resultantes.

Em seguida, a blockchain podia ser redefinida antes da próxima execução de testes.

Essa previsibilidade ajudava os desenvolvedores a identificar se uma alteração no código modificava o comportamento do contrato.

As blockchains públicas reais são menos previsíveis porque outros usuários podem alterar o estado compartilhado dos contratos, a ordem das transações, a demanda por gas, a liquidez e os timestamps.

Por isso, os testes locais determinísticos devem ser combinados com testes de integração mais abrangentes e testes adversariais.

Ganache vs. mainnet da Ethereum

A mainnet da Ethereum é uma blockchain pública e descentralizada na qual ETH, tokens e contratos inteligentes podem ter valor financeiro real.

O Ganache é uma simulação controlada localmente, cujo operador pode alterar saldos, horários de blocos, contas e histórico.

As transações na mainnet competem por espaço limitado em blocos e pagam taxas determinadas pelas condições atuais da rede.

O Ganache pode usar mineração instantânea e configurações de taxas ajustáveis.

A mainnet contém atividade imprevisível de usuários e aplicativos de todo o mundo.

Uma nova blockchain do Ganache contém apenas as contas, os contratos e as transações incluídos pelo desenvolvedor.

A segurança da mainnet depende do protocolo mais amplo da Ethereum e da rede de validadores.

A segurança do Ganache depende do computador local e da configuração controlada por um único operador.

Ser aprovado nos testes do Ganache não comprova que um contrato é seguro ou compatível com o comportamento atual da mainnet.

Ganache vs. uma testnet pública

Uma testnet pública é uma blockchain de desenvolvimento compartilhada e operada por muitos participantes.

O guia de redes de desenvolvimento da Ethereum explica as diferenças entre ambientes locais e redes públicas de teste compartilhadas.

Uma testnet pública oferece condições mais realistas de rede, produção de blocos, competição por transações e interação com contratos implantados de forma independente.

O Ganache oferece execução mais rápida, saldos locais gratuitos, controle total e redefinição imediata do estado.

Os testes locais costumam ser melhores para testes unitários rápidos, enquanto uma testnet pública com manutenção ativa pode oferecer testes de integração mais abrangentes.

As criptomoedas de testnet também não têm valor financeiro pretendido, embora existam em uma rede compartilhada, e não no computador de um único desenvolvedor.

Nem os testes locais nem os testes em testnets públicas substituem uma análise profissional de segurança para um contrato que controlará criptoativos valiosos.

Ganache vs. uma rede privada Ethereum

Uma rede privada Ethereum pode consistir em vários nós de execução e consenso conectados entre si, sem participar da mainnet da Ethereum.

O Ganache geralmente simulava a execução da blockchain em um processo mais simples e voltado ao desenvolvimento.

Uma rede privada com vários nós pode testar a comunicação peer-to-peer, a propagação de blocos, a sincronização, o comportamento do consenso e as falhas de nós.

O Ganache se concentrava mais no desenvolvimento rápido de aplicativos, em contas previsíveis, no acesso local a RPC e em controles de teste convenientes.

A documentação de rede privada do Geth explica que redes privadas Ethereum podem oferecer suporte a cenários de teste com vários nós e usuários.

Por isso, testes avançados de protocolo podem exigir uma rede com vários clientes, em vez de um único processo do Ganache.

Limitações do Ganache

O Ganache não reproduzia o ambiente econômico, de rede, consenso e atividade adversarial completo da mainnet da Ethereum.

A confirmação instantânea podia ocultar problemas relacionados a transações pendentes, alterações nas taxas-base, conflitos de nonce ou regras de substituição.

A ordem previsível das transações podia ocultar riscos de front-running, back-running, competição por liquidações e outros riscos de ordenação.

Os fundos de teste ilimitados podiam ocultar problemas de financiamento de contas e integração de usuários.

Uma rede local não continha automaticamente oráculos, bridges, pools de liquidez, tokens, sistemas de governança ou outros contratos externos reais.

O fork podia acrescentar estado público copiado, mas ainda não reproduzia todos os eventos que poderiam ocorrer entre a simulação e a execução em produção.

O status arquivado do Ganache cria o risco adicional de que o resultado de compiladores atuais ou o comportamento da Ethereum não tenham suporte.

Um processo de teste completo deve incluir ferramentas locais mantidas, testes em redes compartilhadas, análise de segurança, fuzzing e revisão da configuração de implantação.

Riscos de segurança do Ganache

As contas do Ganache não foram projetadas para proteger criptomoedas valiosas.

As chaves privadas podem aparecer na saída do terminal, ser exibidas na interface gráfica, ser armazenadas em arquivos do projeto ou ser geradas a partir de frases-padrão conhecidas.

Um servidor RPC do Ganache pode expor funções poderosas de desenvolvimento que nunca devem ficar disponíveis para usuários desconhecidos na internet.

Vincular um servidor de desenvolvimento local a uma interface de rede pública pode criar uma exposição de segurança desnecessária.

Os dados de uma blockchain copiada por fork podem exibir saldos reais de contas, mas esses saldos locais não comprovam que o operador controla os ativos originais.

Os scripts escritos para o Ganache podem conter atalhos que seriam perigosos se reutilizados com chaves de produção.

As credenciais de desenvolvimento e de produção devem permanecer completamente separadas.

Nenhum site, ambiente de teste ou representante do suporte precisa de uma frase de recuperação real para criar uma blockchain local no Ganache.

Erros comuns do Ganache

Um erro de conexão pode ocorrer quando um aplicativo usa o host RPC, a porta ou o protocolo incorretos.

Um erro de identificador de cadeia pode ocorrer quando uma carteira está configurada para outra rede local.

Um erro de nonce pode aparecer quando uma carteira guarda transações de uma sessão anterior do Ganache que foi redefinida.

Um erro de saldo insuficiente pode ocorrer quando o endereço selecionado não é uma das contas locais financiadas.

Um erro de falta de gas pode resultar de um limite baixo de gas para a transação ou de um caminho de execução do contrato que exige mais trabalho do que o esperado.

Um erro de opcode sem suporte pode indicar que o contrato foi compilado para uma versão da EVM mais recente do que a compatível com o Ganache.

Um erro de fork pode resultar de um endpoint RPC remoto indisponível, dados de bloco incompatíveis, limites de solicitações ou comportamento de protocolo sem suporte.

Um endereço de contrato inesperado pode resultar de um implantador, nonce, frase mnemônica ou ordem de implantação diferentes.

O Ganache ainda pode ser usado?

O Ganache ainda pode ser usado quando uma versão arquivada é instalada e funciona corretamente no ambiente do desenvolvedor.

Ele ainda pode ser útil para reproduzir os resultados de testes de um projeto antigo ou entender fluxos de trabalho históricos de desenvolvimento para Ethereum.

Um projeto legado pode fixar a versão do pacote Ganache, o ambiente de execução, o compilador e as dependências para preservar a reprodutibilidade.

No entanto, continuar funcionando não significa que o software esteja atualizado, seja seguro ou compatível com a Ethereum moderna.

As equipes que mantêm aplicativos valiosos devem comparar cada conjunto de testes legado com os resultados de uma implementação de EVM com manutenção ativa.

Novos projetos não devem criar dependência adicional de longo prazo em um simulador sem suporte.

Migração para fora do Ganache

A migração deve começar pelo registro das configurações exatas do Ganache usadas pelo projeto.

Entre as configurações importantes estão a frase mnemônica, o número de contas, os saldos das contas, o chain ID, o network ID, a porta RPC, o modo de mineração, os limites de gas, os timestamps, o caminho do banco de dados e a configuração do fork.

A equipe deve identificar testes que usem métodos RPC específicos do Ganache para snapshots, alterações de tempo, mineração, mudanças de saldo ou impersonação de contas.

Os recursos equivalentes devem ser configurados no novo ambiente local.

Os scripts de implantação devem ser testados, pois a estimativa de gas, os recibos de transação, as mensagens de erro e o comportamento da mineração podem ser diferentes.

Os snapshots de gas devem ser gerados novamente, em vez de copiados dos resultados do Ganache.

Os testes com fork devem ser repetidos em um nó atual e em uma versão da EVM compatível com a rede de implantação pretendida.

A migração final deve preservar o comportamento funcional e, ao mesmo tempo, melhorar o suporte às regras atuais do protocolo Ethereum.

Desenvolvimento local moderno para Ethereum

As orientações atuais de desenvolvimento para Ethereum recomendam redes locais e frameworks mantidos para escrever, testar e depurar contratos inteligentes.

A documentação oficial de redes de desenvolvimento da Ethereum lista as opções atuais de teste local.

Desenvolvedores que precisam de um comportamento semelhante ao de um cliente de execução real também podem criar uma cadeia de desenvolvimento com o Geth.

O guia do modo de desenvolvimento do Geth explica como iniciar uma rede Ethereum local e implantar um contrato nela.

Equipes avançadas podem usar redes de teste configuráveis com vários clientes para testar conectividade, consenso e compatibilidade entre clientes.

O ambiente mais adequado depende da linguagem de programação, do compilador, do alvo da EVM, do framework de testes, dos requisitos de fork e da rede de implantação.

O Ganache tem um token?

O Ganache não tem uma criptomoeda oficial nem um token negociado no mercado.

O ETH simulado usado no Ganache é apenas dado local de desenvolvimento.

Não se deve presumir que um token com o nome Ganache tenha qualquer ligação com o software de desenvolvimento arquivado.

Qualquer pessoa pode criar um token e atribuir a ele um nome conhecido de software ou empresa.

Os usuários devem identificar criptomoedas pela blockchain e pelo endereço exato do contrato, não apenas pelo nome ou logotipo.

Uma alegação de que o ETH de teste do Ganache pode ser comprado, sacado ou convertido em ETH real é um sinal de alerta de possível golpe.

Perguntas frequentes

O que é Ganache, em termos simples?

Ganache é um simulador local de blockchain Ethereum usado para testar contratos inteligentes e aplicativos descentralizados sem gastar criptomoedas reais.

O Ganache ainda recebe manutenção?

Não. O Ganache foi encerrado em 2023, e seu repositório público de código-fonte foi arquivado em 2024.

Ainda é possível instalar o Ganache?

Pacotes arquivados ainda podem ser instalados em ambientes compatíveis, mas são softwares legados sem suporte.

O Ganache é uma blockchain real de criptomoedas?

O Ganache mantém blocos, transações, contas e contratos locais, mas não é uma rede pública descentralizada de criptomoedas.

O Ganache usa ETH real?

Não. As contas do Ganache usam ETH simulado, que só tem valor dentro da blockchain local de desenvolvimento.

É possível enviar ETH do Ganache para a mainnet da Ethereum?

Não. Os saldos locais do Ganache não existem na mainnet da Ethereum e não podem ser sacados para ela.

O Ganache tem um token oficial?

Não. O Ganache é um software de desenvolvimento e não tem uma criptomoeda oficial negociada no mercado.

Uma carteira pode se conectar ao Ganache?

Sim. Uma carteira compatível com Ethereum pode se conectar usando o endpoint RPC do Ganache e a configuração correta da rede local.

O Ganache pode implantar contratos inteligentes Solidity?

Sim. Contratos Solidity compilados podem ser implantados e executados na EVM local do Ganache.

O Ganache pode testar tokens e NFTs?

Sim. Os desenvolvedores podem implantar e testar transferências, aprovações, emissão, queima, propriedade e lógica de permissões de tokens locais.

O que é Ganache CLI?

Ganache CLI é a versão de linha de comando do simulador local de blockchain.

O que é a interface gráfica do Ganache?

É o aplicativo desktop que exibia visualmente contas, blocos, transações, contratos, eventos e configurações.

O que é um espaço de trabalho do Ganache?

Um espaço de trabalho é uma configuração salva do Ganache com definições de blockchain local, contas, mineração e projeto.

O que é um snapshot do Ganache?

Um snapshot registra o estado da blockchain local para que os testes possam reverter depois ao mesmo ponto inicial.

O Ganache pode alterar o tempo da blockchain?

Sim. Os métodos de desenvolvimento do Ganache podem avançar o tempo e modificar os timestamps dos blocos locais para fins de teste.

O que é um fork do Ganache?

Um fork do Ganache cria uma blockchain local com base nos dados de contas e contratos copiados de um bloco selecionado de uma rede pública.

As transações em um fork do Ganache afetam a rede pública?

Não. As transações feitas após o fork permanecem dentro do simulador local.

O Ganache pode impersonar um endereço público?

Ele pode simular localmente transações de endereços selecionados, mas não revela chaves privadas nem concede controle sobre ativos reais.

O Ganache calcula gas?

Sim. O Ganache simula o uso e as taxas de gas de acordo com as regras da EVM implementadas em sua versão arquivada.

As estimativas de gas do Ganache são precisas para a Ethereum atual?

Não necessariamente, pois as atualizações mais recentes da Ethereum e os resultados de compiladores atuais podem não ter suporte.

Por que o Ganache mostra um opcode sem suporte?

O contrato pode ter como alvo uma versão da EVM que contém uma instrução não implementada pela versão instalada do Ganache.

O Ganache é igual à mainnet da Ethereum?

Não. A mainnet é uma rede pública descentralizada com ativos reais, enquanto o Ganache é controlado por um desenvolvedor local.

O Ganache é igual a uma testnet pública?

Não. Uma testnet pública é compartilhada por muitos participantes, enquanto uma blockchain comum do Ganache é executada em privado em um único sistema de desenvolvimento.

É possível usar o Ganache sem acesso à internet?

Uma blockchain local básica do Ganache pode funcionar offline, mas o fork de rede exige acesso a um nó remoto.

O Ganache é seguro para produção?

Não. As chaves de teste expostas, o histórico controlável, os métodos RPC de desenvolvimento e a falta de suporte tornam o Ganache inadequado para a custódia de ativos em produção.

Devo importar uma frase de recuperação real para o Ganache?

Não. Frases de recuperação reais e chaves privadas de produção nunca devem ser usadas em um simulador local de desenvolvimento.

Projetos legados podem continuar usando o Ganache?

É possível manter uma versão fixada para testes históricos, mas recomenda-se migrar para um ambiente mantido.

Por que os desenvolvedores devem migrar do Ganache?

A migração oferece suporte aos protocolos atuais, manutenção de dependências, correções de segurança e compatibilidade com resultados modernos do Solidity.

Ser aprovado nos testes do Ganache comprova que um contrato é seguro?

Não. Testes locais não substituem testes adversariais, integração com a rede atual, revisão de código nem auditoria independente de contratos inteligentes.

Conclusão

O Ganache é um simulador local de blockchain historicamente importante que ajudou desenvolvedores de Ethereum a criar e testar contratos inteligentes rapidamente.

Ele oferecia contas financiadas, chaves determinísticas, mineração instantânea, snapshots, controles de tempo, contabilização local de gas, fork de rede e impersonação de contas.

O ETH e os tokens simulados existem apenas dentro da blockchain local e não têm valor de mercado real.

O Ganache difere da mainnet da Ethereum porque um único desenvolvedor controla as contas, a produção de blocos, o histórico e as condições da rede.

Ele também difere de uma testnet pública porque seu estado normalmente é privado, previsível e fácil de redefinir.

O Ganache foi oficialmente encerrado em 2023, e seu repositório de código-fonte passou a ser somente leitura em 2024.

As versões arquivadas podem continuar sendo úteis para manter projetos legados, mas não se deve esperar que ofereçam suporte às atualizações atuais da Ethereum ou ao comportamento de compiladores modernos.

Os desenvolvedores nunca devem usar chaves privadas reais, expor publicamente um servidor RPC do Ganache nem considerar testes locais bem-sucedidos como prova de segurança em produção.

Os projetos que migram do Ganache devem preservar as configurações de contas, cadeia, mineração, snapshots, timestamps, RPC, gas e fork em um ambiente substituto mantido.

O Ganache é mais bem entendido como uma infraestrutura legada de desenvolvimento para Ethereum, cujos conceitos de teste continuam influenciando ferramentas modernas de blockchain local.