Instalación de Web3.js
Hay pocas librerías que necesitas para empezar con JavaScript o TypeScript en Solana.
Web3.js
@solana/web3.js es una librería que tiene todas las herramientas básicas para interactuar con Solana, enviar transacciones, y leer desde la blockchain.
Lo puedes instalar con algunos de los siguientes comandos:
yarn add @solana/web3.js
npm install --save @solana/web3.js
<!-- Development (un-minified) -->
<script src="https://unpkg.com/@solana/web3.js@latest/lib/index.iife.js"></script>
<!-- Production (minified) -->
<script src="https://unpkg.com/@solana/web3.js@latest/lib/index.iife.min.js"></script>
SPL-Token
@solana/spl-token es una librería que contiene muchos de los bindings de JavaScript/TypeScript necesarios para interactuar con los tokens SPL. Puedes usar esta librería para mintear nuevos tokens SPL, transferir tokens, y más.
You can install this library with the following:
yarn add @solana/spl-token
npm install --save @solana/spl-token
<!-- Development (un-minified) -->
<script src="https://unpkg.com/@solana/spl-token@latest/lib/index.iife.js"></script>
<!-- Production (minified) -->
<script src="https://unpkg.com/@solana/spl-token@latest/lib/index.iife.min.js"></script>
Wallet-Adapter
Es una colección de librerías llamada wallet-adapter que te ayudan a conectarte a cualquier wallet dentro de Solana. Actualmente este paquete soporta usos con Svelte, Angular, Vue.js, y React. Wallet-adapter puede empezar rápidamente a integrar tu dAppp con wallets como Phantom, Solflare, y más.
Lo puedes instalar con algunos de los siguientes comandos:
yarn add @solana/wallet-adapter-wallets \
@solana/wallet-adapter-base
npm install --save @solana/wallet-adapter-wallets \
@solana/wallet-adapter-base
Instalación de Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Para Windows por favor visita el sitio de instalación de Rust
Instalación de CLI
macOS & Linux
Abre tu app terminal favorita.
Reemplaza LATEST_RELEASE con la versión deseada e instala la última release de Solana en tu máquina corriendo:
sh -c "$(curl -sSfL https://release.solana.com/LATEST_RELEASE/install)"
Puedes reemplazar LATEST_RELEASE con algún tag de release que se identifique con la versión de release que desees, o uses uno de los 3 canales simbólicos: stable, beta, o edge. Para encontrar la última release, revisa las versiones disponibles aquí.
La siguiente salida indica una actualización exitosa:
downloading LATEST_RELEASE installer
Configuration: /home/solana/.config/solana/install/config.yml
Active release directory: /home/solana/.local/share/solana/install/active_release
* Release version: LATEST_RELEASE
* Release URL: https://github.com/solana-labs/solana/releases/download/LATEST_RELEASE/solana-release-x86_64-unknown-linux-gnu.tar.bz2
Update successful
Dependiendo de tu sistema, al final de la instalación este mensaje puede aparecer:
Please update your PATH environment variable to include the solana programs:
Si ves el mensaje de arriba, copia y el pega el comando para actualizar PATH.
Confirma que tenes la versión de Solana deseada corriendo:
solana --version
Después de una instalación exitosa, solana-install update puede ser usado para actualizar fácilmente el software de Solana a una nueva versión en cualiquier momento.
Downloading Binaries (Linux)
Alternativamente puedes instalar los binarios en vez de utilizar solana-install.
Descarga los binarios navegando hacia https://github.com/solana-labs/solana/releases/latest, descargando solana-release-x86_64-unknown-linux-msvc.tar.bz2, después extrae el archivo:
tar jxf solana-release-x86_64-unknown-linux-gnu.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH
Downloading Binaries (macOS)
Alternativamente puedes instalar los binarios en vez de utilizar solana-install.
Descarga los binarios navegando hacia https://github.com/solana-labs/solana/releases/latest, descargando solana-release-x86_64-apple-darwin.tar.bz2, después extrae el archivo:
tar jxf solana-release-x86_64-apple-darwin.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH
Windows
Abre el Símbolo del sistema o Command Prompt (cmd.exe) como un Administrador.
Busca el Símbolo del Sistema o Command prompt en la barra de búsqueda de Windows. Cuando el Símbolo del Sistema aparezca, hacer click derecho y seleccionar "Abrir como administrador". Si te aparece una ventana preguntandote "Queres permitir a esta app que realice cambios en tu dispositivo?", clickea en "Si".
Copiar y pegar el siguiente comando, después apretar Entre para descargar el instalador de solana en una carpeta temporal.
curl https://release.solana.com/v1.9.16/solana-install-init-x86_64-pc-windows-msvc.exe --output C:\solana-install-tmp\solana-install-init.exe --create-dirs
Si v1.9.16 no es tu versión deseada, encuentra la última release acá.
Copiar y pegar el siguiente comando, después presionar Enter para instalar la última versión de Solana. Si ves un pop-up de seguridad de tu sistema, por favor selecciona permitir que el programa pueda correr.
C:\solana-install-tmp\solana-install-init.exe v1.9.16
Para encontrar la última release, revisa las versiones disponibles acá.
Cuando el instalador esta terminado, presiona Enter.
Cerra el Símbolo del Sistema o Command Prompt y re-abre un nuevo Símbolo del Sistema como un usuario normal.
Busca "Símbolo del Sistema" o "Command Prompt" en la barra de búsqueda, y hace click izquierdo en el mismo (no es necesario correrlo como Administrador).
Confirma que tenes tu versión deseada de Solana instalada corriendo el siguiente comando:
solana --version
Después de una instalación exitosa, solana-install update puede ser usado para actualizar fácilmente el software de Solana a una nueva versión en cualiquier momento.
Downloading Binaries
Alternativamente puedes instalar los binarios en vez de utilizar solana-install.
Descarga los binarios navegando hacia https://github.com/solana-labs/solana/releases/latest, descargando solana-release-x86_64-pc-windows-msvc.tar.bz2, después extrae el archivo usando WinZip o alguna herramienta similar.
Abre un Símbolo del Sistema y navega a la carpeta donde extrajiste los binarios y ejecuta los siguientes comandos:
cd solana-release/
set PATH=%cd%/bin;%PATH%
Compilación desde el Código Fuente
Sino pudiste usar los binarios pre-armados o prefieres compilarlos desde el código fuente navega a https://github.com/solana-labs/solana/releases/latest y descarga el archivo de código fuente. Extrae el código y compila los binarios con:
./scripts/cargo-install-all.sh .
export PATH=$PWD/bin:$PATH
Puedes ejecutar el siguiente comando para obtener el mismo resultado que con los binarios pre-armados.
solana-install init