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

# 常见问题

> Blockradar 最常见问题的解答。

## 存款与 Webhooks

<AccordionGroup>
  <Accordion title="我的存款没有显示在控制台上">
    这通常是临时的索引延迟。使用存款查找器手动触发索引：

    * **控制台：** 前往主钱包 → 概览 → 点击"Deposit Finder"
    * **API：** 使用 `transactionHash` 调用 `POST /v1/wallets/{walletId}/rescan/blocks`

    [存款查找器文档 →](/zh/essentials/wallets)
  </Accordion>

  <Accordion title="Webhooks 延迟或不一致">
    Webhook 延迟可能由区块链网络拥堵、临时节点索引延迟或您的 Webhook 端点返回错误导致。

    检查 Webhook 日志：

    * **控制台：** 主钱包 → 开发者 → Webhook 日志
    * **API：** `GET /v1/wallets/{walletId}/webhooks`
  </Accordion>

  <Accordion title="我发送了原生代币（ETH/TRX）— 为什么没有显示？">
    Blockradar 设计上仅索引稳定币。原生代币存款（ETH、TRX、SOL 等）不会出现在控制台的交易历史中。但资金仍在您的钱包中，可以在区块链浏览器上查看或通过 API 或控制台提现。
  </Accordion>
</AccordionGroup>

## 自动归集

<AccordionGroup>
  <Accordion title="为什么我的资金自动转移到了主钱包？">
    默认情况下，`disableAutoSweep` 设置为 `false`，即自动归集已启用。当存款到达子地址时，会自动归集到您的主钱包。

    要将资金保留在子地址中：

    * 通过 API 创建地址时设置 `disableAutoSweep: true`
    * 或在控制台的地址设置中切换 **Disable Auto Sweep**
  </Accordion>

  <Accordion title="我禁用了自动归集但资金仍然被转移了">
    检查两个配置级别：

    * **主钱包级别** — 为所有地址设置默认值
    * **地址级别** — 覆盖主钱包设置

    地址级别的设置始终优先。请验证特定地址是否已设置 `disableAutoSweep: true`。
  </Accordion>

  <Accordion title="我可以设置自动归集的阈值吗？">
    可以。您可以配置归集阈值，使资金仅在达到一定余额后才自动归集。

    [钱包配置 →](/zh/essentials/wallets)
  </Accordion>
</AccordionGroup>

## Gas 费用与网络成本

<AccordionGroup>
  <Accordion title="Gas 费用是如何运作的？">
    Gas 费用以原生代币直接支付给区块链：

    | 链                           | 原生代币 |
    | --------------------------- | ---- |
    | Ethereum / Base / Polygon 等 | ETH  |
    | Tron                        | TRX  |
    | Solana                      | SOL  |

    Blockradar 不会在网络成本之上收取额外费用。
  </Accordion>

  <Accordion title="为什么 Tron 的费用比其他链更高？">
    由于 Tron 处理带宽和能量的方式，Tron 网络费用通常为每笔交易 \$1–6。这是区块链级别的成本，不是 Blockradar 的收费。

    更低成本的替代方案：

    * **Solana：** 每笔交易约 \$0.01–0.30
    * **Base：** 每笔交易约 \$0.01–0.10
    * **Polygon：** 每笔交易约 \$0.01–0.10
  </Accordion>

  <Accordion title="预估的网络费用高于实际收取的费用">
    `/withdraw/network-fee` 端点返回保守估计值，以确保交易即使在网络高度拥堵时也能成功。您只需支付实际网络费用，通常低于预估值。
  </Accordion>

  <Accordion title="我可以用 USDT/USDC 支付 Gas 费用而不是原生代币吗？">
    不可以，区块链 Gas 费用必须以链的原生代币支付。但是，您可以启用无 Gas 提现，让您的主钱包为子地址交易代付 Gas。
  </Accordion>
</AccordionGroup>

## 无 Gas 交易

<AccordionGroup>
  <Accordion title="如何启用无 Gas 提现？">
    启用无 Gas 后，主钱包代替子地址支付提现的 Gas 费用。

    启用方式：

    * **主钱包级别：** 控制台 → 主钱包设置 → 启用无 Gas 交易
    * **地址级别：** 创建或更新地址时设置 `enableGaslessWithdraw: true`

    您还可以设置阈值，仅覆盖高于或低于特定金额的提现。

    [无 Gas 交易 →](/zh/essentials/withdrawals) · [地址参数 →](/zh/essentials/addresses)
  </Accordion>

  <Accordion title="哪个钱包支付 Gas — 主钱包还是子地址？">
    取决于 `enableGaslessWithdraw` 设置：

    * **启用（`true`）：** 主钱包支付 Gas
    * **禁用（`false`，默认）：** 子地址需要自己的 Gas
  </Accordion>
</AccordionGroup>

## 兑换与桥接

<AccordionGroup>
  <Accordion title="支持哪些兑换？">
    Blockradar 仅支持稳定币之间的兑换：USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX、JPYC。

    原生代币兑换和桥接在所有支持的链上均可用，Tron 除外。
  </Accordion>

  <Accordion title="我收到 'No swap quotes available' 错误">
    这通常意味着不支持该兑换对（例如兑换为原生代币），或金额对于可用流动性来说太小或太大。
  </Accordion>

  <Accordion title="我在兑换时收到 'Wallet not found or not active' 错误">
    此错误通常意味着您使用了错误的资产 ID。您需要使用**钱包特定的资产 ID**，而不是通用资产 ID。

    查找正确 ID 的方法：

    * **控制台：** 前往您的钱包 → 资产 → 从那里复制资产 ID
    * **API：** 使用钱包详情端点返回的资产 ID
  </Accordion>

  <Accordion title="我可以进行跨链兑换吗？">
    可以。您可以通过控制台或 API 跨不同区块链兑换和桥接资产。通过 API 进行跨链兑换时，将目标主钱包的资产 ID 作为 `toAssetId` 传递。

    [兑换文档 →](/zh/essentials/swap)
  </Accordion>
</AccordionGroup>

## 钱包设置与配置

<AccordionGroup>
  <Accordion title="我可以为一条区块链创建多个主钱包吗？">
    Blockradar 每个账户每条区块链网络仅允许一个主钱包。要支持额外的区块链，您必须为其创建单独的主钱包。在单个主钱包内，您可以根据需要创建任意数量的子地址，按用户、应用或用途划分资金。不支持为同一区块链创建多个主钱包。
  </Accordion>

  <Accordion title="我可以删除地址吗？">
    不可以，由于区块链的限制，地址无法删除。您只能在控制台中停用它们。停用的地址不会接收新的存款或被监控。
  </Accordion>

  <Accordion title="如何导出私钥？">
    通过 API 获取钱包或地址详情时使用 `showPrivateKey: true` 参数。

    <Warning>仅在安全、可信的环境中使用此功能。</Warning>
  </Accordion>
</AccordionGroup>

## 提现与转账

<AccordionGroup>
  <Accordion title="如何从子地址提现到外部钱包？">
    使用提现 API 端点：`POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw`

    [提现文档 →](/zh/essentials/withdrawals)
  </Accordion>

  <Accordion title="我的交易一直处于 'pending' 状态">
    常见原因：

    * 主钱包（如果使用无 Gas）或子地址中的 Gas 不足
    * 队列处理 — 由于区块链 nonce，交易按顺序处理
    * 节点问题 — 临时延迟

    如果超过 30 分钟仍处于待处理状态，请携带交易 ID 联系支持团队。
  </Accordion>

  <Accordion title="如何在主钱包和子地址之间转移资金？">
    所有链上资金转移都使用提现端点。没有单独的"转账"端点。

    * **主钱包到子地址：** `POST /v1/wallets/{walletId}/withdraw`，子地址作为目标
    * **子地址到主钱包：** `POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw`，主钱包地址作为目标
    * **子地址到外部：** 相同端点，外部地址作为目标

    [提现文档 →](/zh/essentials/withdrawals)
  </Accordion>

  <Accordion title="如何获取特定子地址的交易历史？">
    使用带有地址查询参数的交易端点：

    ```
        GET /v1/wallets/{walletId}/transactions?address={addressId}
    ```

    [交易文档 →](/zh/api-reference/transactions/get-transactions)
  </Accordion>
</AccordionGroup>

## 资产找回

<AccordionGroup>
  <Accordion title="我将资金发送到了错误的链或不支持的资产">
    在控制台中使用资产找回功能。

    [资产找回 →](/zh/essentials/asset-recovery)
  </Accordion>
</AccordionGroup>

## 测试网与主网

<AccordionGroup>
  <Accordion title="我将主网资金发送到了测试网地址 — 我的资金丢失了吗？">
    不会，您的资金没有丢失。主网和测试网是独立的网络，但地址在密码学上是关联的。您可以使用资产找回来恢复资金。

    [资产找回 →](/zh/essentials/asset-recovery)

    <Tip>交易前请始终检查控制台中的环境指示器（显示"Test Mode"或"Live Mode"）。</Tip>
  </Accordion>

  <Accordion title="如何从测试网切换到主网？">
    1. 使用控制台中的环境切换按钮（通常在右上角或钱包设置中）
    2. 从 **Testnet** 切换到 **Live**
    3. 为主网创建新的主钱包
    4. 更新您的 API 密钥 — 测试网密钥在主网上无法使用

    <Warning>测试网地址无法接收主网资金，反之亦然。</Warning>
  </Accordion>

  <Accordion title="在哪里获取测试网代币？">
    | 链                  | 水龙头                                                                                |
    | ------------------ | ---------------------------------------------------------------------------------- |
    | Ethereum (Sepolia) | [Sepolia Faucet](https://sepoliafaucet.com) 或 [Alchemy](https://sepoliafaucet.com) |
    | BNB Chain          | [BNB Testnet Faucet](https://testnet.bnbchain.org/faucet-smart)                    |
    | Polygon (Amoy)     | [Polygon Faucet](https://faucet.polygon.technology)                                |
    | Base               | [Alchemy Faucet](https://www.alchemy.com/faucets/base-sepolia)                     |
    | Tron (Nile)        | [Nile Testnet](https://nileex.io/join/getJoinPage)                                 |
    | Solana             | [Solana Faucet](https://faucet.solana.com)                                         |
    | Circle USDC        | [Circle Faucet](https://faucet.circle.com)                                         |
  </Accordion>
</AccordionGroup>

## API 错误与故障排除

<AccordionGroup>
  <Accordion title="&#x22;Wallet not found or not active&#x22;">
    常见原因：

    * 错误的钱包 ID
    * 错误的 API 密钥（与钱包不匹配）
    * 使用通用资产 ID 而非钱包特定的资产 ID
  </Accordion>

  <Accordion title="&#x22;Internal Server Error&#x22; / 500 错误">
    通常是临时问题。如果持续出现，请携带您调用的端点、区块链/网络以及完整的错误响应联系支持团队。
  </Accordion>

  <Accordion title="401 Unauthorized">
    您的 API 密钥无效或与您尝试访问的钱包不匹配。请检查：

    * API 密钥是否正确（没有多余的空格）
    * API 密钥是否属于此钱包
    * 是否在主网上使用了测试网密钥（或反之）
    * API 密钥是否已被轮换或重新生成
  </Accordion>

  <Accordion title="404 Not Found">
    资源（钱包、地址或资产）不存在或您使用了错误的 ID。常见原因包括错误的钱包 ID 或地址 ID、使用通用资产 ID 而非钱包特定的 ID，或端点 URL 中的拼写错误。
  </Accordion>
</AccordionGroup>

## 虚拟账户与 cNGN

<AccordionGroup>
  <Accordion title="如何设置虚拟账户以接收 NGN 存款？">
    虚拟账户允许您的用户存入 NGN（尼日利亚奈拉），自动转换为链上稳定币。

    要求：

    * 必须在主网/Live 模式下（非测试网）
    * 必须完成 KYB 验证

    [虚拟账户文档 →](/zh/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="虚拟账户没有显示在我的控制台中">
    虚拟账户仅在以下情况下显示：您处于 Live 模式、您的账户已完成 KYB 验证，并且该功能已为您的账户启用。
  </Accordion>

  <Accordion title="什么是 cNGN？">
    cNGN 是一种与尼日利亚奈拉挂钩的稳定币。Blockradar 支持 cNGN 交易以及与其他稳定币的兑换。
  </Accordion>
</AccordionGroup>

## 法币出入金

<AccordionGroup>
  <Accordion title="用户如何存入法币（NGN）并接收加密货币？">
    使用 NGN 虚拟账户：

    1. 为用户生成虚拟账户
    2. 用户通过银行转账或移动支付存入 NGN
    3. 资金自动转换为稳定币并出现在链上

    [虚拟账户文档 →](/zh/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="除了 NGN 之外还支持其他法币吗？">
    目前虚拟账户仅支持 NGN。对于其他货币，您需要集成第三方法币服务提供商，这将允许您将资金提取为 KES、NGN、TZS、UGX、BRL 和 MWK。请参阅[提取法币](/zh/use-cases/withdraw-fiat)。
  </Accordion>
</AccordionGroup>

## 功能请求

<AccordionGroup>
  <Accordion title="你们支持比特币（BTC）吗？">
    不支持。Blockradar 专注于稳定币。目前不支持比特币。
  </Accordion>

  <Accordion title="你们会添加对新区块链或代币的支持吗？">
    Blockradar 与区块链和稳定币无关 — 可根据请求集成其他网络和资产。[联系我们](mailto:info@blockradar.co)讨论您的需求。
  </Accordion>
</AccordionGroup>

## 计费与订阅

<AccordionGroup>
  <Accordion title="我可以用稳定币支付订阅费吗？">
    可以。您可以通过发送到您邮箱的支付链接付款，或从您的主钱包提现到支付链接地址。
  </Accordion>

  <Accordion title="我可以用信用卡支付吗？">
    目前我们仅支持稳定币支付订阅费。
  </Accordion>
</AccordionGroup>

## 支持的区块链与资产

<AccordionGroup>
  <Accordion title="Blockradar 支持哪些区块链？">
    Ethereum、BNB Chain、Polygon、Tron、Base、Arbitrum、Optimism、Solana、Celo、Lisk、Avalanche、Asset Chain、Plasma 和 Tempo。

    Blockradar 与区块链和稳定币无关 — 可根据请求集成其他网络。
  </Accordion>

  <Accordion title="Blockradar 支持哪些稳定币？">
    USDT、USDC、DAI、BUSD、cUSD、cNGN、EURC、IDRX、JPYC。

    可根据请求集成其他资产。
  </Accordion>
</AccordionGroup>

## 开发者提示

<AccordionGroup>
  <Accordion title="钱包 ID、地址 ID 和资产 ID 之间有什么区别？">
    * **钱包 ID：** 标识您的主钱包
    * **地址 ID：** 标识钱包内的特定子地址
    * **资产 ID：** 标识钱包内的特定资产（USDT、USDC 等）

    <Warning>始终使用钱包资产列表中的钱包特定资产 ID，而不是通用资产 ID。</Warning>
  </Accordion>

  <Accordion title="生产环境最佳实践">
    * 始终使用主网/Live 模式进行真实交易
    * 将钱包 ID 和地址 ID 存储在数据库中
    * 实现 Webhook 处理程序以获取实时交易更新
    * 使用存款查找器作为漏掉交易的备份
    * 监控主钱包的 Gas（原生代币）余额
    * 如果您的用户不需要持有原生代币，请启用无 Gas 提现
  </Accordion>
</AccordionGroup>

## 需要帮助？

<CardGroup cols={3}>
  <Card title="文档" icon="book" href="https://docs.blockradar.co">
    docs.blockradar.co
  </Card>

  <Card title="控制台" icon="gauge" href="https://dashboard.blockradar.co">
    dashboard.blockradar.co
  </Card>

  <Card title="预约支持电话" icon="calendar" href="https://calendly.com/daniel-blockradar/blockradar-tech-support">
    在此预约
  </Card>
</CardGroup>