> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway

> Apprenez à gérer l'USDC inter-chaînes avec la fonctionnalité Gateway

<Note>
  En bref<br />
  Gateway permet une gestion unifiée de l'USDC sur plusieurs blockchains — déposez depuis n'importe quelle chaîne, retirez vers n'importe quelle chaîne, le tout depuis un solde unique abstrait de la chaîne. Pas de pont manuel ni de fragmentation de la liquidité.
</Note>

<iframe className="w-full h-[500px]" height="315" src="https://www.youtube.com/embed/2zlnvIArI_s?si=Q_jg2-xR4d783w3g" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

## Prérequis

Avant d'utiliser l'API Gateway, assurez-vous de disposer de :

<Steps>
  <Step title="Clé API">
    Obtenez votre clé API depuis le [Tableau de bord Blockradar](https://dashboard.blockradar.co). Accédez à **Developers** pour en générer une.
  </Step>

  <Step title="Wallet compatible">
    Créez une master wallet sur une chaîne compatible avec Gateway (Ethereum, Base, Polygon, Arbitrum, Optimism ou Avalanche). Utilisez l'[API Créer Wallet](/en/api-reference/wallets/create-wallet) ou le tableau de bord.
  </Step>

  <Step title="Solde USDC">
    Assurez-vous que votre wallet dispose d'USDC à déposer dans Gateway. Gateway ne prend en charge que l'USDC pour les opérations inter-chaînes.
  </Step>

  <Step title="Jeton natif pour le gas">
    Approvisionnez votre wallet avec des jetons natifs (ETH, MATIC, AVAX) pour couvrir les frais de réseau des opérations de dépôt et de retrait.
  </Step>
</Steps>

<Warning>
  N'envoyez JAMAIS d'USDC directement au contrat Gateway Wallet via un transfert de jeton standard — cela entraînera une perte permanente de fonds. Utilisez uniquement les méthodes officielles de l'API pour les dépôts.
</Warning>

## Fonctionnement

Gateway vous permet de gérer l'USDC de manière transparente sur toutes les blockchains prises en charge. Il élimine les ponts manuels, le rééquilibrage et la fragmentation de la liquidité — vous permettant de déplacer, déposer et retirer de l'USDC instantanément, de n'importe quelle chaîne vers n'importe quelle chaîne.

### Actions prises en charge :

* Déposer de l'USDC depuis n'importe quelle blockchain prise en charge dans votre solde Gateway unifié.

* Retirer (frapper) instantanément de l'USDC sur n'importe quelle autre blockchain prise en charge.

* Consulter les wallets, transactions et soldes via l'API.

## Référence API

### **Endpoints**

Voici les principaux endpoints API pour les opérations Gateway :

#### **Endpoints Gateway pour Master Wallet**

* [POST /gateway/deposit](/en/api-reference/gateway/master-wallet-deposit) – Déposer de l'USDC sur le solde Gateway

* [POST /gateway/withdraw](/en/api-reference/gateway/master-wallet-withdraw) – Retirer de l'USDC du solde Gateway vers n'importe quelle chaîne prise en charge

* [GET /gateway/wallets](/en/api-reference/gateway/get-supported-master-wallets) – Lister les wallets Gateway

* [GET /gateway/transactions](/en/api-reference/gateway/master-wallet-transactions) – Examiner toutes les transactions liées à Gateway

* [GET /gateway/balance](/en/api-reference/gateway/master-wallet-get-balance) – Consulter le solde unifié d'USDC

* [POST /gateway/deposit-network-fee](/en/api-reference/gateway/master-wallet-deposit-network-fee) – Obtenir une estimation des frais de réseau pour le dépôt

* [POST /gateway/withdraw-network-fee](/en/api-reference/gateway/master-wallet-withdraw-network-fee) – Obtenir une estimation des frais de réseau pour le retrait

#### **Endpoints Gateway pour Adresses Enfants**

Vous pouvez accéder aux fonctionnalités Gateway directement depuis la page de l'adresse enfant dans le tableau de bord :

<img className="gateway-child-address" src="https://mintcdn.com/blockradar/Q4zdBTyprhDmz_Ni/images/child-address-gateway.png?fit=max&auto=format&n=Q4zdBTyprhDmz_Ni&q=85&s=e196861c718f20b6696f78ac6064eb17" alt="Gateway d'adresse enfant" width="3444" height="1908" data-path="images/child-address-gateway.png" />

* [POST /addresses/{addressId}/gateway/deposit/{walletId}](/en/api-reference/gateway/child-address-deposit) – Déposer de l'USDC sur le solde Gateway pour une adresse enfant

* [POST /addresses/{addressId}/gateway/withdraw](/en/api-reference/gateway/child-address-withdraw) – Retirer de l'USDC du solde Gateway pour une adresse enfant vers n'importe quelle chaîne prise en charge

* [GET /addresses/{addressId}/gateway/transactions](/en/api-reference/gateway/child-address-transactions) – Examiner toutes les transactions liées à Gateway pour une adresse enfant

* [GET /addresses/{addressId}/gateway/balance](/en/api-reference/gateway/child-address-get-balance) – Consulter le solde unifié d'USDC pour une adresse enfant

* [POST /addresses/{addressId}/gateway/deposit/{walletId} /network-fee](/en/api-reference/gateway/child-address-deposit-network-fee) – Obtenir une estimation des frais de réseau pour le dépôt d'une adresse enfant

* [POST /addresses/{addressId}/gateway/withdraw/network-fee](/en/api-reference/gateway/child-address-withdraw-network-fee) – Obtenir une estimation des frais de réseau pour le retrait d'une adresse enfant

<Note>
  {" "}

  N'envoyez JAMAIS d'USDC directement au contrat Gateway Wallet via un transfert de jeton standard — cela
  entraînera une perte permanente de fonds. Utilisez uniquement les méthodes officielles de l'API pour les dépôts.{" "}
</Note>

<Note>
  {" "}

  * Gateway affiche les frais de réseau avant le dépôt ou le retrait ; les frais sont déduits
    du solde de votre master wallet.{" "}
</Note>

***

## Aperçu du tableau de bord

Le tableau de bord Gateway fournit une interface intuitive pour gérer votre solde unifié d'USDC. Vous pouvez créer des règles, surveiller les soldes et configurer les préférences de règlement sans utiliser l'API.

<img className="gateway-dashboard" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/gateway-dashboard1.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=7532a0c2409bd1295d61b2fc33a436ac" alt="Tableau de bord Gateway" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### Sections clés du tableau de bord :

* **Wallets** – Affichez toutes les wallets associées et leurs soldes unifiés
* **Transactions** – Suivez les dépôts, retraits et activités de règlement.
* **Règles Gateway** – Configurez des règles de règlement automatique pour les dépôts entrants.

***

## Configuration du règlement automatique

Les règles de règlement automatique permettent aux dépôts d'être automatiquement convertis en un solde unifié d'USDC sur la chaîne de destination de votre choix (par exemple, Base). Cela évite d'avoir à échanger ou à utiliser un pont manuellement pour les actifs.
autosettlement-gateway1.png

<img className="gateway-autosettlement1" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=182a6bb9fedd570c2bc5356ba2a595a3" alt="Configuration du règlement automatique" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### Pourquoi le règlement automatique est important

* **Réduit la fragmentation** – Toutes les stablecoins entrantes sont normalisées en USDC.
* **Gain de temps** – Pas besoin de surveiller ou de convertir manuellement les dépôts.
* **Gestion des risques** – Appliquez une tolérance au glissement et des règles pour vous protéger contre les mauvaises exécutions.
* **Efficacité opérationnelle** – Garantit que votre trésorerie repose toujours sur un solde unique abstrait de la chaîne.

***

## Créer une règle de règlement

Chaque règle vous permet de définir comment et quand les dépôts entrants sont réglés :

<img className="gateway-autosettlement3" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway3.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=a00263fbcdc6276dc8f87bcbfa6fa452" alt="Configuration du règlement automatique 2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **Nom de la règle** – Donnez un nom descriptif à votre règle de règlement.
* **Montant min./max.** – Contrôlez la taille des dépôts qui déclenchent le règlement.
* **Tolérance au glissement** – Protège contre une forte volatilité ou une mauvaise exécution.
* **Actif source** – Choisissez les actifs à régler automatiquement (par exemple, USDT, DAI).
* **Actif de destination** – Généralement USDC, unifié dans Gateway.
* **Chaîne de destination** – Sélectionnez votre chaîne cible (par exemple, Base).
* **Préférence de règlement** – Optimisez pour une exécution *La plus rapide*, *La moins chère* ou *La plus sûre*.

<img className="gateway-autosettlement5" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway5.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=cd8c46aad05819eee00312e580b3d2f2" alt="Configuration du règlement automatique 2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

Une fois enregistrées, les règles sont automatiquement appliquées aux dépôts correspondant à vos critères.

***

## Finalité du dépôt

Lors du dépôt dans Gateway, les fonds ne sont crédités sur votre solde unifié qu'après que la transaction a atteint la **finalité** sur la chaîne source.\
La finalité dépend des règles de consensus de chaque chaîne et du nombre de confirmations de blocs requises.

***

### Testnet

| Chaîne               | Source         | Destination    |
| -------------------- | -------------- | -------------- |
| **Avalanche Fuji**   | <span>✔</span> | <span>✔</span> |
| **Base Sepolia**     | <span>✔</span> | <span>✔</span> |
| **Ethereum Sepolia** | <span>✔</span> | <span>✔</span> |

<Note>
  Vous pouvez obtenir des actifs de test sur les environnements de test listés
  [ici](/en/essentials/wallets#test-environment)
</Note>

### Mainnet

| Chaîne        | Source         | Destination    |
| ------------- | -------------- | -------------- |
| **Arbitrum**  | <span>✔</span> | <span>✔</span> |
| **Avalanche** | <span>✔</span> | <span>✔</span> |
| **Base**      | <span>✔</span> | <span>✔</span> |
| **Ethereum**  | <span>✔</span> | <span>✔</span> |
| **Optimism**  | <span>✔</span> | <span>✔</span> |
| **Polygon**   | <span>✔</span> | <span>✔</span> |

***

### Confirmations requises et délais de finalité

| Chaîne        | Confirmations  | Délai approx. de finalité |
| ------------- | -------------- | ------------------------- |
| **Arbitrum**  | \~65 blocs ETH | \~13 à 19 minutes         |
| **Avalanche** | 1              | \~8 secondes              |
| **Base**      | \~65 blocs ETH | \~13 à 19 minutes         |
| **Ethereum**  | \~65           | \~13–19 minutes           |
| **Optimism**  | \~65 blocs ETH | \~13 à 19 minutes         |
| **Polygon**   | \~2-3          | \~8 secondes              |

***

<Note>
  Gateway ne crédite votre solde **qu'après l'atteinte de la finalité**. Veillez à
  tenir compte de ces délais de confirmation lors de la conception des flux destinés aux utilisateurs,
  en particulier si vous prenez en charge à la fois testnet et mainnet.
</Note>

<br /> Bon développement ! ❤️