Participants

• Utilisateur
• Fireblocks
• Gate (Module OES)

1. Processus d’initialisation du Workspace

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

Étape 1. L’utilisateur contacte Fireblocks – Demande de création d’un Workspace

L’utilisateur soumet une demande à Fireblocks, qui crée alors un nouveau workspace pour l’utilisateur.

Étape 2. Fireblocks configure le Workspace en tant que Workspace OES

Fireblocks configure le workspace pour qu’il soit compatible avec le mode OES de Gate et active les fonctionnalités requises telles que Delegate, Undelegate, Paiement des frais de gas, etc.

Étape 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écifiquement pour Fireblocks.
Exigences :

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

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

• Aucune position ouverte

• Solde nul

Étape 4. L’utilisateur lie la clé API Gate au Workspace Fireblocks

L’utilisateur retourne sur Fireblocks et lie 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égation, règlement, etc.).

Étape 5. L’utilisateur commence à déléguer chaque devise prise en charge (déclenche la création du wallet sur Gate)

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

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

Remarques :

• La première tentative de délégation échouera probablement (wallet non encore initialisé) → Cette erreur peut être ignorée
• Attendre ~10 minutes, puis déléguer à nouveau pour réussir
• Chaque actif de règlement pris en charge doit être délégué au moins une fois pour activer le wallet

Dépôts utilisateur & Collatéral des frais de gas (garantie)

Dans le modèle OES traditionnel, les deux parties doivent déposer des garanties de plusieurs millions de dollars dans les wallets de l’autre.
En mode OES self-custody de Fireblocks :

• Gate ne demande pas à l’utilisateur de déposer une grosse garantie sur Gate.

• L’utilisateur doit maintenir l’équivalent de 100 USDT en actifs de la blockchain principale dans son propre Workspace Fireblocks. (délégués à Gate)

• Gate va geler ce petit montant pour couvrir les frais de gas des règlements.

• Les actifs restent entièrement en self-custody dans Fireblocks et ne quittent jamais le workspace.

• L’utilisateur doit maintenir l’équivalent de 50 USDT en actifs de la blockchain principale dans son propre Workspace Fireblocks. (sans les déléguer à Gate)

• Au total, 150 USDT de collatéral sur la blockchain principale sont nécessaires

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

Détails des actifs sur la blockchain principale

① L’utilisateur dépose des actifs de la blockchain principale dans le Workspace Fireblocks

Chaque chaîne de règlement doit disposer de sa crypto principale correspondante.
Exemples :

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

② Déléguer à Gate le montant de crypto principale équivalant à 100 USDT

Gate va automatiquement geler ce montant comme collatéral pour les frais de gas.

③ Maintenir un solde du wallet mappé Gate ≥ 100 USDT

Cela garantit une disponibilité suffisante pour les frais de gas.

④ Prévoir environ 50 USDT supplémentaires en crypto principale

(Dans le Workspace Fireblocks)
Utilisé pour couvrir plusieurs transactions de règlement.

Devises de règlement prises en charge & exigences de la blockchain principale

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

3.1 Signalement des erreurs de règlement par Gate

Gate peut fournir des données structurées sur les erreurs de règlement :
Mais ces données sont transmises à Fireblocks, pas 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 principal requis
5. Montant principal requis

3.2 En cas d’échec du règlement (ex. : frais de gas insuffisants)

Gate retourne une structure d’erreur standardisée à Fireblocks.
Cependant, Fireblocks ne remonte pas encore pleinement ces erreurs.
Si l’utilisateur rencontre un échec de règlement :
→ Veuillez contacter votre interlocuteur 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 solde insuffisant sur la blockchain principale → retourne une erreur
• L’utilisateur approvisionne l’actif principal ou augmente le solde du wallet mappé Gate → retente le règlement

Résumé final du processus de bout en bout

Phase d’initialisation

1. L’utilisateur contacte Fireblocks
2. Fireblocks crée un Workspace
3. Fireblocks le configure en Workspace OES
4. L’utilisateur génère une clé API Gate
5. L’utilisateur lie la clé API sur Fireblocks
6. L’utilisateur délègue chaque devise prise en charge (première tentative échoue → attendre 10 min → réessayer)

Phase de collatéral des frais de gas

1. L’utilisateur dépose des cryptos principales dans le Workspace Fireblocks
2. L’utilisateur délègue à Gate l’équivalent de 100 USDT en cryptos principales (gelés)
3. Maintenir un solde du wallet mappé Gate ≥ 100 USDT
4. Maintenir ~50 USDT d’actifs principaux dans le Workspace pour des règlements répétés

Phase de règlement

1. Gate calcule le gas principal requis et initie le règlement
2. Si le gas est insuffisant → Gate retourne une erreur standardisée
3. L’utilisateur réapprovisionne le gas → retente le règlement