Oak

Blocktime-Cron (BCron) Expressions
Login

Blocktime-Cron (BCron) Expressions

A bcron expression describes how often a payment should happen. Optionally it can also include start and end-time limits.

Examples

/1000 => repeat the payment every 1000 blocks
:750000/1 => repeat the payment every block, until blockheight 750000
740000/15 => repeat the payment every 15 blocks, starting at blockheight 740000

Full spec

From Until Frequency BCron
--------------------------
-    -     -             n  Only once, at block n
-    -     1            /1  Every block
-    -     n            /n  Every block which is a multiple of n
x    -     1           x/1  Every block starting from x
x    -     n           x/n  Every n blocks from x (x, x+n, x+2n, ..)
-    y     1          :y/1  Every block until y
-    y     n          :y/n  Every n blocks until y (.., y-2n, y-n, y)
x    y     1         x:y/1  Every block starting from x until y
x    y     n         x:y/n  Every n blocks starting from x until y (x, x+n, x+2n, .. x+in <= y)

When from is specified, the ticks count relative to from.

When from isn't specified, but until is, the ticks count relative to until. For example, for :200/3, the ticks are (.., 194, 197, 200).