Nuevos usuarios de RPC: 35% de descuento el primer mesVer oferta

Endpoint RPC y API de Sui Testnet

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.

Regístrate en el plan gratuito para desbloquear hasta 40 req/s y obtener analítica de uso y rendimiento de la API. Empezar

Límite del endpoint público: 5 req/sec

Conecta con Sui Testnet

Mainnet Testnet

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

Host gRPC de Sui

sui-testnet.api.onfinality.io:443

sui-testnet.api.onfinality.io:443

Endpoint JSON-RPC

https://sui-testnet.api.onfinality.io/public

https://sui-testnet.api.onfinality.io/public

Pasa a Growth Plan

Alto rendimiento
Analítica RPC potente
Hasta 500 rps
Sin límite diario de respuestas
Soporte prioritario
Servidores descentralizados

Empezar

Detalles RPC y gRPC de Sui Testnet

Elemento

Valor

Red

Sui Testnet

Token nativo

SUI

Protocolo principal

Sui gRPC v2

Protocolo legacy

Sui JSON-RPC

Transporte gRPC

HTTP/2 + TLS

Transporte JSON-RPC

HTTPS

Streaming gRPC

Compatible

Host gRPC

sui-testnet.api.onfinality.io:443

Endpoint JSON-RPC

https://sui-testnet.api.onfinality.io/public

Regiones

France / N. Virginia / Hong Kong

Disponibilidad de 30 días

99,99 % · Ver detalles

Conectar con Sui Testnet

Usa la API gRPC de Sui Full Node para acceder de forma tipada a checkpoints, transacciones, objetos y saldos. El endpoint público es útil para las primeras pruebas; añade una API key para el tráfico autenticado de la aplicación.

Endpoint gRPC público

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

Endpoint gRPC autenticado

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

Comprobar conectividad gRPC

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

Sui ha dejado obsoleto Full Node JSON-RPC en favor de gRPC y GraphQL. Usa gRPC para nuevas integraciones y migra las aplicaciones JSON-RPC existentes como parte de tu ruta de actualización.

API gRPC del Full Node de Sui

Sui gRPC expone servicios tipados para leer el estado del ledger, consultar objetos y paquetes Move, ejecutar transacciones y consumir datos blockchain en vivo desde un 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

Streaming gRPC de Sui en tiempo real

Usa SubscriptionService streams para recibir checkpoints, transacciones y eventos a medida que se producen. El streaming evita sondear repetidamente endpoints HTTP en aplicaciones que necesitan actividad de Sui en vivo.

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

Estos streams tipados proporcionan los equivalentes gRPC de los flujos legacy sui_subscribeEvent y sui_subscribeTransaction flujos de trabajo.

Usar máscaras de campos con Sui gRPC

Las máscaras de campos permiten que los clientes soliciten solo los campos de respuesta que necesitan. Esto mantiene las respuestas centradas y ayuda a controlar el tamaño del payload al consultar checkpoints, transacciones y objetos detallados.

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

Sui JSON-RPC — acceso legacy

Las aplicaciones existentes pueden seguir usando Sui JSON-RPC durante la migración. El endpoint legacy sigue siendo útil por compatibilidad, pero las nuevas integraciones de Sui deberían preferir gRPC o GraphQL mientras la red abandona Full Node JSON-RPC.

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

Migrar de Sui JSON-RPC a gRPC

Sustituye las llamadas a métodos legacy por métodos de servicios gRPC tipados al actualizar clientes, indexadores, wallets y servicios backend.

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`

Ver la guía de migración de Sui JSON-RPC →

Construye en Sui con gRPC

Wallets y exchanges

Consulta saldos, objetos, transacciones y actividad en vivo para wallets de Sui, sistemas de custodia y flujos de exchanges.

Indexadores y exploradores

Combina consultas del ledger, máscaras de campos y suscripciones para crear datasets de Sui, exploradores, búsquedas y pipelines de analítica.

Aplicaciones DeFi

Lee el estado de objetos y saldos, simula transacciones, ejecuta transacciones firmadas y transmite la actividad del protocolo para productos DeFi.

Juegos y aplicaciones de consumo

Usa el modelo centrado en objetos de Sui y streams en tiempo real para activos de juegos, funciones sociales, coleccionables digitales y experiencias de consumo.

Pipelines de datos backend

Usa respuestas gRPC tipadas y servicios de streaming para alimentar sistemas operativos, monitorización, informes y productos de datos sin ejecutar un Full Node.

Endpoints de Sui Mainnet y Testnet

Entorno	Mainnet	Testnet
Red	Sui Mainnet	Sui Testnet
gRPC	Compatible	Compatible
JSON-RPC	Legacy	Legacy
Entorno	Producción	Desarrollo / QA
Más adecuado para	Aplicaciones en producción	Pruebas y staging