Saltar al contenido principal

Configuración

Los contratos inteligentes Stellar son pequeños programas escritos en el lenguaje de programación Rust.

Para crear y desarrollar contratos, necesitas los siguientes requisitos previos:

Instalar Rust

Si usa macOS, Linux u otro sistema operativo tipo Unix, el método más simple para instalar una toolchain de Rust es instalar rustup. Instala rustup con el siguiente comando.

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

Luego reinicia la terminal.

Instalar el objetivo

You'll need a "target" for which your smart contract will be compiled. Qué objetivo necesitas dependerá de la versión de Rust que estés usando.

Para Rust v1.85.0 o superior, instala el objetivo wasm32v1-none.

rustup target add wasm32v1-none

Para versiones anteriores de Rust, instala el objetivo wasm32-unknown-unknown.

rustup target add wasm32-unknown-unknown

Configure an editor

Many editors have support for Rust. Visit the following link to find out how to configure your editor: https://www.rust-lang.org/tools

Here are the tools to you need to configure your editor:

  1. Visual Studio Code as code editor (or another code editor that supports Rust)
  2. Rust Analyzer for Rust language support
  3. CodeLLDB for step-through-debugging

Install the Stellar CLI

The Stellar CLI can execute smart contracts on futurenet, testnet, mainnet, as well as in a local sandbox.

información

The latest stable release is v22.6.0.

Install

There are a few ways to install the latest release of Stellar CLI.

Install with Homebrew (macOS, Linux):

brew install stellar-cli

Install with cargo from source:

cargo install --locked [email protected] --features opt
información

Report issues and share feedback about the Stellar CLI here.

Documentation

The auto-generated comprehensive reference documentation is available here.

Autocompletion

You can use stellar completion to generate shell completion for different shells. You should absolutely try it out. It will feel like a super power!

Para habilitar el autocompletado en la sesión actual del shell:

source <(stellar completion --shell bash)

To enable autocomplete permanently, run the following command, then restart your terminal:

echo "source <(stellar completion --shell bash)" >> ~/.bashrc

Configuring the CLI for Testnet

Configure an Identity

When you deploy a smart contract to a network, you need to specify an identity that will be used to sign the transactions.

Let's configure an identity called alice. You can use any name you want, but it might be nice to have some named identities that you can use for testing, such as alice, bob, and carol. Notice that the account will be funded using Friendbot.

stellar keys generate --global alice --network testnet --fund

You can see the public key of alice with:

stellar keys address alice

Like the Network configs, the --global means that the identity gets stored in ~/.config/stellar/identity/alice.toml. You can omit the --global flag to store the identity in your project's .stellar/identity folder instead.

información

We previously used ~/.config/soroban (global) and .soroban (local) as the configuration directories. These directories are still supported, but the preferred name is now ~/.config/stellar and .stellar moving forward.