> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Helius CLI > Interfaz de línea de comandos para Helius con más de 95 comandos para administrar cuentas, consultar Solana, enviar transacciones, gestionar webhooks, transmitir datos y automatizar el staking. La [Helius CLI](https://www.npmjs.com/package/helius-cli) es una interfaz de línea de comandos completa para la plataforma Helius. Proporciona más de 95 comandos para administrar cuentas, consultar datos de blockchain, enviar transacciones, gestionar webhooks, transmitir datos en tiempo real, hacer staking, usar ZK Compression y mucho más. Además, ofrece resultados JSON procesables por máquinas para cada comando. **¿Usas una herramienta de IA compatible con MCP?** El [servidor MCP de Helius](/docs/es/agents/mcp) es la forma recomendada para que los agentes de IA interactúen con Helius. Proporciona 10 herramientas enrutadas con entradas y salidas estructuradas, incluido el registro de cuentas integrado. Usa la CLI para scripts de shell, pipelines de CI/CD o cuando MCP no esté disponible. ## Instalación ```bash theme={"system"} npm install -g helius-cli ``` ## Inicio rápido — Usuarios existentes Si ya tienes una clave de API de Helius, solo configúrala y comienza: ```bash theme={"system"} helius config set-api-key YOUR_API_KEY ``` Obtén tu clave en [dashboard.helius.dev](https://dashboard.helius.dev). Eso es todo; omite los pasos de registro que aparecen a continuación. ## Inicio rápido — Usuarios nuevos Las invocaciones de `helius signup` que crean cuentas requieren `--email`, `--first-name` y `--last-name`, incluido el plan Agent. `helius signup --resume`, que completa un registro existente después de pagar mediante el enlace alojado, no necesita otros indicadores. ```bash theme={"system"} helius keygen ``` Resultado: ``` ✓ Keypair generated Path: ~/.helius/keypair.json Address: 7xKp...3nQm To use this wallet, fund it with: • ~0.001 SOL for transaction fees • 1 USDC for Helius signup ``` La sugerencia de fondos anterior solo se aplica si usarás el pago automático. No agregues fondos si planeas pagar mediante el enlace alojado. Hay dos modos de pago: enlace alojado (paga desde cualquier billetera sin agregar fondos) o pago automático (paga USDC desde el par de claves local, que debe contener aproximadamente 0.001 SOL más el importe del plan). ```bash theme={"system"} # Default: print a hosted payment link, pay with any wallet in the browser helius signup --email you@example.com --first-name Jane --last-name Doe # After paying via link, finalize the account helius signup --resume # Or autopay from the local keypair helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe ``` ```bash theme={"system"} helius projects helius apikeys helius rpc ``` Tu clave de API es información confidencial que permite acceder a tu cuenta de Helius. Nunca la expongas en código del lado del cliente, repositorios públicos ni áreas accesibles desde el navegador. ## Planes y precios Puedes comprar cualquier plan compartido de Helius directamente mediante la CLI. Pasa `--plan` durante el registro o usa `helius upgrade` más adelante: | Plan | Precio | Créditos | Valor de `--plan` | | ------------ | ---------------- | ----------- | ----------------- | | Agent | \$1 una sola vez | 1,000,000 | `agent` | | Developer | \$49/mes | 10,000,000 | `developer` | | Business | \$499/mes | 100,000,000 | `business` | | Professional | \$999/mes | 200,000,000 | `professional` | El plan **Agent** (`agent`) es el predeterminado. Cuesta \$1 (pagado en USDC) para evitar abusos y te proporciona 1,000,000 de créditos. Para obtener límites de frecuencia más altos y más créditos, regístrate con un plan de pago o mejora tu plan más adelante. ### Registro con un plan específico ```bash theme={"system"} # Default: Agent plan ($1) helius signup --email you@example.com --first-name Jane --last-name Doe # Developer plan ($49/mo) helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe # Yearly billing (paid plans only) helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe ``` ### Mejorar una cuenta existente ```bash theme={"system"} helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe ``` ### Pagar una renovación Cuando vence la renovación de una suscripción (mensual o anual), Helius crea una **intención de pago**: un pago pendiente con un ID, importe y vencimiento únicos. Recibirás el ID de la intención de pago por correo electrónico o mediante el [panel](https://dashboard.helius.dev). ```bash theme={"system"} helius pay ``` El comando obtiene los detalles de la intención, muestra el importe y el vencimiento, solicita confirmación y luego envía el pago en USDC desde la billetera de tu par de claves. ## Referencia de comandos La CLI proporciona más de 95 comandos en 14 categorías. Todos los comandos admiten `--json` para generar resultados procesables por máquinas y las anulaciones globales `--api-key ` / `--network `. Los más de 95 comandos: administración de cuentas, consultas de blockchain, API de DAS, billetera, webhooks, envío de transacciones, WebSockets, staking, compresión ZK y mucho más ## Modo de salida JSON Agrega `--json` a cualquier comando para obtener resultados procesables por máquinas: ```bash theme={"system"} helius projects --json helius balance Gh9ZwEm... --json helius asset owner 86xCnPe... --json ``` Ejemplo: ```json theme={"system"} { "projects": [ { "id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf", "name": "My Project", "plan": "free" } ] } ``` ## Códigos de salida Los agentes deben comprobar los códigos de salida para garantizar una automatización confiable: | Código | Significado | | ------ | ------------------------------- | | 0 | Éxito | | 1 | Error general | | 10 | No se inició sesión | | 11 | No se encontró el par de claves | | 20 | SOL insuficiente | | 21 | USDC insuficiente | | 30 | No se encontraron proyectos | | 31 | No se encontró el proyecto | | 40 | Error de API | ## Configuración La configuración se almacena en `~/.helius/`: ``` ~/.helius/ ├── config.json # JWT token, API key, network, default project └── keypair.json # Solana keypair (if generated with keygen) ``` Administra la configuración con: ```bash theme={"system"} helius config show # View current config helius config set-api-key # Set API key helius config set-network devnet # Switch to devnet helius config set-project # Set default project helius config clear # Reset everything ``` ### Orden de resolución de claves de API Las claves de API se resuelven en este orden: 1. Indicador `--api-key ` (anulación por comando) 2. Variable de entorno `HELIUS_API_KEY` 3. `~/.helius/config.json` (configurado mediante `helius config set-api-key`) ## Opciones globales Todos los comandos aceptan estos indicadores: | Indicador | Descripción | | ---------------------- | --------------------------------------------------------------------- | | `--api-key ` | Anula la clave de API configurada | | `--network ` | Anula la red (`mainnet` o `devnet`) | | `--json` | Genera la salida en formato JSON | | `-k, --keypair ` | Ruta al archivo del par de claves (para comandos que requieren firma) | ## Flujo de trabajo completo para agentes ```bash theme={"system"} # Step 1: Generate keypair helius keygen # Step 2: Create account (default: hosted payment link, pay from any wallet) helius signup --email you@example.com --first-name Jane --last-name Doe helius signup --resume # Finalize after paying via link # Or autopay from the local keypair (requires ~0.001 SOL + plan USDC): # helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe # Step 3: Get API keys helius projects helius apikeys # Step 4: Get RPC endpoints helius rpc # Step 5: Start querying helius balance
helius asset owner helius tx history
--limit 10 ``` ## Próximos pasos Orientación sobre la API, flujos de trabajo y manejo de errores para agentes Conecta herramientas de IA directamente con las API de Helius Conoce los planes de Helius y las opciones de mejora Supervisa el uso de tu API y administra las claves ## Soporte Únete a nuestro Discord para obtener ayuda en tiempo real y soporte de la comunidad Comunícate directamente con nuestro equipo de soporte