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

> 了解如何使用 Gateway 功能管理跨链 USDC

<Note>
  简而言之<br />
  Gateway 支持在多个区块链上统一管理 USDC——从任意链存入，向任意链提取，全部基于单一的链抽象余额。无需手动桥接或承受流动性碎片化。
</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 />

## 前提条件

在使用 Gateway API 之前，请确保您具备：

<Steps>
  <Step title="API 密钥">
    从 [Blockradar 控制台](https://dashboard.blockradar.co) 获取您的 API 密钥。导航至 **Developers** 以生成密钥。
  </Step>

  <Step title="支持的钱包">
    在 Gateway 支持的链（Ethereum、Base、Polygon、Arbitrum、Optimism 或 Avalanche）上创建一个 master wallet。使用 [创建钱包 API](/en/api-reference/wallets/create-wallet) 或控制台。
  </Step>

  <Step title="USDC 余额">
    确保您的钱包中有 USDC 可存入 Gateway。Gateway 仅支持 USDC 进行跨链操作。
  </Step>

  <Step title="用于 Gas 的原生代币">
    为您的钱包充值原生代币（ETH、MATIC、AVAX），以支付存入和提取操作的网络费用。
  </Step>
</Steps>

<Warning>
  请勿使用标准代币转账直接向 Gateway Wallet 合约发送 USDC——这将导致资金永久丢失。仅使用官方 API 方法进行存款。
</Warning>

## 工作原理

Gateway 让您能够无缝地在所有支持的区块链上管理 USDC。它消除了手动桥接、再平衡和流动性碎片化——让您可以即时地在任意链之间移动、存入和提取 USDC。

### 支持的操作：

* 从任何受支持的区块链将 USDC 存入您的统一 Gateway 余额。

* 在任何其他受支持的区块链上即时提取（铸造）USDC。

* 通过 API 查看钱包、交易和余额。

## API 参考

### **Endpoints**

以下是 Gateway 操作的核心 API 端点：

#### **Master Wallet Gateway 端点**

* [POST /gateway/deposit](/en/api-reference/gateway/master-wallet-deposit) – 将 USDC 存入 Gateway 余额

* [POST /gateway/withdraw](/en/api-reference/gateway/master-wallet-withdraw) – 将 USDC 从 Gateway 余额提取到任何受支持的链

* [GET /gateway/wallets](/en/api-reference/gateway/get-supported-master-wallets) – 列出 Gateway 钱包

* [GET /gateway/transactions](/en/api-reference/gateway/master-wallet-transactions) – 查看所有与 Gateway 相关的交易

* [GET /gateway/balance](/en/api-reference/gateway/master-wallet-get-balance) – 查询统一的 USDC 余额

* [POST /gateway/deposit-network-fee](/en/api-reference/gateway/master-wallet-deposit-network-fee) – 获取存款网络费用估算

* [POST /gateway/withdraw-network-fee](/en/api-reference/gateway/master-wallet-withdraw-network-fee) – 获取提款网络费用估算

#### **子地址 Gateway 端点**

您可以从控制台中的子地址页面直接访问 Gateway 功能：

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

* [POST /addresses/{addressId}/gateway/deposit/{walletId}](/en/api-reference/gateway/child-address-deposit) – 为子地址将 USDC 存入 Gateway 余额

* [POST /addresses/{addressId}/gateway/withdraw](/en/api-reference/gateway/child-address-withdraw) – 将子地址的 Gateway 余额中的 USDC 提取到任何受支持的链

* [GET /addresses/{addressId}/gateway/transactions](/en/api-reference/gateway/child-address-transactions) – 查看子地址所有与 Gateway 相关的交易

* [GET /addresses/{addressId}/gateway/balance](/en/api-reference/gateway/child-address-get-balance) – 查询子地址统一的 USDC 余额

* [POST /addresses/{addressId}/gateway/deposit/{walletId} /network-fee](/en/api-reference/gateway/child-address-deposit-network-fee) – 获取子地址存款网络费用估算

* [POST /addresses/{addressId}/gateway/withdraw/network-fee](/en/api-reference/gateway/child-address-withdraw-network-fee) – 获取子地址提款网络费用估算

<Note>
  {" "}

  请勿使用标准代币转账直接向 Gateway Wallet 合约发送 USDC——这将
  导致资金永久丢失。仅使用官方 API 方法进行存款。{" "}
</Note>

<Note>
  {" "}

  * Gateway 在存款或提款之前显示网络费用；费用从您的 master wallet 余额中
    扣除。{" "}
</Note>

***

## 控制台概览

Gateway 控制台提供直观的 UI 来管理您的统一 USDC 余额。您可以创建规则、监控余额并配置结算偏好，无需使用 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 控制台" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### 控制台关键板块：

* **钱包** – 查看所有关联的钱包及其统一余额
* **交易** – 跟踪存款、提款和结算活动。
* **Gateway 规则** – 为传入存款配置自动结算规则。

***

## 自动结算配置

自动结算规则允许将存款自动转换为您所选目标链（例如 Base）上的统一 USDC 余额。这消除了手动交换或桥接资产的需要。
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="自动结算配置" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### 为什么自动结算很重要

* **减少碎片化** – 所有传入的稳定币都被规范化为 USDC。
* **节省时间** – 无需手动监控或转换存款。
* **风险管理** – 应用滑点容差和规则以防止不良执行。
* **运营效率** – 确保您的资金始终位于单一的、链抽象的余额中。

***

## 创建结算规则

每条规则都可让您定义传入存款的结算方式和时间：

<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="自动结算配置 2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **规则名称** – 为您的结算规则取一个描述性的名称。
* **最小/最大金额** – 控制触发结算的存款大小。
* **滑点容差** – 防止高波动性或执行不佳。
* **源资产** – 选择要自动结算的资产（例如 USDT、DAI）。
* **目标资产** – 通常为 USDC，在 Gateway 中统一。
* **目标链** – 选择您的目标链（例如 Base）。
* **结算偏好** – 优化为 *最快*、*最便宜* 或 *最安全* 的执行。

<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="自动结算配置 2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

保存后，规则将自动应用于符合您条件的存款。

***

## 存款最终性

存入 Gateway 时，资金仅在交易在源链上达到 **最终性** 后才会计入您的统一余额。\
最终性取决于每条链的共识规则和所需的区块确认数。

***

### 测试网

| 链                    | 源              | 目标             |
| -------------------- | -------------- | -------------- |
| **Avalanche Fuji**   | <span>✔</span> | <span>✔</span> |
| **Base Sepolia**     | <span>✔</span> | <span>✔</span> |
| **Ethereum Sepolia** | <span>✔</span> | <span>✔</span> |

<Note>
  您可以在
  [此处](/en/essentials/wallets#test-environment) 列出的测试环境中获取测试资产
</Note>

### 主网

| 链             | 源              | 目标             |
| ------------- | -------------- | -------------- |
| **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> |

***

### 所需确认数与最终性时间

| 链             | 确认数           | 大致最终性时间      |
| ------------- | ------------- | ------------ |
| **Arbitrum**  | \~65 个 ETH 区块 | \~13 至 19 分钟 |
| **Avalanche** | 1             | \~8 秒        |
| **Base**      | \~65 个 ETH 区块 | \~13 至 19 分钟 |
| **Ethereum**  | \~65          | \~13–19 分钟   |
| **Optimism**  | \~65 个 ETH 区块 | \~13 至 19 分钟 |
| **Polygon**   | \~2-3         | \~8 秒        |

***

<Note>
  Gateway 仅在 **达到最终性后** 才会计入您的余额。在设计面向用户的流程时，
  请务必考虑这些确认时间，
  特别是在同时支持测试网和主网时。
</Note>

<br /> 编程愉快！❤️