Eventos de Stellar: eventos retroactivos

Cuando Protocolo 23 se implemente más adelante este año, CAP-67 no solo comenzará a emitir eventos para nuevos libros mayores. También puede generar eventos para libros mayores pasados si se configura para hacerlo. Eso significa que cualquier proveedor que quiera un flujo de eventos unificados verdaderamente completo debe reingresar toda la historia con dos nuevas banderas principales activadas.

Esta es una actualización de protocolo atípica: P23 tiene la capacidad de emitir nuevos datos de eventos en el TransactionMeta para libros mayores pasados. Si tu servicio o herramientas almacenan la historia completa de Stellar para los usuarios finales, ya sean billeteras, exchanges, plataformas de análisis o indexadores personalizados, necesitarás optar por ello; de lo contrario, te perderás todos los movimientos de operaciones clásicas que ocurrieron antes de P23.

configuraciones para admitir dos nuevas banderas. Por defecto, ambas banderas están desactivadas. Los operadores deben optar explícitamente:

yaml

```

# en tu stellar-core.cfg o stellar-core.conf

# añade operaciones clásicas al flujo unificado

EMIT_CLASSIC_EVENTS: true

# genera nuevos eventos para todos los libros mayores históricos

BACKFILL_STELLAR_ASSET_EVENTS: true

```

• EMIT_CLASSIC_EVENTS
  Cuando verdadero, se emiten dos nuevos tipos de eventos: eventos de tarifas y movimientos de tokens de operaciones clásicas (pagos, pagos de camino, recuperaciones, etc). El evento de tarifa cubre todas las tarifas de transacción cobradas, incluyendo transacciones de Soroban y reembolsos. No se emiten eventos de tarifas a menos que esta bandera esté establecida, ni siquiera para transacciones de Soroban. Estos eventos se agregarán al flujo de eventos hacia adelante (desde la actualización P23 en adelante).
• BACKFILL_STELLAR_ASSET_EVENTS
  Cuando verdadero, Core emitirá nuevos eventos para todos los libros mayores pasados (génesis → presente), permitiéndote llenar cualquier brecha en tu flujo de eventos históricos. El operador necesitará activar el rellenado; la bandera solo permite que core cree nuevos datos para libros mayores pasados.

Nota: Protocolo 23 introduce una nueva versión de TransactionMeta XDR, TransactionMetaV4. Si operas un nodo RPC, Horizon o Galexie, el soporte para la nueva versión meta se incluirá con la actualización del protocolo.

Tus Tres Caminos de Actualización

Nota: La opción 3 desbloquea la capacidad de calcular con precisión los saldos de las cuentas, la oferta circulante y otros análisis de tokens, pero requiere la reingestión completa de la historia.

Beneficios

• Análisis completos: saldos históricos, métricas de oferta, rastreos de auditoría
• API Uniforme: un esquema de eventos para cada movimiento de tokens, pasado y futuro
• Mejor UX: billeteras, exchanges y dApps obtienen una historia consistente

Costos / Compensaciones

• Crecimiento en tamaño de DB: Stellar RPC con EMIT_CLASSIC_EVENTS=true vio un aumento en tamaño de DB de ~2.5 GB por día. Para RPCs con una ventana de retención de 7 días, esto es un aumento de ~10% en tamaño
• Crecimiento en Almacenamiento de Análisis: El almacenamiento de eventos completos sin comprimir es de ~7TB
• Los impactos en el rendimiento de CPU y RAM son insignificantes y no requerirán redimensionar componentes de infraestructura

1. Revisa tu base de usuarios: si atiendes billeteras, exchanges, dApps o plataformas de análisis que rastrean flujos de tokens, se recomienda encarecidamente apoyar una historia completa de Eventos Clásicos.
2. Actualiza tu Core/Galaxie/RPC compatible con P23 para configurar estas banderas.
3. Planea una reingestión completa de la historia si necesitas datos pasados completos.

De esa manera, tu flujo de eventos unificados realmente cubrirá cada acuñación, transferencia, quema y operación de recuperación, incluso las operaciones clásicas previas a P23.

Para más sobre el diseño general de CAP-67 ve Eventos de Stellar: Rastrea Todo, y para detalles completos del lanzamiento de P23, consulta el Anuncio del Protocolo 23 y la correspondiente Guía de Actualización.