Dystopia

Dystopia allows low cost, near 0 slippage trades on uncorrelated or tightly correlated assets. The protocol incentivizes fees instead of liquidity. Liquidity providers (LPs) are given incentives in the form of token, the amount received is calculated as follows;

• 100% of weekly distribution weighted on votes from ve-token holders

The above is distributed to the gauge (see below), however LPs will earn between 40% and 100% based on their own ve-token balance.

LPs with 0 ve* balance, will earn a maximum of 40%.

AMM

What differentiates Dystopia's AMM;

Dystopia AMMs are compatible with all the standard features as popularized by Uniswap V2, these include;

• Lazy LP management
• Fungible LP positions
• Chained swaps to route between pairs
• priceCumulativeLast that can be used as external TWAP
• Flashloan proof TWAP
• Direct LP rewards via skim
• xy>=k

Dystopia adds on the following features;

• 0 upkeep 30 minute TWAPs. This means no additional upkeep is required, you can quote directly from the pair
• Fee split. Fees do not auto accrue, this allows external protocols to be able to profit from the fee claim
• New curve: x3y+y3x, which allows efficient stable swaps
• Curve quoting: y = (sqrt((27 a^3 b x^2 + 27 a b^3 x^2)^2 + 108 x^12) + 27 a^3 b x^2 + 27 a b^3 x^2)^(1/3)/(3 2^(1/3) x) - (2^(1/3) x^3)/(sqrt((27 a^3 b x^2 + 27 a b^3 x^2)^2 + 108 x^12) + 27 a^3 b x^2 + 27 a b^3 x^2)^(1/3)
• Routing through both stable and volatile pairs
• Flashloan proof reserve quoting

token

TBD

ve-token

Vested Escrow (ve), this is the core voting mechanism of the system, used by BaseV1Factory for gauge rewards and gauge voting.

This is based off of ve(3,3)

• deposit_for deposits on behalf of
• emit Transfer to allow compatibility with third party explorers
• balance is moved to tokenId instead of address
• Locks are unique as NFTs, and not on a per address basis

function balanceOfNFT(uint) external returns (uint)

BaseV1Pair

Base V1 pair is the base pair, referred to as a pool, it holds two (2) closely correlated assets (example MIM-UST) if a stable pool or two (2) uncorrelated assets (example FTM-SPELL) if not a stable pool, it uses the standard UniswapV2Pair interface for UI & analytics compatibility.

function mint(address to) external returns (uint liquidity)
function burn(address to) external returns (uint amount0, uint amount1)
function swap(uint amount0Out, uint amount1Out, address to, bytes calldata data) external

Functions should not be referenced directly, should be interacted with via the BaseV1Router

Fees are not accrued in the base pair themselves, but are transfered to BaseV1Fees which has a 1:1 relationship with BaseV1Pair

BaseV1Factory

Base V1 factory allows for the creation of pools via function createPair(address tokenA, address tokenB, bool stable) external returns (address pair)

Base V1 factory uses an immutable pattern to create pairs, further reducing the gas costs involved in swaps

Anyone can create a pool permissionlessly.

BaseV1Router

Base V1 router is a wrapper contract and the default entry point into Stable V1 pools.

function addLiquidity(
    address tokenA,
    address tokenB,
    bool stable,
    uint amountADesired,
    uint amountBDesired,
    uint amountAMin,
    uint amountBMin,
    address to,
    uint deadline
) external ensure(deadline) returns (uint amountA, uint amountB, uint liquidity)

function removeLiquidity(
    address tokenA,
    address tokenB,
    bool stable,
    uint liquidity,
    uint amountAMin,
    uint amountBMin,
    address to,
    uint deadline
) public ensure(deadline) returns (uint amountA, uint amountB)

function swapExactTokensForTokens(
    uint amountIn,
    uint amountOutMin,
    route[] calldata routes,
    address to,
    uint deadline
) external ensure(deadline) returns (uint[] memory amounts)

Gauge

Gauges distribute arbitrary token(s) rewards to BaseV1Pair LPs based on voting weights as defined by ve voters.

Arbitrary rewards can be added permissionlessly via function notifyRewardAmount(address token, uint amount) external

Gauges are completely overhauled to separate reward calculations from deposit and withdraw. This further protect LP while allowing for infinite token calculations.

Previous iterations would track rewardPerToken as a shift everytime either totalSupply, rewardRate, or time changed. Instead we track each individually as a checkpoint and then iterate and calculation.

Bribe

Gauge bribes are natively supported by the protocol, Bribes inherit from Gauges and are automatically adjusted on votes.

Users that voted can claim their bribes via calling function getReward(address token) public

Fees accrued by Gauges are distributed to Bribes

BaseV1Voter

Gauge factory permissionlessly creates gauges for pools created by BaseV1Factory. Further it handles voting for 100% of the incentives to pools.

function vote(address[] calldata _poolVote, uint[] calldata _weights) external
function distribute(address token) external

veDYST distribution recipients

Name	Address	Qty
PolygonDAO	0x342952B86Bea9F2225f14D9f0dddDE070D1d0cC1	11,000,000.00
FRAX	0xDCB5A4b6Ee39447D700F4FA3303B1d1c25Ea9cA7	3,000,000.00
MAI	0x3FEACf904b152b1880bDE8BF04aC9Eb636fEE4d8	1,000,000.00
Aavegotchi	0xD4151c984e6CF33E04FFAAF06c3374B2926Ecc64	192,307.69
Adamant Finance	0x59cbff972fe0c19c881354a9cde52aca704da848	192,307.69
Beefy Finance	0xe37dD9A535c1D3c9fC33e3295B7e08bD1C42218D	192,307.69
CompliFi	0xa2722e04A1C70756AD297695e3c409507dc01341	192,307.69
Gains Network	0xeEc0974A7DBD8341A0aA07Ea95C61745aa691Cd9	192,307.69
GotchiVault	0x3F2c32b452c235218d6e1c3988E4B1F5F74afD4a	192,307.69
Impermax Finance	0x3f81e3d58ff74B8b692e4936c310D3A5f333cF28	192,307.69
InsurAce	0xe96DAADd5d03F2f067965a466228f6D2CF4b3bD2	192,307.69
Jarvis Network	0x2709fa6FA31BD336455d4F96DdFC505b3ACA5A68	192,307.69
Klima DAO	0x65A5076C0BA74e5f3e069995dc3DAB9D197d995c	192,307.69
Kogefarm	0xb26adCEE4aDE6812b036b96d77A7E997Ddd0F611	192,307.69
Market	0xd6f81D154D0532906140ef37268BC8eD2A17e008	192,307.69
Mimo Defi	0x4A0b0189035D3d710aa9DA8a13174Dd904c77148	192,307.69
Multichain	0xe0c92587b8b2C1a8Bd069F1f0eB990fD42a2198F	192,307.69
pNetwork	0x6e321232bD0C4A223355B06eB6BeFB9975f5618e	192,307.69
PoolTogether	0x3feE50d2888F2F7106fcdC0120295EBA3ae59245	192,307.69
Ramp	0xB63428448De118A7A6B6622556BaDAcB409eA961	192,307.69
Solo Top	0xC1B43205C21071aF382587f9519d238240d8B4F3	192,307.69
Sphere Finance	0x20D61737f972EEcB0aF5f0a85ab358Cd083Dd56a	192,307.69
StakeDAO	0xaA8B91ba8d78A0dc9a74FaBc54B6c4CC76191B0c	192,307.69
Synapse	0xBdD38B2eaae34C9FCe187909e81e75CBec0dAA7A	192,307.69
Tetu	0xcc16d636dD05b52FF1D8B9CE09B09BC62b11412B	192,307.69
Tidal Finance	0x42B5bb174CfA09012581425EAF62De1d1185ac7C	192,307.69
Vesq	0x4F64c22FB06ab877Bf63f7064fA21C5c51cc85bf	192,307.69
Goodghosting	0xcc7b93e2aa199785ebd57ca563ecea7314afa875	192,307.69
OtterClam	0x929A27c46041196e1a49C7B459d63eC9A20cd879	192,307.69

Mumbai deployment

Name	Address
wMATIC	0xe02f20BB33F8Bfb48eB907523435CA886e139A08
USDT	0x801FC386bd0a7998EE162ffF32b793D0624f3476
MIM	0xe0695CD828B63C0E4b70fdD44d0f066560EE8CfE
DAI	0x1ac7b60D5dDeB00DF64C992c8c760463250Ca158

Name	Address
DystFactory	0xD0692d6C30cd7a383f227Ba1cB28EeCE2F050926
DystRouter01	0xe9EdEb5576ea876014e76A496B4c564756ddDAEF
GovernanceTreasury	0x463cA34bC5530819EE1467A18C1c48a1bB306B74
BribeFactory	0x0C6868831c504Fb0bB61A54FEfC6464804380508
GaugesFactory	0xC9d5917A0cb82450Cd687AF31eCAaC967D7F121C
DYST	0xD8a4054d63fCb0030BC73E2323344Ae59A19E92b
DystMinter	0x08d7607b2FD46ae255040014a39CDC2094e55901
DystVoter	0x75e1e98650c119c4E3dCE3070CE6A5397Ed70c6a
Ve	0xa4EB2E1284D9E30fb656Fe6b34c1680Ef5d4cBFC
VeDist	0x0B62ad43837A69Ad60289EEea7C6e907e759F6E8
Controller	0xC363F3D4e1C005bf5321040653A088F71Bb974Ab

Polygon deployment

Name	Address
DystFactory	0x1d21Db6cde1b18c7E47B0F7F42f4b3F68b9beeC9
DystRouter01	0xbE75Dd16D029c6B32B7aD57A0FD9C1c20Dd2862e
GovernanceTreasury	0xBd51042D3A9EF62d4d93013315AE96A0c1760d7E
BribeFactory	0x7adD42D9c53Df14C1bC2507034F63b0AC924345F
GaugesFactory	0x719BfE5213AF9c2523E9f46b86cc70EB8b7F530F
DYST	0x39aB6574c289c3Ae4d88500eEc792AB5B947A5Eb
DystMinter	0xAda8e498cbb580937F72b6FEa696cAB1EE9E22B2
DystVoter	0x649BdF58B09A0Cd4Ac848b42c4B5e1390A72A49A
veDYST	0x060fa7aD32C510F12550c7a967999810dafC5697
VeDist	0x3EfB1b284a3EBa3955c53b728a2Cc4182a07e92F
Controller	0x7377eA6Afb77Ba013B23306154691c231824522a