Skip to main content

Crate ic_timers

Crate ic_timers 

Source
Expand description

Observable and recovery-aware timer primitives for Internet Computer canisters.

ic-timers is a higher-level wrapper around ic-cdk-timers, which remains the provider that arms and clears platform timers. This crate adds provider-neutral control, scheduling, and observation values above it.

This initial scaffold exposes the deterministic control and platform boundaries extracted from Canic. It does not yet provide the complete registry or watchdog runtime described in the workspace architecture note.

Re-exports§

pub use control::TimerControl;
pub use control::TimerControlAction;
pub use control::TimerControlError;
pub use control::TimerRegistration;
pub use platform::TimerHandle;
pub use platform::clear_timer;
pub use platform::set_timer;
pub use schedule::ScheduleError;
pub use schedule::TimerDirective;
pub use snapshot::MAX_TIMER_LABEL_BYTES;
pub use snapshot::MeasurementSummary;
pub use snapshot::PreArmedSuccessor;
pub use snapshot::TimerCompletion;
pub use snapshot::TimerCompletionOutcome;
pub use snapshot::TimerCounters;
pub use snapshot::TimerDirectiveSnapshot;
pub use snapshot::TimerEpoch;
pub use snapshot::TimerIdentity;
pub use snapshot::TimerIdentityError;
pub use snapshot::TimerIdentityField;
pub use snapshot::TimerLabel;
pub use snapshot::TimerLabelError;
pub use snapshot::TimerLastOutcome;
pub use snapshot::TimerMeasurement;
pub use snapshot::TimerObservabilitySnapshot;
pub use snapshot::TimerOutcomeSnapshot;
pub use snapshot::TimerPerformance;
pub use snapshot::TimerPolicy;
pub use snapshot::TimerProcessCondition;
pub use snapshot::TimerRegistrationStatus;
pub use snapshot::TimerSchedulingMode;
pub use snapshot::TimerSchedulingSnapshot;
pub use snapshot::TimerSnapshot;
pub use snapshot::TimerStateSnapshot;

Modules§

control
Deterministic arbitration for one logical timer identity.
platform
Direct boundary to the Internet Computer timer provider.
schedule
Typed decisions for work completed by a timer callback.
snapshot
Provider-neutral timer identity and canonical snapshot values.