Saltar al contenido principal

El SuiClient - El empleado de correos de tu aplicación

  • Audiencia: Desarrolladores nuevos en el Sui blockchain.
  • Requisitos previos: Comprensión básica de los conceptos de blockchain (carteras, transacciones).
  • Objetivo: Entender el papel del SuiClient en la arquitectura de la aplicación.

Introducción​

En el ecosistema Sui, tu aplicación no puede hablar directamente con la red blockchain. Necesita un intermediario que se encargue de los protocolos de comunicación, la obtención de datos y el envío de transacciones.

El SuiClient es la interfaz principal en el Sui TypeScript SDK para este propósito.

La arquitectura: La analogía de la "oficina de correos"​

Piensa en la Red Sui como un sistema postal masivo y global.

  • Tu Aplicación es un cliente en el mostrador.
  • El SuiClient es el Empleado de Correos.

Confías en el empleado para interactuar con el sistema. No puedes clasificar el correo o conducir los camiones de reparto por ti mismo; debes hacer las solicitudes a través del empleado.

flowchart LR
    A["Tu Aplicación<br/>(Cliente)"] -->|Solicita Servicio| B("SuiClient<br/>(Empleado)")
    B -->|Procesa Solicitud| C["Nodo de Red Sui<br/>(Sistema Postal)"]
    C -->|Entrega Resultado| B
    B -->|Entrega Artículo| A

Conexión a la red​

Al igual que un empleado trabaja en una sucursal específica, una instancia de SuiClient se conecta a un entorno de red específico a través de un RPC (Remote Procedure Call) Endpoint.

Cuando inicializas el cliente, defines a qué entorno se dirige:

RedDescripciónCaso de Uso
MainnetLa red de producción en vivo. Activos reales, valor real.Aplicaciones de producción.
TestnetRed de prueba pública. Refleja el versionado de Mainnet.Pruebas de integración.
DevnetRed experimental. Se limpia con frecuencia.Prototipos rápidos y desarrollo local.

Capacidades principales​

El SuiClient maneja dos categorías distintas de operaciones. Comprender la diferencia es fundamental para el diseño de la aplicación.

1. Operaciones de lectura (consultas)​

Estas son solicitudes para consultar datos existentes en el libro mayor.

  • Coste: Gratuito (Sin tarifas de gas).
  • Seguridad: No se requiere firma de billetera.
  • Mecanismo: El cliente consulta la base de datos local del nodo y devuelve el resultado inmediatamente.
  • Ejemplos:
    • getObject(): Obtención de metadatos NFT.
    • getBalance(): Comprobación de los fondos de una billetera.

2. Operaciones de escritura (transacciones)​

Estas son solicitudes para cambiar el estado del libro mayor.

  • Coste: Requiere tokens SUI para las tarifas de gas.
  • Seguridad: Requiere una firma criptográfica de la billetera del usuario.
  • Mecanismo: El cliente envía la transacción firmada a los validadores de la red para su procesamiento.
  • Ejemplos:
    • Transferencia de monedas.
    • Acuñación de NFT.
    • Modificación de datos de juegos en cadena.

Próximos pasos​

Ahora que comprendes la arquitectura, el siguiente paso es realizar una Operación de Lectura. La próxima guía proporciona un script para consultar datos en vivo desde la Sui Devnet.