Ingestar SDK
¿Qué es el Ingestar SDK?
El SDK está compuesto por varios paquetes de Golang publicados bajo github.com/stellar/go para adquirir y analizar datos de la red Stellar. Proporciona enlaces a nivel de lenguaje que convierten los flujos codificados en XDR binario emitidos desde la red en enlaces de modelo de datos programáticos fluidos.
¿Por qué usar el Ingestar SDK?
Las aplicaciones pueden aprovechar el SDK para desarrollar rápidamente canalizaciones de ingestión capaces de adquirir datos de la red Stellar en tiempo real o históricos y derivar modelos de datos personalizados. El SDK permite que las aplicaciones recorran las estructuras de datos jerárquicas de la red: archivos de historial, ledgers, transacciones, operaciones, cambios en el estado del ledger y eventos.
Usa el SDK para tener una experiencia de desarrollador intuitiva, segura en tiempo de compilación, y con tipos de datos de la red:
Entradas de Ledger
Obtén el estado final de las entradas de ledger en la red al cierre de cualquier secuencia de ledger de punto de control reciente o históricamente envejecida. Un ledger de punto de control ocurre una vez cada 64 ledgers, durante el cual la red publicará estos datos en archivos de historial en el formato de archivos comprimidos que contienen listas de BucketEntry, en las cuales cada una contiene una LedgerEntry y la LedgerKey.
Las entradas de ledger están firmadas criptográficamente como parte de cada ledger y, por lo tanto, representan el estado acumulativo de confianza en un punto en el tiempo para activos relacionados con una cuenta o un contrato. Ejemplos de tipos de activos:
- líneas de confianza que mantienen saldos de tokens
- ofertas que mantienen solicitudes y demandas en el DEX de la red stellar
- datos de contrato que mantienen almacenamiento clave/valor para contratos
Metadatos de Ledger
Accede a todas las transacciones y sus operaciones anidadas que se incluyeron en cada ledger cerrado. También contiene los cambios (pre/post) para cada entrada de ledger cuando se modifica debido a la actividad de transacciones y todos los eventos de contrato Soroban emitidos como resultado de invocaciones de contrato durante la ejecución de la transacción. Es, efectivamente, un registro de confirmación para las entradas de ledger.
Usa los metadatos para detectar cambios incrementales en las entradas de ledger que ocurren como resultado de cada transacción. Estos cambios y los eventos emitidos después de cada transacción representan modelos de datos valiosos específicos de un momento en el tiempo (expresados como una secuencia de ledger en la red), algunos ejemplos del mundo real:
- un pago en forma de transferencia de token entre cuentas
- se realiza una oferta para intercambiar un token por otro token a un precio determinado en el dex
- transferencias de token entre cuentas y contratos
El SDK proporciona paquetes que los clientes pueden usar para adquirir y analizar los metadatos en formato de datos de transmisión, con lectores y funciones de devolución de llamada.
Los flujos de metadatos de ledger pueden obtenerse de manera ilimitada a medida que se cierran los ledgers en tiempo real en la red Stellar, y también en un modo de repetición histórica con un rango limitado de secuencias de ledger pasadas.