Tiempo y Reloj

La sysvar Clock proporciona slot, epoch y unix_timestamp para reglas basadas en tiempo: expiraciones, acantilados de vesting y límites de tasa. Los slots son discretos; las marcas de tiempo son aproximaciones del reloj de pared.

Receta

let clock = Clock::get()?;
if clock.unix_timestamp > deadline { return Err(ProgramError::InvalidAccountData); }

Cuándo recurrir a esto:

• Expiración de depósito en garantía (escrow).
• Desbloqueo de vesting.
• Período de enfriamiento entre acciones.

Ejemplo de Trabajo

pub fn assert_not_expired(deadline: i64) -> Result<(), ProgramError> {
    let now = Clock::get()?.unix_timestamp;
    if now > deadline { return Err(ProgramError::InvalidAccountData); }
    Ok(())
}

Lo que esto demuestra:

• Llamada al sistema Clock::get().
• Comparación de unix_timestamp.
• La expiración devuelve un error.

Análisis Profundo

Slot vs Tiempo

Manipulación

Los validadores tienen una deriva de marca de tiempo limitada: diseñe períodos de gracia.

Notas de Rust

// Almacenar la fecha límite i64 al inicializar desde el cliente o administrador.

Errores Comunes

• Confiar solo en el argumento de marca de tiempo del cliente - Forjado si no proviene de Clock. Solución: Siempre usar Clock::get().
• Asumir que el slot es tiempo preciso - La duración del slot varía ligeramente. Solución: Usar unix_timestamp para el reloj de pared.
• Sin expiración en el depósito en garantía - Bloqueado para siempre. Solución: Fecha límite obligatoria o cancelación.
• Desbordamiento de marca de tiempo - Límites de i64. Solución: Comprobación de cordura de las fechas límite.
• Fecha límite pasada al inicializar - Inmediatamente expirado. Solución: Validar al crear.

Alternativas

Preguntas Frecuentes

Relacionado

• Máquinas de Estado en Cadena - Tiempos de espera
• Vault y Escrow - Expiración de depósito en garantía
• Conceptos Básicos de Programas - Contexto de tiempo de ejecución

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.