¿Qué es la blockchain de Stellar?

La blockchain de Stellar es una plataforma descentralizada, lo que significa que no depende de un solo servidor o entidad. En cambio, una red de computadoras (o nodos) trabaja en conjunto para verificar y registrar todas las transacciones de forma transparente. Esto hace que cada operación sea muy rápida (generalmente en 2 a 5 segundos) y que las tarifas sean mínimas (¡prácticamente simbólicas!). ⚡️🔒

Un poco de su historia

Stellar fue creada en 2014 por Jed McCaleb y Joyce Kim. Ambos ya tenían experiencia en el mundo de las criptomonedas (McCaleb, por ejemplo, estuvo involucrado en proyectos como Ripple y Mt. Gox). La idea era sencilla pero poderosa: crear una plataforma que facilitara el envío de dinero de forma global, especialmente para aquellos que no tienen acceso a los servicios bancarios tradicionales. Para lograrlo, se diseñó una red en la que se pudiera usar una moneda digital propia llamada Lumens (XLM), la cual se usa para pagar las pequeñas tarifas de transacción y para mantener el sistema en marcha. 🚀🌟

¿Por qué es importante?

• Inclusión financiera: Stellar busca que más personas en el mundo puedan acceder a servicios financieros sin tener que depender de bancos tradicionales.

• Velocidad y bajo costo: Con Stellar, las transacciones internacionales son casi instantáneas y con comisiones muy bajas.

• Transparencia y seguridad: Al ser una red descentralizada, todas las operaciones se registran de manera pública y segura, lo que reduce el riesgo de fraudes.

¡Bienvenido a Stellar Español! 🚀✨

Este es tu nuevo punto de referencia en español para todo lo relacionado con Stellar. Diseñado por desarrolladores para desarrolladores, nuestro portal se centra inicialmente en los contratos inteligentes de Soroban y en cómo interactuar con ellos a través de interfaces web intuitivas. 💻🤖

¿Qué encontrarás en Stellar Español?

• Documentación de Soroban: Descubre guías paso a paso, ejemplos de código y recursos técnicos para crear y desplegar contratos inteligentes en Stellar con Soroban. ¡Aprende a sacarle el máximo provecho a esta tecnología revolucionaria! 📚🚀

• Interfaz web para contratos: Explora cómo utilizar herramientas web diseñadas para interactuar de manera fácil y rápida con tus contratos inteligentes. Desde la gestión de cuentas hasta la ejecución de transacciones, te mostramos todo lo que necesitas saber. 🌐🖱️

• Recursos en constante evolución: Nuestro portal se actualizará continuamente. A futuro, complementaremos esta información con fundamentos de Stellar, un blog con noticias y análisis, y muchos temas afines al universo Stellar. 🔄📈

Si deseas apoyar a esta iniciativa

NVM (Node Version Manager) es una herramienta que permite instalar, gestionar y cambiar entre múltiples versiones de Node.js en un mismo sistema. Es útil para desarrolladores que trabajan en proyectos con diferentes versiones de Node.js, ya que facilita la instalación, actualización y cambio de versiones sin afectar otras configuraciones del sistema. Funciona en macOS, Linux y, con herramientas adicionales, en Windows.

Instalación

Mac y linux

Se ingresa a este link para ver las últimas versiones

Abrimos la terminal y ejecutamos lo siguiente:

Windows

Nos dirigimos al siguiente link y bajamos la última versión

Node.js es un entorno de ejecución de JavaScript basado en el motor V8 de Chrome, que permite desarrollar aplicaciones escalables del lado del servidor con un modelo asíncrono y no bloqueante. Utiliza un solo hilo con eventos para manejar múltiples conexiones de manera eficiente, es altamente escalable y cuenta con un extenso ecosistema de paquetes a través de npm. Es ideal para APIs, microservicios, aplicaciones en tiempo real y servidores web.

Para nosotros es relevante la instalación de nodejs para la interacción web con los contratos de la red Stellar

Instalación

Nos dirijimos a para ver la última version LTS

Abrimos la terminal y ejecutamos:

Está es la última version el 12 de Junio de 2025

Fácil no? asi podemos instalar y gestionar varias versiones de Node js mucho más fácil 😊

Descarga del Visual studio code

Ir al siguiente link https://code.visualstudio.com/Download

Instalación de plugins útiles

#![no_std]
use soroban_sdk::{contract, contractimpl, contracttype, Address, Env};

#[contracttype]
pub enum DataKey {
    Counter(Address),
}

#[contract]
pub struct IncrementContract;

#[contractimpl]
impl IncrementContract {
    /// Increment increments a counter for the user, and returns the value.
    pub fn increment(env: Env, user: Address, value: u32) -> (Address, u32) {
        // Requires user to have authorized call of the increment of this
        // contract with all the arguments passed to increment, i.e. user
        // and value. This will panic if auth fails for any reason.
        // When this is called, Soroban host performs the necessary
        // authentication, manages replay prevention and enforces the user's
        // authorization policies.
        // The contracts normally shouldn't worry about these details and just
        // write code in generic fashion using Address and require_auth (or
        // require_auth_for_args).
        user.require_auth();

        // This call is equilvalent to the above:
        // user.require_auth_for_args((&user, value).into_val(&env));

        // The following has less arguments but is equivalent in authorization
        // scope to the above calls (the user address doesn't have to be
        // included in args as it's guaranteed to be authenticated).
        // user.require_auth_for_args((value,).into_val(&env));

        // Construct a key for the data being stored. Use an enum to set the
        // contract up well for adding other types of data to be stored.
        let key = DataKey::Counter(user.clone());

        // Get the current count for the invoker.
        let mut count: u32 = env.storage().persistent().get(&key).unwrap_or_default();

        // Increment the count.
        count += value;

        // Save the count.
        env.storage().persistent().set(&key, &count);

        // Return the count to the caller.
        (user, count)
    }
}

Explicación del código

El cliente de Stellar es super importante en la escritura de contratos en Stellar, ya que se encarga de la creación de la estructura básica y archivos, su compilación, despliegue y pruebas respectivas.

Intalación:

MAC

Se ejecuta el siguiente comando en la terminal

Rust es el lenguaje de propósito general en el cual se escriben los contratos para la red de Stellar a continuación un paso a paso para su instalación.

Para la instalación de rust, dirigirse a este enlace: https://www.rust-lang.org/es/tools/install

Instalación en macOS y Linux

Paso 1: Abrir la Terminal

Abre tu aplicación de terminal (Terminal.app en macOS o la terminal de tu distribución Linux).

Paso 2: Descargar e instalar Rust con rustup

Este comando descargará un script y te guiará por el proceso de instalación. Generalmente se recomienda usar la opción predeterminada para instalar la versión estable.

Paso 3: Configurar el entorno

Una vez finalizada la instalación, cierra y vuelve a abrir la terminal o ejecuta:

Esto garantiza que el directorio de Cargo (donde se instalan las herramientas, por ejemplo, rustc, cargo y rustup) se añada a tu variable de entorno PATH.

Paso 4: Verificar la instalación

Comprueba que Rust se instaló correctamente ejecutando:

Paso 5: Instalar un compilador de C (si es necesario)

Rust requiere un enlazador para compilar correctamente:

• En macOS: Instala las herramientas de línea de comandos de Xcode

• En Linux (por ejemplo, Ubuntu): Asegúrate de tener instalado el paquete build-essential

• Fedora

• Arch

Paso 6: Agregar lo siguiente a Rust, para poder generar archivos WebAssembly

Ejecutamos lo siguente para saver laversión de Rust:

Si el rust es anterior a la versión 1.85

Si el rust es igual o mayor a la versión 1.85

Instalación en Windows

Paso 1: Descargar el instalador

Visita la y descarga el instalador para Windows (rustup-init.exe). Elige la versión de 32 o 64 bits según tu sistema.

Paso 2: Ejecutar el instalador

Ejecuta el archivo descargado y sigue las instrucciones en pantalla. Durante la instalación, es posible que se te pida instalar las Visual Studio C++ Build Tools (necesarias para compilar Rust en Windows). También debemos instalar el windows SDK acorde a la versión de windows que tengamos.

Paso 3: Verificar la instalación

Abre una terminal (CMD o PowerShell) y ejecuta:

Paso 4: Agregamos el paquete que genera el WebAsembly

Ejecutamos lo siguente para saver laversión de Rust:

Si el rust es anterior a la versión 1.85

Si el rust es igual o mayor a la versión 1.85

Una vez visto lo básico del cliente, miremos lo pertinente enfocado a los contratos inteligentes, como es:

• Creación de un contratos.

• Compilación de contratos.

• Despliegue.

• Ejecución de contrato.

Creación de un contrato Syntaxis: stellar contract init "nombre_contrato"

stellar contract init hola_mundo

Estructura y archivos creados

Dentro de lib.rs está el contrato por defecto

Compilación del contrato Se ejecuta el siguiente comando:

Podemos ver que se creo una carpeta llamada release, más internamente vemos que está creado el archivo hello_world.wasm

💡el nombre del archivos en web assembly es el que automáticamente se pone dentro del archivo Cargo.toml

Despliegue del contrato

Mac/linux

Windows

Felicidades, ya tienes el contratro deplegado en testnet 🥳

Interactuando con los contratos Sintaxis stellar contract invoke --id "contrato" --source "identidad" --network testnet -- "función" --"parametro" "dato del parámetro"

Linux y MAC

Windows

El resultado es:

El cliente de Stellar es super importante en la escritura de contratos en Stellar, ya que se encarga de la creación de la estructura básica y archivos, su compilación, despliegue y pruebas respectivas.

En esta primera pare veremos lo siguiente:

• Creación de una cuenta (identidad)

• Obtención de la llave pública (address)

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

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

🗂️ ¿Qué es un Repositorio de Código?

Imagínate que estás escribiendo un libro con tus amigos. Necesitas un lugar donde guardar todas las páginas, ver quién escribió qué, y poder volver a versiones anteriores si algo sale mal. ¡Un repositorio de código es exactamente eso, pero para tu código! 📚✨

Un repositorio (o "repo" como le dicen los cool 😎) es como una carpeta mágica que:

• 💾 Guarda todo tu código de forma segura

• 📝 Recuerda cada cambio que haces (¡como una máquina del tiempo!)

• 👥 Permite que varios programadores trabajen juntos sin hacer un desastre

• 🔄 Te deja volver atrás si rompes algo (¡todos lo hacemos!)

🎯 ¿Para qué sirve exactamente?

🕰️ Control de versiones

Es como tener un "deshacer" súper poderoso. Cada vez que guardas cambios, Git crea una "foto" de tu proyecto. Si algo se rompe, ¡simplemente vuelves a una foto anterior!

👥 Colaboración

Imagina que tú y tus amigos están pintando un mural gigante. Sin organización, todos pintarían encima del trabajo de otros. ¡Un repositorio evita este caos digital!

🛡️ Respaldo automático

Tu código vive en la nube, así que aunque tu computadora se rompa, tu trabajo está seguro. ¡Es como tener un backup automático súper inteligente!

📖 Documentación

Puedes guardar instrucciones, notas y explicaciones junto con tu código. ¡Tu futuro yo te lo agradecerá!

🌟 Las Plataformas Más Populares

🐙 GitHub - El Rey de los Repos

GitHub es como el Instagram de los programadores. Es donde vive el código más cool del mundo:

• 🔥 Más de 100 millones de repositorios

• 🆓 Gratis para proyectos públicos

• 🤝 Perfecto para mostrar tu trabajo a empleadores

¿Por qué es genial para principiantes?

• Interface súper amigable 😊

• Toneladas de tutoriales y documentación

• GitHub Pages (¡puedes hacer sitios web gratis!)

🦊 GitLab - El Todoterreno

GitLab es como el Swiss Army knife del desarrollo:

• 🛠️ No solo guarda código, también lo prueba y despliega

• 🏢 Perfecto para empresas

• 🔧 Herramientas integradas de CI/CD (no te preocupes, lo aprenderás después)

🪣 GitBucket - El Independiente

GitBucket es como el rebelde cool:

• 🆓 100% gratis y de código abierto

• 🏠 Lo instalas en tu propio servidor

• 🎮 Perfecto para aprender sin depender de otros

💻 Git en Consola - Tu Nueva Herramienta Favorita

Git es como el motor que hace funcionar todos estos repositorios. La consola (terminal) es donde ocurre la magia real. ¡No te asustes, es más fácil de lo que parece! 🪄

📥 ¿Cómo instalar Git?

🍎 Para Mac (macOS)

Siguiendo las instrucciones de:

Opción 1:

Si tienes instalado brew, se corre la instrucción en consola

Opción 2:

Si tienes instalado MacPorts, se corre la instrucción en consola

🐧 Para Linux

Ubuntu/Debian (Los más comunes) 📦

Fedora/Red Hat 🎩

Arch Linux (Para los aventureros) 🏔️

🪟 Para Windows

1. 📥 Ve a

2. 🖱️ Descarga el instalador

🎉 ¡Tu Primer Paso!

Una vez instalado, abre tu terminal y escribe:

Si ves algo como git version 2.x.x, ¡felicidades! 🎊 Git está listo para usar.

⚙️ Configuración inicial (Súper importante)

Dile a Git quién eres:

¡Y listo! Ya estás preparado para comenzar tu aventura en el mundo de Git y los repositorios. 🚀

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

Análisis del código:

Importaciones del SDK de Soroban

• Symbol y symbol_short: Se usan para trabajar con identificadores cortos y optimizados en el entorno de Soroban.

  • Symbol Es un string de 32 caracteres, viene ocupa 64 bit (a-z A-Z 0-9)

  • symbol_short! Es un string de 9 caracteres (a-z A-Z 0- 9)

• String: Es una versión adaptada del tipo cadena de texto para el entorno sin estándar (no_std) y específicamente optimizada para contratos inteligentes en Soroban.

Definición de una Constante const MESSAGE: Symbol = symbol_short!("Message");

🛠 Explicación de las funciones

Todas las funciones trabajan con env: Env, que proporciona acceso al almacenamiento y otras funcionalidades del entorno Soroban.

1️⃣ set_message(env: Env, message: String)

✅ Guarda un mensaje en el almacenamiento.

📌 Paso a paso:

1. Toma como entrada un mensaje de tipo String.

2. Usa env.storage().instance().set() para almacenar el mensaje en la blockchain usando la clave MESSAGE.

2️⃣ get_message(env: Env) -> String

✅ Obtiene el mensaje almacenado.

📌 Paso a paso:

1. Intenta recuperar el valor asociado a MESSAGE en el almacenamiento.

2. Si la clave no existe, usa .unwrap_or() para devolver un mensaje por defecto: "Default Message".

3. Devuelve el mensaje almacenado o el mensaje por defecto.

📌 Resumen

Este contrato inteligente permite almacenar y recuperar un mensaje de la blockchain de Soroban:

• set_message(): Guarda un mensaje en la blockchain.

• get_message(): Obtiene el mensaje guardado o un mensaje por defecto si aún no se ha establecido.

Compilación del contrato la compilación y creación del webassembly es con el siguiente comando: stellar contract build

Despliegue del contratro

Para Mac y Linux el salto de línea es con el caractér " \" y en Windows con el caracter " ´ "

Reemplaze el simbolo * por el respectivo caractér de salto de linea a su sistema operativo.

Pruebas del contratro

Para linux y Mac el salto de línea de la instrucción es con el caracter " \ " para Windows con el caracter " ` "

Invocación de la función set_message

Invocación de la función get_message

🧪 Guía Completa de Testing en Stellar Soroban

🔍 ¿Por qué necesitamos tests? (detallado)

🛡️ Prevención de bugs críticos: detecta errores en lógica de negocio antes de deployment que podrían resultar en pérdida de fondos o estados inconsistentes. 🎯 Validación de edge cases: simula condiciones extremas (overflow, underflow, fondos insuficientes) para asegurar comportamiento robusto. 💰 Protección de inversión: evita costos de re-deployment y pérdida de confianza por bugs en mainnet. 🔄 Refactoring seguro: permite cambiar implementaciones manteniendo garantías de comportamiento. 🧪 Simulación de ataques: prueba vectores de ataque conocidos (reentrancy, front-running, privilege escalation) de forma controlada.

🌟 ¿Qué ofrece Soroban para testing? (explicación técnica)

📦 soroban_sdk::testutils: módulo con herramientas para crear entornos de prueba aislados y mockear comportamientos. 🏗️ Env::default(): crea un entorno de testing limpio con ledger simulado, storage independiente y control total sobre el tiempo. 👤 MockAuth: permite simular firmas y autorizaciones sin claves privadas reales. 📊 Budget tracking: monitorea consumo de CPU y memoria durante tests para optimizar gas costs. 🎭 Address generation: crea direcciones determinísticas para tests reproducibles.

🔧 Herramientas y conceptos clave (más allá de la sintaxis)

Env::default() — qué hace y efectos

• Crea un entorno aislado donde cada test ejecuta independientemente

• Simula un ledger con timestamp, sequence numbers y storage limpio

• Permite control sobre authorizaciones y mock data

MockAuth patterns

• MockAuth::authorize(): simula que una dirección específica autorizó la transacción

• MockAuthInvoke: para casos complejos con múltiples contratos

• Cuidado: solo para testing; en mainnet require_auth() usa firmas reales

Testing strategies

• Unit tests: funciones individuales con inputs específicos

• Integration tests: flujos completos entre múltiples funciones

• Fuzzing: inputs aleatorios para encontrar casos no contemplados

Error handling validation

• Usa should_panic o assert!(result.is_err()) para validar fallos esperados

• Verifica que error codes específicos se generen correctamente

• Simula condiciones de falla (fondos insuficientes, permisos incorrectos)

📋 Estrategias y patrones prácticos (con por qué y cuándo usarlas)

Arrange-Act-Assert pattern

• Arrange: configura estado inicial (addresses, balances, roles)

• Act: ejecuta la función bajo prueba

• Assert: verifica resultados esperados

Test data management

• Usa direcciones determinísticas para reproducibilidad

• Crea helpers para setup común (inicializar contratos, crear usuarios)

• Mantén tests independientes — no dependas de estado previo

Mocking strategies

• Mock external contracts durante unit tests

• Simula condiciones de red (timeouts, failures) en integration tests

• Usa MockAuth para probar flujos sin manejar claves privadas

Performance testing

• Mide budget consumption para optimizar gas costs

• Prueba límites de storage y memoria

• Valida que operaciones batch no excedan límites de transacción

💡 Ejemplos Prácticos — Código + explicaciones detalladas (línea a línea)

En proceso...

🚀 ¿Qué es una Cripto Wallet?

Una cripto wallet (billetera de criptomonedas) es como tu billetera digital personal para guardar, enviar y recibir criptomonedas. A diferencia de una billetera física que guarda dinero en efectivo, una cripto wallet almacena las claves privadas que te dan acceso y control sobre tus activos digitales en la blockchain.

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

Borramos el contrato generado en lib.rs y ponemos el siguiente código

📌 Explicación general

• Usa #![no_std], lo que indica que no usa la biblioteca estándar de Rust.

• Importa módulos de soroban_sdk, necesarios para ejecutar el contrato en Soroban.

• Define un contrato llamado DataTypesContract.

• Implementa varias funciones que realizan suma de números con diferentes tipos (u32, i32, u64, i64, u128, i128).

• Incluye una función para negar un booleano.

🛠 Explicación de las funciones

Todas las funciones reciben _env: Env, aunque no lo utilizan directamente. Es un requisito en Soroban para la ejecución de contratos.

1️⃣ Funciones de suma

Cada una de estas funciones suma dos números del mismo tipo y retorna el resultado.

📌 Ejemplo de uso: Si llamamos a add_u32(5, 10), devuelve 15. Si llamamos a add_i64(-20, 50), devuelve 30.

2️⃣ negate_bool(_env: Env, flag: bool) -> bool

✅ Invierte un valor booleano (true ↔ false).

📌 Paso a paso:

1. Recibe un valor booleano (flag).

2. Usa el operador lógico ! para invertirlo.

3. Retorna el valor opuesto.

📌 Ejemplo de uso: Si llamamos negate_bool(true), devuelve false. Si llamamos negate_bool(false), devuelve true.

📌 Resumen

Este contrato define funciones matemáticas y lógicas en Soroban:

• Funciones de suma (add_u32, add_i32, add_u64, add_i64, add_u128, add_i128): Permiten sumar números de diferentes tamaños y signos.

• Función booleana

Compilación del contrato

Ejecutamos lo siguiente:

Despliegue del contrato

Para Mac y Linux el salto de línea es con el carácter " \" y en Windows con el carácter " ´ "

Reemplaze el simbolo * por el respectivo carácter de salto de linea a su sistema operativo.

Pruebas del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Función add_u32

Función negate_bool

Para crear el contrato ejecutamos lo siguiente:

Dentro de la carpeta counter, en el archivo lib.rs borramos todo el código y ponemos el siguiente código:

Básicamente es un contrato con un contador y 3 funciones:

Análisis del código:

Importaciones del SDK de Soroban

• Symbol y symbol_short: Se usan para trabajar con identificadores cortos y optimizados en el entorno de Soroban.

  • Symbol Es un string de 32 caracteres, viene ocupa 64 bit (a-z A-Z 0-9)

  • symbol_short! Es un string de 9 caracteres (a-z A-Z 0- 9)

🛠 Explicación de las funciones

Todas las funciones trabajan con env: Env, que proporciona acceso al almacenamiento y otras funcionalidades del entorno Soroban.

1️⃣ add_to_counter(env: Env, increment: u32)

✅ Suma un número arbitrario al contador.

📌 Paso a paso:

1. Recupera el valor actual de COUNTER desde el almacenamiento, usando .unwrap_or(0), lo que garantiza que si la clave no existe, se toma como 0.

2. Suma el increment recibido como parámetro.

2️⃣ inc_counter(env: Env)

✅ Incrementa el contador en 1. 📌 Paso a paso: Esta función es similar a add_to_counter, pero en lugar de recibir un parámetro, simplemente suma 1 al contador.

3️⃣ get_counter(env: Env) -> u32

✅ Devuelve el valor actual del contador.

📌 Paso a paso:

1. Recupera el valor de COUNTER del almacenamiento.

2. Si la clave no existe, devuelve 0.

3. Retorna el valor del contador.

📌 Resumen

Este contrato mantiene un contador en la blockchain de Soroban con:

• add_to_counter(): Incrementa el contador en un valor específico.

• inc_counter(): Incrementa el contador en 1.

• get_counter(): Obtiene el valor actual del contador.

Compilación del contrato:

Despliegue del contratro

Para Mac y Linux el salto de línea es con el carácter " \" y en Windows con el carácter " ´ "

Reemplaze el simbolo * por el respectivo carácter de salto de linea a su sistema operativo.

Pruebas del contratro

Para linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Invocación de la función add_to_counter

Invocación de la función inc_counter

Invocación de la función get_counter

Los strings pueden pasarse a contratos y almacenes utilizando el tipo Bytes.

Tenga en cuenta que los bytes contenidos en los strings no se ajustan necesariamente a ninguna codificación de texto estándar, como ASCII o Unicode UTF-8. Son bytes sin interpretar. Se trata de bytes sin interpretar, y los usuarios que esperen una codificación determinada deberán aplicarla manualmente.

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

Borramos el contrato generado en lib.rs y ponemos el siguiente código

📚 Teoría sobre if, else y match en Rust

Rust ofrece dos estructuras de control clave para la toma de decisiones: if-else y match.

✅ if-else

Se usa para tomar decisiones en función de una condición booleana.

📌 Sintaxis básica:

📌 Ejemplo en Rust:

📌 Cuándo usar if-else

• Cuando se necesita verificar una condición booleana única.

• Cuando solo hay dos opciones (true o false).

✅ match

Se usa para comparar un valor con múltiples posibles casos, similar a switch en otros lenguajes.

📌 Sintaxis básica:

📌 Ejemplo en Rust:

📌 Cuándo usar match

• Cuando hay varias condiciones posibles.

• Cuando se trabaja con enum, strings o patrones complejos.

Código en Soroban

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

Borramos el contrato generado en lib.rs y ponemos el siguiente código

📌 Explicación general del código

• Usa #![no_std], lo que significa que no usa la biblioteca estándar de Rust.

• Importa módulos de soroban_sdk, necesarios para escribir contratos inteligentes en Soroban.

• Define una estructura de contrato

🛠 Explicación de las Funciones

1️⃣ check_number

Descripción: Determina si un número es positivo o negativo.

Mecanismo:

• Recibe un número entero (i32) como entrada.

• Emplea una estructura condicional if-else para evaluar el valor de num.

• Si num es mayor o igual a 0, retorna un String

2️⃣ check_role

Descripción: Asigna permisos según el rol del usuario.

Mecanismo:

• Define tres roles fijos utilizando el macro symbol_short!:

  • Admin

  • User

📌 Resumen General Este contrato inteligente demuestra el uso de condicionales y estructuras de control en Soroban. A través de check_number se evalúa la positividad o negatividad de un número, mientras que check_role asigna permisos basándose en roles específicos.

Compilación del contrato

Ejecutamos lo siguiente:

Despliegue del contrato

Para Mac y Linux el salto de línea es con el carácter " \" y en Windows con el carácter " ´ "

Reemplaze el simbolo * por el respectivo carácter de salto de linea a su sistema operativo.

Pruebas del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Función get_length

Función check_role

En Rust, el tipo Option es una forma segura y explícita de representar que un valor puede estar presente o no. Es como decir "puede haber algo o no" 🔍. En lugar de usar null (que puede causar errores difíciles de encontrar), Rust usa Option para obligarte a manejar ambos casos.

La definición de Option es muy sencilla:

• Some(valor): Indica que sí hay un valor. 😊

📚 Loops en Rust: Repetición de código de forma eficiente

En programación, los loops (o bucles) permiten repetir la ejecución de un bloque de código automáticamente. Son útiles para realizar tareas repetitivas, recorrer colecciones de datos o ejecutar acciones hasta que se cumpla una condición.

⚠️ En contratos inteligentes, es importante que los loops tengan límites claros para evitar ciclos infinitos y un consumo excesivo de gas.

✅ loop (bucle infinito controlado) Se ejecuta indefinidamente hasta que se encuentra una condición de salida.

📌 Sintaxis básica:

📌 Ejemplo en Rust:

📌 Cuándo usar loop Cuando no se sabe cuántas iteraciones se necesitarán y se desea un control manual de salida.

A continuación vamos a realizar nuestro primer ejercicio en react 😃

Consiste en realizar una conexión usando la libreria de que nos permite integrarnos a varias billeteras y el uso del servicio api rest de el cual ofrece varios servicios, para este caso en particular la lectura de saldo de una dirección en particular.

Por recomendaciones de la documentación de react, como indican usar un framework, usaremos el de , que es uno de los más populares.

_{Creación del proyecto}

Tipos de Almacenamiento en Stellar Soroban

🌟 Introducción Teórica

Imagina que tu contrato inteligente es como una casa 🏠, y necesitas diferentes tipos de espacios para guardar tus cosas:

• 🗄️ Un archivo permanente para documentos importantes

• 📋 Una mesa de trabajo para proyectos actuales

• 🗑️ Una papelera para cosas temporales

En Soroban tenemos exactamente eso: tres tipos de almacenamiento que nos permiten gestionar nuestros datos de manera eficiente y económica.

🎯 Los Tres Tipos de Almacenamiento

1. 💾 PERSISTENT STORAGE (Almacenamiento Persistente)

🧠 ¿Qué es?

Es el almacenamiento más duradero y confiable de Soroban. Los datos aquí se mantienen "para siempre" (hasta que explícitamente los borres). Es como guardar algo en una caja fuerte 🔒.

✨ Características:

• 🔄 Permanente: Los datos NO se borran automáticamente

• 💰 Más costoso: Requiere más fees porque ocupa espacio indefinidamente

• 🛡️ Más seguro: Ideal para datos críticos del contrato

🎯 ¿Cuándo usarlo?

• 👤 Información de usuarios (balances, perfiles)

• ⚙️ Configuraciones del contrato que no cambian

• 📊 Datos históricos importantes

💡 Ejemplo Práctico:

Compilación del contrato:

Despliegue del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Pruebas del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Función set_balance

2. 🏃‍♂️ INSTANCE STORAGE (Almacenamiento de Instancia)

🧠 ¿Qué es?

Es el almacenamiento intermedio de Soroban. Los datos aquí duran bastante tiempo, pero pueden "caducar" si no se usan. Es como tu escritorio de trabajo 📝 - mantienes las cosas que usas regularmente.

✨ Características:

• ⏳ Semi-permanente: Los datos pueden expirar si no se acceden

• 💸 Costo medio: Más barato que persistent, más caro que temporary

• 🔄 Auto-renovable: Cada acceso extiende su tiempo de vida

🎯 ¿Cuándo usarlo?

• ⚙️ Configuraciones del contrato que pueden cambiar

• 📊 Metadatos del contrato (nombre, símbolo, decimales)

• 🎮 Estados de juego que duran varias partidas

💡 Ejemplo Práctico:

Compilación del contrato:

Despliegue del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Pruebas del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

Función init_token

3. ⚡ TEMPORARY STORAGE (Almacenamiento Temporal)

🧠 ¿Qué es?

Es el almacenamiento más barato y temporal de Soroban. Los datos aquí se borran automáticamente después de un tiempo. Es como usar notas adhesivas 📝 para recordatorios rápidos.

✨ Características:

• ⏰ Temporal: Los datos se borran automáticamente (aprox. 24 horas)

• 💰 Más barato: Ideal para optimizar costos

• 🚀 Rápido: Perfecto para operaciones que no necesitan persistir

🎯 ¿Cuándo usarlo?

• 🔢 Cálculos intermedios en transacciones complejas

• 🎫 Nonces y tokens de sesión

• 📊 Caché de datos temporales

💡 Ejemplo Práctico:

Compilación del contrato:

Despliegue del contrato

Para Linux y Mac el salto de línea de la instrucción es con el carácter " \ " para Windows con el carácter " ` "

🎯 Comparación Rápida

🎨 Consejos de Mejores Prácticas

💾 Para PERSISTENT:

• ✅ Usa para balances de usuarios

• ✅ Datos que nunca deben perderse

• ❌ Evita para datos temporales (caro)

🏃‍♂️ Para INSTANCE:

• ✅ Configuraciones del contrato

• ✅ Metadatos que cambian ocasionalmente

• ❌ Evita para datos de usuarios individuales

⚡ Para TEMPORARY:

• ✅ Cálculos intermedios

• ✅ Sistema de cooldowns

• ✅ Cache temporal

• ❌ Evita para datos importantes

📚 Manejo de errores

🎯 Parte Teórica: Fundamentos del Manejo de Errores

¿Por qué es importante el manejo de errores? 🤔

En los contratos inteligentes de Soroban, el manejo de errores es crítico porque:

• 🛡️ Seguridad: Evita comportamientos inesperados que podrían ser explotados

• 💰 Protección de fondos: Previene pérdidas de tokens o activos

• 🎯 Experiencia del usuario: Proporciona mensajes claros sobre qué salió mal

🔧 Tipos de Errores en Soroban

1. Errores del Sistema (Host Errors) 🏠

Son errores que maneja automáticamente el entorno de Soroban:

• Falta de memoria

• Límites de gas excedidos

• Operaciones matemáticas inválidas (división por cero)

2. Errores Personalizados (Custom Errors) ✨

Son errores que tú defines para tu lógica de negocio:

• Permisos insuficientes

• Parámetros inválidos

• Estados de contrato incorrectos

🛠️ Herramientas para Manejar Errores

Result<T, E> - Tu mejor amigo 🤝

Macros útiles 🎨

• panic!() - Para errores irrecuperables (¡usar con cuidado!)

• assert!() - Para validaciones críticas

• log!() - Para debugging (solo en testnet)

📋 Estrategias de Manejo de Errores

1. Validación Temprana ⚡

Valida todos los parámetros al inicio de la función

2. Errores Específicos 🎯

Crea tipos de error específicos para cada situación

3. Propagación Controlada 📤

Usa ? para propagar errores de forma limpia

4. Logging Inteligente 📝

Registra errores para facilitar el debugging

💡 Ejemplos Prácticos:

🌱 Ejemplo : Contrato Básico SIN Errores Personalizados

Empecemos con algo simple que usa solo los errores que Soroban ya tiene integrados:

🎯 Conceptos Clave de este Ejemplo:

✅ Herramientas Básicas de Manejo de Errores:

1. Option<T> 📦

   • Some(value) cuando todo está bien

   • None

📋 Cuándo Usar Cada Herramienta: