Near CLI

¿Qué es Near CLI?

Near CLI es una herramienta de línea de comandos que permite a usuarios y desarrolladores interactuar con la blockchain NEAR desde un terminal.

En el sector cripto, CLI significa «interfaz de línea de comandos» (command-line interface): una herramienta basada en texto para ejecutar comandos de blockchain, en lugar de utilizar únicamente una wallet web o una aplicación.

La versión moderna de Near CLI suele conocerse como

, una utilidad de consola basada en Rust diseñada para ayudar a gestionar cuentas, claves, contratos inteligentes, tokens, transacciones y ajustes de red.

El sitio web oficial de Near CLI la describe como una CLI de NEAR Protocol fácil de usar, con indicaciones interactivas que guían a los usuarios por los comandos.

Near CLI puede utilizarse para aprender en testnet, desplegar contratos inteligentes, gestionar cuentas, transferir tokens, interactuar con NFT, realizar acciones relacionadas con el staking y automatizar flujos de trabajo de blockchain.

Near CLI no es una wallet, una blockchain ni un token independiente.

Es una interfaz que envía consultas y transacciones firmadas a la blockchain NEAR mediante conexiones RPC.

Como Near CLI puede firmar transacciones reales de blockchain, debe tratarse como una herramienta cripto potente que exige gestionar las claves con cuidado y revisar las transacciones.

Por qué es importante Near CLI en el sector cripto

Near CLI es importante porque muchas acciones de blockchain son más fáciles de probar, repetir, automatizar y depurar desde un terminal.

Los desarrolladores utilizan Near CLI para crear cuentas, desplegar contratos inteligentes, llamar a métodos de contratos, consultar el estado de estos, gestionar claves de acceso y probar aplicaciones antes de su lanzamiento.

Los usuarios avanzados pueden utilizar Near CLI para inspeccionar cuentas, enviar tokens, interactuar con tokens fungibles NEP-141, interactuar con NFT NEP-171 y gestionar la configuración de la red.

Los equipos de proyecto pueden utilizar Near CLI para scripts de despliegue, operaciones de tesorería, flujos de trabajo DAO, procesos de prueba y mantenimiento de producción.

Esto hace que Near CLI sea importante para el ámbito técnico del ecosistema NEAR.

Sin embargo, el control que ofrecen los comandos puede entrañar riesgos, porque un comando incorrecto puede enviar activos, cambiar permisos o desplegar código en la cuenta equivocada.

Un flujo de trabajo seguro con Near CLI debe incluir siempre la comprobación de la red y la cuenta, la protección de las claves, la revisión de las transacciones y la práctica en testnet antes de utilizar mainnet.

Near CLI y near-cli-rs

Near CLI es el nombre general de la interfaz de línea de comandos de NEAR.

es la implementación actual basada en Rust que se utiliza en los flujos de trabajo modernos de desarrollo de NEAR.

El repositorio oficial de near-cli-rs en GitHub describe la herramienta como un complemento fácil de usar para interactuar con NEAR Protocol desde la línea de comandos.

El antiguo repositorio de NEAR CLI basado en Node.js está marcado como obsoleto y recomienda migrar a

.

Esta diferencia es importante porque los tutoriales antiguos pueden mostrar comandos o pasos de instalación desactualizados.

Los usuarios deben seguir la documentación oficial vigente en lugar de copiar comandos de publicaciones, capturas de pantalla o guías archivadas antiguas.

Cómo funciona Near CLI

Near CLI convierte los comandos del terminal en consultas o transacciones de la blockchain NEAR.

Un comando de solo lectura puede consultar saldos de cuentas, datos de contratos, metadatos de tokens, claves de acceso o información sobre transacciones sin modificar el estado de la blockchain.

Un comando que modifica el estado crea una transacción que debe firmarse con una clave válida de una cuenta.

Las acciones que modifican el estado pueden incluir enviar NEAR, transferir tokens, desplegar contratos, añadir claves, eliminar claves, llamar a métodos que admiten depósitos o cambiar el estado de un contrato inteligente.

Una vez firmada la transacción, Near CLI la envía a un endpoint RPC de NEAR para que la procese la red.

A continuación, la CLI muestra el resultado, como el estado de la transacción, los registros, los datos devueltos, el consumo de gas o un mensaje de error.

Este flujo convierte Near CLI en un enlace directo entre el terminal del usuario y la blockchain NEAR.

Instalar Near CLI

Near CLI puede instalarse mediante varios métodos oficiales, según el sistema operativo y la configuración de desarrollo del usuario.

La página oficial de instalación de Near CLI enumera opciones como un instalador de shell, un instalador de PowerShell, npm, npx, Cargo y binarios precompilados.

La guía oficial de NEAR para crear cuentas también muestra opciones de instalación de

para los desarrolladores que quieran crear y utilizar cuentas de testnet.

Los usuarios solo deben instalar Near CLI desde fuentes oficiales, ya que una CLI falsa podría robar claves, modificar comandos o engañarlos para que firmen transacciones perjudiciales.

Después de la instalación, pueden ejecutar

para abrir las indicaciones interactivas o consultar los flujos de comandos disponibles.

Los equipos de proyecto deben documentar la versión de la CLI que utilizan en sus scripts, ya que el comportamiento de los comandos puede cambiar entre versiones.

Near CLI y las cuentas NEAR

Las cuentas NEAR son cuentas de blockchain con nombres legibles que pueden guardar activos, tener claves de acceso, desplegar contratos inteligentes e interactuar con aplicaciones descentralizadas.

Near CLI puede ayudar a crear, importar, inspeccionar y gestionar cuentas, según la red y el flujo de trabajo.

La guía oficial para crear cuentas NEAR explica que los desarrolladores suelen interactuar con NEAR mediante la CLI cuando crean contratos inteligentes.

Los nombres de las cuentas deben comprobarse cuidadosamente antes de cada transacción, ya que los ID de cuenta parecidos pueden provocar errores.

Un usuario puede mantener cuentas distintas para trabajar en testnet, guardar activos de mainnet, desplegar contratos, gestionar la tesorería y realizar pruebas.

Esta separación reduce la posibilidad de que un error de desarrollo afecte a activos valiosos o contratos de producción.

Near CLI y las claves de acceso

Las claves de acceso son una de las funciones de seguridad más importantes para gestionar cuentas NEAR.

Una clave de acceso total puede realizar acciones de gran alcance, como transferir activos, desplegar contratos, añadir claves o eliminarlas.

Una clave de acceso para llamadas a funciones puede limitarse a acciones concretas de contratos y ser más segura para gestionar permisos de aplicaciones.

Near CLI puede ayudar a consultar, añadir, importar y gestionar claves.

Si se filtra una clave de acceso total, toda la cuenta puede quedar en riesgo.

Los usuarios deben evitar guardar claves privadas en repositorios de código, capturas de pantalla, registros compartidos, mensajes de chat, terminales públicos o carpetas en la nube poco seguras.

Las claves antiguas o que ya no se utilicen deben eliminarse.

Near CLI y los contratos inteligentes

Near CLI se utiliza ampliamente para desarrollar contratos inteligentes en NEAR.

La guía oficial de NEAR para desplegar contratos inteligentes explica cómo utilizar NEAR CLI para desplegar un contrato y llamar a sus métodos.

Los contratos inteligentes de NEAR suelen compilarse en archivos WebAssembly antes de su despliegue.

Near CLI puede desplegar un archivo

compilado en una cuenta NEAR que almacenará el código del contrato.

Después del despliegue, Near CLI puede llamar a métodos de consulta para leer datos o a métodos de cambio para actualizar el estado.

Las llamadas de consulta sirven para comprobar saldos, metadatos, configuración y valores almacenados.

Las llamadas de cambio requieren transacciones firmadas y pueden modificar el estado del contrato, mover activos o adjuntar depósitos.

Los desarrolladores deben probar el despliegue de contratos y las llamadas a métodos en testnet antes de utilizar mainnet.

Near CLI y los tokens

Near CLI puede interactuar con los estándares de tokens de NEAR llamando a métodos estándar de contratos inteligentes.

En el caso de los tokens fungibles, la guía oficial sobre el estándar de tokens fungibles de NEAR explica que NEP-141 es la especificación de los contratos de tokens fungibles en NEAR.

Near CLI puede llamar a métodos NEP-141 para consultar saldos, realizar transferencias, registrar almacenamiento y ejecutar flujos de trabajo entre tokens y contratos, siempre que el usuario indique la cuenta de contrato y los argumentos correctos.

En el caso de los NFT, la guía oficial sobre el estándar de NFT de NEAR explica que NEP-171 es la especificación de los tokens no fungibles en NEAR.

Near CLI puede llamar a métodos de NFT para consultar datos de tokens, transferir NFT, autorizar cuentas o interactuar con la lógica específica de un proyecto de NFT.

Antes de firmar, los usuarios deben verificar las cuentas de los contratos de tokens y NFT, los ID de token, las cuentas receptoras y los argumentos de los métodos.

El símbolo de un token o la imagen de un NFT no bastan para demostrar que un activo sea oficial.

Near CLI y los depósitos de almacenamiento

Los depósitos de almacenamiento son importantes en NEAR porque los contratos pagan por los datos persistentes que guardan on-chain.

Es posible que un contrato de tokens NEP-141 exija que una cuenta registre almacenamiento antes de poder recibir o mantener ese token.

Un contrato relacionado con NFT o un mercado también puede exigir depósitos de almacenamiento para anuncios, autorizaciones o registros de usuarios.

Near CLI puede llamar a métodos relacionados con el almacenamiento cuando el contrato los admite.

Los usuarios no deben confundir los depósitos de almacenamiento con las comisiones de gas.

El gas paga el cálculo, mientras que los depósitos de almacenamiento reservan espacio de almacenamiento en la blockchain para los datos del contrato.

Antes de adjuntar un depósito, los usuarios deben leer la documentación del contrato y confirmar la cantidad necesaria.

Near CLI y testnet

Testnet es el mejor lugar para aprender a utilizar Near CLI, ya que los errores no ponen en riesgo los activos de mainnet.

Un desarrollador puede crear una cuenta de testnet, desplegar un contrato, llamar a métodos, registrar almacenamiento, enviar tokens de prueba y revisar los resultados de las transacciones.

Practicar en testnet ayuda a entender las cuentas, las claves, el gas, los depósitos, los argumentos JSON y el comportamiento de los contratos.

Sin embargo, que una operación funcione en testnet no garantiza la seguridad en mainnet.

Mainnet implica activos y costes reales, así como una mayor presión operativa.

Antes de firmar transacciones, los usuarios deben comprobar siempre si Near CLI está configurada para testnet o mainnet.

Near CLI y la seguridad en mainnet

Los comandos de Near CLI en mainnet pueden afectar a activos reales y contratos activos.

Una transferencia en mainnet envía valor real.

Un despliegue en mainnet puede actualizar el código de un contrato de producción.

Una acción sobre una clave en mainnet puede cambiar quién controla una cuenta.

Antes de firmar, los usuarios deben comprobar la red, la cuenta firmante, la cuenta receptora, el nombre del método, los argumentos JSON, el gas, el depósito adjunto y el resultado esperado.

Para acciones importantes, los equipos deberían utilizar listas de comprobación, revisiones por pares, firma con hardware, gobernanza multifirma o flujos de aprobación de DAO cuando corresponda.

Near CLI nunca debe utilizarse en un dispositivo comprometido ni con comandos copiados de personas desconocidas.

Near CLI y los riesgos de seguridad

La seguridad de Near CLI depende de instalarla desde fuentes oficiales, utilizar dispositivos seguros, almacenar las claves con cuidado y revisar las transacciones.

La guía de la FTC sobre estafas con criptomonedas aconseja tener cuidado con las estafas cripto que recurren a la suplantación de identidad, la urgencia y las promesas sospechosas.

Un estafador podría publicar un tutorial, paquete, comando para reclamar activos o mensaje de soporte falsos que insten a los usuarios a ejecutar comandos perjudiciales.

Ninguna herramienta legítima de NEAR, cuenta de soporte ni contrato debería pedir una frase semilla o una clave privada en un chat público o en un sitio web aleatorio.

Los usuarios nunca deben pegar claves privadas en scripts desconocidos.

Antes de ejecutar comandos que no conozcan, deben verificar la documentación en fuentes oficiales de NEAR.

Deben utilizar cuentas distintas para desarrollo, pruebas, producción y almacenamiento de activos de gran valor.

Near CLI e impuestos

La actividad realizada con Near CLI puede generar registros importantes para cuestiones fiscales y contables.

La página oficial del IRS sobre activos digitales indica que quizá deban declararse las transacciones con activos digitales y que los ingresos procedentes de estos activos pueden estar sujetos a impuestos.

Utilizar Near CLI para enviar, recibir, hacer staking, reclamar, acuñar, vender, desplegar o transferir tokens, o interactuar con ellos, puede plantear cuestiones fiscales según el lugar de residencia y la situación personal del usuario.

Los usuarios deben guardar los hashes de las transacciones, las fechas, los ID de cuenta, las cantidades de tokens, los costes de gas, los depósitos de almacenamiento, los valores razonables de mercado y los datos de las acciones realizadas mediante contratos.

Los equipos de proyecto también deben llevar un registro de los costes de despliegue, los movimientos de tesorería, la distribución de tokens, las recompensas y los gastos operativos.

Las normas fiscales varían según la jurisdicción, por lo que los usuarios con una actividad relevante deberían hablar con un profesional fiscal cualificado.

Ventajas de Near CLI

Near CLI ofrece a los desarrolladores y a los usuarios avanzados control directo sobre las acciones que realizan en la blockchain NEAR.

Permite gestionar cuentas y claves, desplegar contratos, llamar a métodos, operar con tokens y NFT, configurar parámetros y gestionar flujos de transacciones.

Puede agilizar el desarrollo porque los comandos se pueden repetir, documentar y automatizar.

Puede facilitar la depuración, ya que los usuarios pueden consultar directamente el estado de los contratos y los resultados de las transacciones.

Puede ayudar a gestionar operaciones profesionales si se utiliza con control de versiones, procesos de revisión, almacenamiento seguro de claves y listas de comprobación claras para los despliegues.

La principal ventaja de Near CLI es el control, y el principal requisito es utilizarla con responsabilidad.

Errores frecuentes al utilizar Near CLI

Un error frecuente es utilizar comandos desactualizados de la CLI obsoleta basada en Node.js en lugar de consultar la documentación actual de

.

Otro error es ejecutar un comando de mainnet pensando que la CLI está conectada a testnet.

Un tercer error es enviar activos al ID de cuenta equivocado.

Un cuarto error es desplegar el código del contrato en la cuenta equivocada.

Un quinto error es adjuntar un depósito excesivo a una llamada de contrato.

Un sexto error es exponer claves privadas en el historial del terminal, capturas de pantalla, registros o repositorios.

Un séptimo error es copiar comandos para llamar a contratos sin entender el método, los argumentos o el depósito adjunto.

Un octavo error es suponer que utilizar la línea de comandos es automáticamente más seguro que utilizar una interfaz de wallet.

Buenas prácticas para usuarios de Near CLI

Instala Near CLI únicamente desde fuentes oficiales de NEAR o near-cli-rs.

Empieza en testnet antes de utilizar mainnet.

Mantén las cuentas con activos de gran valor separadas de las cuentas de desarrollo.

Protege las claves privadas, las frases semilla y las frases de recuperación.

Comprueba la red, la cuenta firmante, la cuenta receptora, el método, los argumentos, el gas y el depósito antes de cada transacción.

Utiliza transacciones de prueba pequeñas al probar un flujo de trabajo nuevo.

Documenta los comandos importantes, los hashes de las transacciones y las versiones de los despliegues.

Actualiza Near CLI con cuidado y prueba los scripts después de cada actualización.

No ejecutes comandos procedentes de mensajes desconocidos, cuentas de soporte falsas o páginas sospechosas de airdrops.

Resumen SEO y AEO de Near CLI

Near CLI es una interfaz de línea de comandos para interactuar con la blockchain NEAR desde un terminal.

La implementación moderna actual es

, una herramienta basada en Rust con indicaciones interactivas.

Near CLI permite gestionar cuentas, claves, tokens, NFT, contratos inteligentes, transacciones, ajustes RPC y flujos de trabajo de despliegue.

Los desarrolladores utilizan Near CLI para desplegar contratos inteligentes WebAssembly y llamar a métodos de contratos.

Los usuarios pueden utilizar Near CLI para interactuar con NEAR nativo, tokens fungibles NEP-141 y NFT NEP-171.

La antigua NEAR CLI basada en Node.js está obsoleta, por lo que los usuarios deben seguir la documentación actual de

.

Near CLI es una herramienta potente, pero puede entrañar riesgos si se exponen claves privadas, se elige una red equivocada, se adjunta un depósito incorrecto o se firman comandos que no se entienden.

La forma más segura de utilizar Near CLI es empezar en testnet, verificar las fuentes oficiales, proteger las claves y revisar cada transacción antes de firmarla.

Preguntas frecuentes

¿Qué significa Near CLI?

Near CLI es la interfaz de línea de comandos que se utiliza para interactuar con la blockchain NEAR desde un terminal.

¿Near CLI es lo mismo que near-cli-rs?

Near CLI es el término general, mientras que

es la implementación actual basada en Rust que se utiliza habitualmente.

¿Se sigue recomendando la antigua NEAR CLI basada en Node.js?

No. La antigua NEAR CLI basada en Node.js está obsoleta y se recomienda utilizar

.

¿Qué se puede hacer con Near CLI?

Near CLI permite gestionar cuentas, claves, contratos inteligentes, tokens, NFT, transacciones, configuración, conexiones RPC y flujos de trabajo de despliegue.

¿Near CLI permite desplegar contratos inteligentes?

Sí. Near CLI puede desplegar contratos inteligentes WebAssembly compilados en cuentas NEAR.

¿Near CLI permite enviar tokens?

Sí. Near CLI puede enviar NEAR nativo e interactuar con contratos de tokens fungibles NEP-141 si el usuario proporciona la cuenta y los datos del método correctos.

¿Near CLI permite gestionar NFT?

Sí. Near CLI puede interactuar con contratos de NFT NEP-171 mediante llamadas a contratos estándar o específicas de un proyecto.

¿Es seguro Near CLI?

Near CLI puede utilizarse de forma segura si se instala desde fuentes oficiales y se protege el almacenamiento de claves, se comprueba cuidadosamente la red y se revisan las transacciones.

¿Deberían utilizar Near CLI los principiantes?

Los principiantes pueden utilizar Near CLI, pero deberían empezar en testnet y evitar usar cuentas con activos de gran valor mientras aprenden.

¿Qué debo comprobar antes de ejecutar un comando de Near CLI?

Debes comprobar la red, la cuenta firmante, la cuenta receptora, el nombre del método, los argumentos JSON, el gas, el depósito adjunto, los permisos de las claves y el resultado esperado.

Conclusión

Near CLI es una herramienta importante de línea de comandos para interactuar con la blockchain NEAR.

Ayuda a los desarrolladores y usuarios avanzados a gestionar cuentas, claves, contratos inteligentes, tokens, NFT, transacciones y configuración de red desde un terminal.

La experiencia moderna de Near CLI se basa en

, mientras que la antigua CLI basada en Node.js está obsoleta.

Near CLI resulta especialmente útil para desplegar contratos inteligentes, aprender en testnet, depurar, automatizar e interactuar directamente con contratos.

Su mayor ventaja es el control, pero ese control implica una responsabilidad.

Los usuarios deben instalarla únicamente desde fuentes oficiales, proteger las claves, separar los flujos de trabajo de testnet y mainnet, verificar cada comando y evitar copiar instrucciones de fuentes desconocidas.

Para los desarrolladores, Near CLI es una herramienta práctica para crear y mantener aplicaciones NEAR.

Para los usuarios de criptomonedas, es una interfaz potente que debe utilizarse con cuidado, ya que los comandos firmados pueden tener consecuencias reales en la blockchain.

La forma más segura de entender Near CLI es como una herramienta de terminal profesional para NEAR que funciona mejor con documentación oficial, hábitos seguros de gestión de claves y una revisión rigurosa de las transacciones.