Sobre los Efectos


Un Efecto añade nuevas funcionalidades al Ledger mediante la implementación del patrón de diseño observador (observer). Representa un escuchador (listener) registrado para eventos específicos del Ledger y define una acción a ejecutar cuando se activa (es decir, cuando ocurre un evento). Cada cambio en los datos del Ledger genera un Evento, y todos los Efectos registrados que coinciden con ese evento se activan posteriormente.

Evento

Un Evento se genera cada vez que los datos en el Ledger cambian. Esto incluye acciones como crear o modificar un registro, añadir una firma o actualizar el saldo de una billetera. Cada Evento contiene datos que describen lo ocurrido e identifican los registros afectados. Como cualquier otro registro del Ledger, un Evento está estructurado y firmado usando la llave privada del Ledger, lo que permite a los receptores verificar su autenticidad utilizando la llave pública del Ledger.

Señal

Una Señal es un identificador en forma de cadena que categoriza el tipo de Evento que ocurrió en el Ledger. Cada Efecto se registra para responder a una única Señal, lo que significa que todos los Eventos que lleven esa Señal intentarán activar el Efecto correspondiente. El sistema del Ledger define las Señales disponibles y determina cuándo se generan los Eventos de cada tipo. Este comportamiento no es configurable por los usuarios.

Filtro

Además de la Señal, se puede aplicar un Filtro para proporcionar un control más fino sobre qué Eventos activan un Efecto. Un Filtro es una expresión que apunta a datos dentro del Evento; solo los Eventos que coincidan con los criterios del Filtro activarán el Efecto.

Acción

Una Acción define el comportamiento que ocurre cuando un Efecto es activado por un Evento. Sirve como punto de entrada para ejecutar lógica personalizada o iniciar procesos en respuesta a Eventos del Ledger. Las Acciones pueden tomar la forma de webhooks u otros mecanismos usados para reenviar Eventos a sistemas externos para su procesamiento.

Un uso poderoso de las Acciones es permitir interacciones recursivas con el propio Ledger. Por ejemplo, una Acción puede crear o modificar registros del Ledger en respuesta a cambios previos, permitiendo a los usuarios construir cadenas (o grafos de eventos) de operaciones para soportar flujos de trabajo complejos.


Historial de cambios
1.0.0
  • Agregado Versión inicial