mimo protocol
English 1.1
Search
K

The Formulas

This page shows the formulas used in mimo protocol.

Automated Market Making

In each trade, traders trade certain amount of a particular token for certain amount of another token with the price defined by a formula. There is no orderbook and waiting for fulfillment.
The formula that mimo uses is the famous
xy=kx * y = k
that has been widely adopted by AMM based DEX, such as uniswap.

The formula
xy=kx * y = k

Assume that
XX
is the source token, and
YY
is the destination token. In mimo,
XX
,
YY
could be either IOTX or XRC20 tokens. Let
xx
,
yy
be X-token, Y-token in current liquidity pool, respectively.
Based on the famous AMM equation
xy=kx * y = k
where
kk
is a constant.
The product of
xx
and
yy
remains the same before and after trading. For details, please refer to vbuterin's post.

Pricing based on the inputs

Let's further define
dxd_x
,
dyd_y
are how many X-tokens you want to pay, and how many Y-tokens you will get, respectively.
We'd like to know, the price based on
dxd_x
or
dyd_y
. IfgetInputPrice denotes how many Y-Tokens (i.e.
dyd_y
) can be bought by selling a given
dxd_x
,
getInputPrice(x,y,dx)=y997dx1000x+997dxgetInputPrice(x, y, d_x) = \dfrac{y * 997 * dx}{1000 * x + 997 * d_x}
or in code,
getInputPrice(x, y, dx) = (y * 997 * dx) / (1000 x + 997 dx)
If getOutputPrice denotes how many X-tokens is needed to buy
dyd_y
Y-tokens,
getOutputPrice(x,y,dy)=1000xdy(ydy)997+1getOutputPrice(x, y, d_y) = \dfrac{1000 * x * d_y}{(y-d_y)*997} + 1
or in code,
getOutputPrice(x, y, dy) = 1000 x * dy / ((y - dy) * 997) + 1
where / in above equations denotes divToInteger, which means divide with rounding to floor of the results.

Price impact

In AMM, the price would change after each trade,
dxd_x
,
dyd_y
and
x,yx, y
the liquidity in the pool. The price impact is what traders want to know before the trade.
There are two ways of calculating price impact. It can be based on
x,y,dxx, y, d_x
, or
x,y,dyx, y ,d_y
. One is based on input , one is based on output.
PriceImpact(x,y,dx)=(1000x)2(1000x+997dx)21PriceImpact(x, y, d_x) = \frac{ (1000*x)^2} { (1000*x + 997*d_x)^2} -1
or
PriceImpact(x,y,dy)=(ydy)2y21PriceImpact(x, y, d_y) = \dfrac{(y-d_y)^2}{y^2} -1
in code,
price impact(x, y, dx) = (1000*x)^2 / (1000*x + 997*dx)^2 - 1
price impact(x, y, dy) = (y - dy)^2 / y^2 - 1
Note that the price impact is always between -1 and 0.

Cross-Trading Price Impact

If there are no direct trading pairs between two tokens, like in V1 where we only support IOTX/token pairs, traders need to use one token, such as IOTX, as a bridge to trade among two tokens.
In this case, the price impact would be
PriceImpactcross=PI1PI2+PI1+PI2PriceImpact_{cross} = PI_1 * PI_2 + PI_1 + PI_2
or in code,
price impact = PI1 * PI2 + PI1 + PI2
where
PI1 is the price impact of first trading pair, such as x to IOTX
PI2 is the price impact of second trading pair, such as IOTX to y