Documentación de SolanaPrimeros pasos

Instalación

Esta sección cubre los pasos para configurar tu entorno local para el desarrollo en Solana.

Instalación rápida

En Mac y Linux, ejecuta este único comando para instalar todas las dependencias.

Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Usuarios de Windows: primero deben instalar WSL (ver Instalar dependencias). Luego ejecuten el comando anterior en la terminal de Ubuntu (Linux).

Después de la instalación, deberías ver una salida como la siguiente:

Installed Versions:

Rust: rustc 1.86.0 (05f9846f8 2025-03-31)

Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Anchor CLI: anchor-cli 0.31.1

Node.js: v23.11.0

Yarn: 1.22.1

Si el comando de instalación rápida no funciona, consulta la sección Instalar dependencias a continuación para obtener instrucciones para instalar cada dependencia individualmente.

Si el comando de instalación rápida se ejecuta correctamente, salta a las secciones Conceptos básicos de la CLI de Solana y Conceptos básicos de la CLI de Anchor a continuación.

Instalar dependencias

Las instrucciones a continuación te guían a través de la instalación de cada dependencia individualmente.

  • Los usuarios de Windows primero deben instalar WSL (Subsistema de Windows para Linux) y luego instalar las dependencias especificadas en la sección de Linux a continuación.
  • Los usuarios de Linux deben comenzar con las dependencias especificadas en la sección de Linux a continuación.
  • Los usuarios de Mac deben comenzar con las instrucciones de instalación de Rust a continuación.

Instalar Rust

Los desarrolladores construyen programas de Solana utilizando el lenguaje de programación Rust.

Instala Rust con rustup.

Ejecuta el siguiente comando para instalar Rust:

Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Deberías ver el siguiente mensaje después de que se complete la instalación:

Ejecuta el siguiente comando para recargar tu variable de entorno PATH para incluir el directorio bin de Cargo:

Terminal
$ 
. "$HOME/.cargo/env"

Para verificar que la instalación se realizó correctamente, comprueba la versión de Rust:

Terminal
$ 
rustc --version

Deberías ver un resultado como el siguiente:

rustc 1.86.0 (05f9846f8 2025-03-31)

Instalar la CLI de Solana

La CLI de Solana proporciona todas las herramientas necesarias para construir y desplegar programas de Solana.

Instala el conjunto de herramientas de la CLI de Solana utilizando el comando de instalación oficial:

Terminal
$ 
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Puedes reemplazar stable con la etiqueta de versión que coincida con la versión de software de tu lanzamiento deseado (por ejemplo, v2.0.3), o usar uno de los tres nombres de canal simbólicos: stable, beta o edge.

Para una primera instalación de la CLI de Solana, es posible que veas el siguiente mensaje pidiéndote que añadas una variable de entorno PATH:

Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:



export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

Si estás usando Linux o WSL, necesitas añadir el binario de la CLI de Solana a tu PATH para que el comando esté disponible en tu terminal.

Primero, ejecuta el siguiente comando para comprobar qué shell estás utilizando:

Terminal
$ 
echo $SHELL
  • Si la salida contiene /bash, usa .bashrc.
  • Si la salida contiene /zsh, usa .zshrc.

Dependiendo de tu shell, ejecuta el comando apropiado.

Para Bash (bashrc):

Terminal
$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc

$ 
source ~/.bashrc

Para Zsh (zshrc):

Terminal
$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc

$ 
source ~/.zshrc

Luego ejecuta el siguiente comando para actualizar la sesión de terminal o reinicia tu terminal.

Terminal
$ 
source ~/.bashrc # If using Bash

$ 
source ~/.zshrc # If using Zsh

Para verificar que la instalación se realizó correctamente, comprueba la versión de Solana CLI:

Terminal
$ 
solana --version

Deberías ver un resultado como el siguiente:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Puedes ver todas las versiones disponibles en el repositorio de Github de Agave.

Agave es el cliente validator de Anza, anteriormente conocido como el cliente validator de Solana Labs.

Para actualizar posteriormente la Solana CLI a la última versión, puedes usar el siguiente comando:

Terminal
$ 
agave-install update

Instalar Anchor CLI

Anchor es un framework para desarrollar programas en Solana. El framework Anchor utiliza macros de Rust para simplificar el proceso de escribir programas en Solana.

Puedes instalar la CLI de Anchor y sus herramientas de dos maneras:

  1. Anchor Version Manager (AVM) - Método de instalación recomendado
  2. Sin AVM - Instalar directamente desde GitHub

El gestor de versiones de Anchor (AVM) te permite instalar y gestionar diferentes versiones de Anchor en tu sistema y actualizar fácilmente las versiones de Anchor en el futuro.

Instala AVM con el siguiente comando:

Terminal
$ 
cargo install --git https://github.com/coral-xyz/anchor avm --force

Confirma que AVM se ha instalado correctamente:

Terminal
$ 
avm --version

Instala la última versión de Anchor CLI usando AVM:

Terminal
$ 
avm install latest

$ 
avm use latest

Puedes instalar una versión específica de Anchor CLI especificando el número de versión:

Terminal
$ 
avm install 0.30.1

$ 
avm use 0.30.1

No olvides ejecutar el comando avm use para declarar la versión de Anchor CLI que se ejecutará en tu sistema.

  • Si instalaste la versión latest, ejecuta avm use latest.
  • Si instalaste la versión 0.30.1, ejecuta avm use 0.30.1.

Para verificar que la instalación se realizó correctamente, comprueba la versión de Anchor CLI:

Terminal
$ 
anchor --version

Deberías ver un resultado como el siguiente:

anchor-cli 0.31.1

Al instalar Anchor CLI en Linux o WSL, es posible que encuentres este error:

error: could not exec the linker cc = note: Permission denied (os error 13)

Si ves este mensaje de error:

  1. Instala las dependencias listadas en la sección Linux al principio de esta página.
  2. Intenta instalar Anchor CLI nuevamente.

Node.js y Yarn

El archivo de prueba predeterminado del proyecto Anchor (TypeScript) creado con el comando anchor init requiere Node.js y Yarn. (La plantilla de prueba en Rust está disponible usando anchor init --test-template rust)

Al ejecutar anchor build, si encuentras los siguientes errores:

Después de aplicar la solución anterior, intenta ejecutar anchor build nuevamente.

Al ejecutar anchor test después de crear un nuevo proyecto de Anchor en Linux o WSL, puedes encontrar los siguientes errores si no tienes Node.js o Yarn instalados:

Permission denied (os error 13)
No such file or directory (os error 2)

Conceptos básicos de Solana CLI

Esta sección explica algunos comandos comunes de Solana CLI para ayudarte a comenzar.

Configuración de Solana

Para ver tu configuración actual:

Terminal
$ 
solana config get

Deberías ver un resultado como el siguiente:

Config File: /Users/test/.config/solana/cli/config.yml

RPC URL: https://api.mainnet-beta.solana.com

WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)

Keypair Path: /Users/test/.config/solana/id.json

Commitment: confirmed

La URL RPC y la URL Websocket especifican el clúster de Solana al que la CLI realiza peticiones.

Puedes actualizar el clúster de la CLI de Solana usando los siguientes comandos:

Terminal
$ 
solana config set --url mainnet-beta

$ 
solana config set --url devnet

$ 
solana config set --url localhost

$ 
solana config set --url testnet

También puedes usar las siguientes opciones abreviadas:

Terminal
$ 
solana config set -um    # For mainnet-beta

$ 
solana config set -ud    # For devnet

$ 
solana config set -ul    # For localhost

$ 
solana config set -ut    # For testnet

La ruta del keypair apunta a la cartera predeterminada de Solana (keypair) utilizada por la CLI de Solana para pagar las comisiones de transacción y desplegar programas. Por defecto, este archivo se almacena en ~/.config/solana/id.json.

Crear cartera

Para enviar transacciones usando la CLI de Solana, necesitas una cartera de Solana financiada con SOL.

Para generar un keypair en la ruta predeterminada, ejecuta el siguiente comando:

Terminal
$ 
solana-keygen new

Deberías ver un resultado como el siguiente:

Generating a new keypair



For added security, enter a BIP39 passphrase



NOTE! This passphrase improves security of the recovery seed phrase NOT the

keypair file itself, which is stored as insecure plain text



BIP39 Passphrase (empty for none):



Wrote new keypair to /Users/test/.config/solana/id.json

===========================================================================

pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT

===========================================================================

Save this seed phrase and your BIP39 passphrase to recover your new keypair:

cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing

===========================================================================

Si ya tienes una cartera del sistema de archivos guardada en la ubicación predeterminada, este comando no la sobrescribirá a menos que fuerces explícitamente la sobrescritura usando la bandera --force.

Para ver la dirección de tu cartera (clave pública), ejecuta:

Terminal
$ 
solana address

Airdrop de SOL

Solicita un airdrop de SOL a tu cartera para pagar transacciones y despliegues de programas.

Configura tu clúster a devnet:

Terminal
$ 
solana config set -ud

Luego solicita un airdrop de SOL en devnet:

Terminal
$ 
solana airdrop 2

Los airdrops de devnet limitan las solicitudes a 5 SOL por petición. Si alcanzas los límites de frecuencia o encuentras errores, intenta usar el Faucet Web en su lugar.

Para verificar el saldo de SOL en tu wallet, ejecuta el siguiente comando:

Terminal
$ 
solana balance

Ejecutar un validator local

La CLI de Solana incluye un validator de prueba integrado para desarrollo local.

En una terminal separada, ejecuta el siguiente comando para iniciar un validator local:

Terminal
$ 
solana-test-validator

Recuerda también actualizar tu CLI para usar localhost antes de ejecutar comandos de Solana CLI:

Terminal
$ 
solana config set -ul

Conceptos básicos de Anchor CLI

Esta sección explica algunos comandos comunes de Anchor CLI para ayudarte a comenzar. Para más información sobre Anchor CLI, consulta la documentación de Anchor.

Inicializar proyecto

Para crear un nuevo proyecto de Anchor, ejecuta el siguiente comando:

Terminal
$ 
anchor init <project-name>

Por ejemplo, para crear un proyecto llamado my-project, ejecuta:

Terminal
$ 
anchor init my-project

Este comando crea un nuevo directorio con el nombre del proyecto e inicializa un nuevo proyecto de Anchor con un programa básico en Rust y una plantilla de prueba en TypeScript.

Navega al directorio del proyecto:

Terminal
$ 
cd <project-name>

Consulta la estructura de archivos del proyecto Anchor.

Compilar programa

Para compilar tu proyecto, ejecuta el siguiente comando:

Terminal
$ 
anchor build

Puedes encontrar el programa compilado en el directorio /target/deploy.

Desplegar programa

Para desplegar tu proyecto, ejecuta el siguiente comando:

Terminal
$ 
anchor deploy

Este comando despliega tu programa en el cluster especificado en el archivo Anchor.toml.

Probar programa

Para probar tu proyecto, ejecuta el siguiente comando:

Terminal
$ 
anchor test

Este comando compila, despliega y ejecuta las pruebas para tu proyecto.

Cuando usas localnet como cluster en Anchor.toml, Anchor automáticamente inicia un validador local, despliega tu programa, ejecuta las pruebas y luego detiene el validador.

Is this page helpful?

Anterior

Composición de múltiples programas

Siguiente

Conceptos fundamentales

Tabla de Contenidos

Editar Página

Gestionado por

© 2025 Fundación Solana. Todos los derechos reservados.
Solana
Conéctate
© 2025 Fundación Solana. Todos los derechos reservados.