Introducción a la CLI de Solana

Como parte de su viaje de desarrollo de Solana, deberá familiarizarse con la CLI de Solana.

Es muy poderoso y muy importante comprender algunos comandos para realizar algunas tareas específicas:

1️⃣ Crear billeteras
2️⃣ Actualizar la configuración de su red Solana
3️⃣ SOL gratuito desde el AirDrop (también conocido como fondos en su cuenta)
4️⃣ Ejecutar un validador de prueba
5️⃣ Implementar programas Solana

PD: También hay un video de YouTube para este tutorial de Solana.

Aprenda a utilizar la CLI de Solana

Esta guía asume que ya tiene instalada la CLI de Solana. Si no es así, consulte esta guía sobre cómo instalar Solana CLI en Linux.

Crea una billetera Solana para el desarrollo

Para implementar programas Solana en la cadena de bloques (ya sea un validador local o un RPC remoto), necesitará crear una billetera Solana.

Para simplificar, generaremos una billetera con sistema de archivos que almacenará nuestra clave privada (privateKey) en un archivo en su computadora. De esta manera, podemos decirle fácilmente a Solana CLI y/o Anchor CLI que usen esta billetera para implementar nuestros programas Solana.

La billetera del sistema de archivos predeterminada generalmente se encuentra en ~/.config/solana/id.json.

Cuando crea nuevas wallets de sistema de archivos, puede especificar cualquier ubicación de archivo específica con el indicador --outfile /path/to/file.

Para generar una nueva wallet (billetera) Solana utiliza este comando:

solana-keygen new --outfile ~/.config/solana/solfate-dev.json

Al generar cada wallet (billetera), también puedes establecer una frase de contraseña (como un archivo de claves SSH).

¡RECOMIENDO ENCARECIDAMENTE establecer una frase de contraseña para la billetera, especialmente para cualquier billetera que pueda usar en producción en algún momento!

Para efectos de este tutorial he decidido no usar esta frase de contraseña.

Una vez creada su billetera, obtendrá una lectura de su pubkey (también conocida como dirección de su billetera) y su frase inicial. No olvides escribir tu frase inicial en un lugar seguro si realmente vas a conservar esta dirección de billetera.

Lea la configuración de Solana

Para lograr cualquier cosa en la cadena de bloques de Solana, incluso con un validador de prueba local, deberá asegurarse de que su CLI de Solana esté configurada para conectarse a la red Solana RPC correcta y con la billetera correcta.

Para ver la configuración actual de Solana CLI, ejecute este comando:

solana config get

Debería obtener una lectura como esta:

Config File: /home/nick/.config/solana/cli/config.yml
RPC URL: https://api.testnet.solana.com
WebSocket URL: wss://api.testnet.solana.com/ (computed)
Keypair Path: /home/nick/.config/solana/id.json
Commitment: confirmed

Las configuraciones son MUY importantes son la URL RPC y el archivo Keypair Path.

RPC URL: le indica a la CLI a qué clúster de red Solana desea conectarse. Generalmente, para el desarrollo local, debe configurar su propio validador de pruebas local (también conocido como localnet). Solo los RPC de la “red principal” utilizarán realmente tokens SOL reales y, por lo tanto, dinero real.

Keypair Path: la clave privada de la billetera (como la que creamos anteriormente) para usar para implementar programas e interactuar con el RPC.

Actualice su configuración de Solana

Cuando desee cambiar la configuración de su red Solana o cambiar el archivo de clave de billetera predeterminado, deberá actualizar su configuración con la CLI de Solana.

Al configurar su URL RPC (también conocido como cambiar su red Solana), puede usar el nombre corto de la red (como “mainnet”, “testnet”, etc.) o la URL completa para un nodo RPC activo:

solana config set --url testnet

Para cambiar el archivo de la clave de billetera que utiliza la CLI:

solana config set --keypair /path/to/file

Consulta el saldo de tu billetera

Necesitará SOL para interactuar con la cadena de bloques, incluso durante el desarrollo. Siempre puede consultar fácilmente el saldo de su billetera (o la de cualquier persona) utilizando la CLI de Solana.

Para verificar el saldo de la dirección de su billetera configurada por CLI (también conocida como la que ha configurado con el archivo de claves de su sistema de archivos):

solana balance

Para consultar el saldo de cualquier otra billetera:

solana balance WALLET_ADDRESS_HERE

El comando solana balancesolo verificará el saldo de la billetera determinada en la red Solana actualmente seleccionada.

Financia tu billetera a través de AirDrop

Con su nueva configuración de billetera y seleccionada en la red RPC correcta, deberá depositar fondos en su billetera con SOL.

Este SOL se utilizará para implementar programas en la cadena de bloques, así como para pagar el alquiler y las transacciones mientras desarrolla programas.

Periódicamente, a medida que implemente o interactúe con los programas de Solana, deberá financiar su billetera con SOL (el token nativo de Solana).

Puede depositar fondos en su cuenta utilizando dos métodos:

1. AirDrop a través de Solana CLI

Para solicitar un AirDrop gratuito a su billetera seleccionada actualmente:

solana airdrop 1

El comando solana airdrop de solana tiene un límite en la cantidad de SOL que se puede lanzar. Cualquier solicitud que supere este límite hará que la transacción falle. Al momento de escribir esto, el límite es 5.

Tal como habrás adivinado, el AirDrop se producirá en la red que estás seleccionado en la configuración de Solana. Y no, el lanzamiento aéreo no funciona en la red principal. No seas tonto.

1. AirDrop a través de Solfate faucet

Otra manera fácil de obtener su SOL devnet y/o testnet gratuito en su billetera es usar un grifo público. Aquí en Solfate operamos un grifo público Solana faucet.

Todo lo que necesita hacer es ingresar la dirección de su billetera y hacer clic en el botón de la red Solana que desee: devnet o testnet.

Ejecute el validador de pruebas de Solana

Como mencioné anteriormente, cuando desarrolle sus programas Solana localmente, lo más probable es que desee ejecutar una versión de host local de la cadena de bloques Solana llamada “validador de prueba”(test validator). Tal como puede pensar, esto le permitirá tener una versión completa de la cadena de bloques Solana directamente en su computadora local.

Ejecutar y desarrollar usando el validador de pruebas es excelente (y recomendado) por varias razones:

• Transacciones aún más rápidas (¡tú eres el único que las realiza!)
• Menor riesgo de transacciones rechazadas
• sin limitación desde puntos finales RPC públicos
• fácil acceso a los registros del programa Solana (a través de la macro "msg" en Rust)

Para ejecutar el validador de pruebas de Solana, abra una nueva ventana de terminal y ejecute el siguiente comando:

solana-test-validator

Esta red localhost, también conocida como “localnet”, que se ejecuta en su terminal, enviará todos los mensajes que su programa Solana envíe a la cadena de bloques. Lo cual es una excelente manera de ayudar a depurar sus programas.

A excepción de algunos links actualizados y párrafos, este tutorial fue escrito en el idioma inglés por Nick Frostbutter. Muchas gracias por crear este tipo de contenido.

Espero esta traducción le sea de ayuda a la comunidad Hispanohablante que usa Solana que está creciendo enormemente.

Haz parte de la comunidad SOLANA LATAM.

HispanaSol