helloworld

Nos vamos a una ruta donde queramos crear nuestro proyecto y ponemos el siguiente comando:

stellar contract init helloworld

Como podemos observar el proyecto como tal se llama helloworld y en la carpeta contracts se creó una carpeta llamada hello-world, este contrato se genera por defecto cuando creamos un proyecto pero no indicamos como se llama el contrato como tal

Análisis del código generado

1 Declaración de No-Standard Library

#![no_std]

• Esta directiva le indica al compilador que el contrato se compilará sin la biblioteca estándar de Rust. Esto con el fin de hacer lo más liviano posible.

2 Importación de Elementos del SDK

use soroban_sdk::{contract, contractimpl, vec, Env, String, Vec};

• contract Es un macro atributo que se aplica a una estructura para marcarla como el contenedor del contrato. Esto permite que el entorno de Soroban reconozca el contrato y genere la metadata necesaria.

• contractimpl Es otro macro atributo que se utiliza en el bloque impl para indicar que las funciones definidas en ese bloque serán exportadas y podrán ser invocadas desde el entorno de ejecución del contrato.

• vec Es un macro propio de Soroban que crea un vector (colección dinámica) adaptado al entorno de contratos. Permite inicializar vectores de forma similar a vec! de Rust, pero considerando las particularidades del entorno.

• Env Es una estructura que representa el entorno en el que se ejecuta el contrato. A través de ella se accede a funciones esenciales como el almacenamiento, emisión de eventos, logs, etc.

• String Es una implementación propia del tipo cadena optimizada para entornos sin estándar (no_std) y adaptada a las limitaciones de ejecución de los contratos inteligentes en Soroban.

• Vec Es el tipo vector (colección dinámica) proporcionado por Soroban, similar al Vec estándar de Rust pero diseñado para trabajar de forma segura y eficiente en contratos inteligentes.

Definición del Contrato

//#[contract]
pub struct Contract;

Implementación de las Funciones del Contrato

#[contractimpl]
impl Contract {
    pub fn hello(env: Env, to: String) -> Vec<String> {
        vec![&env, String::from_str(&env, "Hello"), to]
    }
}

• La anotación #[contractimpl] sobre el bloque impl Contract indica que las funciones definidas serán expuestas para que puedan ser llamadas por el entorno de Soroban.

• Función hello:

Firma:

pub fn hello(env: Env, to: String) -> Vec

Recibe dos argumentos: env: Env: El entorno de ejecución, que se usa para acceder a funcionalidades propias del runtime de Soroban.

to: String: Una cadena que se pasa como parámetro. Retorna un Vec, es decir, un vector de cadenas.

Cuerpo de la función:

vec![&env, String::from_str(&env, "Hello"), to]

Se usa el macro vec! propio de Soroban para crear un vector. Elementos del vector:

1. &env: Se pasa el entorno para que el macro pueda asignar memoria o gestionar la colección en el contexto de Soroban.

2. String::from_str(&env, "Hello"): Convierte el literal "Hello" en un objeto de tipo String propio de Soroban, usando el entorno env para la conversión.

3. to: Se agrega la cadena que se recibió como argumento.

4. Al no tener ";" al final es el valor a retornar que se especifica en la función

Compilación:

stellar contract build

Despliegue:

• Mac/Linux

stellar contract deploy \
  --wasm target/wasm32-unknown-unknown/release/hello_world.wasm \
  --source developer \
  --network testnet \
  --alias hello_world

• Windows

stellar contract deploy `
  --wasm target/wasm32-unknown-unknown/release/hello_world.wasm `
  --source developer `
  --network testnet `
  --alias hello_world

Pruebas del contrato

Linux y MAC

stellar contract invoke \
--id CD5VLB73SUDKSXGWA5B3U52V4PUS7BKNILRN5CRNCWBDX4PAC44OBUVK \
--source developer \
--network testnet \
-- \
hello \
--to Pascual

Windows

stellar contract invoke `
--id CD5VLB73SUDKSXGWA5B3U52V4PUS7BKNILRN5CRNCWBDX4PAC44OBUVK `
--source developer `
--network testnet `
-- `
hello `
--to Manolo

Obtenemos lo siguiente: