Le SuiClient - l'employé du bureau de poste de votre application

• Public: Développeurs qui découvrent la blockchain Sui.
• Prérequis: Compréhension de base des concepts de la blockchain (portefeuilles, transactions).
• Objectif: Comprendre le rôle du SuiClient dans l'architecture de l'application.

---

Introduction

Dans l'écosystème Sui, votre application ne peut pas communiquer directement avec le réseau blockchain. Elle a besoin d'un intermédiaire pour gérer les protocoles de communication, la récupération des données et la soumission des transactions.

Le SuiClient est l'interface principale dans le Sui TypeScript SDK à cette fin.

L'architecture : L'analogie du "bureau de poste

Imaginez le réseau Sui comme un système postal global et massif.

• Votre application est un client au guichet.
• Le SuiClient est l'employé du bureau de poste.

Vous dépendez de l'employé pour interagir avec le système. Vous ne pouvez pas trier le courrier ou conduire les camions de livraison vous-même ; vous devez faire vos demandes par l'intermédiaire de l'employé.

Code

flowchart LR
    A["Votre App<br/>(Client)"] -->|Demande Service| B("SuiClient<br/>(Employé)")
    B -->|Traite la demande| C["Nœud de réseau Sui<br/>(Système postal)"]
    C -->|Délivre le résultat| B
    B -->|Transmet l'article| A

Image

Connexion au réseau

Tout comme un employé travaille dans une succursale spécifique, une instance SuiClient se connecte à un environnement réseau spécifique via un RPC (Remote Procedure Call) Endpoint.

Lorsque vous initialisez le client, vous définissez l'environnement qu'il cible :

Réseau	Description	Cas d'utilisation
Mainnet	Le réseau de production en direct. Actifs réels, valeur réelle.	Le réseau de production en direct.
Testnet	Réseau de test public. Miroir des versions du réseau principal.	Les tests d'intégration et de mise en scène.
Devnet	Réseau expérimental. Nettoyé fréquemment.	Prototypage rapide et développement local.

Capacités de base

Le SuiClient gère deux catégories distinctes d'opérations. Comprendre la différence est essentiel pour la conception de l'application.

1. Opérations de lecture (requêtes)

Il s'agit de demandes de consultation de données existantes dans le grand livre.

Coût: Gratuit (pas de frais d'essence). Sécurité: Aucune signature de portefeuille n'est requise.

• Mécanisme : Le client interroge la base de données locale du nœud et renvoie le résultat immédiatement.
• Exemples:
  • getObject() : Récupération des métadonnées NFT.
  • getBalance() : Vérification des fonds d'un portefeuille.

2. Opérations d'écriture (transactions)

Il s'agit de demandes visant à modifier l'état du grand livre.

Coût: Nécessite des jetons SUI pour les frais d'essence. Sécurité: Requiert une signature cryptographique du portefeuille de l'utilisateur. Mécanisme : le client soumet la transaction signée aux validateurs du réseau pour traitement.

Exemples:

• Transfert de pièces.
• Frapper des NFT.
• Modification des données de jeu sur la chaîne.

---

Prochaines étapes

Maintenant que vous comprenez l'architecture, l'étape suivante consiste à effectuer une opération de lecture. Le guide suivant fournit un script permettant d'interroger les données en direct du Sui Devnet.