Métodos

Todo lo que necesitas saber sobre los métodos RPC disponibles, parámetros y respuestas, y cómo hacer solicitudes RPC.

📄️ getEvents

Devuelve eventos de contrato

📄️ getFeeStats

Devuelve estadísticas sobre las tarifas de inclusión cobradas para transacciones de Soroban y transacciones de Stellar

📄️ getHealth

Devuelve la salud del nodo

📄️ getLatestLedger

Devuelve el ledger conocido más reciente

📄️ getLedgerEntries

Devuelve las entradas del ledger

📄️ getLedgers

Devuelve la lista de ledgers

📄️ getNetwork

Devuelve la configuración de red

📄️ getTransaction

Devuelve los detalles de la transacción

📄️ getTransactions

Devuelve la lista de transacciones

📄️ getVersionInfo

Devuelve información de la versión

📄️ sendTransaction

Envía una transacción

📄️ simulateTransaction

Envía una transacción de invocación de contrato de prueba

¿No sabes cuál endpoint necesitas para obtener lo que quieres? Muchos de los campos devueltos están profundamente anidados en estructuras XDR, por lo que puede ser difícil averiguar qué tipo de información está disponible en cada uno de ellos. Aquí tienes un vistazo a lo que proporcionan los endpoints "caballo de batalla", en orden decreciente de granularidad:

• getLedgers opera a nivel de bloque, proporcionándote los detalles completos de lo que ocurrió durante la aplicación de ese ledger (conocido como "metadatos del ledger", definido en el protocolo por la unión LedgerCloseMeta, específicamente la iteración V1). Cada uno de los endpoints subsiguientes es solo un microscopio a un subconjunto de los datos disponibles proporcionados por este endpoint. Los metadatos incluyen cosas como:
  • Detalles para recrear el estado de la blockchain (ver Encabezados de ledgers para más).
  • La información del consenso que condujo al cierre del bloque (ver Stellar Consensus Protocol).
  • El conjunto de transacciones, sus respectivas operaciones y los resultados de aplicar esas transacciones en este bloque (ver Transacciones).
• getTransaction(s) opera a través de un rango de ledgers o en un solo hash de transacción dependiendo de la variante. Los datos estructurados aquí incluyen detalles tales como:
  • La estructura exacta de la transacción ("sobre") que fue enviada.
  • Resultados para cada una de las operaciones dentro de la transacción.
  • Todos los efectos secundarios en el estado del ledger que ocurrieron como resultado de esta transacción.
• getEvents te permite buscar eventos que ocurrieron en un rango de ledgers. Los eventos son emitidos por el sistema y por contratos inteligentes para comunicar cambios de estado significativos a indexadores fuera de la cadena (ver Eventos para más). Cada evento consiste en temas (que puedes filtrar) y datos que son ScVals, el tipo "valor" genérico de Stellar (ver Desarrollo de Contratos para más).
• getLedgerEntries, en contraste con los endpoints anteriores, proporciona información sobre el estado en vivo on-chain en lugar de acciones históricas. La página getLedgerEntries en sí misma detalla los diferentes tipos de estado almacenado en la cadena y cómo recuperarlos.

Si aún no estás seguro de lo que estás buscando, recuerda que puedes pasar xdrFormat: "json" como parámetro a cada uno de estos endpoints para obtener una versión en JSON completamente desempacada y legible por humanos de las estructuras XDR devueltas. Puedes navegar a través de estos hasta que encuentres lo que necesitas y volver a la variación Base64+desempacar en tu aplicación. Equipado con una comprensión de cómo atravesar XDR, la estructura del protocolo y tu SDK favorito, deberías poder encontrar cualquier cosa que desees sobre la red Stellar con estos endpoints.