试用公开接口
grpcurl -v \
-d '{
"sequence_number": "299599072",
"read_mask": {
"paths": ["transactions"]
}
}' \
sui-testnet.api.onfinality.io:443 \
sui.rpc.v2.LedgerService/GetCheckpoint使用上方接口与请求完成初步检查,再测试应用实际需要的方法与流量模式。
在 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使用上方接口与请求完成初步检查,再测试应用实际需要的方法与流量模式。
根据响应单位额度和峰值速率选择共享 RPC 套餐;方法权重与网络支持范围需另行核对。
套餐数据核对于 2026 年 11 月 8 日。RU 不总是等于原始请求次数,WebSocket 响应也计入限制。请核对当前价格与该网络的方法文档;节点费用及适用税费另计。
使用 Sui Full Node gRPC API,以类型化方式访问检查点、交易、对象和余额。公共端点适合初始测试;添加 API key 即可处理已认证的应用流量。
grpcurl -v \
-d '{
"sequence_number": "299599072",
"read_mask": {
"paths": ["transactions"]
}
}' \
sui-testnet.api.onfinality.io:443 \
sui.rpc.v2.LedgerService/GetCheckpointgrpcurl -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/GetCheckpointgrpcurl sui-testnet.api.onfinality.io:443 sui.rpc.v2.LedgerService/GetServiceInfoSui 已弃用 Full Node JSON-RPC,转而支持 gRPC 和 GraphQL。新的集成请使用 gRPC,并将现有 JSON-RPC 应用作为升级路径的一部分进行迁移。
Sui gRPC 提供类型化服务,用于读取账本状态、查询对象和 Move 包、执行交易,以及从 Sui Full Node 获取实时区块链数据。
GetServiceInfoGetObjectBatchGetObjectsGetTransactionBatchGetTransactionsGetCheckpointGetEpochListCheckpointsListTransactionsListEventsListDynamicFieldsListOwnedObjectsGetCoinInfoGetBalanceListBalancesSubscribeCheckpointsSubscribeTransactionsSubscribeEventsExecuteTransactionSimulateTransactionGetPackageGetDatatypeGetFunctionListPackageVersionsLookupNameReverseLookupNameVerifySignature使用SubscriptionService流接收产生的检查点、交易和事件。对于需要实时 Sui 活动的应用,流式传输可以避免反复轮询 HTTP 端点。
SubscribeCheckpointsSubscribeTransactionsSubscribeEvents这些类型化流提供旧版sui_subscribeEvent和sui_subscribeTransaction工作流的 gRPC 等价能力。
字段掩码允许客户端只请求所需的响应字段。这可以让响应更聚焦,并帮助应用在查询详细检查点、交易和对象时控制负载大小。
{
"sequence_number": "299599072",
"read_mask": {
"paths": ["transactions"]
}
}现有应用可以在迁移期间继续使用 Sui JSON-RPC。旧版端点仍可用于兼容性,但随着网络逐步弃用 Full Node JSON-RPC,新的 Sui 集成应优先使用 gRPC 或 GraphQL。
curl -H 'Content-Type: application/json' \
-d '{
"jsonrpc":"2.0",
"id":1,
"method":"sui_getTotalTransactionBlocks"
}' \
'https://sui-testnet.api.onfinality.io/public'更新客户端、索引器、钱包和后端服务时,请使用类型化 gRPC 服务方法替换旧版方法调用。
| Sui JSON-RPC | Sui gRPC |
|---|---|
sui_getObject | LedgerService.GetObject |
sui_getTransactionBlock | LedgerService.GetTransaction |
suix_queryTransactionBlocks | LedgerService.ListTransactions |
suix_queryEvents | LedgerService.ListEvents |
sui_subscribeEvent | SubscriptionService.SubscribeEvents |
sui_subscribeTransaction | SubscriptionService.SubscribeTransactions |
sui_executeTransactionBlock | TransactionExecutionService.ExecuteTransaction |
sui_dryRunTransactionBlock | TransactionExecutionService.SimulateTransaction |
为 Sui 钱包、托管系统和交易所工作流查询余额、对象、交易和实时活动。
结合账本查询、字段掩码和订阅,构建 Sui 数据集、区块浏览器、搜索和分析管道。
读取对象和余额状态,模拟交易,执行已签名交易,并为 DeFi 产品流式获取协议活动。
利用 Sui 以对象为中心的模型和实时流处理游戏资产、社交功能、数字收藏品和消费者体验。
使用类型化 gRPC 响应和流式服务为运营系统、监控、报告和数据产品提供数据,无需运行 Full Node。
| 环境 | Mainnet | 测试网 |
|---|---|---|
| 网络 | Sui Mainnet | Sui Testnet |
| gRPC | 支持 | 支持 |
| JSON-RPC | 旧版 | 旧版 |
| 环境 | 生产 | 开发/QA |
| 适用场景 | 线上应用 | 测试与预发布 |
根据应用请求、运维要求与上线流程规划接入方式。
先完成连接检查,再验证应用需要的读取、交易或数据处理流程。
增加流量前检查方法限制、套餐额度与使用量;不同方法可能消耗不同的响应单位。
评估延迟、重试和服务可用性时,使用实际客户端地区与请求模式。