OnFinality
新用户订阅 RPC,首月享 6.5 折优惠查看优惠
Sui Testnet logo

Sui Testnet RPC 端点与 API

Sui delivers the benefits of Web3 with the ease of Web2

Connect to Sui Testnet through OnFinality's production-ready gRPC and RPC infrastructure. Use the Sui Full Node gRPC API to query checkpoints, transactions, objects and balances, execute or simulate transactions, and stream real-time blockchain activity without operating your own Sui full node.

Sui has deprecated Full Node JSON-RPC in favour of gRPC and GraphQL. OnFinality provides Sui gRPC access for teams migrating existing applications or building new wallets, exchanges, indexers, explorers, games, and backend services.

创建免费 API key:每天 400,000 响应单位,最高 40 响应单位/秒。不同方法的消耗权重不同。

公共接口速率限制为 5 req/sec

连接 Sui 测试网
grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui-testnet.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint
grpcurl -v \ -d '{ "sequence_number": "299599072", "read_mask": { "paths": ["transactions"] } }' \ sui-testnet.api.onfinality.io:443 \ sui.rpc.v2.LedgerService/GetCheckpoint
Sui gRPC 主机
sui-testnet.api.onfinality.io:443
sui-testnet.api.onfinality.io:443
JSON-RPC 端点
https://sui-testnet.api.onfinality.io/public
https://sui-testnet.api.onfinality.io/public
开始接入

连接 Sui Testnet

在 Sui 测试网上通过 OnFinality gRPC 验证 Move 对象访问、检查点处理和交易模拟。为主网上线前的应用后端演练数据流订阅与集成行为,方便团队检查对象型应用所需的链访问流程。

试用公开接口

首次请求
grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui-testnet.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

使用上方接口与请求完成初步检查,再测试应用实际需要的方法与流量模式。

02

创建自己的访问方式

  1. 打开控制台并选择当前网络。
  2. 创建端点,复制控制台提供的访问配置。
  3. 生产使用前验证应用方法、峰值流量与错误处理。
创建 Sui Testnet RPC 端点
RPC API

RPC API 套餐与响应单位

根据响应单位额度和峰值速率选择共享 RPC 套餐;方法权重与网络支持范围需另行核对。

Developer

免费
包含响应单位
每天 400,000
速率限制
最高 40 RU/秒
超额 RU
不提供

Accelerate

$249/月
包含响应单位
每月 1 亿
速率限制
500 RU/秒
超额 RU
$3.75/百万
对比 RPC 套餐

套餐数据核对于 2026 年 11 月 8 日。RU 不总是等于原始请求次数,WebSocket 响应也计入限制。请核对当前价格与该网络的方法文档;节点费用及适用税费另计。

网络参考

Sui Testnet RPC 与 gRPC 详情

网络
Sui Testnet
原生代币
SUI
主要协议
Sui gRPC v2
旧版协议
Sui JSON-RPC
gRPC 传输
HTTP/2 + TLS
JSON-RPC 传输
HTTPS
gRPC 流式传输
支持
gRPC 主机
sui-testnet.api.onfinality.io:443
JSON-RPC 端点
https://sui-testnet.api.onfinality.io/public
区域
France / N. Virginia / Hong Kong
网络参考

连接 Sui Testnet

使用 Sui Full Node gRPC API,以类型化方式访问检查点、交易、对象和余额。公共端点适合初始测试;添加 API key 即可处理已认证的应用流量。

公共 gRPC 端点

API
grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui-testnet.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

已认证 gRPC 端点

API
grpcurl -v \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui-testnet.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

检查 gRPC 连接

API
grpcurl sui-testnet.api.onfinality.io:443 sui.rpc.v2.LedgerService/GetServiceInfo

Sui 已弃用 Full Node JSON-RPC,转而支持 gRPC 和 GraphQL。新的集成请使用 gRPC,并将现有 JSON-RPC 应用作为升级路径的一部分进行迁移。

网络参考

Sui Full Node gRPC API

Sui gRPC 提供类型化服务,用于读取账本状态、查询对象和 Move 包、执行交易,以及从 Sui Full Node 获取实时区块链数据。

LedgerService

GetServiceInfoGetObjectBatchGetObjectsGetTransactionBatchGetTransactionsGetCheckpointGetEpochListCheckpointsListTransactionsListEvents

StateService

ListDynamicFieldsListOwnedObjectsGetCoinInfoGetBalanceListBalances

SubscriptionService

SubscribeCheckpointsSubscribeTransactionsSubscribeEvents

TransactionExecutionService

ExecuteTransactionSimulateTransaction

MovePackageService

GetPackageGetDatatypeGetFunctionListPackageVersions

NameService

LookupNameReverseLookupName

SignatureVerificationService

API
VerifySignature
网络参考

Sui gRPC 实时流式传输

使用SubscriptionService流接收产生的检查点、交易和事件。对于需要实时 Sui 活动的应用,流式传输可以避免反复轮询 HTTP 端点。

SubscribeCheckpointsSubscribeTransactionsSubscribeEvents

这些类型化流提供旧版sui_subscribeEvent和sui_subscribeTransaction工作流的 gRPC 等价能力。

网络参考

在 Sui gRPC 中使用字段掩码

字段掩码允许客户端只请求所需的响应字段。这可以让响应更聚焦,并帮助应用在查询详细检查点、交易和对象时控制负载大小。

API
{
  "sequence_number": "299599072",
  "read_mask": {
    "paths": ["transactions"]
  }
}
网络参考

Sui JSON-RPC — 旧版访问

现有应用可以在迁移期间继续使用 Sui JSON-RPC。旧版端点仍可用于兼容性,但随着网络逐步弃用 Full Node JSON-RPC,新的 Sui 集成应优先使用 gRPC 或 GraphQL。

API
curl -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"sui_getTotalTransactionBlocks"
  }' \
  'https://sui-testnet.api.onfinality.io/public'
网络参考

从 Sui JSON-RPC 迁移到 gRPC

更新客户端、索引器、钱包和后端服务时,请使用类型化 gRPC 服务方法替换旧版方法调用。

Sui JSON-RPCSui gRPC
sui_getObjectLedgerService.GetObject
sui_getTransactionBlockLedgerService.GetTransaction
suix_queryTransactionBlocksLedgerService.ListTransactions
suix_queryEventsLedgerService.ListEvents
sui_subscribeEventSubscriptionService.SubscribeEvents
sui_subscribeTransactionSubscriptionService.SubscribeTransactions
sui_executeTransactionBlockTransactionExecutionService.ExecuteTransaction
sui_dryRunTransactionBlockTransactionExecutionService.SimulateTransaction
网络参考

使用 gRPC 在 Sui 上构建

钱包与交易所

为 Sui 钱包、托管系统和交易所工作流查询余额、对象、交易和实时活动。

索引器与区块浏览器

结合账本查询、字段掩码和订阅,构建 Sui 数据集、区块浏览器、搜索和分析管道。

DeFi 应用

读取对象和余额状态,模拟交易,执行已签名交易,并为 DeFi 产品流式获取协议活动。

游戏与消费者应用

利用 Sui 以对象为中心的模型和实时流处理游戏资产、社交功能、数字收藏品和消费者体验。

后端数据管道

使用类型化 gRPC 响应和流式服务为运营系统、监控、报告和数据产品提供数据,无需运行 Full Node。

网络参考

Sui Mainnet 与 Testnet 端点

环境Mainnet测试网
网络Sui MainnetSui Testnet
gRPC支持支持
JSON-RPC旧版旧版
环境生产开发/QA
适用场景线上应用测试与预发布
按工作负载选择

基于 Sui Testnet 构建应用

根据应用请求、运维要求与上线流程规划接入方式。

应用集成

先完成连接检查,再验证应用需要的读取、交易或数据处理流程。

用量规划

增加流量前检查方法限制、套餐额度与使用量;不同方法可能消耗不同的响应单位。

运行维护

评估延迟、重试和服务可用性时,使用实际客户端地区与请求模式。

永远不用担心基础设施

OnFinality 消除了 DevOps 的繁重工作,让您能够更聪明、更快地构建。

开始