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

## 前提条件

在使用 Gateway API 之前，请确保您已完成以下步骤：

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

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

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

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

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

<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 让您无缝管理所有支持区块链上的 USDC。它消除了手动桥接、重新平衡和流动性碎片化的需求——让您可以从任何链到任何链即时移动、充值和提现 USDC。

### 支持的操作：

* 从任何支持的区块链将 USDC 充值到您的统一 Gateway 余额。

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

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

## API 参考

### **端点**

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

#### **主钱包 Gateway 端点**

* [POST /gateway/deposit](/zh/api-reference/gateway/master-wallet-deposit) – 将 USDC 充值到 Gateway 余额

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

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

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

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

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

* [POST /gateway/withdraw-network-fee](/zh/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}](/zh/api-reference/gateway/child-address-deposit) – 为子地址将 USDC 充值到 Gateway 余额

* [POST /addresses/{addressId}/gateway/withdraw](/zh/api-reference/gateway/child-address-withdraw) – 为子地址从 Gateway 余额提现 USDC 到任何支持的链

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

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

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

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

<Note>
  {" "}

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

<Note>
  {" "}

  * Gateway 在充值或提现前显示网络费用；费用从您的主钱包余额中扣除。{" "}
</Note>

***

## 控制面板概述

Gateway 控制面板提供直观的用户界面来管理您的统一 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 余额。这消除了手动交换或桥接资产的需要。

<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>
  您可以在[此处](/zh/essentials/wallets#测试环境)列出的测试环境中获取测试资产
</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 /> 祝您开发愉快！