Participants

• Utilisateur
• Fireblocks
• Gate (module OES)

1. Processus d'initialisation de l'espace de travail

(Géré par l’utilisateur et Fireblocks)

Etape 1. L'utilisateur contacte Fireblocks - Demande de création d'un espace de travail.

L'utilisateur soumet une demande à Fireblocks et Fireblocks crée un nouvel espace de travail pour l'utilisateur.

Étape 2. Fireblocks configure l'espace de travail en tant qu'espace de travail OES.

Fireblocks configure l'espace de travail pour qu'il soit compatible avec le mode OES de Gate et active les fonctionnalités requises telles que Délégué , Délégué , Paiement des frais de gas , etc.

Etape 3. L'utilisateur génère une clé API sur Gate

L'utilisateur se connecte à la plateforme Gate et génère une clé API spécifique pour Fireblocks.
Exigences :

• Doit être créé par le compte principal de Gate.

• Le compte principal (y compris tous les sous-comptes) doit remplir les deux conditions :

• Aucune position en cours

• Solde à zéro

Etape 4. L'utilisateur lie la clé API de la passerelle à l'espace de travail de Fireblocks.

L’utilisateur retourne sur Fireblocks et associe la clé API Gate dans les paramètres du workspace.
Après cette étape, Fireblocks peut interagir avec Gate au nom de l’utilisateur (délégué, règlement, etc.).

Etape 5. L'utilisateur commence à déléguer chaque devise prise en charge (ce qui déclenche la création d'un portefeuille dans Gate).

L'utilisateur délègue chaque devise de règlement prise en charge par Fireblocks.
Actions de délégation :

• Déclenche Fireblocks → Requête de Gate
• Gate génère automatiquement une adresse de portefeuille mappée pour cet actif.

Remarques :

• La première tentative de délégation va probablement échouer (le portefeuille n'a pas encore été initialisé) → Cette erreur peut être ignorée.
• Attendez ~10 minutes , puis déléguez à nouveau pour réussir
• Chaque actif de règlement pris en charge doit être délégué au moins une fois pour activer le portefeuille.

Dépôts des utilisateurs et garantie des frais de gas (collatéral)

Dans le modèle OES traditionnel, les deux parties doivent déposer un collatéral de plusieurs millions de dollars dans les portefeuilles de l’autre partie.
En mode Fireblocks self-custody OES :

• Gate n'exige pas que l'utilisateur dépose des garanties importantes dans Gate.

• L'utilisateur doit maintenir l'équivalent de 100 USDT d'actifs du réseau principal dans son propre espace de travail Fireblocks. （déléguer à Gate）

• Gate gèlera ce petit montant afin de couvrir les frais de gas liés au règlement.

• Les actifs restent entièrement autonomes à l'intérieur des Fireblocks et ne quittent jamais l'espace de travail.

• L'utilisateur doit maintenir l'équivalent de 50 USDT d'actifs du réseau principal dans son propre espace de travail Fireblocks. (sans les déléguer à Gate)

• Au total, 150 USDT de garantie du réseau principal sont nécessaires

Avantage : L’exigence de collatéral passe de plusieurs millions → ~quelques centaines d’USDT.

Détails de l'actif du réseau principal

① L'utilisateur dépose les actifs du réseau principal dans l'espace de travail Fireblocks.

Réseau de règlement doit disposer de sa monnaie native du réseau principal correspondant.
Exemples:

• ERC → ETH
• BRC → BTC
• Solana → SOL
• Tron → TRX

② Déléguer à Gate un montant d'actif du réseau principal équivalent à 100 USDT

Gate gèlera automatiquement ce montant en tant que collatéral pour les frais de gas.

③ Maintenir un solde ≥ 100 USDT dans le portefeuille mappé sur Gate

Cela garantit la disponibilité de frais de gas suffisants.

④ Préparer ~50 USDT supplémentaires de l'actif du réseau principal

(Dans l'espace de travail Fireblocks)
Utilisé pour couvrir des opérations de règlement multiples.

Devises de règlement prises en charge et exigences du réseau principal

3. Conditions préalables au règlement & Traitement des échecs

3.1 Rapport d'erreurs de règlement par Gate

Gate peut fournir des données sur les erreurs de règlement structuré :
Mais ces données sont transmises à Fireblocks et non directement aux clients.
Informations fournies :

1. Devise de règlement
2. Montant du règlement
3. Réseau de règlement (ERC / BRC / Solana / Tron)
4. Actif requis du réseau principal
5. Montant requis sur le réseau principal

3.2 Lorsqu’un règlement échoue (par exemple en cas de frais de gas insuffisants)

Gate renvoie une structure d’erreur standardisée à Fireblocks.
Cependant, Fireblocks n’affiche pas encore pleinement ces erreurs.
Si l'utilisateur rencontre un échec de règlement :
→ Veuillez contacter votre représentant du support API pour connaître la cause détaillée.

Exemple de réponse d'erreur

{
"success": false,
"errors": [
{
"type": "gas_fee_insufficient",
"currency": "USDT",
"network": "ETH",
"message": "Missing gas fee",
"details": {
"available": "0",
"mainCoin": "ETH",
"required": "0,01"
},
"severity": "error"
}
],
"message": "Gas fee insufficient for settlement/withdrawal",
"data": {
"amount": "100,0",
"collateralId": "fb_test_2001",
"currency": "USDT",
"userId": 2001
}
}

Logique de Gate

• Détecte un équilibre insuffisant du réseau principal → renvoie une erreur
• L’utilisateur réapprovisionne les actifs du réseau principal ou augmente le solde du portefeuille mappé sur Gate → nouvelle tentative de règlement

Résumé final du processus de bout en bout

Phase d'initialisation

1. L’utilisateur contacte Fireblocks
2. Fireblocks crée un espace de travail
3. Fireblocks le configure en tant qu'un espace de travail OES.
4. L'utilisateur génère une clé API Gate
5. L'utilisateur lie la clé API dans Fireblocks.
6. L'utilisateur délègue chaque devise prise en charge (la première tentative échoue → attendez 10 minutes → réessayez).

Phase de collatéral pour les frais de gas

1. L’utilisateur dépose des actifs du réseau principal dans l'espace de travail Fireblocks
2. L’utilisateur délègue à Gate des actifs du réseau principal d’une valeur équivalente à 100 USDT (montant gelé)
3. Maintenir un solde ≥ 100 USDT dans le portefeuille mappé sur Gate
4. Maintenir environ 50 USDT d’actifs du réseau principal dans l'espace de travail pour les règlements répétés

Phase de règlement

1. Gate calcule le gas requis sur le réseau principal et lance le règlement
2. Si le gas est insuffisant → Gate renvoie une erreur normalisée
3. L’utilisateur réapprovisionne le gas → nouvelle tentative de règlement