¿Qué es un RPC de Sui y cómo se usa?

¿Qué es el RPC de Sui?

El RPC de Sui (Llamada a Procedimiento Remoto) es la interfaz que permite a aplicaciones externas comunicarse con nodos completos de Sui. A través de RPC, los desarrolladores pueden consultar el estado de la blockchain, enviar transacciones e interactuar con contratos inteligentes Move. Sui proporciona múltiples protocolos RPC para adaptarse a diferentes casos de uso y requisitos de rendimiento.

La red Sui está diseñada para aplicaciones de baja latencia y alto rendimiento, lo que hace que el rendimiento del RPC sea crítico para dApps, billeteras y servicios de infraestructura. Elegir la interfaz y el proveedor de RPC adecuados impacta directamente en la capacidad de respuesta y confiabilidad de tu aplicación.

Interfaces RPC de Sui: JSON-RPC, gRPC y GraphQL

Sui actualmente admite tres interfaces RPC, cada una con sus propias fortalezas y estado de obsolescencia:

JSON-RPC es el protocolo RPC original de Sui. Ahora está obsoleto y se desactivará en julio de 2026. Se recomienda encarecidamente a los desarrolladores migrar a gRPC o GraphQL. La documentación de Sui proporciona una guía de migración con mapeo de métodos y problemas comunes.

gRPC es un protocolo binario de alto rendimiento que utiliza Búferes de Protocolo para una serialización eficiente. Es ideal para aplicaciones de producción que requieren baja latencia y alto rendimiento. gRPC también admite acceso de archivo para datos históricos más allá de 14 épocas.

GraphQL es un lenguaje de consulta flexible que permite a los clientes solicitar exactamente los datos que necesitan. Es particularmente útil para consultas complejas que involucran objetos anidados y relaciones. GraphQL está actualmente en beta, pero se recomienda para nuevos proyectos.

• JSON-RPC: Obsoleto, se desactivará en julio de 2026. Úsalo solo para integraciones heredadas.
• gRPC: Recomendado para producción. Alto rendimiento, admite streaming y datos de archivo.
• GraphQL: Beta pero potente. Mejor para consultas complejas y recuperación flexible de datos.

Cómo conectarse al RPC de Sui

Hay dos formas principales de conectarse a la red Sui a través de RPC: ejecutar tu propio nodo completo o usar un proveedor de RPC alojado.

Ejecutar tu propio nodo completo de Sui te da control total sobre la configuración del nodo, pero requiere hardware significativo, mantenimiento y experiencia operativa. Debes habilitar las interfaces RPC deseadas (gRPC, GraphQL) en tu nodo.

Los proveedores de RPC alojados ofrecen endpoints gestionados que abstraen las operaciones del nodo. Generalmente proporcionan alta disponibilidad, balanceo de carga y soporte para múltiples interfaces. Al seleccionar un proveedor, considera factores como latencia, garantías de tiempo de actividad, límites de tasa y soporte para gRPC y GraphQL.

• Autogestionado: Control total, pero alta carga operativa.
• Alojado: Infraestructura gestionada, más fácil de escalar, pero dependencia del proveedor.

Endpoints RPC de Sui: Mainnet y Testnet

Sui proporciona endpoints públicos tanto para mainnet como para testnet. Son gratuitos, pero a menudo tienen límites de tasa y sin garantías de tiempo de actividad, lo que los hace adecuados solo para desarrollo y pruebas.

Para aplicaciones de producción, un proveedor de RPC confiable es esencial. Los proveedores ofrecen endpoints dedicados con límites de tasa más altos, menor latencia y acuerdos de nivel de servicio (support terms). OnFinality, por ejemplo, proporciona endpoints RPC de mainnet y testnet de Sui con soporte para gRPC y GraphQL.

• Self-hosted: Full control, but high operational overhead.
• Hosted: Managed infrastructure, easier to scale, but vendor dependency.

Elegir un proveedor de RPC de Sui

Con muchos proveedores que ofrecen servicios RPC de Sui, seleccionar el adecuado depende de los requisitos de tu proyecto. Los criterios clave incluyen:

Latencia: La proximidad geográfica a las ubicaciones de los nodos afecta el tiempo de ida y vuelta. Los proveedores con distribución global pueden ofrecer menor latencia.

Confiabilidad: Busca proveedores con altas garantías de tiempo de actividad e infraestructura redundante.

Soporte de interfaz: Asegúrate de que el proveedor admita gRPC y GraphQL, ya que JSON-RPC está obsoleto.

Escalabilidad: Para aplicaciones de alto tráfico, pueden ser necesarios nodos dedicados o planes de nivel superior.

OnFinality ofrece endpoints RPC de Sui con rendimiento competitivo y planes flexibles, incluyendo un nivel gratuito para desarrollo.

• Latencia: Elige un proveedor con nodos cercanos a tus usuarios.
• Tiempo de actividad: Busca support terms y datos históricos de tiempo de actividad.
• Interfaz: Prefiere proveedores que admitan gRPC y GraphQL.
• Escalabilidad: Considera nodos dedicados para cargas de trabajo de producción.

Casos de uso comunes del RPC de Sui

El RPC de Sui se utiliza en una variedad de aplicaciones:

Billeteras: Consultar saldos, historial de transacciones y enviar transacciones.

dApps: Interactuar con contratos inteligentes Move, leer datos en cadena y ejecutar cambios de estado.

Indexadores y análisis: Obtener grandes volúmenes de datos para indexación, monitoreo y análisis.

Bots y automatización: Automatizar trading, staking y otras operaciones en cadena.

Para cada caso de uso, la elección de la interfaz y el proveedor de RPC puede impactar significativamente el rendimiento y el costo.

• Latency: Choose a provider with nodes close to your users.
• availability: Look for SLAs and historical availability data.
• Interface: Prefer providers that support gRPC and GraphQL.
• Scalability: Consider dedicated nodes for production workloads.

Migración de JSON-RPC a gRPC o GraphQL

Con la obsolescencia de JSON-RPC, todos los desarrolladores de Sui deben planificar la migración a gRPC o GraphQL. La Fundación Sui proporciona una guía de migración detallada que incluye mapeo de métodos, errores comunes y ejemplos de código.

gRPC se recomienda para aplicaciones que requieren alto rendimiento y baja latencia, mientras que GraphQL es ideal para consultas de datos flexibles. Ambas interfaces son compatibles con los principales proveedores de RPC, incluido OnFinality.

Comienza identificando todas las llamadas JSON-RPC en tu código base, luego mapea los métodos equivalentes de gRPC o GraphQL. Prueba exhaustivamente en testnet antes de implementar en mainnet.

• Revisa la guía oficial de migración de JSON-RPC de Sui.
• Mapea los métodos JSON-RPC obsoletos a equivalentes de gRPC o GraphQL.
• Prueba la migración en testnet antes del despliegue en mainnet.
• Actualiza tu proveedor de RPC si no admite gRPC o GraphQL.

Migrating from JSON-RPC to gRPC or GraphQL

With JSON-RPC being deprecated, all Sui developers should plan migration to gRPC or GraphQL. The Sui Foundation provides a detailed migration guide that includes method mapping, common pitfalls, and code examples.

gRPC is recommended for applications that require high throughput and low latency, while GraphQL is ideal for flexible data queries. Both interfaces are supported by major RPC providers, including OnFinality.

Start by identifying all JSON-RPC calls in your codebase, then map them to the equivalent gRPC or GraphQL methods. Test thoroughly on testnet before deploying to mainnet.

• Review the official Sui JSON-RPC Migration Guide.
• Map deprecated JSON-RPC methods to gRPC or GraphQL equivalents.
• Test migration on testnet before mainnet deployment.
• Update your RPC provider if they do not support gRPC or GraphQL.

Preguntas frecuentes