Le SuiClient : l'employé de poste de votre application

• Public : Développeurs découvrant 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 de la blockchain. Elle nécessite 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 SDK TypeScript de Sui à cette fin.

L'architecture : L'analogie du « bureau de poste »

Imaginez le réseau Sui comme un système postal mondial 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 ni conduire les camions de livraison vous-même ; vous devez effectuer vos demandes par l'intermédiaire de l'employé.

Image

Code

flowchart LR
    A["Votre application<br/>(Client)"] -->|Demande un service| B("SuiClient<br/>(Employé)")
    B -->|Traite la requête| C["Nœud du réseau Sui<br/>(Système postal)"]
    C -->|Fournit le résultat| B
    B -->|Remet l'objet| A

ASCII

┌──────────────────┐ Demande un service ┌──────────────────┐ Traite la requête  ┌─────────────────────┐
│Votre application │──────────────────► │    SuiClient     │──────────────────► │ Nœud du réseau Sui  │
│     (Client)     │◄────────────────── │    (Employé)     │◄────────────────── │  (Système postal)   │
└──────────────────┘   Remet l'objet    └──────────────────┘ Fournit le résultat└─────────────────────┘

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 point de terminaison d'appel de procédure à distance (RPC).

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.	Applications de production.
Testnet	Réseau de test public. Reflète le versionnement du réseau principal.	Tests de préproduction et d'intégration.
Devnet	Réseau expérimental. Réinitialisé fréquemment.	Prototypage rapide et tests publics.
Localnet	Réseau de test local s'exécutant sur votre machine.	Développement et tests hors ligne.

Capacités principales

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 registre.

• Coût : Gratuit (sans frais de gas).
• 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 d'un 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 registre.

• Coût : Nécessite des jetons SUI (mesurés en MIST) pour les frais de gas.
• Sécurité : Requiert une signature cryptographique du portefeuille de l'utilisateur.
• Mécanisme : Le client soumet la transaction signée via le nœud complet RPC, qui la transmet au réseau de validateurs pour exécution et consensus.
• Exemples :
  • Transfert de jetons.
  • Frappe de NFTs.
  • Modification de 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, Comment récupérer des données d'objet, fournit un script permettant d'interroger des données en direct depuis le devnet de Sui.