Resumen
# ¿Qué es Stellar RPC y cómo se usa? Stellar RPC (Llamada a Procedimiento Remoto) es la interfaz estándar para interactuar con la red blockchain de Stellar. Permite a los desarrolladores consultar datos del libro mayor, enviar transacciones y gestionar cuentas de forma programática. La API RPC de Stellar es distinta de la JSON-RPC compatible con Ethereum; utiliza una API Horizon personalizada basada en principios RESTful, pero también admite una RPC de Soroban para interacciones con contratos inteligentes. Esta guía cubre los endpoints esenciales, la autenticación y las mejores prácticas para desarrollar en Stellar. Ya sea que estés construyendo una aplicación de pagos, un exchange descentralizado o un contrato inteligente en Soroban, el acceso confiable a RPC es fundamental. OnFinality proporciona endpoints RPC de Stellar gestionados con alta disponibilidad y baja latencia, compatibles tanto con Horizon como con Soroban RPC para cargas de trabajo de producción.
Puntos clave
- Stellar RPC se accede principalmente a través de la API REST de Horizon y la RPC de Soroban para contratos inteligentes.
- Los endpoints de Horizon permiten consultar cuentas, transacciones, ofertas y datos del libro mayor.
- Soroban RPC permite el despliegue, invocación y recuperación de eventos de contratos usando JSON-RPC.
- La autenticación para endpoints públicos de Stellar RPC generalmente no es necesaria, pero se aplican límites de tasa.
- Para aplicaciones de producción, usa un proveedor de RPC gestionado como OnFinality para garantizar confiabilidad y escalabilidad.
- La testnet de Stellar está disponible para desarrollo y se puede acceder a través de endpoints RPC de testnet dedicados.
- Elegir entre nodos RPC compartidos y dedicados depende de tus requisitos de rendimiento y latencia.
Entendiendo Stellar RPC: Horizon vs Soroban
Stellar ofrece dos interfaces RPC principales: Horizon y Soroban RPC. Horizon es una API RESTful que proporciona acceso a datos centrales de la red Stellar, como cuentas, transacciones y entradas del libro mayor. Es la forma más común de interactuar con Stellar para operaciones tradicionales de pago y activos.
Soroban RPC es una interfaz JSON-RPC introducida para la plataforma de contratos inteligentes de Stellar. Permite a los desarrolladores desplegar e invocar contratos, consultar el estado de los contratos y suscribirse a eventos de contratos. Soroban RPC sigue de cerca la especificación JSON-RPC de Ethereum, pero utiliza métodos específicos de Stellar.
Ambas interfaces son esenciales para desarrollar en Stellar. OnFinality admite endpoints RPC tanto de Horizon como de Soroban, asegurando que tengas un único proveedor para todas tus necesidades de desarrollo en Stellar.
- Horizon: API RESTful para cuentas, transacciones, ofertas y datos del libro mayor.
- Soroban RPC: JSON-RPC para despliegue e invocación de contratos inteligentes.
- Ambos están disponibles en mainnet y testnet.
Endpoints Clave de Horizon
Horizon proporciona una amplia gama de endpoints para interactuar con la red Stellar. A continuación se muestran algunos de los más utilizados.
- List the exact RPC methods, chains, and environments your app will call.
- Test with the same request pattern your frontend, backend, bot, dashboard, or indexer will use.
- Check whether archive, trace, WebSocket, testnet, analytics, or dedicated-node access is actually required.
- Review pricing, usage visibility, and upgrade paths before moving sustained traffic.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Endpoint | GET /accounts/{account_id} | Recupera detalles de la cuenta, saldos y número de secuencia. |
| Endpoint | GET /transactions/{hash} | Obtén detalles de la transacción, incluyendo tarifa, memo y operaciones. |
| Endpoint | POST /transactions | Envía una transacción firmada a la red. |
| Endpoint | GET /ledgers/{sequence} | Consulta el encabezado y metadatos del libro mayor. |
| Endpoint | GET /offers/{offer_id} | Recupera detalles de una oferta específica en el exchange descentralizado. |
Métodos de Soroban RPC
Soroban RPC expone métodos similares a JSON-RPC de Ethereum. Los métodos clave incluyen:
- getHealth: Verifica si el nodo RPC está sincronizado y saludable.
- getLedgerEntry: Recupera una entrada específica del libro mayor (código de contrato, datos de contrato, etc.).
- sendTransaction: Envía una transacción Soroban firmada.
- getTransaction: Obtiene el estado y resultado de una transacción enviada.
- simulateTransaction: Simula una invocación de contrato para estimar tarifas y validar.
- getEvents: Consulta eventos de contrato por tema o ID de contrato.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Endpoint | GET /accounts/{account_id} | Retrieve account details, balances, and sequence number. |
| Endpoint | GET /transactions/{hash} | Get transaction details including fee, memo, and operations. |
| Endpoint | POST /transactions | Submit a signed transaction to the network. |
| Endpoint | GET /ledgers/{sequence} | Query ledger header and metadata. |
| Endpoint | GET /offers/{offer_id} | Retrieve details of a specific offer on the decentralized exchange. |
Autenticación y Límites de Tasa
Los endpoints públicos de Stellar RPC (tanto Horizon como Soroban) generalmente no requieren autenticación. Sin embargo, imponen límites de tasa para prevenir abusos. Por ejemplo, la instancia pública de Horizon de la Stellar Development Foundation permite hasta 10 solicitudes por segundo por IP. Los endpoints de Soroban RPC pueden tener límites similares o más estrictos.
Para aplicaciones de producción, depender de endpoints públicos es arriesgado debido a posibles limitaciones o tiempos de inactividad. Usar un proveedor de RPC gestionado como OnFinality te brinda límites de tasa más altos, rendimiento dedicado y disponibilidad respaldada por support terms. OnFinality también ofrece claves API para autenticación y seguimiento de uso.
- getHealth: Check if the RPC node is synced and healthy.
- getLedgerEntry: Retrieve a specific ledger entry (contract code, contract data, etc.).
- sendTransaction: Submit a signed Soroban transaction.
- getTransaction: Get the status and result of a submitted transaction.
- simulateTransaction: Simulate a contract invocation to estimate fees and validate.
- getEvents: Query contract events by topic or contract ID.
Elegir entre Stellar RPC Compartido y Dedicado
Los endpoints RPC compartidos son rentables y adecuados para desarrollo, pruebas y aplicaciones de bajo tráfico. Agrupan recursos entre múltiples usuarios, lo que puede provocar un rendimiento variable durante picos de uso.
Los nodos dedicados de Stellar proporcionan infraestructura aislada con rendimiento garantizado, sin límites de tasa y control total sobre la configuración del nodo. Son ideales para aplicaciones de alto rendimiento, exchanges o servicios que requieren baja latencia constante.
OnFinality ofrece opciones de Stellar RPC tanto compartidas como dedicadas. Puedes comenzar con un endpoint compartido y actualizar a dedicado a medida que tu aplicación crezca.
Mejores Prácticas para la Integración de Stellar RPC
Al integrar Stellar RPC, sigue estas mejores prácticas para garantizar confiabilidad y eficiencia.
- Usa pooling de conexiones y lógica de reintentos para manejar fallos transitorios.
- Monitorea el uso de tu límite de tasa y actualiza a un nodo dedicado si alcanzas los límites constantemente.
- Almacena en caché los datos consultados con frecuencia (por ejemplo, detalles de cuentas) para reducir las llamadas RPC.
- Para Soroban, simula siempre las transacciones antes de enviarlas para detectar errores y estimar tarifas.
- Usa testnet para desarrollo y staging antes de desplegar en mainnet.
- Elige un proveedor con almacenamiento en caché perimetral global para minimizar la latencia.
Primeros Pasos con OnFinality Stellar RPC
OnFinality proporciona endpoints RPC de Stellar gestionados tanto para Horizon como para Soroban. Para comenzar:
1. Regístrate en una cuenta de OnFinality y navega a la página de la red Stellar. 2. Obtén la URL de tu endpoint API y la clave API opcional. 3. Configura tu aplicación para usar el endpoint, estableciendo los encabezados adecuados para autenticación si es necesario. 4. Comienza a hacer solicitudes usando tu cliente HTTP o SDK preferido. Los endpoints de OnFinality están optimizados para baja latencia y alta disponibilidad, con conmutación por error automática y balanceo de carga.
- Acceso instantáneo a RPC de mainnet y testnet de Stellar.
- Compatible con Horizon REST y Soroban JSON-RPC.
- Escalable desde nodos compartidos a dedicados.
- Monitoreo y soporte 24/7.
Getting Started with OnFinality Stellar RPC
OnFinality provides managed Stellar RPC endpoints for both Horizon and Soroban. To get started:
1. Sign up for an OnFinality account and navigate to the Stellar network page. 2. Obtain your API endpoint URL and optional API key. 3. Configure your application to use the endpoint, setting appropriate headers for authentication if required. 4. Start making requests using your preferred HTTP client or SDK. OnFinality endpoints are optimized for low latency and high availability, with automatic failover and load balancing.
- Instant access to Stellar mainnet and testnet RPC.
- Supports both Horizon REST and Soroban JSON-RPC.
- Scalable from shared to dedicated nodes.
- 24/7 monitoring and support.
Preguntas frecuentes
¿Cuál es la diferencia entre Horizon y Soroban RPC?
Horizon es una API RESTful para operaciones centrales de la red Stellar (cuentas, transacciones, ofertas). Soroban RPC es una interfaz JSON-RPC para interacciones con contratos inteligentes en la plataforma Soroban.
¿Necesito una clave API para usar Stellar RPC?
Los endpoints públicos de Stellar RPC generalmente no requieren una clave API, pero tienen límites de tasa. Proveedores gestionados como OnFinality pueden ofrecer claves API para límites más altos y seguimiento de uso.
¿Puedo usar Stellar RPC para contratos inteligentes de Soroban?
Sí, Soroban RPC está diseñado específicamente para desplegar e invocar contratos inteligentes en Stellar. Proporciona métodos como sendTransaction, simulateTransaction y getEvents.
¿Cuáles son los límites de tasa para Stellar RPC?
Los endpoints públicos a menudo limitan a 10 solicitudes por segundo por IP. Los proveedores gestionados ofrecen límites más altos o acceso ilimitado con nodos dedicados.
¿Cómo elijo entre Stellar RPC compartido y dedicado?
El RPC compartido es adecuado para desarrollo y aplicaciones de bajo tráfico. El RPC dedicado se recomienda para aplicaciones de producción con alto rendimiento o requisitos de baja latencia.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
