Flow CLI (Dapper Labs)

¿Qué es Flow CLI?

Flow CLI es la interfaz de línea de comandos oficial para desarrollar aplicaciones e interactuar con la blockchain Flow.

CLI son las siglas de «command-line interface» (interfaz de línea de comandos): significa que los desarrolladores controlan la herramienta introduciendo comandos de texto en un terminal, en lugar de hacer clic en botones de una aplicación gráfica.

Flow CLI puede inicializar proyectos blockchain, ejecutar una red Flow local, probar código Cadence, desplegar contratos inteligentes, enviar transacciones, ejecutar scripts, gestionar cuentas, generar claves, instalar dependencias de contratos y obtener datos de la blockchain.

Proporciona un flujo de desarrollo común para Flow Emulator local, Flow Testnet y Flow Mainnet.

La herramienta está destinada principalmente a desarrolladores de contratos inteligentes, equipos de aplicaciones descentralizadas, ingenieros de infraestructura, testers y otros usuarios técnicos que crean soluciones en Flow.

Flow CLI no es una criptomoneda, una wallet cripto, un nodo blockchain, una aplicación para consumidores ni un producto de trading.

Es software para desarrolladores que se comunica con Flow Access Nodes y servicios de desarrollo locales.

La documentación oficial de Flow CLI la describe como una herramienta para gestionar proyectos, cuentas, contratos, transacciones, dependencias y consultas a la blockchain desde una misma interfaz.

¿Qué relación hay entre Flow CLI y Dapper Labs?

Flow fue diseñada y desarrollada originalmente por Dapper Labs; por eso, a veces se busca Flow CLI como «Flow CLI Dapper Labs».

Dapper Labs creó Flow para respaldar aplicaciones blockchain dirigidas a grandes audiencias de consumidores, sin obligar a cada aplicación a competir por los mismos recursos de procesamiento limitados.

La historia oficial de Flow y Cadence identifica a Dapper Labs como diseñador y desarrollador original de la blockchain.

Flow CLI se distribuye ahora como software de código abierto a través de la organización Onflow y forma parte del ecosistema de desarrollo más amplio de Flow.

El repositorio oficial de código fuente de la herramienta está disponible públicamente bajo la licencia Apache 2.0.

Por tanto, Flow CLI debe entenderse como una herramienta oficial de la red Flow, no como una aplicación privada para consumidores operada exclusivamente dentro de Dapper Labs.

¿Cuál es la última versión de Flow CLI?

A fecha de 14 de julio de 2026, la última versión publicada de Flow CLI es la 2.17.4.

La versión 2.17.4 se publicó el 4 de junio de 2026 y actualizó la herramienta a Cadence 1.10.3.

La versión también actualizó los componentes de los contratos principales de Flow incluidos en el paquete para que fueran compatibles con Cadence 1.10.3.

Los desarrolladores pueden confirmar la versión actual en la página oficial de versiones de Flow CLI.

La información de versiones puede cambiar con frecuencia, ya que CLI debe seguir siendo compatible con las nuevas versiones de Cadence, las actualizaciones del emulador, los contratos principales, las funciones de red y las correcciones de seguridad.

Para comprobar la versión instalada localmente, se puede ejecutar

en un terminal.

Los equipos de producción deben utilizar una versión de CLI probada y fijada en sus sistemas automatizados de compilación, en lugar de cambiarla automáticamente con cada despliegue.

¿Por qué es importante Flow CLI?

Desarrollar para una blockchain implica algo más que escribir un archivo de contrato inteligente.

También hay que crear cuentas, gestionar claves, resolver direcciones de contratos, enviar transacciones firmadas, inspeccionar resultados, probar condiciones de error y desplegar código en la red correcta.

Flow CLI reúne estas tareas en una herramienta coherente.

Reduce la necesidad de construir manualmente solicitudes sin procesar a Flow Access Nodes para las operaciones habituales de desarrollo.

CLI también permite repetir comandos, algo útil para las pruebas, los scripts de despliegue, la integración continua y la colaboración entre equipos.

Un comando guardado en un script de despliegue se puede revisar y ejecutar de forma coherente en distintos entornos de desarrollo.

Esto es más seguro que depender por completo de pasos manuales no documentados realizados mediante una interfaz gráfica.

Cómo instalar Flow CLI

Flow CLI se puede instalar en macOS, Windows y la mayoría de los sistemas Linux.

Los desarrolladores deben seguir las instrucciones oficiales de instalación de Flow CLI, ya que los binarios disponibles y las versiones de sistemas operativos compatibles pueden cambiar.

En macOS, un comando habitual de instalación es

.

Normalmente, una instalación con Homebrew se puede actualizar con

.

También se proporcionan scripts de instalación oficiales para los entornos compatibles de Linux, macOS y Windows.

Antes de ejecutar un script de instalación con permisos elevados del sistema, el desarrollador debe revisarlo.

Instalar software directamente desde un sitio web no verificado o un mensaje copiado de redes sociales puede exponer un ordenador, las claves privadas y los archivos del proyecto a código malicioso.

Tras la instalación, el desarrollador debe ejecutar

y para confirmar que el ejecutable funciona y está disponible en la ruta del sistema.

Cómo iniciar un proyecto de Flow

El comando principal para crear un proyecto Flow es

.

Este comando crea la estructura del proyecto y genera un archivo de configuración central llamado

.

Las versiones actuales de Flow CLI pueden ofrecer plantillas de proyecto para distintos tipos de aplicaciones, incluidos proyectos Cadence básicos y flujos de trabajo blockchain más especializados.

Una plantilla puede incluir directorios para contratos inteligentes, transacciones, scripts, pruebas y configuración del proyecto.

La guía oficial de inicialización de proyectos explica cómo

crea los archivos necesarios para un nuevo entorno de desarrollo.

Los desarrolladores deben revisar el proyecto generado, en lugar de dar por hecho que todos los ajustes predeterminados son adecuados para producción.

Hay que comprobar las direcciones de red, los alias de cuenta, las dependencias, la configuración de los firmantes y los destinos de despliegue antes de enviar transacciones reales.

¿Qué es flow.json?

es el archivo de configuración central que utiliza Flow CLI.

Describe las redes, cuentas, contratos, dependencias, destinos de despliegue y rutas del proyecto que debe utilizar CLI.

La referencia oficial de configuración de flow.json explica las secciones y los formatos disponibles.

La sección

define las conexiones con entornos como el emulador, testnet y mainnet.

La sección

asigna nombres de cuenta legibles a direcciones Flow y configuraciones de claves de firma.

La sección

vincula nombres de contratos Cadence con archivos de código fuente y direcciones específicas de cada red.

La sección

indica qué contratos deben desplegarse en qué cuentas de cada red.

Un archivo de configuración bien mantenido permite que la misma importación Cadence resuelva distintas direcciones en el emulador, testnet y mainnet.

Así se evita codificar de forma fija la dirección de un contrato de una red en todos los archivos de código fuente.

Los equipos deben revisar los cambios en

mediante control de versiones, ya que modificar un destino de despliegue o un alias de cuenta puede enviar una transacción al entorno equivocado.

¿flow.json almacena claves privadas?

Flow CLI admite configuraciones que contienen información de claves privadas, pero incluir directamente una clave de producción sin cifrar en un archivo

compartido es peligroso.

Una clave privada permite a quien la posee autorizar transacciones blockchain para la cuenta Flow asociada, de acuerdo con el peso de la clave y la configuración de la cuenta.

Si el archivo de configuración se sube a un repositorio público, un atacante podría controlar contratos, tokens y capacidades administrativas.

Las opciones de configuración actuales de Flow CLI incluyen claves hexadecimales directas, archivos de claves externos, derivación mediante frase mnemotécnica e integración con Google Cloud KMS.

El uso de un sistema externo de gestión de claves puede reducir la necesidad de exponer el material de firma en bruto a los archivos locales del proyecto.

Los archivos de claves, las configuraciones específicas de cada entorno y otros secretos deben excluirse de los repositorios públicos de control de versiones.

Los desarrolladores también deben separar las claves del emulador de las claves de testnet y mainnet.

La clave de servicio predeterminada del emulador es pública y solo es segura porque el emulador es una red de desarrollo local que no contiene activos reales.

¿Qué redes puede utilizar Flow CLI?

Flow CLI puede interactuar con Flow Emulator local, Flow Testnet, Flow Mainnet y puntos de acceso personalizados de Flow Access Node.

El emulador está pensado para el desarrollo local privado.

Testnet es un entorno público para probar aplicaciones sin utilizar activos de Flow de producción.

Mainnet es la blockchain de producción, donde las transacciones pueden afectar a cuentas reales, contratos desplegados y criptoactivos.

Muchos comandos aceptan una opción

que identifica el entorno de destino.

Por ejemplo, un desarrollador puede utilizar

, o .

No especificar o verificar la red puede hacer que un despliegue o una transacción se envíe a un entorno distinto del previsto.

Los scripts de producción deben indicar expresamente la red seleccionada y exigir comprobaciones adicionales antes de utilizar firmantes de mainnet.

¿Qué es Flow Emulator?

Flow Emulator es una red local ligera que reproduce funciones importantes de la blockchain Flow para el desarrollo y las pruebas.

Se incluye con Flow CLI y se puede iniciar con

.

La documentación oficial de Flow Emulator lo describe como un entorno local para ejecutar transacciones, desplegar contratos y probar aplicaciones antes de utilizar una red pública.

Como el emulador funciona localmente, los desarrolladores pueden restablecer su estado, inspeccionar registros detallados y probar errores sin gastar criptomonedas reales.

El emulador incluye una cuenta de servicio que puede crear cuentas, firmar transacciones y desplegar contratos dentro del entorno local.

Su clave privada no es adecuada para mainnet, ya que es pública e intencionadamente predecible.

El emulador ofrece una compatibilidad de funciones casi completa con Flow Access API, pero los desarrolladores no deben suponer que un solo ordenador puede reproducir a la perfección todas las condiciones de producción.

La latencia de la red pública, el comportamiento de los validadores, la congestión de la red, los servicios externos y las configuraciones de las cuentas de producción pueden producir resultados distintos.

¿Cómo funciona el flujo de desarrollo local?

Un flujo habitual de trabajo con Flow CLI empieza por crear un proyecto con

.

A continuación, el desarrollador inicia una blockchain local con

.

Los contratos Cadence se añaden al proyecto y se vinculan en

.

El desarrollador despliega los contratos en cuentas del emulador y ejecuta transacciones de prueba o scripts.

Las pruebas automatizadas pueden ejecutarse con

.

Cuando las pruebas locales se superan, el proyecto puede desplegarse en testnet para probarlo en una red pública compartida.

El despliegue en mainnet solo debe realizarse después de revisar el código, la configuración de las cuentas, los permisos de los firmantes, las dependencias y el plan de despliegue.

¿Cómo despliega Flow CLI contratos inteligentes?

Flow CLI puede desplegar contratos inteligentes Cadence en las cuentas definidas en la configuración del proyecto.

El comando de despliegue a nivel de proyecto es

.

La documentación oficial sobre despliegues explica que este comando lee los contratos y los destinos de despliegue de

.

Al desplegar, el desarrollador puede especificar la red de destino.

Por ejemplo,

despliega los contratos configurados del proyecto en el entorno local.

Si se cambia la red a testnet o mainnet, CLI utiliza las cuentas, los alias y la configuración de Access Node correspondientes.

El despliegue de un contrato inteligente es una transacción blockchain y, por tanto, requiere la autorización de una cuenta con los permisos de clave adecuados.

Un despliegue puede fallar por código Cadence no válido, importaciones sin resolver, permisos de cuenta insuficientes, una clave de firma incorrecta o problemas de conexión con la red.

Un despliegue en mainnet puede tener consecuencias permanentes, por lo que los desarrolladores deben verificar el código del contrato y la dirección de la cuenta antes de firmar.

¿Puede Flow CLI actualizar un contrato existente?

Flow CLI puede enviar transacciones de actualización para contratos ya almacenados en una cuenta Flow.

La actualización debe estar autorizada por una clave con peso suficiente en la cuenta propietaria del contrato.

Las actualizaciones de contratos Cadence están sujetas a las reglas del lenguaje y de la red que protegen los recursos almacenados y el estado existente de las aplicaciones.

Aun cuando la transacción sea técnicamente válida, una actualización puede introducir errores, interrumpir aplicaciones dependientes o cambiar el comportamiento previsto.

Antes de actualizar un contrato de producción, los desarrolladores deben probar las migraciones y confirmar la compatibilidad con los datos existentes de las cuentas.

La guía oficial de Flow para desplegar contratos explica la configuración de cuentas, el despliegue y las consideraciones para actualizar contratos.

¿Qué es Cadence?

Cadence es un lenguaje de programación de contratos inteligentes diseñado para la blockchain Flow.

Utiliza conceptos de programación orientada a recursos para representar criptoactivos y otros valores que no deben copiarse ni perderse accidentalmente.

Flow CLI incluye las herramientas necesarias para ejecutar, probar, analizar, desplegar e interactuar con código Cadence.

Las versiones de CLI y Cadence deben seguir siendo compatibles, ya que los cambios en el lenguaje pueden afectar al análisis sintáctico, la comprobación de tipos, la ejecución y el comportamiento de los contratos.

A fecha de la versión 2.17.4 de Flow CLI, la versión incluida de Cadence es la 1.10.3.

Los desarrolladores pueden consultar el comportamiento actual del lenguaje en la documentación oficial de Cadence.

¿Cuál es la diferencia entre un script y una transacción Cadence?

Un script Cadence lee el estado de la blockchain sin modificarlo de forma permanente.

Un script puede consultar el saldo de una cuenta, leer un campo público de un contrato, calcular un resultado o inspeccionar capacidades públicas almacenadas.

Los scripts no requieren autorización mediante transacción porque no pueden modificar el estado de la blockchain.

Una transacción Cadence sí puede cambiarlo.

Las transacciones pueden transferir criptoactivos, crear recursos, llamar a funciones de contratos, modificar el almacenamiento de una cuenta o ejecutar otras acciones autorizadas.

La transacción debe estar firmada por las cuentas que desempeñan las funciones de pagador, proponente o autorizador.

Flow CLI ofrece grupos de comandos separados para ejecutar scripts y enviar transacciones.

Esta distinción es importante porque enviar una transacción conlleva riesgos de autorización, comisiones y cambios de estado que no se aplican del mismo modo a un script de solo lectura.

¿Cómo envía transacciones Flow CLI?

Flow CLI puede crear, firmar, enviar y consultar transacciones Flow.

El comando de transacción identifica el archivo de transacción Cadence, los argumentos, la configuración del firmante y la red de destino.

CLI utiliza la información de cuenta de

o las opciones de línea de comandos para crear las firmas necesarias.

Después del envío, una transacción Flow pasa por varios estados antes de alcanzar un resultado final sellado.

Una transacción puede fallar tras enviarse si su ejecución Cadence genera un error.

El desarrollador debe inspeccionar el resultado, los eventos emitidos y los mensajes de error, en lugar de considerar el envío como prueba de éxito.

La sintaxis exacta de los comandos y las opciones disponibles figuran en la descripción oficial de los comandos de Flow CLI.

¿Cómo gestiona las cuentas Flow CLI?

Las cuentas Flow pueden contener criptoactivos, contratos inteligentes, recursos almacenados, capacidades públicas y una o más claves públicas.

Flow CLI puede crear cuentas, consultar sus datos, inspeccionar claves, añadirlas o revocarlas y desplegar contratos en cuentas autorizadas.

El modelo de cuentas separa una dirección Flow de cualquier clave pública individual.

Una cuenta puede contener varias claves con pesos, algoritmos de firma, algoritmos de hash y números de secuencia distintos.

Este diseño permite rotar claves, utilizar varios dispositivos, compartir el control y emplear otros modelos de autorización.

La documentación oficial de cuentas Flow explica en qué se diferencian de los modelos de direcciones en los que una sola clave determina una dirección de forma permanente.

Revocar una clave comprometida solo puede proteger una cuenta si las demás claves válidas siguen aportando suficiente peso de autorización.

Los desarrolladores deben probar los procedimientos de gestión de claves antes de depender de ellos para cuentas de producción con activos de gran valor.

¿Cómo gestiona Flow CLI las claves criptográficas?

Flow CLI incluye comandos para generar y decodificar claves compatibles con Flow.

También ofrece comandos para crear y verificar firmas digitales.

La generación de claves debe utilizar aleatoriedad segura, ya que un atacante podría reconstruir una clave privada predecible.

Una clave privada nunca debe copiarse en una incidencia pública, una grabación compartida del terminal, un mensaje de chat o un repositorio de código fuente.

El historial de la línea de comandos también puede exponer secretos si se proporcionan claves privadas directamente como argumentos del comando.

Los sistemas de producción deben preferir archivos de claves con permisos restringidos, almacenamiento protegido por hardware o un servicio compatible de gestión de claves.

Las copias de seguridad de las claves deben protegerse, ya que perder todas las claves válidas puede impedir para siempre controlar la cuenta.

¿Qué es el gestor de dependencias de Flow CLI?

El gestor de dependencias de Flow CLI instala y registra contratos Cadence externos utilizados por un proyecto.

Los contratos inteligentes suelen depender de estándares, interfaces e implementaciones desplegados en otros lugares de la red Flow.

El gestor de dependencias puede recuperar el código fuente de los contratos y actualizar la configuración del proyecto para resolver correctamente las importaciones.

El comando

muestra las dependencias registradas actualmente en un proyecto.

El comando

puede instalar una dependencia desde una ubicación de red compatible.

La documentación oficial sobre la gestión de dependencias explica cómo instalar, inspeccionar y gestionar dependencias de contratos.

Los desarrolladores deben revisar el código y las direcciones de las dependencias, en lugar de suponer que todos los contratos on-chain son seguros.

Una dependencia maliciosa o identificada incorrectamente puede introducir comportamientos no autorizados en una aplicación descentralizada.

Los equipos también deben considerar si otra cuenta puede actualizar un contrato importado después del despliegue de la aplicación.

¿Cómo prueba Flow CLI los contratos inteligentes Cadence?

Flow CLI incluye Cadence Testing Framework y ejecuta archivos de prueba con el comando

.

Las pruebas pueden verificar contratos inteligentes, scripts, transacciones, eventos emitidos, cambios en las cuentas y fallos previstos.

El sistema de pruebas utiliza Flow Emulator en el entorno de pruebas de Cadence.

Esto permite crear cuentas, desplegar contratos, enviar transacciones e inspeccionar el estado sin afectar a una blockchain pública.

La guía oficial de pruebas de Cadence explica los flujos de trabajo de pruebas unitarias y de integración.

Las pruebas de integración son especialmente útiles porque pueden revelar problemas relacionados con la configuración de cuentas, la autorización de transacciones, las importaciones, las capacidades y el movimiento de recursos.

Un porcentaje elevado de cobertura de código no demuestra que un contrato sea seguro, ya que las pruebas pueden no examinar las hipótesis más peligrosas.

Cuando corresponda, los contratos críticos para la seguridad también deben someterse a revisión manual, pruebas adversariales y una auditoría independiente.

¿Qué son las pruebas con bifurcación en Flow CLI?

Las pruebas con bifurcación crean un entorno de desarrollo local que puede leer el estado de Flow Mainnet o Testnet mientras ejecuta cambios localmente.

Permiten probar código con contratos desplegados, direcciones y estado de blockchain reales sin modificar la red pública original.

Por ejemplo, un desarrollador puede iniciar una bifurcación basada en mainnet con un comando como

.

La guía oficial de Flow sobre pruebas con bifurcación explica cómo el emulador local reproduce el estado de otra red Flow.

Estas pruebas son útiles cuando una aplicación depende de contratos o datos de cuentas difíciles de reproducir manualmente.

También pueden ayudar a detectar problemas de compatibilidad antes de actualizar un contrato de producción.

Un entorno bifurcado no equivale a crear una bifurcación permanente de la blockchain Flow.

Es una copia privada para pruebas, cuyas transacciones locales no modifican mainnet ni testnet.

Aun así, los desarrolladores deben verificar la altura de bloque y la red seleccionadas, ya que los resultados pueden diferir si cambia posteriormente el estado de producción.

¿Qué es el linting en Flow CLI?

El linting analiza el código fuente en busca de posibles errores, patrones inseguros, problemas de formato y otros fallos sin desplegar el contrato.

Flow CLI ofrece el comando

para proyectos Cadence.

El linting puede detectar algunos problemas al principio del desarrollo e incorporarse a las comprobaciones automatizadas.

Las versiones actuales admiten una opción de directorio base para proyectos que guardan archivos Cadence fuera de la ubicación predeterminada.

Un resultado satisfactorio del linting no demuestra que la lógica de negocio, el control de acceso, los incentivos económicos o la gestión de recursos sean correctos.

El linting debe combinarse con pruebas, revisión de código y supervisión de producción.

¿Cómo se consultan datos de la blockchain con Flow CLI?

Flow CLI puede recuperar cuentas, bloques, colecciones, eventos, transacciones, resultados de ejecución y otros datos disponibles a través de Flow Access API.

El comando

puede recuperar un bloque por identificador, altura o el último bloque disponible.

El comando

obtiene información sobre una cuenta Flow.

Los comandos de eventos pueden recuperar los eventos emitidos en un intervalo de bloques seleccionado.

Los comandos de transacción pueden inspeccionar el estado y el resultado de una transacción enviada.

Estas funciones son útiles para el desarrollo, la depuración, la supervisión y las investigaciones sencillas de blockchain.

CLI no es un indexador histórico completo, ya que Access Nodes y los servicios de indexación especializados pueden ofrecer distintas capacidades de consulta.

Una aplicación de análisis de gran tamaño normalmente necesitará, además de comandos CLI, una base de datos, un servicio de procesamiento de eventos u otra infraestructura específica.

¿Qué son las plantillas de interacción de Flow?

Las plantillas de interacción de Flow ofrecen descripciones estandarizadas de transacciones y scripts Cadence.

A veces se denominan plantillas FLIX.

Una plantilla puede describir el código de interacción, los argumentos, las dependencias y los metadatos necesarios para que las wallets o aplicaciones comprendan una operación.

Flow CLI incluye comandos FLIX para ejecutar, generar y empaquetar interacciones compatibles.

Las plantillas pueden mejorar la coherencia entre desarrolladores de aplicaciones, wallets y contratos inteligentes.

Los usuarios deben verificar el código y los argumentos de la transacción antes de firmarla, ya que una plantilla no elimina los riesgos de los contratos inteligentes ni de las wallets.

¿Qué son los comandos de transacciones programadas?

Las versiones actuales de Flow CLI incluyen comandos para interactuar con transacciones programadas de Flow.

Las transacciones programadas permiten a los contratos inteligentes organizar ejecuciones autónomas futuras conforme a las reglas de programación de la red.

Entre sus posibles usos cripto están las transferencias periódicas, las acciones de contratos diferidas, la lógica financiera automatizada y el comportamiento de aplicaciones basado en el tiempo.

El comando

puede crear el recurso de gestión necesario para administrar transacciones programadas de una cuenta.

Hay comandos adicionales para enumerar, inspeccionar y cancelar las transacciones programadas compatibles.

La documentación oficial sobre transacciones programadas explica los requisitos de configuración, las prioridades y el comportamiento de los comandos.

Programar una transacción no garantiza un resultado económico favorable, ya que los precios de los activos, los saldos de las cuentas, el estado de los contratos y las condiciones de red pueden cambiar antes de su ejecución.

¿Qué es Flowser?

Flowser es un explorador visual que se puede utilizar con un entorno local de Flow Emulator.

Flow CLI incluye un comando para iniciar Flowser cuando están disponibles los componentes necesarios.

La interfaz ayuda a los desarrolladores a inspeccionar cuentas locales, contratos, bloques, transacciones y eventos sin tener que consultar manualmente cada elemento.

Flowser complementa la línea de comandos, pero no sustituye las pruebas automatizadas ni la revisión del código fuente.

Los resultados mostrados en un explorador local corresponden al estado actual del emulador y no deben confundirse con la actividad de mainnet.

¿Qué es Flow Dev Wallet?

Flow Dev Wallet es una herramienta de desarrollo para probar la autorización de wallets y las interacciones con aplicaciones.

Flow CLI puede iniciar un entorno de wallet de desarrollo para los flujos de trabajo locales compatibles.

Un desarrollador puede utilizarla para simular el inicio de sesión, la autorización de cuentas, la aprobación de transacciones y otras funciones de wallet al crear una aplicación descentralizada.

Dev Wallet no está pensada para proteger activos de producción de valor.

Las aplicaciones de producción deben integrarse con las wallets adecuadas de los usuarios y seguir prácticas seguras de autenticación y revisión de transacciones.

¿Flow CLI es compatible con Flow EVM?

Flow admite contratos inteligentes Cadence y un entorno Ethereum Virtual Machine, pero Flow CLI es principalmente el flujo oficial de línea de comandos para el modelo de desarrollo de Flow basado en Cadence y Access API.

Las aplicaciones Solidity en Flow EVM suelen utilizar herramientas JSON-RPC compatibles con EVM y una EVM Gateway.

La documentación oficial de Flow EVM Gateway explica que los clientes EVM se conectan a través de una puerta de enlace que implementa la especificación Ethereum JSON-RPC.

Las aplicaciones Cadence también pueden interactuar con Flow EVM mediante Cadence Owned Accounts y contratos de red.

Los desarrolladores deben elegir las herramientas según si la aplicación está escrita en Cadence, Solidity o combina ambos entornos de ejecución.

Que una herramienta se llame Flow CLI no significa que todas las operaciones específicas de EVM se realicen con el mismo conjunto de comandos.

Flow CLI frente a un SDK de Flow

Flow CLI es una herramienta de terminal interactiva y programable.

Un kit de desarrollo de software (SDK) de Flow es una biblioteca de programación que se importa al código de una aplicación.

CLI es útil para el desarrollo local, la configuración de proyectos, la interacción manual con la red, las pruebas y la automatización de despliegues.

Un SDK se adapta mejor a servicios de backend, servidores de aplicaciones, bots, wallets, indexadores y otros programas que deben comunicarse con Flow mientras se ejecutan.

Un equipo de desarrollo puede utilizar Flow CLI para desplegar un contrato y, a continuación, un SDK de JavaScript, Go o móvil para interactuar con él desde una aplicación.

Ambas categorías de herramientas se complementan, en lugar de sustituirse directamente.

Flow CLI frente a un entorno gráfico de desarrollo

Un entorno gráfico de desarrollo ofrece menús, editores, herramientas visuales para cuentas y otras funciones que se controlan con clics.

Flow CLI ofrece comandos más fáciles de automatizar, guardar en scripts y reproducir en integración continua.

Una herramienta gráfica puede resultar más accesible para principiantes, mientras que CLI puede ofrecer más control y transparencia para flujos de trabajo repetibles.

Muchos desarrolladores combinan ambos enfoques: editan Cadence en un entorno de desarrollo integrado y ejecutan comandos de Flow CLI en un terminal integrado.

La extensión oficial de Cadence puede ofrecer asistencia de sintaxis y desarrollo, mientras Flow CLI se encarga de la ejecución y el despliegue.

¿Se puede usar Flow CLI en integración continua?

Los comandos de Flow CLI pueden incorporarse a flujos de trabajo de integración y despliegue continuos.

Una canalización puede instalar una versión fijada de CLI, analizar archivos Cadence, ejecutar pruebas, inicializar un emulador, desplegar contratos de prueba y verificar las transacciones previstas.

El despliegue automatizado en mainnet requiere controles mucho más estrictos que las pruebas automatizadas.

Las claves privadas deben guardarse en un sistema seguro de gestión de secretos, no directamente en el archivo de la canalización.

El despliegue en producción puede requerir aprobación manual, artefactos de lanzamiento firmados, ramas protegidas y varios revisores.

Una canalización debe detenerse si las pruebas, las comprobaciones de linting, la verificación del despliegue o las comprobaciones del resultado de una transacción no producen el resultado previsto.

Los equipos también deben registrar las versiones de Flow CLI y Cadence utilizadas en cada lanzamiento.

¿Flow CLI recopila datos de uso?

Actualmente, Flow CLI recopila de forma predeterminada recuentos agregados del uso de comandos mediante Mixpanel.

La documentación oficial indica que este sistema de recuento no recopila los valores de los argumentos ni de las opciones de los comandos.

Los usuarios pueden desactivar la recopilación de métricas con

.

Las métricas se pueden volver a activar con

.

La página oficial de Flow CLI sobre recopilación de datos explica qué se recopila y cómo cambiar el ajuste.

Las organizaciones con requisitos de privacidad, cumplimiento normativo o compilación aislada deben revisar el funcionamiento de la telemetría antes de instalar CLI en entornos controlados.

Buenas prácticas de seguridad para Flow CLI

Los desarrolladores deben instalar Flow CLI únicamente siguiendo la documentación oficial o desde recursos de versiones verificados.

Antes de firmar o desplegar una transacción, deben verificar la red seleccionada.

Las claves privadas de mainnet no deben almacenarse en texto sin cifrar en archivos de proyecto públicos.

Deben utilizarse cuentas y claves separadas para el desarrollo local, las pruebas, la administración de contratos, el control de tesorería y la actividad habitual de las aplicaciones.

Las cuentas de producción deben utilizar pesos de clave adecuados y evitar depender de un único portátil de desarrollador sin protección.

Hay que verificar las importaciones de contratos y las direcciones de las dependencias en cada red.

Antes de enviar una transacción, deben revisarse las funciones de los firmantes, los argumentos, los límites de gas y los contratos de destino.

Los desarrolladores deben inspeccionar el resultado sellado de la transacción, en lugar de suponer que se ha completado correctamente por el mero hecho de enviarla.

Las versiones de CLI deben probarse antes de introducir actualizaciones en los flujos de trabajo de producción.

Las claves de cuenta antiguas o sin uso deben revocarse cuando exista una vía de autorización de reemplazo segura.

Nunca deben introducirse frases semilla ni claves privadas en sitios web que afirmen necesitarlas para activar Flow CLI.

Errores habituales de Flow CLI

Un error de conexión puede indicar que el emulador no está en ejecución, que la dirección de Access Node es incorrecta, que el puerto seleccionado no está disponible o que no se puede acceder a un servicio de red.

Un error de autorización puede deberse a una clave privada, un índice de clave, un número de secuencia, un algoritmo de firma, un algoritmo de hash o una dirección de cuenta incorrectos.

Puede producirse un error de importación si falta un alias de contrato Cadence o apunta a una dirección de red incorrecta.

Un error de despliegue puede deberse a código Cadence no válido, una versión incompatible del lenguaje, dependencias ausentes o autorización insuficiente de la cuenta.

Una transacción puede fallar si un argumento tiene un tipo Cadence incorrecto o si la cuenta carece del recurso o la capacidad necesarios.

Puede producirse un error de número de secuencia cuando varias transacciones intentan utilizar la misma clave de proponente casi al mismo tiempo.

Los desarrolladores deben leer el mensaje de error completo, confirmar qué red está activa y utilizar la opción

del comando antes de cambiar ajustes del proyecto que no estén relacionados.

Usos habituales de Flow CLI

Flow CLI permite crear y configurar un nuevo proyecto Cadence.

Puede ejecutar una blockchain local para desarrollar contratos inteligentes.

Puede crear cuentas y gestionar claves de cuenta.

Puede desplegar y actualizar contratos Cadence.

Puede ejecutar scripts de solo lectura y transacciones firmadas.

Puede instalar dependencias de contratos y gestionar alias de red.

Puede ejecutar pruebas unitarias, pruebas de integración, comprobaciones de linting y pruebas con bifurcación del estado de mainnet.

Puede recuperar bloques, transacciones, cuentas, colecciones y eventos.

Puede respaldar procesos automatizados de compilación y despliegue.

También puede ayudar a reproducir operaciones blockchain al investigar errores de aplicaciones.

Limitaciones de Flow CLI

Flow CLI no hace que un contrato inteligente sea seguro automáticamente.

No puede impedir que un desarrollador firme una transacción perjudicial o despliegue código en la cuenta equivocada.

No sustituye las auditorías profesionales, el modelado de amenazas, el diseño del control de acceso ni la supervisión operativa.

El emulador local no puede reproducir a la perfección todas las condiciones de una red pública.

CLI tampoco es una interfaz de wallet completa diseñada para consumidores habituales.

No proporciona una base de datos completa de análisis históricos de todas las transacciones de Flow.

Los desarrolladores siguen teniendo que comprender Cadence, las cuentas Flow, las funciones de las transacciones, las capacidades, el almacenamiento de recursos, las dependencias y la seguridad de la red.

Preguntas frecuentes

¿Qué significa Flow CLI?

Flow CLI significa Flow Command-Line Interface (interfaz de línea de comandos de Flow), la herramienta oficial de desarrollo para la blockchain Flow basada en terminal.

¿Flow CLI está desarrollada por Dapper Labs?

Flow fue diseñada y desarrollada originalmente por Dapper Labs, mientras que Flow CLI se mantiene actualmente como software oficial de código abierto del ecosistema Flow a través de la organización Onflow.

¿Flow CLI es una wallet de criptomonedas?

No. Flow CLI es una herramienta para desarrolladores, aunque puede utilizar claves privadas configuradas para firmar transacciones y gestionar cuentas Flow.

¿Cuál es la última versión de Flow CLI?

A fecha de 14 de julio de 2026, la última versión oficial es Flow CLI 2.17.4.

¿Qué versión de Cadence incluye Flow CLI 2.17.4?

Flow CLI 2.17.4 incluye Cadence 1.10.3.

¿Cómo instalo Flow CLI en macOS?

Un método habitual es ejecutar

mediante Homebrew.

¿Cómo compruebo la versión de Flow CLI?

Ejecuta

en un terminal.

¿Cómo creo un nuevo proyecto Flow?

Ejecuta

y selecciona una plantilla de proyecto adecuada.

¿Qué es flow.json?

es el archivo principal de configuración del proyecto, donde se definen las redes, cuentas, contratos, dependencias y destinos de despliegue.

¿Cómo inicio Flow Emulator?

Ejecuta

en el terminal.

¿Flow Emulator utiliza FLOW real?

No. El emulador local utiliza datos y activos de desarrollo que no tienen valor en mainnet.

¿Puede Flow CLI desplegar contratos en mainnet?

Sí. Flow CLI puede desplegar contratos en Flow Mainnet si se proporcionan la red, la cuenta, la clave y la configuración de despliegue correctas.

¿Qué comando despliega un proyecto Flow?

El comando estándar para desplegar un proyecto es

, normalmente con una opción de red explícita.

¿Puede Flow CLI actualizar contratos inteligentes?

Sí. Puede enviar transacciones autorizadas de actualización de contratos, sujetas a las reglas de Cadence y de la red Flow.

¿Cómo ejecuto pruebas Cadence?

Ejecuta

desde un proyecto Flow configurado.

¿Qué son las pruebas con bifurcación de Flow?

Las pruebas con bifurcación ejecutan un entorno local con una copia del estado de mainnet o testnet, sin modificar la blockchain pública.

¿Flow CLI permite crear cuentas?

Sí. Flow CLI puede crear y consultar cuentas Flow y gestionar sus claves.

¿Flow CLI puede leer datos de la blockchain?

Sí. Puede recuperar bloques, cuentas, transacciones, eventos, colecciones y otros datos disponibles a través de Flow Access Nodes.

¿Cuál es la diferencia entre un script y una transacción Flow?

Un script lee el estado sin modificar la blockchain, mientras que una transacción se firma y puede modificarlo.

¿Flow CLI puede gestionar dependencias de contratos?

Sí. Su gestor de dependencias puede instalar, enumerar y registrar contratos Cadence externos utilizados por un proyecto.

¿Flow CLI recopila telemetría?

Flow CLI recopila actualmente de forma predeterminada recuentos agregados de comandos. Los usuarios pueden desactivar esta función con

.

¿Deben guardarse las claves privadas en flow.json?

Las claves privadas de producción no deben guardarse como texto sin cifrar en un archivo

compartido o público.

¿Puede utilizarse Flow CLI en despliegues automatizados?

Sí, pero los despliegues de producción deben utilizar versiones fijadas, secretos protegidos, controles de revisión y verificación explícita de la red.

¿Flow CLI funciona con Flow Testnet?

Sí. Testnet es uno de los entornos estándar compatibles mediante la configuración de red de Flow CLI.

¿Flow CLI se utiliza para desarrollar en Solidity?

Flow CLI admite principalmente flujos de trabajo de Cadence y Flow Access API, mientras que las aplicaciones Solidity en Flow EVM suelen utilizar herramientas JSON-RPC compatibles con EVM.

¿Flow CLI es de código abierto?

Sí. El código fuente de Flow CLI está disponible públicamente bajo la licencia Apache 2.0.

¿El uso de Flow CLI puede provocar pérdidas de criptomonedas?

Sí. Las claves, redes, direcciones, código de contratos o argumentos de transacción incorrectos pueden causar pérdidas irreversibles en mainnet.

Conclusión

Flow CLI es la herramienta oficial de desarrollo por línea de comandos para crear aplicaciones e interactuar con ellas en la blockchain Flow.

Su relación con Dapper Labs se debe a que esta diseñó y desarrolló Flow originalmente, mientras que CLI funciona ahora como software de código abierto del ecosistema Flow.

La herramienta reúne la inicialización de proyectos, el acceso al emulador, las pruebas Cadence, la gestión de cuentas y claves, el despliegue de contratos, la gestión de dependencias, el envío de transacciones y las consultas a la blockchain.

Su sistema de configuración

permite a los desarrolladores gestionar entornos coherentes en el emulador, testnet, mainnet y las bifurcaciones de redes locales.

Flow CLI puede hacer que el desarrollo blockchain sea más reproducible, pero no elimina los riesgos de las claves inseguras, los contratos defectuosos, los destinos de despliegue incorrectos, las dependencias maliciosas ni las transacciones irreversibles.

Los desarrolladores deben utilizar versiones oficiales, proteger las credenciales de firma, probar en varios entornos, inspeccionar los resultados de las transacciones y aplicar controles de revisión estrictos antes de desplegar en Flow Mainnet.