Mejores prácticas para errores y eventos

Los programas de Anchor observables y depurables utilizan errores tipados, eventos estructurados y un registro mínimo.

Cómo usar esta lista

• Aplica en cada instrucción pública antes de mainnet.
• Verifica que el indexador analice el estilo de emisión elegido.
• Fija la tabla de errores de IDL en los repositorios del cliente.

A - Errores

• Usa #[error_code] para todos los fallos dirigidos al usuario códigos estables en IDL.
• Añade nuevas variantes; no las reordenes preserva las asignaciones del cliente.
• Mapea fallos de restricciones con @ Variant mensajes específicos.
• Simula transacciones en clientes antes de enviarlas decodifica errores temprano.

B - Eventos y registros

• Emite eventos para cambios de estado indexables no msg! en producción.
• Elige emit vs emit_cpi consistentemente documenta para el equipo de indexación.
• Cierra los registros de depuración detrás de las características ahorra CU en mainnet.
• Mantén las cargas útiles de eventos pequeñas evita la truncación de registros.

Preguntas frecuentes

Relacionados

• Eventos con emit! - eventos
• #[error_code] & require! - errores
• Mejores prácticas de generación de código - sincronización de IDL

Versiones de la pila: 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.