Flow CLI (Dapper Labs)

O que é o Flow CLI?

Flow CLI é a interface oficial de linha de comando para desenvolver aplicativos e interagir com a blockchain Flow.

CLI significa interface de linha de comando: os desenvolvedores controlam a ferramenta digitando comandos de texto em um terminal, em vez de clicar em botões de um aplicativo gráfico.

O Flow CLI pode inicializar projetos de blockchain, executar uma rede Flow local, testar código Cadence, implantar contratos inteligentes, enviar transações, executar scripts, gerenciar contas, gerar chaves, instalar dependências de contratos e consultar dados da blockchain.

Ele oferece um fluxo de desenvolvimento comum para o Flow Emulator local, a Flow Testnet e a Flow Mainnet.

A ferramenta se destina principalmente a desenvolvedores de contratos inteligentes, equipes de aplicativos descentralizados, engenheiros de infraestrutura, testadores e outros usuários técnicos que desenvolvem na Flow.

O Flow CLI não é uma criptomoeda, carteira de cripto, nó de blockchain, aplicativo para consumidores nem produto de negociação.

É um software para desenvolvedores que se comunica com nós de acesso da Flow e serviços locais de desenvolvimento.

A documentação oficial do Flow CLI o descreve como uma ferramenta para gerenciar projetos, contas, contratos, transações, dependências e consultas à blockchain por meio de uma única interface.

Qual é a conexão entre o Flow CLI e a Dapper Labs?

A Flow foi originalmente projetada e desenvolvida pela Dapper Labs, motivo pelo qual algumas pessoas pesquisam Flow CLI como “Flow CLI Dapper Labs”.

A Dapper Labs criou a Flow para viabilizar aplicativos blockchain voltados a grandes públicos de consumidores sem exigir que cada aplicativo disputasse os mesmos recursos de processamento limitados.

O histórico oficial da Flow e da Cadence identifica a Dapper Labs como a projetista e desenvolvedora original da blockchain.

Atualmente, o Flow CLI é distribuído como software de código aberto pela organização Onflow e faz parte do ecossistema mais amplo de desenvolvimento da Flow.

O repositório oficial do código-fonte da ferramenta é público e está disponível sob a licença Apache 2.0.

Portanto, o Flow CLI deve ser entendido como uma ferramenta oficial da rede Flow, e não como um aplicativo privado para consumidores operado exclusivamente pela Dapper Labs.

Qual é a versão mais recente do Flow CLI?

Em 14 de julho de 2026, a versão mais recente publicada do Flow CLI é a 2.17.4.

A versão 2.17.4 foi lançada em 4 de junho de 2026 e atualizou a ferramenta para a versão 1.10.3 da Cadence.

O lançamento também atualizou os componentes dos contratos principais da Flow incluídos no pacote para versões compatíveis com a Cadence 1.10.3.

Os desenvolvedores podem confirmar o lançamento atual na página oficial de versões do Flow CLI.

As versões podem mudar com frequência, pois a CLI precisa permanecer compatível com novos lançamentos da Cadence, atualizações do emulador, contratos principais, recursos de rede e correções de segurança.

Para verificar a versão instalada localmente, o desenvolvedor pode executar

em um terminal.

Equipes de produção devem usar uma versão testada e fixada da CLI em sistemas de compilação automatizados, em vez de alterar versões automaticamente a cada implantação.

Por que o Flow CLI é importante?

O desenvolvimento de blockchain envolve mais do que escrever um arquivo de contrato inteligente.

O desenvolvedor também precisa criar contas, gerenciar chaves, resolver endereços de contratos, enviar transações assinadas, inspecionar resultados, testar condições de falha e implantar o código na rede correta.

O Flow CLI reúne essas tarefas em uma ferramenta consistente.

Ele reduz a necessidade de criar manualmente solicitações brutas aos nós de acesso da Flow para operações comuns de desenvolvimento.

A CLI também torna os comandos repetíveis, algo útil para testes, scripts de implantação, integração contínua e colaboração em equipe.

Um comando salvo em um script de implantação pode ser revisado e executado de forma consistente em vários ambientes de desenvolvimento.

Isso é mais seguro do que depender inteiramente de etapas manuais não documentadas realizadas por meio de uma interface gráfica.

Como instalar o Flow CLI

O Flow CLI pode ser instalado no macOS, Windows e na maioria dos sistemas Linux.

Os desenvolvedores devem seguir as instruções oficiais de instalação do Flow CLI, pois os binários disponíveis e as versões de sistemas operacionais compatíveis podem mudar.

No macOS, um comando de instalação comum é

.

Normalmente, uma instalação via Homebrew pode ser atualizada com

.

Também são fornecidos scripts oficiais de instalação para ambientes compatíveis com Linux, macOS e Windows.

Antes de executar um script de instalação com permissões elevadas no sistema, o desenvolvedor deve revisá-lo.

Instalar software diretamente de um site não verificado ou de uma mensagem copiada das redes sociais pode expor o computador, as chaves privadas e os arquivos do projeto a códigos maliciosos.

Após a instalação, o desenvolvedor deve executar

e para confirmar que o executável funciona e está disponível no caminho do sistema.

Como iniciar um projeto Flow

O principal comando para criar um projeto Flow é

.

Esse comando cria a estrutura do projeto e gera um arquivo central de configuração chamado

.

As versões atuais do Flow CLI podem oferecer estruturas iniciais para diferentes tipos de aplicativos, incluindo projetos Cadence básicos e fluxos de trabalho blockchain mais especializados.

Uma estrutura inicial pode incluir diretórios para contratos inteligentes, transações, scripts, testes e configurações do projeto.

O guia oficial de inicialização de projetos explica como

cria os arquivos necessários para um novo ambiente de desenvolvimento.

Os desenvolvedores devem inspecionar o projeto gerado, em vez de presumir que todas as configurações padrão são adequadas para produção.

Endereços de rede, aliases de contas, dependências, configurações de signatários e destinos de implantação devem ser verificados antes do envio de transações reais.

O que é flow.json?

é o arquivo central de configuração usado pelo Flow CLI.

Ele descreve as redes, contas, contratos, dependências, destinos de implantação e caminhos do projeto que a CLI deve usar.

A referência oficial de configuração do flow.json explica as seções e os formatos disponíveis.

A seção

define conexões com ambientes como o emulador, a testnet e a mainnet.

A seção

associa nomes de contas legíveis a endereços Flow e configurações de chaves de assinatura.

A seção

associa nomes de contratos Cadence a arquivos-fonte e endereços específicos de cada rede.

A seção

identifica quais contratos devem ser implantados em quais contas em cada rede.

Um arquivo de configuração bem mantido permite que a mesma importação Cadence corresponda a endereços diferentes no emulador, na testnet e na mainnet.

Isso evita que os desenvolvedores incluam diretamente o endereço de contrato de uma rede em todos os arquivos-fonte.

As equipes devem revisar as alterações em

por meio do controle de versão, pois um destino de implantação ou alias de conta alterado pode enviar uma transação ao ambiente errado.

O flow.json armazena chaves privadas?

O Flow CLI permite configurações que contêm informações de chaves privadas, mas é perigoso inserir uma chave de produção sem criptografia diretamente em um arquivo

compartilhado.

Uma chave privada permite que seu detentor autorize transações de blockchain para a conta Flow associada, de acordo com o peso da chave e a configuração da conta.

Se o arquivo de configuração for enviado a um repositório público, um invasor poderá obter controle sobre contratos, tokens e recursos administrativos.

As opções de configuração atuais do Flow CLI incluem chaves hexadecimais diretas, arquivos de chaves externos, derivação baseada em frase mnemônica e integração com o Google Cloud KMS.

O uso de um sistema externo de gerenciamento de chaves pode reduzir a necessidade de expor material bruto de assinatura nos arquivos locais do projeto.

Arquivos de chaves, configurações específicas de ambientes e outros segredos devem ser excluídos do controle de versão público.

Os desenvolvedores também devem separar as chaves do emulador das chaves da testnet e da mainnet.

A chave de serviço padrão do emulador é conhecida publicamente e só é segura porque o emulador é uma rede local de desenvolvimento sem ativos reais.

Quais redes o Flow CLI pode usar?

O Flow CLI pode interagir com o Flow Emulator local, a Flow Testnet, a Flow Mainnet e endpoints personalizados de nós de acesso da Flow.

O emulador se destina ao desenvolvimento local privado.

A testnet é um ambiente público para testar aplicativos sem usar ativos de produção da Flow.

A mainnet é a blockchain de produção, na qual as transações podem afetar contas reais, contratos implantados e criptoativos.

Muitos comandos aceitam a opção

, que identifica o ambiente de destino.

Por exemplo, o desenvolvedor pode usar

, ou .

Não especificar ou verificar a rede pode fazer com que uma implantação ou transação seja enviada a um destino diferente do pretendido.

Os scripts de produção devem especificar claramente a rede selecionada e exigir verificações adicionais antes de usar signatários da mainnet.

O que é o Flow Emulator?

O Flow Emulator é uma rede local leve que reproduz comportamentos importantes da blockchain Flow para desenvolvimento e testes.

Ele vem incluído no Flow CLI e pode ser iniciado com

.

A documentação oficial do Flow Emulator o descreve como um ambiente local para executar transações, implantar contratos e testar aplicativos antes de usar uma rede pública.

Como o emulador é executado localmente, os desenvolvedores podem redefinir seu estado, inspecionar registros detalhados e testar falhas sem gastar criptomoedas reais.

O emulador inclui uma conta de serviço capaz de criar contas, assinar transações e implantar contratos no ambiente local.

Sua chave privada não é adequada para a mainnet, pois é intencionalmente pública e previsível.

O emulador oferece compatibilidade quase completa com a API de acesso da Flow, mas os desenvolvedores não devem presumir que todas as condições de produção podem ser reproduzidas perfeitamente em um único computador.

A latência da rede pública, o comportamento dos validadores, o congestionamento da rede, os serviços externos e as configurações de contas de produção podem gerar resultados diferentes.

Como funciona o fluxo de desenvolvimento local?

Um fluxo de trabalho comum com o Flow CLI começa pela criação de um projeto usando

.

Em seguida, o desenvolvedor inicia uma blockchain local com

.

Os contratos Cadence são adicionados ao projeto e associados no

.

O desenvolvedor implanta os contratos nas contas do emulador e executa transações ou scripts de teste.

Os testes automatizados podem ser executados com

.

Após a aprovação dos testes locais, o projeto pode ser implantado na testnet para testes em uma rede pública compartilhada.

A implantação na mainnet só deve ocorrer depois da revisão do código, da configuração de contas, das permissões dos signatários, das dependências e do plano de implantação.

Como o Flow CLI implanta contratos inteligentes?

O Flow CLI pode implantar contratos inteligentes Cadence em contas definidas na configuração do projeto.

O comando de implantação no nível do projeto é

.

A documentação oficial de implantação explica que esse comando lê os contratos e os destinos de implantação definidos em

.

O desenvolvedor pode especificar a rede desejada durante a implantação.

Por exemplo,

implanta os contratos configurados no projeto no ambiente local.

Ao mudar a rede para testnet ou mainnet, a CLI usa as contas, os aliases e a configuração dos nós de acesso correspondentes.

A implantação de um contrato inteligente é uma transação de blockchain e, portanto, exige autorização de uma conta com as permissões de chave apropriadas.

Uma implantação pode falhar devido a código Cadence inválido, importações não resolvidas, permissões insuficientes na conta, chave de assinatura incorreta ou problema de conexão com a rede.

A implantação na mainnet pode ter consequências permanentes. Por isso, os desenvolvedores devem verificar o código do contrato e o endereço da conta antes de assinar.

O Flow CLI pode atualizar um contrato existente?

O Flow CLI pode enviar transações de atualização de contratos que já estejam armazenados em uma conta Flow.

A atualização precisa ser autorizada por uma chave com peso suficiente na conta proprietária do contrato.

As atualizações de contratos Cadence estão sujeitas às regras da linguagem e da rede, que protegem os recursos armazenados e o estado existente do aplicativo.

Ainda assim, uma atualização pode introduzir bugs, interromper aplicativos dependentes ou alterar o comportamento esperado, mesmo que a transação seja tecnicamente válida.

Os desenvolvedores devem executar testes de migração e confirmar a compatibilidade com os dados existentes da conta antes de atualizar um contrato de produção.

As orientações oficiais de implantação de contratos Flow explicam a configuração de contas, a implantação e os aspectos a considerar em atualizações de contratos.

O que é Cadence?

Cadence é uma linguagem de programação de contratos inteligentes projetada para a blockchain Flow.

Ela utiliza conceitos de programação orientada a recursos para representar criptoativos e outros valores que não devem ser copiados ou perdidos acidentalmente.

O Flow CLI inclui as ferramentas necessárias para executar, testar, analisar, implantar e interagir com código Cadence.

As versões do CLI e da Cadence precisam permanecer compatíveis, pois mudanças na linguagem podem afetar a análise sintática, a verificação de tipos, a execução e o comportamento dos contratos.

Na versão 2.17.4 do Flow CLI, a versão incluída da Cadence é a 1.10.3.

Os desenvolvedores podem aprender sobre o comportamento atual da linguagem na documentação oficial da Cadence.

Qual é a diferença entre um script Cadence e uma transação?

Um script Cadence lê o estado da blockchain sem alterá-lo permanentemente.

Um script pode consultar o saldo de uma conta, ler um campo público de um contrato, calcular um resultado ou inspecionar recursos públicos armazenados.

Scripts não exigem autorização de transação, pois não podem modificar o estado da blockchain.

Uma transação Cadence pode alterar o estado da blockchain.

Transações podem transferir criptoativos, criar recursos, chamar funções de contratos, modificar o armazenamento de uma conta ou executar outras ações autorizadas.

Uma transação precisa ser assinada pelas contas que atuam como pagador, proponente ou autorizador.

O Flow CLI oferece grupos de comandos distintos para executar scripts e enviar transações.

Essa distinção é importante porque o envio de uma transação envolve riscos de autorização, taxas e alterações de estado que não se aplicam da mesma forma a um script somente de leitura.

Como o Flow CLI envia transações?

O Flow CLI pode criar, assinar, enviar e consultar transações Flow.

Um comando de transação identifica o arquivo da transação Cadence, os argumentos, a configuração dos signatários e a rede de destino.

A CLI usa as informações de conta do

ou opções de linha de comando para criar as assinaturas necessárias.

Após o envio, uma transação Flow passa por vários status até chegar a um resultado final selado.

Uma transação pode falhar após o envio se sua execução Cadence gerar um erro.

O desenvolvedor deve inspecionar o resultado, os eventos emitidos e as mensagens de erro, em vez de tratar o envio como prova de sucesso.

A sintaxe exata dos comandos e as opções disponíveis estão listadas na visão geral oficial dos comandos do Flow CLI.

Como o Flow CLI gerencia contas?

As contas Flow podem conter criptoativos, contratos inteligentes, recursos armazenados, capacidades públicas e uma ou mais chaves públicas.

O Flow CLI pode criar contas, consultar detalhes, inspecionar chaves, adicionar ou revogar chaves e implantar contratos em contas autorizadas.

O modelo de contas separa um endereço Flow de qualquer chave pública individual.

Uma conta pode conter várias chaves com pesos, algoritmos de assinatura, algoritmos de hash e números de sequência diferentes.

Esse design permite rotação de chaves, uso de vários dispositivos, controle compartilhado e outros modelos de autorização.

A documentação oficial de contas Flow explica como as contas Flow diferem dos modelos de endereço em que uma única chave determina permanentemente um endereço.

Revogar uma chave comprometida só pode proteger uma conta se outras chaves válidas ainda fornecerem peso de autorização suficiente.

Os desenvolvedores devem testar os procedimentos de gerenciamento de chaves antes de usá-los em contas de produção com alto valor.

Como o Flow CLI lida com chaves criptográficas?

O Flow CLI inclui comandos para gerar e decodificar chaves compatíveis com Flow.

Também oferece comandos para criar e verificar assinaturas digitais.

A geração de chaves precisa usar aleatoriedade segura, pois uma chave privada previsível pode ser reconstruída por um invasor.

Uma chave privada nunca deve ser colada em uma questão pública, gravação compartilhada do terminal, mensagem de chat ou repositório de código-fonte.

O histórico da linha de comando também pode expor segredos quando chaves privadas são fornecidas diretamente como argumentos de comandos.

Sistemas de produção devem preferir arquivos de chave com permissões restritas, armazenamento protegido por hardware ou um serviço compatível de gerenciamento de chaves.

Os backups de chaves devem ser protegidos, pois perder todas as chaves válidas pode eliminar permanentemente a capacidade de controlar a conta.

O que é o gerenciador de dependências do Flow CLI?

O gerenciador de dependências do Flow CLI instala e acompanha contratos Cadence externos usados por um projeto.

Contratos inteligentes dependem frequentemente de padrões, interfaces e implementações implantados em outros locais da rede Flow.

O gerenciador de dependências pode recuperar o código-fonte dos contratos e atualizar a configuração do projeto para que as importações sejam resolvidas corretamente.

O comando

mostra as dependências registradas atualmente em um projeto.

O comando

pode instalar uma dependência a partir de um local de rede compatível.

A documentação oficial de gerenciamento de dependências explica como instalar, inspecionar e gerenciar dependências de contratos.

Os desenvolvedores devem revisar o código e os endereços das dependências, em vez de presumir que todo contrato on-chain é seguro.

Uma dependência maliciosa ou identificada incorretamente pode introduzir comportamentos não autorizados em um aplicativo descentralizado.

As equipes também devem considerar se outro endereço poderá atualizar um contrato importado após a implantação do aplicativo.

Como o Flow CLI testa contratos inteligentes Cadence?

O Flow CLI inclui o Cadence Testing Framework e executa arquivos de teste com o comando

.

Os testes podem verificar contratos inteligentes, scripts, transações, eventos emitidos, alterações em contas e falhas esperadas.

O sistema de testes usa o Flow Emulator nos bastidores do ambiente de teste Cadence.

Isso permite criar contas, implantar contratos, enviar transações e inspecionar o estado sem afetar uma blockchain pública.

O guia oficial de testes Cadence explica os fluxos de testes unitários e de integração.

Os testes de integração são especialmente úteis porque podem revelar problemas relacionados à configuração de contas, autorização de transações, importações, capacidades e movimentação de recursos.

Uma alta porcentagem de cobertura de código não prova que um contrato é seguro, pois os testes podem deixar de verificar as premissas mais perigosas.

Contratos críticos para a segurança também devem passar por revisão manual, testes adversariais e auditoria independente quando apropriado.

O que são testes com fork no Flow CLI?

Os testes com fork criam um ambiente local de desenvolvimento capaz de ler o estado da Flow Mainnet ou Testnet enquanto executa alterações localmente.

Isso permite testar código com contratos implantados, endereços e estado real da blockchain sem modificar a rede pública original.

O desenvolvedor pode iniciar um fork baseado na mainnet com um comando como

.

O guia oficial de testes com fork da Flow explica como o emulador local replica o estado de outra rede Flow.

Os testes com fork são úteis quando um aplicativo depende de contratos ou dados de contas que seriam difíceis de reproduzir manualmente.

Também podem ajudar a identificar problemas de compatibilidade antes de uma atualização de contrato de produção.

Um ambiente com fork não é o mesmo que criar um fork permanente da blockchain Flow.

É uma cópia privada para testes, cujas transações locais não alteram a mainnet nem a testnet.

Os desenvolvedores ainda devem verificar a altura do bloco e a rede selecionada, pois os resultados podem mudar quando o estado de produção se altera.

O que é linting no Flow CLI?

O linting analisa o código-fonte em busca de possíveis erros, padrões inseguros, problemas de formatação e outras questões, sem implantar o contrato.

O Flow CLI oferece o comando

para projetos Cadence.

O linting pode identificar alguns problemas no início do desenvolvimento e ser incluído em verificações automatizadas.

As versões atuais oferecem uma opção de diretório-base para projetos que armazenam arquivos Cadence fora do local padrão.

Um resultado de linting bem-sucedido não comprova que a lógica de negócios, o controle de acesso, os incentivos econômicos ou o gerenciamento de recursos estejam corretos.

O linting deve ser usado junto com testes, revisão de código e monitoramento em produção.

Como o Flow CLI consulta dados da blockchain?

O Flow CLI pode consultar contas, blocos, coleções, eventos, transações, resultados de execução e outras informações disponibilizadas pela API de acesso da Flow.

O comando

pode consultar um bloco por identificador, altura ou pelo bloco mais recente disponível.

O comando

recupera informações de uma conta Flow.

Os comandos de eventos podem consultar eventos emitidos em um intervalo de blocos selecionado.

Os comandos de transação podem inspecionar o status e o resultado de uma transação enviada.

Esses recursos são úteis para desenvolvimento, depuração, monitoramento e investigações simples da blockchain.

A CLI não é um indexador histórico completo, pois os nós de acesso e os serviços especializados de indexação podem oferecer diferentes recursos de consulta.

Um aplicativo de análise de grande porte normalmente precisará de um banco de dados, serviço de processamento de eventos ou outra infraestrutura dedicada além dos comandos da CLI.

O que são Flow Interaction Templates?

Flow Interaction Templates fornecem descrições padronizadas de transações e scripts Cadence.

Às vezes, são chamados de modelos FLIX.

Um modelo pode descrever o código de interação, os argumentos, as dependências e os metadados necessários para que carteiras ou aplicativos compreendam uma operação.

O Flow CLI inclui comandos FLIX para executar, gerar e empacotar interações compatíveis.

Os modelos podem aumentar a consistência entre desenvolvedores de aplicativos, carteiras e contratos inteligentes.

Os usuários ainda precisam verificar o código e os argumentos da transação antes de assinar, pois um modelo não elimina os riscos de contratos inteligentes ou de carteira.

O que são comandos de transações agendadas?

As versões atuais do Flow CLI incluem comandos para interagir com transações agendadas da Flow.

As transações agendadas permitem que contratos inteligentes programem uma execução autônoma futura de acordo com as regras de agendamento da rede.

Possíveis usos em cripto incluem transferências recorrentes, ações de contratos com atraso, lógica financeira automatizada e comportamentos de aplicativos baseados em tempo.

O comando

pode criar o recurso de gerenciamento necessário para controlar transações agendadas de uma conta.

Comandos adicionais podem listar, inspecionar e cancelar as transações agendadas compatíveis.

A documentação oficial sobre transações agendadas explica os requisitos de configuração, as prioridades e o comportamento dos comandos.

Agendar uma transação não garante um resultado econômico favorável, pois os preços dos ativos, os saldos das contas, o estado dos contratos e as condições da rede podem mudar antes da execução.

O que é o Flowser?

Flowser é um explorador visual que pode ser usado com um ambiente local do Flow Emulator.

O Flow CLI inclui um comando para iniciar o Flowser quando os componentes necessários estão disponíveis.

A interface ajuda os desenvolvedores a inspecionar contas locais, contratos, blocos, transações e eventos sem consultar cada item manualmente.

O Flowser complementa a linha de comando, mas não substitui testes automatizados nem a revisão do código-fonte.

Um resultado exibido em um explorador local corresponde ao estado atual do emulador e não deve ser confundido com atividade na mainnet.

O que é a Flow Dev Wallet?

A Flow Dev Wallet é uma ferramenta de desenvolvimento usada para testar a autorização de carteiras e as interações com aplicativos.

O Flow CLI pode iniciar um ambiente de carteira de desenvolvimento para fluxos de trabalho locais compatíveis.

O desenvolvedor pode usá-la para simular login, autorização de contas, aprovação de transações e outros comportamentos de carteira durante a criação de um aplicativo descentralizado.

A Dev Wallet não se destina a proteger ativos valiosos de produção.

Aplicativos de produção devem integrar carteiras de usuários apropriadas e seguir práticas seguras de autenticação e revisão de transações.

O Flow CLI é compatível com Flow EVM?

A Flow oferece suporte a contratos inteligentes Cadence e a um ambiente Ethereum Virtual Machine, mas o Flow CLI é principalmente o fluxo oficial de linha de comando para o modelo de desenvolvimento Cadence e da API de acesso da Flow.

Aplicativos Solidity na Flow EVM geralmente usam ferramentas compatíveis com EVM JSON-RPC e um EVM Gateway.

A documentação oficial do Flow EVM Gateway explica que clientes EVM se conectam por meio de um gateway que implementa a especificação Ethereum JSON-RPC.

Aplicativos Cadence também podem interagir com a Flow EVM por meio de Cadence Owned Accounts e contratos de rede.

O desenvolvedor deve escolher as ferramentas conforme o aplicativo seja escrito em Cadence, Solidity ou combine os dois ambientes de execução.

O uso do nome Flow CLI não significa que todas as operações específicas de EVM sejam realizadas com o mesmo conjunto de comandos.

Flow CLI versus um SDK da Flow

O Flow CLI é uma ferramenta de terminal interativa e programável por scripts.

Um kit de desenvolvimento de software da Flow é uma biblioteca de programação importada no código do aplicativo.

A CLI é útil para desenvolvimento local, configuração de projetos, interação manual com redes, testes e automação de implantação.

Um SDK é mais adequado para serviços de back-end, servidores de aplicativos, bots, carteiras, indexadores e outros softwares que precisam se comunicar com a Flow durante a execução.

Uma equipe de desenvolvimento pode usar o Flow CLI para implantar um contrato e depois usar um SDK de JavaScript, Go ou dispositivo móvel para interagir com ele por meio de um aplicativo.

As duas categorias de ferramentas se complementam, em vez de serem substitutas diretas.

Flow CLI versus um ambiente gráfico de desenvolvimento

Um ambiente gráfico de desenvolvimento oferece menus, editores, ferramentas visuais de contas e outros recursos de apontar e clicar.

Os comandos do Flow CLI são mais fáceis de automatizar, salvar em scripts e reproduzir em processos de integração contínua.

Uma ferramenta gráfica pode ser mais acessível para iniciantes, enquanto uma CLI pode oferecer mais controle e transparência em fluxos de trabalho repetíveis.

Muitos desenvolvedores usam as duas abordagens: editam Cadence em um ambiente de desenvolvimento integrado e executam comandos do Flow CLI em um terminal incorporado.

A extensão oficial Cadence pode oferecer suporte à sintaxe e auxílio ao desenvolvimento, enquanto o Flow CLI cuida da execução e da implantação.

O Flow CLI pode ser usado em integração contínua?

Os comandos do Flow CLI podem ser incluídos em fluxos de trabalho de integração e implantação contínuas.

Um pipeline pode instalar uma versão fixada da CLI, analisar arquivos Cadence, executar testes, inicializar um emulador, implantar contratos de teste e verificar as transações esperadas.

A implantação automatizada na mainnet exige controles muito mais rigorosos do que os testes automatizados.

As chaves privadas devem ser armazenadas em um sistema seguro de gerenciamento de segredos, e não diretamente no arquivo do pipeline.

A implantação em produção pode exigir aprovação manual, artefatos de lançamento assinados, branches protegidas e vários revisores.

O pipeline deve falhar quando os testes, verificações de lint, verificações de implantação ou verificações dos resultados das transações não produzirem os resultados esperados.

As equipes também devem registrar quais versões do Flow CLI e da Cadence foram usadas em cada lançamento.

O Flow CLI coleta dados de uso?

Atualmente, o Flow CLI coleta por padrão contagens agregadas de uso de comandos por meio do Mixpanel.

A documentação oficial informa que valores de argumentos e sinalizadores dos comandos não são coletados por esse sistema de contagem de uso.

Os usuários podem desativar a coleta de métricas com

.

As métricas podem ser ativadas novamente com

.

A página oficial de coleta de dados do Flow CLI explica o que é coletado e como alterar a configuração.

Organizações com requisitos de privacidade, conformidade ou compilação isolada devem revisar o comportamento da telemetria antes de instalar a CLI em ambientes controlados.

Práticas recomendadas de segurança do Flow CLI

Os desenvolvedores devem instalar o Flow CLI somente por meio da documentação oficial ou de arquivos de lançamento verificados.

Devem verificar a rede selecionada antes de assinar ou implantar qualquer transação.

As chaves privadas da mainnet não devem ser armazenadas em texto simples em arquivos públicos do projeto.

Devem ser usadas contas e chaves separadas para desenvolvimento local, testes, administração de contratos, controle do tesouro e atividade rotineira dos aplicativos.

As contas de produção devem usar pesos de chave apropriados e evitar depender de um único laptop de desenvolvedor desprotegido.

As importações de contratos e os endereços de dependências devem ser verificados em cada rede.

Antes do envio, as transações devem ser revisadas quanto às funções dos signatários, aos argumentos, aos limites de gas e aos contratos de destino.

Os desenvolvedores devem inspecionar o resultado selado da transação, em vez de presumir que uma transação enviada foi bem-sucedida.

As versões da CLI devem ser testadas antes de serem atualizadas em fluxos de trabalho de produção.

Chaves de conta antigas ou não utilizadas devem ser revogadas quando houver um caminho seguro de autorização substituto.

Frases de recuperação e chaves privadas nunca devem ser inseridas em sites que afirmem ser necessárias para ativar o Flow CLI.

Erros comuns do Flow CLI

Um erro de conexão pode indicar que o emulador não está em execução, que o endereço do nó de acesso está incorreto, que a porta selecionada está indisponível ou que não é possível acessar um serviço de rede.

Um erro de autorização pode decorrer de uma chave privada, índice de chave, número de sequência, algoritmo de assinatura, algoritmo de hash ou endereço de conta incorretos.

Um erro de importação pode ocorrer quando falta um alias de contrato Cadence ou quando ele aponta para um endereço da rede errada.

Um erro de implantação pode resultar de código Cadence inválido, versão de linguagem incompatível, dependências ausentes ou autorização insuficiente da conta.

Uma transação pode falhar quando um argumento tem tipo Cadence incorreto ou quando a conta não possui o recurso ou a capacidade necessários.

Um erro de número de sequência pode ocorrer quando várias transações tentam usar a mesma chave de proponente quase ao mesmo tempo.

Os desenvolvedores devem ler toda a saída de erro, confirmar a rede ativa e usar a opção

do comando antes de alterar configurações não relacionadas do projeto.

Usos comuns do Flow CLI

O Flow CLI pode ser usado para criar e configurar um novo projeto Cadence.

Pode executar uma blockchain local para desenvolvimento de contratos inteligentes.

Pode criar contas e gerenciar chaves de contas.

Pode implantar e atualizar contratos Cadence.

Pode executar scripts somente de leitura e transações assinadas.

Pode instalar dependências de contratos e gerenciar aliases de rede.

Pode executar testes unitários, testes de integração, verificações de lint e testes com fork do estado da mainnet.

Pode consultar blocos, transações, contas, coleções e eventos.

Pode apoiar pipelines automatizados de compilação e implantação.

Também pode ajudar os desenvolvedores a reproduzir operações de blockchain ao investigar erros de aplicativos.

Limitações do Flow CLI

O Flow CLI não torna automaticamente seguro um contrato inteligente.

Ele não impede que um desenvolvedor assine uma transação prejudicial ou implante código na conta errada.

Não substitui auditoria profissional, modelagem de ameaças, projeto de controle de acesso nem monitoramento operacional.

O emulador local não reproduz perfeitamente todas as condições de uma rede pública.

A CLI também não é uma interface completa de carteira destinada a consumidores comuns.

Ela não oferece um banco de dados completo de análise histórica de todas as transações da Flow.

Os desenvolvedores ainda precisam compreender Cadence, contas Flow, funções de transação, capacidades, armazenamento de recursos, dependências e segurança de rede.

Perguntas frequentes

O que significa Flow CLI?

Flow CLI significa Flow Command-Line Interface, a ferramenta oficial de desenvolvimento em terminal para a blockchain Flow.

O Flow CLI foi criado pela Dapper Labs?

A Flow foi originalmente projetada e desenvolvida pela Dapper Labs, enquanto o Flow CLI é mantido atualmente como software oficial de código aberto do ecossistema Flow pela organização Onflow.

O Flow CLI é uma carteira de criptomoedas?

Não. O Flow CLI é uma ferramenta para desenvolvedores, embora possa usar chaves privadas configuradas para assinar transações e gerenciar contas Flow.

Qual é a versão mais recente do Flow CLI?

Em 14 de julho de 2026, o lançamento oficial mais recente é a versão 2.17.4 do Flow CLI.

Qual versão da Cadence acompanha o Flow CLI 2.17.4?

O Flow CLI versão 2.17.4 inclui a versão 1.10.3 da Cadence.

Como instalo o Flow CLI no macOS?

Um método comum é executar

pelo Homebrew.

Como verifico a versão do Flow CLI?

Execute

em um terminal.

Como crio um novo projeto Flow?

Execute

e selecione uma estrutura inicial de projeto adequada.

O que é flow.json?

é o principal arquivo de configuração do projeto. Ele define redes, contas, contratos, dependências e destinos de implantação.

Como inicio o Flow Emulator?

Execute

no terminal.

O Flow Emulator usa FLOW real?

Não. O emulador local usa estado e ativos de desenvolvimento sem valor na mainnet.

O Flow CLI pode implantar contratos na mainnet?

Sim. O Flow CLI pode implantar contratos na Flow Mainnet quando são fornecidos a rede, a conta, a chave e a configuração de implantação corretas.

Qual comando implanta um projeto Flow?

O comando padrão de implantação de projetos é

, normalmente acompanhado de uma opção explícita de rede.

O Flow CLI pode atualizar contratos inteligentes?

Sim. Ele pode enviar transações autorizadas de atualização de contratos, sujeitas às regras da Cadence e da rede Flow.

Como executo testes Cadence?

Execute

em um projeto Flow configurado.

O que são testes com fork da Flow?

Os testes com fork executam um ambiente local com uma cópia do estado da mainnet ou da testnet, sem alterar a blockchain pública.

O Flow CLI é compatível com a criação de contas?

Sim. O Flow CLI pode criar e consultar contas Flow e gerenciar suas chaves.

O Flow CLI pode ler dados da blockchain?

Sim. Pode consultar blocos, contas, transações, eventos, coleções e outros dados disponíveis pelos nós de acesso da Flow.

Qual é a diferença entre um script Flow e uma transação?

Um script lê o estado sem alterar a blockchain, enquanto uma transação é assinada e pode modificar o estado da blockchain.

O Flow CLI pode gerenciar dependências de contratos?

Sim. Seu gerenciador de dependências pode instalar, listar e acompanhar contratos Cadence externos usados por um projeto.

O Flow CLI coleta telemetria?

Atualmente, o Flow CLI coleta contagens agregadas de comandos por padrão, e os usuários podem desativar o recurso com

.

As chaves privadas devem ser armazenadas no flow.json?

Chaves privadas de produção não devem ser armazenadas como texto sem criptografia em um arquivo

compartilhado ou público.

O Flow CLI pode ser usado em implantações automatizadas?

Sim, mas implantações de produção devem usar versões fixadas, segredos protegidos, controles de revisão e verificação explícita da rede.

O Flow CLI funciona com a Flow Testnet?

Sim. A testnet é um dos ambientes padrão compatíveis com a configuração de redes do Flow CLI.

O Flow CLI é usado para desenvolvimento em Solidity?

O Flow CLI oferece principalmente suporte a fluxos de trabalho Cadence e da API de acesso da Flow, enquanto aplicativos Solidity na Flow EVM geralmente usam ferramentas JSON-RPC compatíveis com EVM.

O Flow CLI é de código aberto?

Sim. O código-fonte do Flow CLI está disponível publicamente sob a licença Apache 2.0.

O uso do Flow CLI pode causar perda de criptomoedas?

Sim. Chaves, redes, endereços, código de contratos ou argumentos de transação incorretos podem causar perdas irreversíveis na mainnet.

Conclusão

O Flow CLI é a ferramenta oficial de desenvolvimento por linha de comando para criar aplicativos e interagir com a blockchain Flow.

Sua conexão com a Dapper Labs decorre do projeto e desenvolvimento originais da Flow pela empresa, enquanto a CLI agora funciona como software de código aberto do ecossistema Flow.

A ferramenta reúne inicialização de projetos, acesso ao emulador, testes Cadence, gerenciamento de contas, operações com chaves, implantação de contratos, gerenciamento de dependências, envio de transações e consultas à blockchain.

O sistema de configuração

permite que os desenvolvedores gerenciem ambientes consistentes no emulador, na testnet, na mainnet e em forks de redes locais.

O Flow CLI pode tornar o desenvolvimento de blockchain mais repetível, mas não elimina os riscos de chaves inseguras, contratos defeituosos, destinos de implantação incorretos, dependências maliciosas ou transações irreversíveis.

Os desenvolvedores devem usar versões oficiais, proteger credenciais de assinatura, testar em vários ambientes, inspecionar os resultados das transações e aplicar controles rigorosos de revisão antes de implantar na Flow Mainnet.