> ## 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

> Aprenda a gerenciar USDC entre cadeias usando o recurso Gateway

<Note>
  Em resumo<br />
  O Gateway permite o gerenciamento unificado de USDC em várias blockchains — deposite de qualquer cadeia, saque para qualquer cadeia, tudo a partir de um único saldo abstraído da cadeia. Sem pontes manuais ou fragmentação de liquidez.
</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é-requisitos

Antes de usar a API do Gateway, certifique-se de ter:

<Steps>
  <Step title="Chave de API">
    Obtenha sua chave de API no [Painel da Blockradar](https://dashboard.blockradar.co). Navegue até **Developers** para gerar uma.
  </Step>

  <Step title="Wallet compatível">
    Crie uma master wallet em uma cadeia compatível com o Gateway (Ethereum, Base, Polygon, Arbitrum, Optimism ou Avalanche). Use a [API Criar Wallet](/en/api-reference/wallets/create-wallet) ou o painel.
  </Step>

  <Step title="Saldo em USDC">
    Certifique-se de que sua wallet tenha USDC para depositar no Gateway. O Gateway suporta apenas USDC para operações entre cadeias.
  </Step>

  <Step title="Token nativo para gas">
    Abasteça sua wallet com tokens nativos (ETH, MATIC, AVAX) para cobrir as taxas de rede das operações de depósito e saque.
  </Step>
</Steps>

<Warning>
  NÃO envie USDC diretamente para o contrato Gateway Wallet usando uma transferência de token padrão — isso resultará em perda permanente de fundos. Use apenas os métodos oficiais da API para depósitos.
</Warning>

## Como funciona

O Gateway permite gerenciar USDC perfeitamente em todas as blockchains suportadas. Ele elimina pontes manuais, rebalanceamento e fragmentação de liquidez — permitindo mover, depositar e sacar USDC instantaneamente, de qualquer cadeia para qualquer cadeia.

### Ações suportadas:

* Depositar USDC de qualquer blockchain suportada no seu saldo unificado do Gateway.

* Sacar (cunhar) USDC instantaneamente em qualquer outra blockchain suportada.

* Visualizar wallets, transações e saldos via API.

## Referência da API

### **Endpoints**

Abaixo estão os endpoints principais da API para operações do Gateway:

#### **Endpoints do Gateway para Master Wallet**

* [POST /gateway/deposit](/en/api-reference/gateway/master-wallet-deposit) – Depositar USDC no saldo do Gateway

* [POST /gateway/withdraw](/en/api-reference/gateway/master-wallet-withdraw) – Sacar USDC do saldo do Gateway para qualquer cadeia suportada

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

* [GET /gateway/transactions](/en/api-reference/gateway/master-wallet-transactions) – Revisar todas as transações relacionadas ao Gateway

* [GET /gateway/balance](/en/api-reference/gateway/master-wallet-get-balance) – Consultar saldo unificado de USDC

* [POST /gateway/deposit-network-fee](/en/api-reference/gateway/master-wallet-deposit-network-fee) – Obter estimativa de taxa de rede para depósito

* [POST /gateway/withdraw-network-fee](/en/api-reference/gateway/master-wallet-withdraw-network-fee) – Obter estimativa de taxa de rede para saque

#### **Endpoints do Gateway para Endereços Filhos**

Você pode acessar os recursos do Gateway diretamente da página do endereço filho no painel:

<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 de Endereço Filho" width="3444" height="1908" data-path="images/child-address-gateway.png" />

* [POST /addresses/{addressId}/gateway/deposit/{walletId}](/en/api-reference/gateway/child-address-deposit) – Depositar USDC no saldo do Gateway para um endereço filho

* [POST /addresses/{addressId}/gateway/withdraw](/en/api-reference/gateway/child-address-withdraw) – Sacar USDC do saldo do Gateway de um endereço filho para qualquer cadeia suportada

* [GET /addresses/{addressId}/gateway/transactions](/en/api-reference/gateway/child-address-transactions) – Revisar todas as transações relacionadas ao Gateway de um endereço filho

* [GET /addresses/{addressId}/gateway/balance](/en/api-reference/gateway/child-address-get-balance) – Consultar saldo unificado de USDC para um endereço filho

* [POST /addresses/{addressId}/gateway/deposit/{walletId} /network-fee](/en/api-reference/gateway/child-address-deposit-network-fee) – Obter estimativa de taxa de rede para depósito de um endereço filho

* [POST /addresses/{addressId}/gateway/withdraw/network-fee](/en/api-reference/gateway/child-address-withdraw-network-fee) – Obter estimativa de taxa de rede para saque de um endereço filho

<Note>
  {" "}

  NÃO envie USDC diretamente para o contrato Gateway Wallet usando uma transferência de token padrão — isso
  resultará em perda permanente de fundos. Use apenas os métodos oficiais da API para depósitos.{" "}
</Note>

<Note>
  {" "}

  * O Gateway exibe as taxas de rede antes do depósito ou saque; as taxas são deduzidas
    do saldo da sua master wallet.{" "}
</Note>

***

## Visão geral do painel

O painel do Gateway fornece uma interface intuitiva para gerenciar seu saldo unificado de USDC. Você pode criar regras, monitorar saldos e configurar preferências de liquidação sem usar a 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="Painel do Gateway" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### Seções principais do painel:

* **Wallets** – Visualize todas as wallets vinculadas e seus saldos unificados
* **Transações** – Acompanhe depósitos, saques e atividades de liquidação.
* **Regras do Gateway** – Configure regras de liquidação automática para depósitos recebidos.

***

## Configuração de liquidação automática

As regras de liquidação automática permitem que os depósitos sejam convertidos automaticamente em um saldo unificado de USDC na cadeia de destino escolhida (por exemplo, Base). Isso elimina a necessidade de trocar ou criar pontes manualmente para ativos.
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="Configuração de liquidação automática" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### Por que a liquidação automática é importante

* **Reduz a fragmentação** – Todas as stablecoins recebidas são normalizadas em USDC.
* **Economiza tempo** – Sem necessidade de monitorar ou converter depósitos manualmente.
* **Gerenciamento de risco** – Aplique tolerância de deslizamento e regras para se proteger contra execuções ruins.
* **Eficiência operacional** – Garante que sua tesouraria sempre permaneça em um único saldo abstraído da cadeia.

***

## Criando uma regra de liquidação

Cada regra permite definir como e quando os depósitos recebidos são liquidados:

<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="Configuração de liquidação automática 2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **Nome da regra** – Dê um nome descritivo à sua regra de liquidação.
* **Valor mín./máx.** – Controle o tamanho dos depósitos que acionam a liquidação.
* **Tolerância de deslizamento** – Protege contra alta volatilidade ou execução ruim.
* **Ativo de origem** – Escolha quais ativos liquidar automaticamente (por exemplo, USDT, DAI).
* **Ativo de destino** – Normalmente USDC, unificado no Gateway.
* **Cadeia de destino** – Selecione sua cadeia alvo (por exemplo, Base).
* **Preferência de liquidação** – Otimize para execução *Mais rápida*, *Mais barata* ou *Mais segura*.

<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="Configuração de liquidação automática 2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

Uma vez salvas, as regras são automaticamente aplicadas aos depósitos que correspondem aos seus critérios.

***

## Finalidade do depósito

Ao depositar no Gateway, os fundos são creditados em seu saldo unificado somente após a transação atingir a **finalidade** na cadeia de origem.\
A finalidade depende das regras de consenso de cada cadeia e das confirmações de bloco necessárias.

***

### Testnet

| Cadeia               | Origem         | Destino        |
| -------------------- | -------------- | -------------- |
| **Avalanche Fuji**   | <span>✔</span> | <span>✔</span> |
| **Base Sepolia**     | <span>✔</span> | <span>✔</span> |
| **Ethereum Sepolia** | <span>✔</span> | <span>✔</span> |

<Note>
  Você pode obter ativos de teste nos ambientes de teste listados
  [aqui](/en/essentials/wallets#test-environment)
</Note>

### Mainnet

| Cadeia        | Origem         | Destino        |
| ------------- | -------------- | -------------- |
| **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> |

***

### Confirmações necessárias e tempos de finalidade

| Cadeia        | Confirmações       | Tempo aprox. para finalidade |
| ------------- | ------------------ | ---------------------------- |
| **Arbitrum**  | \~65 blocos de ETH | \~13 a 19 minutos            |
| **Avalanche** | 1                  | \~8 segundos                 |
| **Base**      | \~65 blocos de ETH | \~13 a 19 minutos            |
| **Ethereum**  | \~65               | \~13–19 minutos              |
| **Optimism**  | \~65 blocos de ETH | \~13 a 19 minutos            |
| **Polygon**   | \~2-3              | \~8 segundos                 |

***

<Note>
  O Gateway só credita seu saldo **após a finalidade ser atingida**. Certifique-se
  de considerar esses tempos de confirmação ao projetar fluxos voltados ao usuário,
  especialmente se for compatível com testnet e mainnet.
</Note>

<br /> Bons códigos! ❤️