什么是 TON 测试网 RPC？如何使用它？

快速推荐：你应该使用哪个 TON 测试网 RPC？

如果你正在 TON 上构建 dApp、钱包或机器人，你需要一个足够可靠的测试网端点，用于持续集成和调试。公共端点如 https://testnet.toncenter.com/api/v2/jsonRPC 适用于轻量测试，但它们通常有速率限制且没有正常运行时间保证。为了获得更稳定的体验，请考虑使用托管 RPC 提供商，如 OnFinality，它提供专用的 TON 测试网端点，具有更高的吞吐量和更好的可靠性。查看 TON 测试网网络页面 获取最新的端点详情。

什么是 TON 测试网？

TON（开放网络）测试网是一个独立的区块链网络，用于开发和测试。它镜像了主网的功能，但使用没有真实价值的测试 TON 代币。开发者使用它来部署智能合约、测试钱包集成以及模拟交易，而无需承担财务风险。

TON 测试网 RPC 端点一览

下表列出了常见的公共 TON 测试网 RPC 端点。请注意，可用性和速率限制可能会变化，因此请始终检查提供商的文档。

如何连接 TON 测试网 RPC

使用 curl 和 JSON-RPC

TON API v2 支持 JSON-RPC。以下是一个基本的 getMasterchainInfo 调用：

curl "https://testnet.toncenter.com/api/v2/jsonRPC" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMasterchainInfo",
    "params": {}
  }'

如果你有 API 密钥，可以通过请求头或查询参数添加：

curl "https://testnet.toncenter.com/api/v2/jsonRPC" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMasterchainInfo",
    "params": {}
  }'

使用 JavaScript（ton 库）

如果你使用 ton npm 包，你可以使用自定义 HTTP 端点创建客户端：

import { TonClient } from "ton";

const client = new TonClient({
  endpoint: "https://testnet.toncenter.com/api/v2/jsonRPC",
  apiKey: "YOUR_API_KEY" // 可选
});

async function main() {
  const info = await client.getMasterchainInfo();
  console.log(info);
}

main();

认证和速率限制

公共 TON 测试网端点通常在没有 API 密钥的情况下将请求限制为每秒一次。要提高限制，你需要注册获取 API 密钥。TON Center API v2 接受 X-API-Key 请求头或 api_key 查询参数中的密钥。始终保密你的 API 密钥，切勿在客户端代码中暴露。

选择 TON 测试网 RPC 提供商

在选择测试网 RPC 提供商时，请考虑以下因素：

• 可靠性：公共端点可能会宕机或限流。托管提供商如 OnFinality 提供专用基础设施，具有更好的正常运行时间。
• 速率限制：免费的公共端点通常有严格的限制。如果你的测试发出许多请求，你需要一个具有更高配额的提供商。
• 地理分布：具有多个区域的提供商可以减少用户的延迟。
• 支持：托管服务通常提供支持渠道和文档。

对于生产工作负载，你可能还需要考虑专用节点。请参阅 RPC 定价 了解选项。

常见陷阱和故障排除

429 请求过多

此错误表示你超出了速率限制。等待一秒钟或添加 API 密钥以提高限制。

认证错误

如果你收到 401，则你的 API 密钥无效或缺失。检查你是否在请求头或查询参数中正确发送了它。

网络问题

如果端点无法访问，请尝试其他提供商或检查你的互联网连接。你也可以使用监控工具来测试端点健康状况。

关键要点

• TON 测试网 RPC 端点允许你与测试网交互以进行开发和测试。
• 公共端点很方便，但可能存在速率限制和可靠性问题。
• 对于严肃的开发，请考虑使用托管 RPC 提供商，如 OnFinality，以获得更好的性能和支持。
• 始终保护你的 API 密钥并遵循认证最佳实践。

常见问题解答

TON 测试网的 RPC URL 是什么？

一个常见的公共端点是 https://testnet.toncenter.com/api/v2/jsonRPC。OnFinality 还提供测试网端点：https://ton-testnet.api.onfinality.io/public/jsonRPC。

我需要 TON 测试网 RPC 的 API 密钥吗？

不是严格必需的，但没有密钥你将被限制为每秒一个请求。为了获得更高的限制，你应该从提供商处获取 API 密钥。

我可以将 TON 测试网 RPC 用于生产吗？

不可以，测试网仅用于开发和测试。对于生产，你应该使用 TON 主网 RPC 端点。

如何获取测试 TON 代币？

你可以从 TON 测试网水龙头获取测试 TON。请查看官方 TON 文档获取当前水龙头 URL。

TON 测试网和主网 RPC 有什么区别？

测试网 RPC 连接到测试网网络，该网络使用测试代币并用于开发。主网 RPC 连接到使用真实 TON 的实时网络。

有关支持的网络和端点的更多信息，请访问 支持的 RPC 网络 页面。