Avalanche CLI

¿Qué es Avalanche CLI?

Avalanche CLI es una herramienta de línea de comandos que los desarrolladores utilizan para crear, probar, desplegar, gestionar y actualizar blockchains Avalanche L1.

En el ámbito de las criptomonedas, una CLI es una herramienta basada en terminal que permite ejecutar operaciones de blockchain mediante comandos, en lugar de una interfaz gráfica.

El repositorio oficial de Avalanche CLI en GitHub la describe como una herramienta de línea de comandos que proporciona acceso a Avalanche y que está especializada en ayudar a los desarrolladores a crear y probar L1.

La guía oficial para crear una Avalanche L1 indica que el primer paso para aprender a desarrollar en Avalanche L1 es aprender a utilizar Avalanche CLI.

Avalanche CLI puede ayudar a generar la configuración de una cadena, desplegarla en una red local o en Fuji Testnet, preparar el despliegue en Mainnet, gestionar nodos y claves, desplegar herramientas de mensajería cross-chain y consultar información sobre validadores.

Resulta especialmente útil para los equipos que desarrollan Avalanche L1, denominadas Subnets en la documentación y las herramientas anteriores.

Una Avalanche L1 puede tener su propia máquina virtual, conjunto de validadores, token de gas, permisos, reglas de comisiones y ajustes específicos para cada aplicación.

Avalanche CLI ayuda a gestionar esta complejidad mediante flujos de comandos guiados y archivos de configuración reutilizables.

Para quienes empiezan, Avalanche CLI suele ser la forma más rápida de entender cómo se crea y despliega una Avalanche L1.

Para los equipos que trabajan en producción, puede facilitar flujos de trabajo importantes, pero debe utilizarse con controles de seguridad sólidos y una revisión operativa minuciosa.

Estado actual de Avalanche CLI

Avalanche CLI sigue siendo importante para los desarrolladores de Avalanche, aunque su estado de mantenimiento cambió a finales de 2025.

La página oficial de versiones de Avalanche CLI indica que, desde diciembre de 2025, Avalanche CLI está en modo de mantenimiento.

El mismo aviso señala que el equipo de Ava Labs no desarrollará nuevas funciones y que solo se abordarán parches de seguridad y correcciones de errores críticos.

Esto es importante para los desarrolladores en 2026: no deben tratar Avalanche CLI como un producto en rápida evolución que recibe nuevas funciones de forma continua.

Conviene considerarla una herramienta consolidada que puede seguir siendo útil para los flujos de trabajo existentes, pero que requiere consultar las notas de versión, las actualizaciones de la documentación y las recomendaciones sobre herramientas más recientes.

El modo de mantenimiento no significa que la herramienta haya dejado de ser útil.

Significa que los desarrolladores deben tener expectativas realistas sobre el soporte futuro y evitar depender de comportamientos no respaldados en sistemas de producción críticos.

Antes de utilizar la CLI en producción, los equipos deben comprobar su compatibilidad con las versiones actuales de AvalancheGo, las reglas vigentes para desplegar L1, los requisitos actuales de gestión de validadores y su propia infraestructura.

Este estado también hace más importante revisar la documentación.

Antes de dar por hecho que los tutoriales antiguos siguen las prácticas recomendadas actuales, los desarrolladores deben consultar las páginas oficiales de Avalanche Builder Hub y el repositorio de GitHub.

Por qué es importante Avalanche CLI

Avalanche CLI es importante porque lanzar una blockchain es más complejo que desplegar un contrato inteligente convencional.

Una Avalanche L1 puede necesitar una configuración de génesis, una máquina virtual, la configuración del gestor de validadores, nodos validadores, parámetros de red, reglas de gas, endpoints RPC, monitorización, actualizaciones y configuración de mensajería cross-chain.

Sin una CLI, los desarrolladores tendrían que crear archivos manualmente, ejecutar nodos, preparar transacciones, hacer un seguimiento de los ID, configurar máquinas virtuales y coordinar validadores en varios sistemas.

Avalanche CLI simplifica muchos de estos pasos mediante comandos y asistentes interactivos.

Esto ayuda a los desarrolladores a aprender más rápido y reduce algunos errores de configuración manual.

La CLI es especialmente útil para el desarrollo local, ya que permite crear una configuración de cadena y probarla antes de utilizar recursos de una testnet pública o de Mainnet.

También ayuda a los equipos a repetir los procesos de despliegue de forma más organizada.

Para el crecimiento del ecosistema Avalanche, herramientas como Avalanche CLI reducen las barreras para experimentar con entornos blockchain personalizados.

Hacen más viable la idea de crear L1 específicas para aplicaciones para los desarrolladores que ya conocen las herramientas EVM, pero necesitan ayuda con la configuración de cadenas específica de Avalanche.

La herramienta no sustituye a la ingeniería de seguridad, pero es una parte importante del flujo de trabajo de los desarrolladores de Avalanche.

Cómo funciona Avalanche CLI

Avalanche CLI permite ejecutar comandos en el terminal para generar archivos de configuración, iniciar redes locales, desplegar Avalanche L1, gestionar claves e interactuar con la infraestructura de Avalanche.

Por lo general, el desarrollador empieza instalando el binario de la CLI en un sistema compatible.

El repositorio oficial indica que la herramienta se ha probado en Linux y Mac, mientras que Windows no es compatible actualmente.

Una vez instalada, se pueden ejecutar comandos mediante el comando avalanche.

Un flujo de trabajo inicial habitual consiste en crear una configuración de Avalanche L1 con avalanche blockchain create.

La referencia oficial de comandos de la CLI indica que el comando blockchain create genera un nuevo archivo de génesis y guía al usuario por los pasos necesarios para crear una blockchain.

Una vez creada la configuración, el desarrollador puede desplegarla localmente con avalanche blockchain deploy y seleccionar Local Network.

La guía oficial de despliegue local explica que se puede desplegar una configuración de Avalanche L1 ya existente en una red local de Avalanche.

Cuando la cadena está en funcionamiento, el desarrollador puede conectar aplicaciones, probar transacciones, consultar validadores y perfeccionar la configuración.

Este flujo de trabajo permite a los equipos detectar problemas antes de pasar a las redes públicas.

Instalación de Avalanche CLI

Avalanche CLI se instala como un binario que los desarrolladores ejecutan desde el terminal.

La guía oficial para crear una Avalanche L1 indica que la forma más rápida de instalar el binario más reciente de Avalanche CLI es ejecutar el script de instalación oficial del repositorio de Avalanche CLI.

De forma predeterminada, el binario se instala en el directorio bin del directorio personal del usuario.

Después, los desarrolladores pueden añadir ese directorio a la ruta del sistema para ejecutar el comando avalanche desde cualquier ubicación del terminal.

La instalación debe realizarse con cuidado, ya que una CLI que gestiona claves, despliegues y configuraciones de cadenas es una herramienta de desarrollo sensible.

Los desarrolladores deben utilizar la documentación y los repositorios oficiales, en lugar de scripts aleatorios de redes sociales, salas de chat o tutoriales copiados.

Antes de ejecutar comandos de shell que descarguen y ejecuten software, deben verificar su procedencia.

Esto es especialmente importante en cripto, ya que los scripts de instalación maliciosos pueden robar claves privadas, sustituir binarios, cambiar direcciones de wallet o modificar parámetros de despliegue.

Los equipos que utilicen Avalanche CLI en un entorno profesional deben documentar la fuente de instalación, la versión, el sistema operativo y el proceso de comprobación de sumas de verificación.

Una instalación reproducible ayuda a reducir los riesgos de la cadena de suministro.

Principales casos de uso de Avalanche CLI

El primer caso de uso importante es crear la configuración de una Avalanche L1.

El segundo es desplegar esa L1 en una red local para probarla.

El tercero es desplegarla en Fuji Testnet antes de Mainnet.

El cuarto es preparar y ejecutar los pasos necesarios para el despliegue en Mainnet.

El quinto es gestionar nodos validadores y consultar su estado.

El sexto es gestionar claves de desarrollo y firmar transacciones.

El séptimo es gestionar actualizaciones de cadenas y cambios de máquinas virtuales.

El octavo es desplegar y probar herramientas de Avalanche Interchain Messaging.

El noveno es exportar e importar datos de configuración de cadenas entre equipos o máquinas.

Estos casos de uso convierten Avalanche CLI en una herramienta completa para el flujo de trabajo de desarrollo, y no solo en un asistente para crear cadenas.

Creación de una Avalanche L1

La creación de una Avalanche L1 con Avalanche CLI suele comenzar con el comando blockchain create.

La referencia oficial de comandos indica que avalanche blockchain create genera un nuevo archivo de génesis para configurar una blockchain y, de forma predeterminada, ejecuta un asistente interactivo.

El asistente puede pedir al desarrollador que elija una máquina virtual, un tipo de gestión de validadores, una dirección de controlador, ajustes del token de gas, opciones de precompilación y otros parámetros de la cadena.

La guía para crear una Avalanche L1 explica que el tutorial para principiantes utiliza Subnet-EVM, la bifurcación de EVM de Avalanche para L1, para crear una Avalanche L1 basada en EVM.

Esto es importante porque muchos desarrolladores buscan un entorno de ejecución compatible con Ethereum que permita personalizar Avalanche L1.

Una configuración de cadena no es lo mismo que una cadena activa.

Es un conjunto de archivos y parámetros que describe cómo debe iniciarse y comportarse la cadena.

Los desarrolladores deben tratar esta configuración como infraestructura crítica.

Una opción de génesis, una dirección de controlador, una elección de token de gas o un ajuste de permisos incorrectos pueden causar problemas difíciles de corregir después del despliegue.

Las pruebas locales deben realizarse antes de cualquier despliegue público.

Despliegue local

El despliegue local es el primer paso más seguro después de crear la configuración de una Avalanche L1.

La guía oficial de despliegue local indica que los desarrolladores pueden desplegar una configuración de Avalanche L1 ya creada en una red local de Avalanche.

La misma guía muestra que el comando de despliegue puede ejecutarse con avalanche blockchain deploy, seguido del nombre de la blockchain y la opción local.

Una red local permite probar el comportamiento de la cadena sin poner en riesgo fondos reales.

También permite probar rápidamente wallets, endpoints RPC, contratos, reglas de gas, validadores, precompilaciones y flujos de las aplicaciones.

El despliegue local es útil porque resulta más fácil corregir los problemas de lanzamiento de una blockchain antes de hacerla pública.

Un desarrollador puede eliminar y volver a crear un entorno local muchas veces.

En Mainnet no existe la misma libertad.

Las pruebas locales deben incluir transacciones normales y casos de error.

El equipo debe probar qué ocurre cuando se reinician los nodos, los ajustes de gas son incorrectos, fallan los contratos, los validadores no están listos o los usuarios interactúan con una configuración de red equivocada.

Despliegue en Fuji Testnet

Fuji Testnet es la red pública de pruebas de Avalanche que se utiliza antes del despliegue en Mainnet.

Avalanche CLI admite flujos de trabajo de testnet para que los desarrolladores puedan pasar de las pruebas locales a un entorno de red más realista.

El despliegue en testnet ayuda a detectar problemas que quizá no aparezcan en un despliegue local.

Algunos ejemplos son la latencia de red, la configuración de RPC pública, la configuración de wallets externas, la coordinación de validadores, la financiación desde un faucet, la monitorización, el calendario de despliegue y las suposiciones sobre la interfaz de usuario.

Un despliegue local correcto no garantiza que el despliegue en testnet también lo sea.

Las pruebas en Fuji deben considerarse un ensayo de las operaciones en Mainnet.

Los desarrolladores deben documentar todos los comandos, archivos de configuración, claves utilizadas, ID de red, ID de cadena, ajustes de los nodos y direcciones de contratos.

También deben probar los procedimientos de recuperación por si un comando falla a mitad de ejecución.

La guía oficial de despliegue en Mainnet indica que primero se debe desplegar y probar una Avalanche L1 en Fuji Testnet.

Es una regla práctica, ya que los errores en Mainnet pueden resultar costosos y hacerse públicos.

Despliegue en Avalanche Mainnet

El despliegue en Mainnet es el flujo de trabajo de Avalanche CLI con mayor riesgo.

La guía oficial de despliegue en Mainnet advierte de que desplegar una Avalanche L1 en Mainnet conlleva numerosos riesgos y exige prestar una atención especial a la seguridad.

El despliegue en Mainnet puede implicar AVAX reales, validadores reales, infraestructura de nodos real, usuarios reales y decisiones de configuración irreversibles.

La guía también señala que el tutorial tiene fines educativos y no garantiza un despliegue seguro.

Esta advertencia debe tomarse en serio.

Avalanche CLI puede guiar el despliegue, pero no puede determinar si una clave de validador es segura, si la gobernanza es adecuada, si la infraestructura es resiliente o si la economía de la cadena tiene sentido.

Antes del despliegue en Mainnet, los equipos deben probar en Fuji, auditar los contratos, proteger las claves, documentar los procedimientos operativos, monitorizar los nodos, verificar las copias de seguridad y preparar una respuesta ante incidentes.

También deben comprender el diseño de su gestor de validadores y las consecuencias de modificar los validadores.

El despliegue en Mainnet nunca debe tratarse como un experimento rápido en la línea de comandos.

Avalanche L1 y Subnets

Avalanche L1 es el término moderno que suele utilizarse para lo que la documentación y las herramientas anteriores de Avalanche denominaban Subnet.

La documentación oficial de ACP-77 analiza la redefinición de las Subnets y describe cambios relacionados con los requisitos para validadores L1 y el control del conjunto de validadores.

Esta terminología es importante porque los desarrolladores aún pueden encontrar comandos, guías o comentarios de código antiguos que utilizan la palabra Subnet.

Al trabajar con Avalanche CLI, deben entender que muchas referencias antiguas a flujos de Subnet corresponden a los flujos actuales de Avalanche L1.

Una Avalanche L1 puede diseñarse para una aplicación, sector, juego, institución, clase de activos o comunidad específicos.

Puede utilizar una máquina virtual compatible con EVM o una máquina virtual personalizada.

También puede tener reglas de validación y supuestos operativos personalizados.

Esta flexibilidad ofrece muchas posibilidades, pero también aumenta la responsabilidad.

Cada Avalanche L1 debe documentar claramente su modelo de validadores, modelo de token, gobernanza, supuestos del bridge y proceso de actualización.

Avalanche CLI ayuda a crear y desplegar L1, pero no hace que todas las L1 sean seguras de forma predeterminada.

Subnet-EVM en Avalanche CLI

Subnet-EVM es una máquina virtual compatible con EVM que se utiliza en muchos flujos de trabajo de desarrollo de Avalanche L1.

La guía para crear una Avalanche L1 indica que el tutorial utiliza Subnet-EVM para crear una Avalanche L1 basada en EVM y que esta admite funciones como tokens de comisiones personalizados, parámetros de gas configurables y precompilaciones con estado.

Esto es importante porque muchos desarrolladores de cripto ya conocen los contratos EVM y las herramientas basadas en Solidity.

Subnet-EVM permite crear Avalanche L1 personalizadas con patrones de contratos inteligentes conocidos.

Sin embargo, una Avalanche L1 compatible con EVM no es automáticamente idéntica a Avalanche C-Chain ni a ninguna otra cadena EVM.

La configuración del token de gas, las precompilaciones, los ID de cadena, las reglas de los validadores, los endpoints RPC y las rutas de los bridges pueden ser distintos.

Los desarrolladores deben configurar las wallets y las aplicaciones para la Avalanche L1 concreta que utilicen.

También deben probar los contratos inteligentes con la configuración de gas y precompilaciones elegida para la L1.

Un contrato que funciona correctamente en un entorno EVM puede requerir pruebas adicionales en la Avalanche L1 de destino.

La compatibilidad reduce las dificultades, pero no elimina la responsabilidad del despliegue.

Máquinas virtuales personalizadas

Avalanche CLI también puede admitir flujos de trabajo con máquinas virtuales personalizadas.

La referencia de comandos de la CLI indica que blockchain create admite Subnet-EVM y máquinas virtuales personalizadas, incluidos archivos de génesis y binarios de VM proporcionados por el usuario.

Una máquina virtual personalizada permite definir reglas de ejecución distintas de las de un entorno EVM convencional.

Puede resultar útil para aplicaciones especializadas que necesiten transiciones de estado, formatos de transacción o funciones de privacidad personalizados, lógica de alto rendimiento o reglas específicas de un sector.

Las máquinas virtuales personalizadas son más avanzadas que los despliegues de Subnet-EVM.

Requieren conocimientos más profundos de AvalancheGo, las interfaces de máquinas virtuales, la distribución de binarios, las actualizaciones de nodos, el comportamiento del consenso y las pruebas.

Un error en una máquina virtual personalizada puede afectar a toda la cadena, ya que la VM define cómo se procesan las transacciones.

Los equipos que desarrollen máquinas virtuales personalizadas deben aplicar una revisión de ingeniería rigurosa y realizar pruebas exhaustivas antes de desplegarlas públicamente.

Avalanche CLI puede ayudar a empaquetar y desplegar configuraciones de VM personalizadas, pero no sustituye a una revisión de seguridad a nivel de protocolo.

El despliegue de una VM personalizada debe considerarse ingeniería blockchain avanzada.

Gestión de validadores

La gestión de validadores es uno de los aspectos más importantes al operar una Avalanche L1.

Los validadores participan en el consenso y contribuyen a que la L1 siga funcionando correctamente.

Avalanche CLI puede facilitar flujos de trabajo relacionados con validadores, como consultar su lista y utilizar comandos de validación.

La referencia de comandos de la CLI indica que blockchain validators muestra los validadores de una blockchain y proporciona estadísticas sobre ellos.

El conjunto de comandos node validate ayuda a los nodos a incorporarse como validadores a la Primary Network y a las Subnets, aunque la referencia de comandos incluye advertencias alfa para algunas partes del conjunto de comandos de nodo.

Los desarrolladores deben prestar atención a estas advertencias, ya que los comandos experimentales pueden cambiar o tener garantías limitadas.

La gestión de validadores no es solo una tarea técnica.

También es una tarea económica y de gobernanza.

Una L1 debe decidir quién puede validar, cómo se añaden o eliminan validadores, qué stake o permisos se exigen, cómo se gestiona el tiempo de inactividad y cómo se abordan las conductas indebidas.

Avalanche CLI puede facilitar las operaciones, pero el modelo de validadores de la cadena debe diseñarse cuidadosamente.

Claves y firma

Avalanche CLI incluye comandos de gestión de claves que permiten crear, listar, exportar, importar y eliminar claves de firma.

La referencia de comandos de la CLI indica que key create puede generar una clave de firma o importar una clave existente desde un archivo.

También señala que key export puede exportar una clave de firma creada.

Estas funciones son prácticas para el desarrollo, pero su uso descuidado puede ser peligroso.

Una clave privada puede controlar fondos, autoridad de despliegue, permisos de validadores o la administración de contratos.

Las claves de desarrollo no deben reutilizarse para despliegues en Mainnet.

Las claves de Mainnet no deben almacenarse en texto sin formato, incluirse en repositorios, compartirse en chats ni guardarse en dispositivos no protegidos.

La guía de despliegue en Mainnet incluye un dispositivo físico de firma entre los requisitos previos, lo que refleja las mayores exigencias de seguridad de los entornos de producción.

Los equipos deben separar las claves de pruebas locales, las de testnet, las de despliegue, las de validadores y las de tesorería.

La seguridad de las claves es uno de los aspectos más importantes para utilizar Avalanche CLI de forma responsable.

Gestión de nodos

Avalanche CLI incluye comandos relacionados con nodos locales, clústeres, comprobaciones de estado, actualizaciones, upgrades, acceso SSH y flujos de validación.

La referencia de comandos de la CLI indica que node local incluye comandos para nodos locales, como start, stop, status, track, destroy y validate.

También señala que node status puede comprobar el estado de bootstrap de nodos y blockchains.

Esto importa porque una Avalanche L1 solo resulta útil si sus nodos están en funcionamiento, sincronizados y conectados.

Los desarrolladores deben saber si los nodos han completado el bootstrap antes de pedirles que validen una L1.

La gestión de nodos en producción debe incluir monitorización, registros, alertas, copias de seguridad, procedimientos de actualización, planificación del almacenamiento, seguridad de red y aislamiento de claves.

Una herramienta de línea de comandos puede ayudar a ejecutar operaciones, pero no debe ser el único control operativo.

Los equipos deben mantener procedimientos que expliquen qué hacer si un nodo se queda atrás, pierde conectividad, no se reinicia o necesita actualizarse a una nueva versión.

La fiabilidad de los nodos afecta a la experiencia de usuario, al rendimiento de los validadores y a la seguridad de la red.

Avalanche CLI puede ayudar a gestionar los nodos, pero sigue siendo necesaria una buena disciplina de infraestructura.

Actualizaciones de la cadena

Las actualizaciones de la cadena son otro ámbito en el que Avalanche CLI puede ayudar a los desarrolladores.

La referencia de comandos de la CLI indica que blockchain upgrade generate crea un archivo upgrade.json y guía al usuario mediante un asistente interactivo.

La misma referencia señala que blockchain upgrade vm puede actualizar el binario de VM de una blockchain local o desplegada públicamente en Fuji o Mainnet.

Las actualizaciones son delicadas porque pueden cambiar la forma en que una cadena procesa las transacciones.

Una actualización de VM puede corregir errores, añadir funciones, cambiar el comportamiento del gas o introducir nuevos riesgos.

Los equipos nunca deben tratar una actualización como un comando rutinario sin revisarla.

Deben probarla primero en local y en testnet.

También deben coordinar a los validadores antes de activarla y monitorizar la cadena después.

Cuando sea posible, deben preparar planes de reversión o de respuesta ante incidentes.

Una actualización fallida puede interrumpir aplicaciones, bloquear fondos de usuarios, dividir el comportamiento de los validadores o dañar la confianza en la L1.

Avalanche CLI e Interchain Messaging

Avalanche CLI incluye comandos para los flujos de trabajo de Interchain Messaging.

La referencia de comandos de la CLI indica que el conjunto de comandos avalanche icm proporciona herramientas para interactuar con contratos de mensajería ICM.

La documentación oficial de Avalanche Interchain Messaging explica que ICM es un protocolo de mensajería de bajo nivel que permite a Avalanche L1 enviar datos a otras Avalanche L1.

La misma documentación explica que ICM utiliza firmas BLS e información del conjunto de validadores para verificar la autenticidad de los mensajes.

Esto es importante porque el modelo Avalanche L1 ofrece más posibilidades cuando las L1 pueden comunicarse entre sí.

ICM puede admitir mensajes cross-chain, instrucciones de aplicaciones, diseños para mover activos y coordinación entre L1.

Avalanche CLI puede ayudar a desplegar o probar contratos y flujos de mensajes relacionados con ICM.

Sin embargo, la mensajería cross-chain es sensible desde el punto de vista de la seguridad.

Los desarrolladores deben comprender la verificación en la cadena de origen, el procesamiento en la cadena de destino, los supuestos sobre relayers, la protección contra la repetición de mensajes y la gestión de errores.

Un error en un mensaje cross-chain puede afectar a más de una cadena a la vez.

Red local, testnet y Mainnet

Los flujos de trabajo de Avalanche CLI deben avanzar, por este orden, de la red local a testnet y después a Mainnet.

La red local es la más adecuada para iterar rápidamente y depurar en las primeras fases.

Fuji Testnet es idónea para ensayar en una red pública y realizar pruebas de integración con una infraestructura más realista.

Mainnet solo debe utilizarse cuando el equipo haya probado, documentado, protegido y revisado el despliegue.

Cada entorno tiene un nivel de riesgo distinto.

Los errores locales suelen ser privados y poco costosos.

Los errores en testnet suelen ser poco costosos, pero pueden revelar debilidades operativas.

Los errores en Mainnet pueden costar fondos reales, afectar a usuarios, dañar la reputación de los validadores o exigir una respuesta pública ante incidentes.

Avalanche CLI facilita el paso entre estos entornos, pero no puede decidir cuándo está listo un proyecto.

La preparación debe basarse en pruebas, monitorización, auditorías, preparación de validadores, seguridad de las claves y claridad en la gobernanza.

Un proceso de despliegue disciplinado es más seguro que pasar precipitadamente de una demostración local a Mainnet.

Avalanche CLI e infraestructura de producción

Una infraestructura de producción requiere mucho más que ejecutar correctamente un comando de despliegue.

Una Avalanche L1 de producción necesita validadores fiables, nodos seguros, acceso RPC estable, paneles de monitorización, alertas, copias de seguridad, registros, procesos de actualización, respuesta ante incidentes y asistencia a usuarios.

Avalanche CLI puede ayudar con algunas operaciones de nodos y cadenas, pero debe formar parte de un sistema operativo más amplio.

Los equipos deben utilizar configuraciones bajo control de versiones cuando proceda, pero nunca deben incluir secretos en los repositorios.

Las claves y credenciales deben gestionarse mediante sistemas seguros de gestión de secretos.

También deben monitorizar el estado de los nodos, el tiempo de actividad de los validadores, el uso del disco y la memoria, el número de peers, la producción de bloques, los errores RPC y el tráfico de las aplicaciones.

Antes de que los usuarios dependan de la cadena, deben probar la recuperación ante desastres.

Avalanche CLI es útil porque estandariza muchos comandos.

Por sí sola, no basta para operar de forma segura una blockchain de producción.

Los equipos de producción necesitan DevOps, seguridad, gobernanza y disciplina operativa específica de blockchain.

Riesgos de seguridad de Avalanche CLI

El primer riesgo de seguridad es instalar un binario falso o modificado de la CLI.

Un binario malicioso puede robar claves, cambiar direcciones, modificar archivos de despliegue o exponer secretos.

El segundo riesgo es gestionar las claves privadas de forma insegura.

Las claves creadas o exportadas mediante los flujos de trabajo de la CLI pueden verse comprometidas si se almacenan sin cuidado.

El tercer riesgo es ejecutar comandos en la red equivocada.

Un comando destinado a una red local o testnet puede resultar peligroso si se ejecuta por error en Mainnet.

El cuarto riesgo son los errores de configuración.

Un archivo de génesis, una dirección del gestor de validadores o un ajuste del token de gas incorrectos pueden causar problemas duraderos.

El quinto riesgo es confiar demasiado en las indicaciones interactivas.

Un desarrollador puede avanzar por las instrucciones sin comprender las consecuencias de cada elección.

El sexto riesgo es utilizar herramientas obsoletas.

Como Avalanche CLI está en modo de mantenimiento, los usuarios deben prestar atención a la compatibilidad y a los flujos de trabajo admitidos.

El séptimo riesgo es no contar con controles operativos adecuados después del despliegue.

Una cadena puede lanzarse correctamente y aun así fallar por una mala gestión de nodos, claves, actualizaciones o monitorización.

Buenas prácticas para utilizar Avalanche CLI

Los desarrolladores deben instalar Avalanche CLI únicamente desde fuentes oficiales de Avalanche.

Antes de utilizarla en flujos de trabajo importantes, deben comprobar la versión instalada.

Deben tener presente que la herramienta entró en modo de mantenimiento en diciembre de 2025.

Toda nueva configuración de cadena debe probarse primero en una red local.

Los desarrolladores deben probar en Fuji Testnet antes de utilizar Mainnet.

Las claves de desarrollo deben mantenerse separadas de las claves de producción.

Para las operaciones en Mainnet, deben utilizar dispositivos físicos de firma y almacenamiento seguro de claves.

Los archivos de configuración de la cadena deben mantenerse organizados y tener copias de seguridad.

Los desarrolladores deben documentar cada comando de despliegue y todos los valores importantes que genere.

Nunca deben confiar únicamente en Avalanche CLI como prueba de que una cadena de producción es segura.

Ventajas de Avalanche CLI

La primera ventaja de Avalanche CLI es que facilita el aprendizaje del desarrollo de Avalanche L1.

La segunda es que permite configurar cadenas de forma guiada mediante flujos interactivos.

La tercera es que simplifica el despliegue en redes locales.

La cuarta es que permite preparar despliegues en testnet y Mainnet.

La quinta es que facilita la gestión de los flujos de trabajo de nodos y validadores.

La sexta es que permite gestionar claves durante el desarrollo.

La séptima es que admite flujos de actualización de cadenas y máquinas virtuales.

La octava es que facilita operaciones de desarrollo relacionadas con ICM.

La novena es que permite repetir los procesos con más facilidad que una configuración manual.

La décima es que ofrece a los desarrolladores una forma práctica de explorar el diseño de Avalanche L1 antes de crear una infraestructura de producción completa.

Limitaciones de Avalanche CLI

La primera limitación es que Avalanche CLI está en modo de mantenimiento desde diciembre de 2025.

La segunda es que no sustituye a las auditorías de seguridad.

La tercera es que no garantiza un despliegue seguro en Mainnet.

La cuarta es que no resuelve el diseño de la gobernanza de los validadores.

La quinta es que no protege automáticamente las claves privadas.

La sexta es que algunas áreas de los comandos de nodo aparecen marcadas como experimentales o alfa en la referencia de comandos.

La séptima es que puede no admitir todas las funciones futuras de Avalanche como flujos de trabajo integrados.

La octava es que requiere familiaridad con el terminal y conocimientos de configuración de blockchains.

La novena es que un despliegue local correcto no demuestra que el sistema esté listo para producción.

La décima es que los equipos deben seguir manteniendo la monitorización, las actualizaciones, la respuesta ante incidentes y la documentación después del despliegue.

Errores habituales al utilizar Avalanche CLI

Un error habitual es seguir un tutorial desactualizado sin consultar la documentación actual.

Otro es confundir la antigua terminología Subnet con el término más reciente Avalanche L1.

Un tercer error es desplegar en Mainnet antes de completar un ensayo exhaustivo en Fuji Testnet.

Un cuarto es utilizar la misma clave para las pruebas locales y el despliegue de producción.

Un quinto es exportar claves privadas sin controles de almacenamiento seguro.

Un sexto es ignorar las advertencias de los comandos experimentales.

Un séptimo es considerar segura una configuración de cadena generada sin revisar todos sus parámetros.

Un octavo es no documentar los ID de cadena, endpoints RPC, direcciones de validadores y direcciones de contratos después del despliegue.

Un noveno es lanzar una L1 sin planes de monitorización y respuesta ante incidentes.

Un décimo es suponer que la CLI protegerá al equipo frente a defectos de diseño relacionados con la gobernanza, la tokenomics, los validadores o las aplicaciones.

Avalanche CLI para principiantes

Los principiantes deben utilizar Avalanche CLI primero como herramienta de aprendizaje.

Un buen flujo de trabajo inicial consiste en instalar la herramienta desde el repositorio oficial, crear una configuración de Avalanche L1 basada en EVM, desplegarla localmente y conectar una wallet o aplicación a la cadena local.

Así se aprende la diferencia entre una configuración de cadena y una red activa.

También se entiende por qué importan los validadores, los tokens de gas, los archivos de génesis, los ID de cadena y los endpoints RPC.

Los principiantes deben evitar desplegar en Mainnet hasta comprender todos los pasos del proceso local y de testnet.

También deben evitar utilizar claves privadas o fondos reales durante las primeras prácticas.

Avalanche CLI puede hacer que los conceptos avanzados parezcan sencillos, pero el sistema subyacente sigue siendo un entorno blockchain real.

Los nuevos desarrolladores deben leer con atención la salida de los comandos y evitar copiar comandos que no entiendan.

El objetivo no es solo poner una cadena en funcionamiento.

También consiste en entender por qué importa cada decisión de configuración.

Avalanche CLI para equipos

Los equipos deben utilizar Avalanche CLI dentro de un proceso de desarrollo estructurado.

Deben definir quién puede crear configuraciones, quién puede aprobar el despliegue, quién controla las claves, quién monitoriza los validadores y quién puede autorizar actualizaciones.

También deben conservar los registros de despliegue y la documentación de las configuraciones.

Siempre que sea posible, deben separar las funciones de desarrolladores, operadores, revisores de seguridad y participantes en la gobernanza.

Antes del lanzamiento, deben probar la recuperación ante desastres y la sustitución de validadores.

También deben preparar documentación para los usuarios que explique el ID de cadena de la L1, los endpoints RPC, el token de gas, las rutas de los bridges, el modelo de validadores y los supuestos de riesgo.

Avalanche CLI puede agilizar el despliegue, pero los equipos siguen necesitando rendición de cuentas.

Si los usuarios mantienen activos reales en ella, una Avalanche L1 de producción es un sistema financiero público.

Ese nivel exige más que ejecutar correctamente un comando en el terminal.

Exige madurez operativa.

Términos cripto relacionados

CLI significa interfaz de línea de comandos: una forma de ejecutar comandos de software desde un terminal.

Avalanche L1 es una blockchain de Avalanche personalizable, con reglas, validadores y entorno de ejecución propios.

Subnet es el término anterior que suele utilizarse para lo que ahora se denomina Avalanche L1.

Subnet-EVM es una máquina virtual compatible con EVM que se utiliza en muchas Avalanche L1.

Un archivo de génesis es la configuración inicial que define el estado de partida de una blockchain.

Un validador es el operador de un nodo que participa en el consenso de una blockchain.

Fuji Testnet es la red pública de pruebas de Avalanche para desarrollo y pruebas.

Mainnet es la red activa en la que intervienen activos y usuarios reales.

ICM significa Avalanche Interchain Messaging, un protocolo de comunicación entre Avalanche L1.

AvalancheGo es el software de nodo utilizado para ejecutar nodos de la red Avalanche.

Preguntas frecuentes

¿Qué es Avalanche CLI?

Avalanche CLI es una herramienta de línea de comandos para crear, probar, desplegar, gestionar y actualizar blockchains Avalanche L1.

¿Para qué se utiliza Avalanche CLI?

Se utiliza para configurar Avalanche L1, realizar despliegues locales y en testnet, preparar despliegues en Mainnet, gestionar nodos y validadores, administrar claves, actualizar cadenas y realizar operaciones relacionadas con ICM.

¿Sigue desarrollándose activamente Avalanche CLI?

El aviso oficial de versiones de GitHub indica que Avalanche CLI entró en modo de mantenimiento en diciembre de 2025. No hay nuevas funciones previstas por Ava Labs y solo se abordarán parches de seguridad y correcciones de errores críticos.

¿Puede Avalanche CLI crear una Avalanche L1?

Sí. El comando avalanche blockchain create puede crear una nueva configuración de Avalanche L1 mediante un asistente interactivo.

¿Puede Avalanche CLI realizar despliegues locales?

Sí. Avalanche CLI puede desplegar una configuración de Avalanche L1 existente en una red local de Avalanche para desarrollo y pruebas.

¿Puede Avalanche CLI desplegar en Mainnet?

Sí. Avalanche CLI puede facilitar los flujos de trabajo de despliegue en Mainnet, pero la documentación oficial advierte de que estos despliegues conllevan muchos riesgos y exigen prestar especial atención a la seguridad.

¿Qué sistemas operativos son compatibles con Avalanche CLI?

El repositorio oficial indica que Avalanche CLI se ha probado en Linux y Mac, mientras que Windows no es compatible actualmente.

¿Cuál es la diferencia entre Avalanche CLI y AvalancheGo?

Avalanche CLI es una herramienta de línea de comandos para desarrolladores, mientras que AvalancheGo es el software de nodo utilizado para ejecutar nodos de la red Avalanche.

¿Avalanche CLI sustituye a las auditorías?

No. Avalanche CLI puede facilitar los flujos de trabajo, pero no sustituye a las auditorías de código, la revisión de configuraciones, la seguridad de las claves, la planificación de validadores ni la monitorización de producción.

¿Cuál es la forma más segura de aprender a utilizar Avalanche CLI?

La forma más segura consiste en instalarla desde fuentes oficiales, crear una L1 de prueba, desplegarla localmente y después ensayar en Fuji Testnet antes de plantearse utilizar Mainnet.

¿Avalanche CLI admite máquinas virtuales personalizadas?

Sí. La referencia oficial de comandos indica que el flujo blockchain create admite Subnet-EVM y máquinas virtuales personalizadas que utilizan archivos de génesis y binarios de VM personalizados.

¿Cuál es el mayor riesgo de utilizar Avalanche CLI?

El mayor riesgo es tratar un flujo de trabajo guiado en línea de comandos como una garantía de seguridad, cuando el despliegue de una L1 de producción también exige claves seguras, infraestructura probada, gobernanza de validadores, monitorización y respuesta ante incidentes.

Conclusión

Avalanche CLI es una herramienta importante para desarrollar y gestionar blockchains Avalanche L1.

Ayuda a crear configuraciones de cadenas, desplegar redes locales, ensayar en Fuji Testnet, preparar despliegues en Mainnet, gestionar nodos, consultar validadores y claves, actualizar máquinas virtuales e interactuar con flujos de trabajo de ICM.

Su principal ventaja es que convierte pasos complejos del desarrollo de Avalanche L1 en comandos de terminal estructurados y flujos guiados.

Esto la hace útil para aprender, crear prototipos, realizar pruebas y llevar a cabo algunas tareas operativas.

Sin embargo, Avalanche CLI debe utilizarse con expectativas actualizadas.

Desde diciembre de 2025, el repositorio oficial de GitHub indica que la herramienta está en modo de mantenimiento.

Por ello, los desarrolladores no deben dar por hecho que se desarrollarán muchas funciones nuevas y deben comprobar cuidadosamente la compatibilidad actual antes de depender de ella en flujos de producción.

Avalanche CLI tampoco garantiza la seguridad.

Puede ayudar a desplegar una cadena, pero no garantizar que sean seguros el diseño de validadores, la gestión de claves, la gobernanza, la tokenomics, las actualizaciones, los bridges, los contratos o la infraestructura.

El proceso de desarrollo más seguro empieza en local, continúa con pruebas en Fuji, protege adecuadamente las claves, documenta cada configuración y monitoriza los nodos. El despliegue en Mainnet solo debe hacerse después de una revisión rigurosa.

Para los principiantes, Avalanche CLI es una de las mejores formas de entender cómo funcionan las Avalanche L1 en la práctica.

Para los equipos, es una herramienta útil para los flujos de trabajo que debe combinarse con DevOps profesional, auditorías, políticas de seguridad y controles de gobernanza.

La lección principal es que Avalanche CLI facilita el desarrollo de Avalanche L1, pero no hace que las operaciones de blockchain sean sencillas ni estén exentas de riesgos.

Utilizada con cuidado, puede acelerar el desarrollo y reducir el trabajo de configuración manual.

Utilizada sin cuidado, puede ayudar a desplegar configuraciones inseguras más rápido de lo que el equipo está preparado para gestionarlas.