Developer Info

Excalidraw — Collaborative whiteboarding made easyExcalidraw

INTERACTIVE ARCHITECTURE DIAGRAM

Source Code

https://github.com/Y2K-Finance/Earthquake

Protocol Contracts

Controller

Used by Keepers to trigger the events that condition the Vaults.

TriggerEndEpoch => function that if the epoch has ended, will transfer the Premium Vault deposit to Collateral Vault, and close that epoch.

TriggerDepeg => function that if the epoch has not ended and the oracle reports a price lower than the Vault Market strike price, will swap Collateral vault deposits with Premium vault, and close that epoch.

TriggerNullEpoch => function that if, after the insurance epoch has begun and one of the Vault Markets has zero deposits, will allow everyone to withdraw their deposits has there is no possibility to resolve this Market.

VaultFactory

VaultV2 is a SemiFungibleVault token based on the ERC1155 standard. The position Id or epochId is now a hash composed of (marketId, epochBegin, epochEnd), which can be deterministically computed using the getEpochId function on the VaultFactoryV2 contract.

Deposit

Shares are minted 1 to 1, while depositAsset can be any ERC20 token as defined by the VaultFactoryV2.

Withdraw

Withdraw fee in V2 is deducted when the vault is settled. The user's entitlement is then calculated based on the percentage of shares they had in the Vault before the insurance epoch began.

Carousel

Carousel inherits the VaultV2 contract and introduces new functionalities: Rollovers, Queue Deposits, and Linear Information Tax.

Rollovers

Users can opt to rollover existing positions into the next available epoch using the enlistInRollover function, specifying the epochId, shares, and receiver. To cease rollovers, users can invoke the delistInRollover function. Pending rollovers can be minted by anyone calling the mintRollovers function during an active deposit window.

CarouselFactory

CarouselFactory is an extension of the VaultV2Factory contract. It differs in the creation of markets and configuration of epochs which are handled through createNewCarouselMarket and createEpochWithEmissions respectively.

A significant improvement is that y2k emissions can now be configured and distributed within each epoch, eliminating the need for deploying an extra StakingRewards contract.

Queue Deposits

V2 permits users to deposit at any time using the deposit function with an id of 0. A QueueItem is minted and later redeemed for a position in the next epoch deposit window. Any party can call the mintDepositInQueue function during an active deposit window to redeem all stored QueueItems.