新用户订阅 RPC，首月享 6.5 折优惠查看优惠

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.

注册免费计划，可将速率提升至 40 req/s，并获得 API 使用量与性能洞察。立即开始

公共接口速率限制为 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

升级 Growth Plan

高性能
强大的 RPC 分析
最高 500 rps
无每日响应限制
优先支持
去中心化服务器

立即开始

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

30 天正常运行时间

99.99% · 查看详情

连接 Sui Testnet

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

公共 gRPC 端点

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

已认证 gRPC 端点

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 连接

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

GetServiceInfo
GetObject
BatchGetObjects
GetTransaction
BatchGetTransactions
GetCheckpoint
GetEpoch
ListCheckpoints
ListTransactions
ListEvents

StateService

ListDynamicFields
ListOwnedObjects
GetCoinInfo
GetBalance
ListBalances

SubscriptionService

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

TransactionExecutionService

ExecuteTransaction
SimulateTransaction

MovePackageService

GetPackage
GetDatatype
GetFunction
ListPackageVersions

NameService

LookupName
ReverseLookupName

SignatureVerificationService

VerifySignature

Sui gRPC 实时流式传输

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

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

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

在 Sui gRPC 中使用字段掩码

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

{
  "sequence_number": "299599072",
  "read_mask": {
    "paths": ["transactions"]
  }
}

Sui JSON-RPC — 旧版访问

现有应用可以在迁移期间继续使用 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'

从 Sui JSON-RPC 迁移到 gRPC

更新客户端、索引器、钱包和后端服务时，请使用类型化 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`