Contract Data Collection

Overview

Framework genérico para leer datos de contratos inteligentes periódicamente y almacenarlos en la base de datos. Usado por el cron CONTRACT_DATA_COLLECTION (cada 15 min).

Flujo

Modelo de datos

Ejemplo: APR de staking

Code
ContractConfig:
  token_symbol: 'a-ARGt'
  contract_address: 0x...
  functions_to_call: ['apr']

ContractData (cada 15 min):
  function_name: 'apr'
  function_value: '250000000000000000'  (18 decimales)

Interpretación:
  250000000000000000 / 1e18 = 0.25 = 25% APY

El BalanceCalculatorService consume este dato para calcular la tasa de rewards.

Extensibilidad

Para monitorear un nuevo contrato:

1. Insertar ContractConfig en DB con address, ABI, y funciones a llamar
2. Setear enabled = true
3. El cron empieza a colectar automáticamente en el siguiente ciclo

No requiere código nuevo — es configuración pura en DB.