> ## 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 como gerenciar USDC entre blockchains usando o recurso Gateway

<Note>
  Em resumo<br />
  O Gateway permite gerenciamento unificado de USDC em múltiplas blockchains—deposite de qualquer chain, saque para qualquer chain, tudo a partir de um único saldo abstraído de chain. 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 API">
    Obtenha sua chave API no [Painel da Blockradar](https://dashboard.blockradar.co). Navegue até **Developers** para gerar uma.
  </Step>

  <Step title="Carteira Suportada">
    Crie uma carteira mestra em uma chain suportada pelo Gateway (Ethereum, Base, Polygon, Arbitrum, Optimism ou Avalanche). Use a [API Criar Carteira](/pt/api-reference/wallets/create-wallet) ou o painel.
  </Step>

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

  <Step title="Token Nativo para Gas">
    Financie sua carteira com tokens nativos (ETH, MATIC, AVAX) para cobrir taxas de rede para operações de depósito e saque.
  </Step>
</Steps>

<Warning>
  NÃO envie USDC diretamente para o contrato da Carteira Gateway 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 que você gerencie USDC perfeitamente em todas as blockchains suportadas. Ele elimina pontes manuais, reequilíbrio e fragmentação de liquidez—permitindo que você mova, deposite e saque USDC instantaneamente, de qualquer chain para qualquer chain.

### Ações suportadas:

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

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

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

## Referência da API

### **Endpoints**

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

#### **Endpoints do Gateway da Carteira Mestra**

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

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

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

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

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

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

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

#### **Endpoints do Gateway de Endereço Filho**

Você pode acessar os recursos do Gateway diretamente da página de 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="Child Address Gateway" width="3444" height="1908" data-path="images/child-address-gateway.png" />

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

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

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

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

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

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

<Note>
  {" "}

  NÃO envie USDC diretamente para o contrato de Carteira Gateway 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 taxas de rede antes do depósito ou saque; as taxas são deduzidas
    do saldo da sua carteira mestra.{" "}
</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 tocar na 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="Gateway Dashboard" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### Principais seções do painel:

* **Carteiras** – Visualize todas as carteiras vinculadas e seus saldos unificados
* **Transações** – Rastreie depósitos, saques e atividade 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 automaticamente convertidos em um saldo unificado de USDC na sua chain de destino escolhida (por exemplo, Base). Isso remove a necessidade de trocar ou fazer ponte de ativos manualmente.
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="Autosettlement Config" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### Por que a Liquidação Automática é Importante

* **Reduz fragmentação** – Todas as stablecoins recebidas são normalizadas em USDC.
* **Economiza tempo** – Não há necessidade de monitorar ou converter depósitos manualmente.
* **Gerenciamento de risco** – Aplique tolerância de deslizamento e regras para proteger contra execuções ruins.
* **Eficiência operacional** – Garante que seu tesouro sempre esteja em um único saldo abstraído de chain.

***

## Criando uma Regra de Liquidação

Cada regra permite que você defina 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="Autosettlement Config2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **Nome da Regra** – Dê à sua regra de liquidação um nome descritivo.
* **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** – Tipicamente USDC, unificado no Gateway.
* **Chain de Destino** – Selecione sua chain 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="Autosettlement Config2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

Uma vez salvas, as regras são aplicadas automaticamente 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 **finalidade** na chain de origem.
A finalidade depende das regras de consenso de cada chain e das confirmações de bloco necessárias.

***

### Testnet

| Chain                | 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](/pt/essentials/wallets#ambiente-de-teste)
</Note>

### Mainnet

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

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

***

<Note>
  O Gateway credita seu saldo apenas **após a finalidade ser alcançada**. Certifique-se de
  considerar esses tempos de confirmação ao projetar fluxos voltados ao usuário,
  especialmente se suportar tanto testnet quanto mainnet.
</Note>

<br /> Bons hacks! ❤️