Eventos con emit!

Los tipos #[event] y la macro emit! escriben logs estructurados que los indexadores pueden parsear. Prefiere eventos sobre msg! ad-hoc para cambios de estado observables.

Receta

#[event]
pub struct TradeExecuted {
    pub user: Pubkey,
    pub amount_in: u64,
    pub amount_out: u64,
}
 
emit!(TradeExecuted { user: ctx.accounts.user.key(), amount_in, amount_out });

Cuándo usar esto: Los indexadores, analíticas o clientes necesitan observación fiable a posteriori.

Ejemplo de Trabajo

#[event]
pub struct PositionOpened {
    pub owner: Pubkey,
    pub market: Pubkey,
    pub size: u64,
    pub timestamp: i64,
}
 
pub fn open_position(ctx: Context<OpenPosition>, size: u64) -> Result<()> {
    let clock = Clock::get()?;
    emit!(PositionOpened {
        owner: ctx.accounts.owner.key(),
        market: ctx.accounts.market.key(),
        size,
        timestamp: clock.unix_timestamp,
    });
    Ok(())
}

Lo que esto demuestra:

• Eventos registrados en IDL
• emit! usa el patrón self-CPI internamente
• Los campos deben ser serializables con Borsh
• Los indexadores se suscriben a los logs del programa

Análisis Profundo

Self-CPI

emit! clásico activa un self-CPI en el que algunos indexadores confían. Para una captura garantizada en todos los runtimes, consulta emit_cpi!.

Diseño de Campos

Incluye las claves necesarias para unir datos off-chain; evita grandes bloques en los eventos.

Errores Comunes

• Cargas útiles de eventos enormes - Límites de CU y logs. Solución: Almacena el hash en la cadena, los detalles fuera de la cadena.
• msg! solo para depuración - No es interpretable por máquinas. Solución: Usa #[event].
• Campos privados no en IDL - Deben ser pub en la struct del evento. Solución: Todos los campos de evento deben ser pub.
• Emitir secretos - Los logs son públicos. Solución: Nunca emitas claves privadas.
• Evento faltante en la ruta de error - Analíticas incompletas. Solución: Emite antes del fallo o usa eventos de error separados.

Alternativas

Preguntas Frecuentes

Relacionados

• emit_cpi! y Eventos Self-CPI - emit fiable
• Logging y Costo de CU - CU
• Construyendo un Indexador - indexadores

Versiones de Stack: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.