Saltar al contenido principal

Saldos Reclamables

Metadatos de la Tabla​

PropiedadConfiguración
Clave(s) Natural(es)balance_id, closed_at
Campo(s) de Particiónbatch_run_date (partición MES)
Campo(s) Clusteredasset_id, last_modified_ledger
Documentacióndbt docs

Detalles de la Columna​

NombreDescripciónTipo de DatosValores del Dominio¿Requerido?Notas
balance_idUn identificador único para este saldo reclamable. El Balance id es una compilación de Balance Type + SHA-256 hash history_operation_idstringSíEl Balance Type está fijado en V0, 00000000. Si hay un cambio en el protocolo que impacte materialmente la mecánica de los saldos reclamables, el tipo de balance se actualizaría a V1.
claimantsLa lista de entradas que pueden reclamar el saldo y las precondiciones que deben cumplirse para reclamarlo.array[record]SíSe pueden especificar varias cuentas en el registro de claimants, incluyendo la cuenta del creador del saldo.
claimants.destinationLa id de cuenta que puede reclamar el saldostringSí
claimants.predicateLa condición que debe cumplirse para que la cuenta destino pueda reclamar el saldo. La condición puede incluir reglas lógicas usando lógica AND, OR y NOT.array[record]Sí
claimants.predicate.unconditionalSi es true significa que esta cláusula de la condición siempre se cumplebooleanNoCuando la condición es solo unconditional = true, significa que el saldo puede reclamarse bajo cualquier condición
claimants.predicate.abs_beforeFecha límite para reclamar el saldo. Si un saldo se reclama antes de esa fecha, entonces la cláusula de la condición se cumple.stringNo
claimants.predicate.rel_beforeUna fecha límite relativa para cuando el saldo reclamable puede ser reclamado. El valor representa el número de segundos desde la hora de cierre del ledger que creó el saldo reclamableintegerNoEsta condición es útil al crear límites basados en condiciones de creación de tiempo. Si el creador quería un saldo solo reclamable una semana después de la creación, esta condición cumpliría esa regla.
claimants.predicate.abs_before_epochUn valor de época UNIX en segundos que representa la misma fecha límite que abs_before.integerNo
asset_typeEl identificador del tipo de código de activo, puede ser un alfanumérico de 4 caracteres, 12 caracteres o el activo nativo de la red, XLM.string
  • credit_alphanum4
  • credit_alphanum12
  • native
Sí
asset_codeLa representación del código del activo en la red de 4 o 12 caracteresstringNo
asset_issuerLa dirección de la cuenta que creó el activostringNo
asset_amountLa cantidad del activo que puede ser reclamadafloatSí
sponsorLa dirección de la cuenta del patrocinador que paga las reservas para este saldo reclamablestringNoLos patrocinadores de los saldos reclamables son los creadores del saldo.
flagsIndica la activación y desactivación de ciertos privilegios del emisor del balanceinteger
  • 0 - Ninguno, por defecto
  • 1 - Autorización para Clawback habilitada
SíLos flags son establecidos por las cuentas de saldos reclamables para un activo. Cuando cuentas de usuarios reclaman un saldo, los flags aplicados al activo se originan en esta cuenta
last_modified_ledgerEl número de secuencia del ledger cuando se modificó la entrada del ledger (este firmante único para la cuenta). Las eliminaciones no cuentan como modificaciones y reportarán el número de secuencia de modificación previointegerSí
ledger_entry_changeCódigo que describe el tipo de cambio aplicado a la entrada del ledger.integer
  • 0 - Entrada de Ledger creada
  • 1 - Entrada de Ledger actualizada
  • 2 - Entrada de Ledger eliminada
  • 3 - Estado de Entrada de Ledger (valor de la entrada)
SíLos tipos válidos de cambio de entrada son 0 y 2 para entradas de tipo claimable_balances. Una vez creado, un saldo no puede ser actualizado.
deletedIndica si la entrada del ledger (balance id) ha sido eliminada o no. Una vez que una entrada es eliminada, no puede recuperarse.booleanSí
closed_atMarca de tiempo en UTC cuando este ledger se cerró y confirmó en la red. Se espera que los ledgers cierren aproximadamente cada 5 segundostimestampSí
ledger_sequenceEl número de secuencia de este ledger. Representa el orden del ledger dentro de la blockchain de Stellar. Cada ledger tiene un número de secuencia único que incrementa con cada nuevo ledger, asegurando que los ledgers se procesen en el orden correcto.integerSí
batch_idRepresentación en cadena del run id para un DAG dado en Airflow. Tiene la forma de scheduled__<batch_end_date>-<dag_alias>. Los batch ids son únicos para el lote y ayudan en la monitorización y capacidades de reejecuciónstringSí
batch_run_dateLa fecha de inicio para el intervalo del lote. Junto con la fecha en el batch_id, la fecha representa el intervalo de ledgers procesados. La fecha de ejecución del lote puede considerarse como un proxy de closed_at para un ledger.datetimeSíLa tabla está particionada por batch_run_date. Se recomienda siempre incluir batch_run_date en el filtro si es posible para ayudar a reducir el costo de la consulta.
batch_insert_tsLa marca de tiempo en UTC cuando un lote de registros fue insertado en la base de datos. Este campo puede ayudar a identificar si un lote fue ejecutado en tiempo real o como parte de una recargatimestampSí
asset_idIdentificador único para asset_code, asset_issuerintegerNo