hopper-core 0.1.0

Core engine for the Hopper zero-copy state framework. Account memory architecture, ABI types, validation graphs, phased execution, zero-copy collections, layout evolution, and cross-program interfaces.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! Time-based validation: deadlines, cooldowns, staleness.

use hopper_runtime::error::ProgramError;

/// Check that a deadline has passed (now >= deadline).
#[inline(always)]
pub fn check_deadline_passed(deadline: i64, now: i64) -> Result<(), ProgramError> {
    if now < deadline {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

/// Check that a deadline has NOT passed (now < deadline).
#[inline(always)]
pub fn check_deadline_not_passed(deadline: i64, now: i64) -> Result<(), ProgramError> {
    if now >= deadline {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

/// Check that enough time has elapsed since the last operation.
#[inline(always)]
pub fn check_cooldown_elapsed(
    last_op_time: i64,
    now: i64,
    cooldown_seconds: i64,
) -> Result<(), ProgramError> {
    let elapsed = now.saturating_sub(last_op_time);
    if elapsed < cooldown_seconds {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

/// Check that data is not stale (updated recently enough).
#[inline(always)]
pub fn check_staleness(
    updated_at: i64,
    now: i64,
    max_age_seconds: i64,
) -> Result<(), ProgramError> {
    let age = now.saturating_sub(updated_at);
    if age > max_age_seconds {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

/// Check that a timestamp is in the future.
#[inline(always)]
pub fn check_in_future(timestamp: i64, now: i64) -> Result<(), ProgramError> {
    if timestamp <= now {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

/// Check that a timestamp is in the past.
#[inline(always)]
pub fn check_in_past(timestamp: i64, now: i64) -> Result<(), ProgramError> {
    if timestamp > now {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}