Protocol
The key components of Davos's functions lie between a set of smart contracts that interact across blockchains and existing contracts. Davos created its customized smart contracts based on a fork of the MakerDAO smart contract set.
Modules
Davos consists of 2 main modules:
The core module (a MakerDAO fork and Davos's Interaction contract) โ provide collateral, borrow DUSD, repay DUSD, withdraw collateral, liquidate collateralized assets.
The rewards module โ claim rewards in DGT.
Requirements
The minimum amount to borrow:
On Arbitrum โ 100 DUSD
On BNB Smart Chain โ 50 DUSD
On Ethereum โ 300 DUSD
On Optimism โ 100 DUSD
On Polygon โ 50 DUSD
Liquidation incentive:
On Polygon โ $5 (tip) + 0 (chip).
On Ethereum โ $10 (tip) + 0.01% of the liquidated amount (chip).
Supported networks
Arbitrum
BNB Smart Chain
Ethereum
Optimist
Polygon
Supported collateral
MATIC collateral support is discontinued. You cannot create new MATIC positions or borrow DUSD on existing ones. Previous borrows are still valid, you can keep them or repay and withdraw MATIC.
MATIC collateral support is discontinued. You cannot create new MATIC positions or borrow DUSD on existing ones. Previous borrows are still valid, you can keep them or repay and withdraw MATIC.
On Arbitrum:
ankrETH
rETH
stEUR
wstETH
On BNB Smart Chain:
ankrBNB
vUSDC
vUSDT
On Ethereum:
ankrETH
rETH
sDAI
sfrxETH
swETH
wstETH
On Optimism:
rETH
wstETH
On Polygon:
stMATIC
On Polygon zkEVm:
ankrETH
rETH
wstETH
Fees
Borrowing rate paid to Davos for borrowing DUSD (fixed number set by the Davos governance):
On Arbitrum โ 5.25%.
On BNB Snart Chain โ 5.25%.
On Ethereum โ 5.25%.
On Optimism โ 5.25%.
On Polygon โ 5.25%.
Liquidation penalty added to the user's debt in a Dutch auction during the liquidation process (fixed by the Davos governance):
On Arbitrum โ 10% of the debt.
On BNB Snart Chain โ 10% of the debt.
On Ethereum โ 10% of the debt.
On Optimism โ 10% of the debt.
On Polygon โ 10% of the debt.
Ratios
Collateral ratio โ a percentage of the user's collateral value that determines the maximum borrowing limit for the user. If the loan reaches the collateral ratio, the loan may get liquidated. The collateral ratio is:
For vUSC and vUSDT โ 93% of the deposited collateral value.
For every other supported token โ 66% of the deposited collateral value.
Rewards
The borrowing reward โ users get rewards for borrowing DUSD, in DGT โ the Davos governance token. Rewards are calculated dynamically and are the product of the rewards rate and the total userโs debt in DUSD. The rewards rate is a fixed amount set by Davos.
The auction start reward โ anybody who triggers the liquidation event of a CDP, i.e., start of a Dutch auction, receives a flat fee (tip) and a percentage fee (chip) for just initiating the process. The tip and chip are paid by Davos from the Davos reserves.
The auction restart reward โ anybody who restarts the Dutch auction, which is part of the liquidation process, receives a flat fee (tip) and a percentage fee (chip). An EOA can restart the auction when the auction time limit is reached or the price decrease has reached a certain threshold. These two limits are set by the Davos governance. The tip and chip are paid by Davos from Davos reserves.
Liquidation Model
The liquidation model is best described by the following example (correct for both Polygon and Ethereum):
Smart Contracts
As a multi-chain version, Davos has its contracts deployed in every supported network:
Arbitrum Mainnet/Goerli
BNB Smart Chain Mainnet/Testnet
Ethereum Mainnet/Goeli
Optimism Mainnet/Goerli
Polygon Mainnet/Mumbai
Polygon zkEVM Mainnet
For addresses, see Smart Contract Addresses and Token Addresses.
The smart contracts that implement Davos are:
MakerDAO set โ the Maker Protocol, also known as the Multi-Collateral Dai (MCD) system, allowing users to generate DUSD by leveraging collateralized assets. DUSD is a decentralized, unbiased, collateral-backed cryptocurrency soft-pegged to the US Dollar.
ABACI โ price decrease function for Dutch auctions during the liquidation process of user's assets.
CLIP โ Dutch auction v2.0 mechanics.
CLIP (MVT_ceMATIC) โ mechanics for MATIC on Polygon.
CLIP (MVT_rETH) โ mechanics for rETH on Ethereum.
CLIP (MVT_sfrxETH) โ mechanics for sfrxETH on Ethereum.
CLIP (MVT_stMATIC) โ mechanics for stMATIC on Polygon.
CLIP (MVT_wstETH) โ mechanics for wstETH on Ethereum.
DOG โ starts Dutch auctions during the liquidation process of user's assets.
DUSD โ stablecoin DUSD users can borrow from Davos.
gemJoin โ ERC-20 token adapters.
DavosJoin โ adapter for connecting DUSD and Davos.
gemJoin (MVT_ceMATIC) โ adapter for connecting the MATIC collateral and Davos.
gemJoin (MVT_rETH) โ adapter connecting rETH collateral and Davos (entry point for collateral).
gemJoin (MVT_sfrxETH) โ adapter connecting sfrxETH collateral and Davos (entry point for collateral).
gemJoin (MVT_stMATIC) โ adapter connecting stMATIC collateral and Davos (entry point for collateral).
gemJoin (MVT_wstETH) โ adapter connecting wstETH collateral and Davos (entry point for collateral).
JUG โ collects Davos's borrowing interest for lending DUSD to the user.
SPOT โ oracle that fetches the price of ankrMATIC, which is an intermediate token used during the process of collateralizing user's assets.
VAT โ ัore vault for collateralized debt positions (CDP).
VOW โ vault balance sheet. Keeps track of debt or surplus of DUSD.
ankrMATIC โ liquid yield-bearing token used during the process of collateralizing user's assets.
AuctionProxy โ entrypoint for Dutch auction methods, which is part of the liquidation process of user's assets. Allow users to start and participate in auctions.
cerosRouter โ finds the best way to obtain ankrMATIC, which is an intermediate token used during the process of collateralizing user's assets.
cerosYieldStrategy โ deposits and withdraws wMATIC into yeildConverter; generates yield for Davos.
CeVault โ stores obtained ankrMATIC, which is an intermediate token used during the process of collateralizing user's assets.
DavosBridge โ external cross-chain bridge that is deployed on the corresponding chains and linked together (Warp Token is the name to recognize our token). Davos needs to give the bridge the right to mint and burn. Warp token is not a real token, it burns on origin chain and mints on destination chain.
DavosOracle โ oracle for the DUSD rewards token.
DavosProvider โ wraps assets and/or sends assets to
masterVault
.DavosProvider โ wraps assets or sends ERC-20 to
masterVault
on Polygon.DavosProvider (rETH) โ sends rETH to
masterVault
on Ethereum.DavosProvider (sfrxETH) โ sends sfrxETH to
masterVault
on Ethereum.DavosProvider (wstETH) โ sends wstETH to
masterVault
on Ethereum.
DGTRewards โ rewards distribution, in the DGT rewards token.
DGTToken โ ERC-20 compatible rewards token DGT given to the user for borrowing DUSD.
dMATIC โ token minted for the user as a deposit receipt for their collateral.
dMATIC (MVT_ceMATIC) โ deposit receipt for MATIC.
dMATIC (MVT_rETH) โ deposit receipt for rETH.
dMATIC (MVT_sfrxETH) โ deposit receipt for sfrxETH.
dMATIC (MVT_wstETH) โ deposit receipt for wstETH.
Interaction โ proxy for the MakerDAO contracts. Provides deposit, withdraw, borrow, payback, and liquidation functions to the end users.
Jar โ staking contract for the DUSD Redistribution Rate and for redistribution rewards (given in the DUSD token).
Oracle โ returns the current price of collateral.
Oracle (MVT_ceMATIC) โ returns the price of MATIC on Polygon.
Oracle (MVT_rETH) โ returns the price of rETH on Ethereum.
Oracle (MVT_sfrxETH) โ returns the price of sfrxETH on Ethereum.
Oracle (MVT_stMATIC) โ returns the price of stMATIC on Polygon.
Oracle (MVT_wstETH) โ returns the price of wstETH on Ethereum.
masterVault โ accepts deposits, mints and burns the token that represents the collateral inside Davos.
masterVault (MVT_ceMATIC) โ wraps MATIC into wMATIC on Polygon; mints or burns ceMATIC, which is the underlying collateral token inside Davos.
masterVault (MVT_rETH) โ accepts rETH deposits on Ethereum; mints or burns shares (MVT_rETH), which is the underlying collateral token inside Davos.
masterVault (MVT_sfrxETH) โ accepts sfrxETH deposits on Ethereum; mints or burns shares (MVT_rETH), which is the underlying collateral token inside Davos.
masterVault (MVT_stMATIC) โ accepts stMATIC deposits on Polygon; mints or burns shares (MVT_stMATIC), which is the underlying collateral token inside Davos.
masterVault (MVT_wstETH) โ accepts wstETH deposits on Ethereum; mints or burns shares (MVT_wstETH), which is the underlying collateral token inside Davos.
swapPool โ swaps wMATIC for ankrMATIC if this option is cheaper than exchanging on DEX.
waitingPool โ keeps track of pending MATIC withdraw requests and fulfills them when liquidity becomes available.
Workflow
Here are the main Davos's operations described in high-level detail.
Providing Collateral
We are going to use stMATIC as an example:
User transfers stMATIC to Davos via
DavosProvider::provide({value: amount})
.DavosProvider
mints dMATIC for the user as a deposit receipt for their collateral.DavosProvider
gets MVT_stMATIC, running the following logic inside:Deposit the user's stMATIC to
masterVault
viamasterVault::depositETH({value: amount)
.masterVault
mints MVT_stMATIC forDavosProvider
.masterVault
wraps stMATIC minting wMATIC.masterVault
manager triggers themasterVault::allocate()
to deposit the wMATIC tocerosYieldStrategy
based on the strategy allocation.cerosYieldStrategy
forwards wMATIC tocerosRouter
which exchanges wMATIC for ankrMATIC through the cheapest swapping option (on DEX or viaswapPool
), viacerosRouter::depositwMatic(amount)
.cerosRouter
sends the obtained ankrMATIC toCeVault
for storing, viaCeVault::depositFor(msg.sender, amount after exchange)
.msg.sender
โDavosProvider
address andamount after exchange
โ the amount of exchanged ankrMATIC.
DavosProvider
collateralizes MVT_stMATIC viaInteraction::deposit(account, address(MVT_stMATIC), amount)
.account
โ user's account address,address(MVT_stMATIC)
โ address of MVT_stMATIC smart contract,amount
โ stMATIC initially collateralized by the user.Interaction
runs the following logic inside:Transfers MVT_stMATIC, which is an ERC-20 token, to the
Interaction
smart contract, via thetransfer()
function of the ERC-20 token smart contract.Transfers the assets to the MakerDAO vault via
gem::join()
. For more information, refer to the Join docs.Makes the
VAT
smart contract fully trust theInteraction
smart contract viaVAT::behalf()
.Locks the assets inside MakerDAO via
VAT::frob()
, effectively collateralizing them. For more information, refer to the VAT docs.Emits a deposit event.
Collateralize LSTs to Borrow DUSD on Ethereum
The workflow stays the same for the LSTs accepted on Polygon and Ethereum as collateral.
User transfers wstETH to Davos via
DavosProvider::provide({value: amount})
.DavosProvider
mints dMATIC for the user as a deposit receipt for their collateral.DavosProvider
gets MVT, running the following logic inside:Deposit the user's wstETH to
masterVault
viamasterVault::depositETH({value: amount)
.masterVault
mints MVT forDavosProvider
. The minting ratio is not 1:1 because of the growing value of reward-bearing LSTs.
DavosProvider
collateralizes MVT viaInteraction::deposit(account, address(MVT_stMATIC), amount)
.account
โ user's account address,address(MVT)
โ address of MVT smart contract,amount
โ wstETH initially collateralized by the user.Interaction
runs the following logic inside:Transfers MVT, which is an ERC-20 token, to the
Interaction
smart contract, via thetransfer()
function of the ERC-20 token smart contract.Transfers the assets to the MakerDAO vault via
gem::join()
. For more information, refer to the Join docs.Makes the
VAT
smart contract fully trust theInteraction
smart contract viaVAT::behalf()
.Locks the assets inside MakerDAO via
VAT::frob()
, effectively collateralizing them. For more information, refer to the VAT docs.Emits a deposit event.
Borrow DUSD
Borrow DUSD via
Interaction::borrow()
. After the transaction is sent,Interaction
runs the following logic inside:Calculate the current DUSD value inside MakerDAO, fed via the Chainlink price feed. While calculating take into consideration the borrowing limit, which is the price of the assets collateralized by the user * loan-to-value ratio (fixed amount set by Davos governance).
Indebt the user equal to the borrowed DUSD amount via
VAT::frob()
. For more information, refer to the VAT docs.Transfer the borrowed DUSD via
gemJoin::exit()
. For more information, refer to the Join docs.Emit a borrow event.
Bridge DUSD
There are two instances of Davos Protocol โ on Ethereum and Polygon. Also, two bridge contract instances โ the same networks. And two DUSD token contracts, independent of each other in terms on supply, i.e., when bridged, tokens on the source network are burned, and tokens on the destination network are minted.
Before bridging, the user approves the amount to bridge by calling
approve(address usr, uint wad)
at the DUSD contact.To bridge from Ethereum to Polygon, the user calls
depositToken(address fromToken, uint256 toChain, address toAddress, uint256 amount)
at the Ethereum bridge contract. The Ethereum bridge contract burns the approved amount and emits a burn event.Based on the transaction, our authorized consensus address creates a proof and signature. The output is
[encodedProof, rawReceipt, proofSignature, proofHash]
.The backend then calls
withdraw(bytes calldata, /* encodedProof */ bytes calldata rawReceipt, bytes memory proofSignature)
at the Polygon bridge network.The Polygon bridge network then calls
mint(address usr, uint wad)
at the DUSD contract.
Repay DUSD
As Davos is testing its multi-chain now on Devnet, there is goign to be a catch settling your debt once the multichain version Mainnet. The catch is you can use DUSD on any network to settle your debt on this network only if you have a debt on it. E.g., if you borrowed 10 DUSD on Ethereum and then bridged them to Polygon, youโre indebted on Ethereum only and not on Polygon. So, you cannot, in this case, settle your debt on Polygon and have to bridge 10 DUSD to Ethereum to do it. However, if you borrowed 10 DUSD on Ethereum and then bridged them to Polygon, and then borrowed 5 more DUSD on Polygon, you now have 15 DUSD on Polygon and can settle your 5 DUSD debt there.
Repay Davos the borrowed DUSD via
Interaction::payback()
. After the transaction is sent,Interaction
runs the following logic inside:Transfer the DUSD to the
Interaction
smart contract, via thetransfer()
function of the ERCs-20 token smart contract.Transfer the DUSD to the MakerDAO vault via
DavosJoin::join()
. For more information, refer to the Join docs.Calculate the current DUSD value inside MakerDAO, fed via the Chainlink price feed.
Subtract the repaid DUSD amount from the userโs debt via
VAT::frob()
. For more information, refer to the VAT docs.Emit a payback event.
Withdraw Collateral
User makes a withdrawal request via
DavosProvider::release(recipient, amount)
.DavosProvider
requests MVT_stMATIC to be sent tomasterVault
viaInteraction::withdraw(account, address(MVT_stMATIC), amount)
.account
โ user's account address,address(MVT_stMATIC)
โ address of MVT_stMATIC smart contract,amount
โ stMATIC initiallly collateralized by the user.Interaction
runs the following logic inside:Unlock the assets via
VAT::frob()
. For more information, refer to the VAT docs.Transfer the assets from the CDP engine to the MakerDAO vault via
VAT::flux()
. For more information, refer to the VAT docs.Transfer the assets to the userโs wallet via
gem::exit()
. For more information, refer to the Join docs.
DavosProvider
request stMATIC frommasterVault
.masterVault
checks if the amount is available inmasterVault
contract. If yes,masterVault
burnsMVT_stMATIC
and sends the stMATIC toDavosProvider
, andDavosProvider
burns the dMATIC. I no,masterVault
withdraws the stMATIC throughcerosYieldStrategy
, sends it toDavosProvider
, andDavosProvider
burns the sMATIC; if no liquiditycerosYieldStrategy
,masterVault
submits the withdraw request towaitingPool
,DavosProvider
still burns the sMATIC, and next time anyone deposits stMATIC,masteVault
fulfills the withdraw request sending stMATIC towaitingPool
, andwaitingPool
sends MATIC further to the user.
Claim Rewards
For borrowing DUSD, claim rewards in DGT to the userโs wallet, via
DGTRewards::claim()
. After the transaction is sent,DGTRewards
runs the following logic inside:Update the rewards pool size and rewards rate.
Transfer the pending user rewards to the userโs wallet via
DGTToken::transfer()
.
Liquidation
When the current worth of collateral (obtained from the Chainlink price feed) with safety margin < borrowed amount of DUSD, the liquidation process can be triggered by anybody via Interaction::startAuction(token, user, keeper), where token โ address of the liquidated assets, user โ address of user whose collateral is being liquidated, keeper โ address of the user who gets a reward (tip + chip) for starting the auction. Then Interaction runs the following logic inside:
Start a Dutch auction:
Set the starting auction price for the liquidated collateral to be equal (current_collaterral_unit_price * buf).
Let anybody come and buy via buyFromAuction(token, auctionId, collateralAmount, maxPrice, receiverAddress) to buy any amount > than dust (currently 50 DUSD on Polygon and 300 DUSD on Ethereum). token โ address of the liquidated assets, auctionId โ ID of the auction, collateralAmount โ amount to buy, maxPrice โ price to pay , receiverAddress โ address of the buyer.
If the maxPrice is > current_ auction_collateral_unit_price, sell the requested amount of the user's collateral to the buyer.
Else, incrementally lower the auction price and let anybody buy still. The reason for decreasing from a higher price is because of bots and change of collateral price from oracle to avoid any sudden loss. The auction lasts a fixed amount of time (tau) set by Davo governance. The price is recalculated every second of the auction.
When the auction time limit is reached or the price decrease has reached a certain threshold (the limits are set by Davos governance; currently 40%), let anybody come and restart the auction and get tip+chip for doing it.
Transfer the price paid in #1.3, in DUSD, from the buyer's wallet to Davos.
Exchange MVT_stMATIC for ankrMATIC and send ankrMATIC to the buyer's wallet. Effectively, buyer buys ankrMATIC that they can later exchange for stMATIC.
Cover debt and keep profit (borrowed amount + (borrowing interest + liquidation penalty)).
Calculate the remainder (price paid - debt - profit). Send the remainder to the userโs wallet.
Price Feed Integrations
For fetching the price of Avalon wBTC on Bitlayer, Davos uses the API3 feed:
-> Avalon wBTC Price Feed on BitLayer - API3
This ensures accurate, real-time pricing data to support collateral valuation for DUSD minting.
Last updated