Docs / Windows and premiums⌄

Concepts

Windows and premiums

One thing decides how long a purchase stays reversible: the premium you pay for it, in ETH. Nothing else moves it, before or after you buy.

How long a window lasts#

The window grows in step with the premium. The launch fixes a reference: REFERENCE_PREMIUM of premium buys exactly BASE_WINDOW of time. On the shipped parameters, 0.05 ETH buys six hours.

KolanHook.windowFor
window = BASE_WINDOW × premium / REFERENCE_PREMIUM
window ≥ MIN_WINDOW         // 30 minutes, or the purchase is refused
window ≤ MAX_WINDOW         // 7 days; premium past it is refunded
expiry = now + window

So twice the premium buys twice the time, whatever the size of the purchase: 0.2 ETH of premium buys a day on any purchase.

What a window costs#

The premium may be at most 30% of the ETH the purchase spends (MAX_PREMIUM_BPS). Because of that cap, long windows need larger purchases, and a purchase under about 0.014 ETH cannot have one at all.

WindowPremiumSmallest purchase that can buy it
30 minutes0.0042 ETH0.014 ETH
1 hour0.0083 ETH0.028 ETH
6 hours0.0500 ETH0.167 ETH
12 hours0.1000 ETH0.333 ETH
1 day0.2000 ETH0.667 ETH
7 days1.4000 ETH4.67 ETH

You pay the premium on top of the 1% tax, so a window always costs more than not taking one. Both are kept whatever happens next; only the ETH spent on the tokens can come back.

Where the premium goes#

Not to the dev. When the window closes, undone or kept, the premium buys tokens from the pool and those tokens are burned. The supply only ever goes down, and every window pushes the price up a little when it ends.

What can and cannot change it#

  • Nothing anyone else does changes the window a premium buys: not volume, not other buyers, not the time of day.
  • The expiry is stored with the purchase. Nothing afterwards can shorten the window.
  • Once the window has ended, it cannot be undone any more, only kept: by you, or by anyone on your behalf.