Skip to main content

DoS Protection Parameters

The CIP-5 scheduler bounds timer work through a fixed native due window, complete resource reservations, live-basefee payment, and independent cleanup capacity. The CIP-1 auction is retired; bids and fairness weights do not affect admission.

Threat Model

Actors can create a backlog at one height, request long-running handlers, or leave timers that expire or cannot pay. The scheduler must bound work even when most of the queue cannot execute.

Admission and Execution Bounds

  • The native phase selects at most eight candidates from the oldest due height, preserving insertion order across its fixed pages. Its structural allowance is 300 units. A full page reserves at most 278 units (30 + 8 × 31); a ninth indivisible item would require 309 units and cannot fit.
  • Natural execution has an 8,800,000-cycle lane and a 550,000-cycle per-fire ceiling by default (governed from its activation gate; see CIP-5 §6.2).
  • Structural access requests are 160 by default, with opt-in tiers of 322 for a general child and 375 for an actor-Intent child. The fire-time ceiling is 375.
  • Each complete charged access request must fit the 887-access natural-timer lane and remaining shared aggregate capacity. It cannot consume a partial remainder.
  • Actors may hold at most 1,024 timers. Scheduling requires a future height; newly created timers cannot fire in their creating block.
These are separate bounds: spare cycles do not override the access, native-window, or aggregate limits. The live access scalar changes charged reservations without rewriting stored structural requests. Protocol constants and governed configuration retain the mutability specified by CIP-5 and CIP-43; there is no auction activation or auction cycle-cap parameter.

Funding and Cleanup

Before handlers run, the phase classifies and pre-charges admitted timers against pre-handler state. Actual live-basefee charges are burned, unused escrow is refunded, and natural fires pay no proposer priority tip. Expired or insufficiently funded timers are removed using a cleanup budget independent of execution. A candidate that cannot fit a complete execution reservation follows CIP-5’s carry/dead-letter rules. Quarantined actors cannot execute; bounded all-deferred head advancement and due-height rotation preserve progress through the queue.

Guarantees and Limits

The scheduler supplies deterministic FIFO admission and bounded work. It does not guarantee a deadline or eventual execution regardless of congestion, expiry, or carry limits. Reserved bid fields and successful-fire counters cannot increase priority, execution caps, or fees.

Further Reading