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 支持在多个区块链上统一管理 USDC——从任意链存入，向任意链提取，全部基于单一的链抽象余额。无需手动桥接或承受流动性碎片化。
Gateway 支持在多个区块链上统一管理 USDC——从任意链存入，向任意链提取，全部基于单一的链抽象余额。无需手动桥接或承受流动性碎片化。
前提条件
在使用 Gateway API 之前，请确保您具备：API 密钥
从 Blockradar 控制台 获取您的 API 密钥。导航至 Developers 以生成密钥。
支持的钱包
在 Gateway 支持的链（Ethereum、Base、Polygon、Arbitrum、Optimism 或 Avalanche）上创建一个 master wallet。使用 创建钱包 API 或控制台。
工作原理
Gateway 让您能够无缝地在所有支持的区块链上管理 USDC。它消除了手动桥接、再平衡和流动性碎片化——让您可以即时地在任意链之间移动、存入和提取 USDC。支持的操作：
- 从任何受支持的区块链将 USDC 存入您的统一 Gateway 余额。
- 在任何其他受支持的区块链上即时提取（铸造）USDC。
- 通过 API 查看钱包、交易和余额。
API 参考
Endpoints
以下是 Gateway 操作的核心 API 端点：Master Wallet Gateway 端点
- POST /gateway/deposit – 将 USDC 存入 Gateway 余额
- POST /gateway/withdraw – 将 USDC 从 Gateway 余额提取到任何受支持的链
- GET /gateway/wallets – 列出 Gateway 钱包
- GET /gateway/transactions – 查看所有与 Gateway 相关的交易
- GET /gateway/balance – 查询统一的 USDC 余额
- POST /gateway/deposit-network-fee – 获取存款网络费用估算
- POST /gateway/withdraw-network-fee – 获取提款网络费用估算
子地址 Gateway 端点
您可以从控制台中的子地址页面直接访问 Gateway 功能：
- POST /addresses//gateway/deposit/ – 为子地址将 USDC 存入 Gateway 余额
- POST /addresses//gateway/withdraw – 将子地址的 Gateway 余额中的 USDC 提取到任何受支持的链
- GET /addresses//gateway/transactions – 查看子地址所有与 Gateway 相关的交易
- GET /addresses//gateway/balance – 查询子地址统一的 USDC 余额
- POST /addresses//gateway/deposit/ /network-fee – 获取子地址存款网络费用估算
- POST /addresses//gateway/withdraw/network-fee – 获取子地址提款网络费用估算
请勿使用标准代币转账直接向 Gateway Wallet 合约发送 USDC——这将
导致资金永久丢失。仅使用官方 API 方法进行存款。
- Gateway 在存款或提款之前显示网络费用；费用从您的 master wallet 余额中 扣除。
控制台概览
Gateway 控制台提供直观的 UI 来管理您的统一 USDC 余额。您可以创建规则、监控余额并配置结算偏好，无需使用 API。
控制台关键板块：
- 钱包 – 查看所有关联的钱包及其统一余额
- 交易 – 跟踪存款、提款和结算活动。
- Gateway 规则 – 为传入存款配置自动结算规则。
自动结算配置
自动结算规则允许将存款自动转换为您所选目标链（例如 Base）上的统一 USDC 余额。这消除了手动交换或桥接资产的需要。 autosettlement-gateway1.png
为什么自动结算很重要
- 减少碎片化 – 所有传入的稳定币都被规范化为 USDC。
- 节省时间 – 无需手动监控或转换存款。
- 风险管理 – 应用滑点容差和规则以防止不良执行。
- 运营效率 – 确保您的资金始终位于单一的、链抽象的余额中。
创建结算规则
每条规则都可让您定义传入存款的结算方式和时间：
- 规则名称 – 为您的结算规则取一个描述性的名称。
- 最小/最大金额 – 控制触发结算的存款大小。
- 滑点容差 – 防止高波动性或执行不佳。
- 源资产 – 选择要自动结算的资产（例如 USDT、DAI）。
- 目标资产 – 通常为 USDC，在 Gateway 中统一。
- 目标链 – 选择您的目标链（例如 Base）。
- 结算偏好 – 优化为 最快、最便宜 或 最安全 的执行。
存款最终性
存入 Gateway 时，资金仅在交易在源链上达到 最终性 后才会计入您的统一余额。最终性取决于每条链的共识规则和所需的区块确认数。
测试网
| 链 | 源 | 目标 |
|---|---|---|
| Avalanche Fuji | ✔ | ✔ |
| Base Sepolia | ✔ | ✔ |
| Ethereum Sepolia | ✔ | ✔ |
您可以在
此处 列出的测试环境中获取测试资产
主网
| 链 | 源 | 目标 |
|---|---|---|
| Arbitrum | ✔ | ✔ |
| Avalanche | ✔ | ✔ |
| Base | ✔ | ✔ |
| Ethereum | ✔ | ✔ |
| Optimism | ✔ | ✔ |
| Polygon | ✔ | ✔ |
所需确认数与最终性时间
| 链 | 确认数 | 大致最终性时间 |
|---|---|---|
| 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 秒 |
Gateway 仅在 达到最终性后 才会计入您的余额。在设计面向用户的流程时，
请务必考虑这些确认时间，
特别是在同时支持测试网和主网时。
编程愉快！❤️