Pyramiding with EOSDT

By generating stablecoins in response to a user posting collateral, the way Equilibrium operates allows for leverage. Consider this example: given a current collateralization ratio (СR) of 130%, when a user deposits X dollars of EOS, the maximum dollar amount of EOSDT he may generate is X / CR. This EOSDT may be then used to buy additional EOS, which can in turn be used as additional collateral to generate more EOSDT — you get the idea!

You might remember the idea of an infinite geometric series from middle school geometry. But do you remember the formula for its sum when the common ratio R is less than one? In our case R = 1 / CR, so the maximum theoretical achievable leverage L is equal to: 1/(1-1/CR)

The following table shows the maximum achievable leverage given a level of collateralization:

Critical collateralization ratio (CR)	Maximum possible leverage
170%	2.43
165%	2.54
160%	2.67
155%	2.82
150%	3.00
145%	3.22
140%	3.50
135%	3.86
130%	4.33
125%	5.00
120%	6.00
115%	7.67
110%	11.00

With current system parameters, users can enjoy a maximum leverage around 4.33. This is of course the theoretical maximum — in reality, the numbers will be lower as it’s unreasonable to collateralize the position around the critical level. There has to be some safety margin above 130%.

From the user’s perspective, the mechanism works the following way:

• The user picks the desired safety margin (SM).

• Based on the SM, the user is offered a choice of leverage (L) from 1 to L_max, where L_max = 1/(1-1/(CR + SM)).

• The user supplies X amount of EOS.

To achieve desired leverage L, the system needs to buy (1 - L) * X EOS on the exchange. This may be done in several iterations in the loop according to the following algo:

generate X * oracle price / (CR + SM) EOSDT
amount_to_buy = (L-1)*X EOS
while amount_to_buy >= 0
    buy Q EOS on exchange
    deposit Q EOS to eosdtcntract
    generate Q * Oracle price / (CR + SM) EOSDT
    amount_to_buy = amount_to_buy - Q
end

New eosdtlevrage contract

All the above logic is implemented within a new contract called eosdtlevrage.

• Contract tables:

  ltvopers table

  Parameter	Type	Description
  oper_id	int64	ID of the operation, PK.
  account	float64	The ratio of EOS collateral to EOST generated for a given position_id.
  amount_to_buy	float64	The amount of EOS necessary to buy in order to achieve desired leverage (see the algo above). Changes on every loop iteration. Initially calculated using rates from eosdtoracliz.orarates
  received_from_dex	float64	actual amount of EOS received from DEX when generated EOSDT was sold. used in actual leverage calculations.
• Contract actions:

  Action	Parameters	Rejections	Example
  deposit deposit EOS to the eosdtlevrage contract, specifying desired leverage L and safety margin (SM)	leverage(L) safety_margin(SM)	When missing signature of caller. When L 1/(1- 1/(critical_ltv + safety_margin). When SM= critical_ltv. When there is not enough liquidity on DEX on any of the loop iterations.	cleos push action eosdtcntract margincall '{"leverage": "2",”safety_margin”,”0.3”}' -p user