DODO (dodo)

In a Sauce program, swap with @sauce/router’s function for the venue (uniswapV2, uniswapV3, uniswapV4, curve, balancerV2, …; Slipstream, PancakeSwap V3 and Algebra pools through uniswapV3), with a minimum output and, where the pool takes one, a price limit (the @sauce/router reference; several pools under one limit, the distributed swap).

​

What it offers

• swap: Swap tokens via DODO V2 Proxy with pair-based routing

​

Notes

• PMM (Proactive Market Maker) provides better capital efficiency than constant product by concentrating liquidity near oracle price
• dodoPairs is an array of DODO pool addresses defining the swap route (each pool has a base token and a quote token)
• directions is a bitmask: for each pool in the path, a bit value of 0 means “sell base token” and 1 means “sell quote token”. The least significant bit corresponds to the first pool
• For a single-pool swap: if you’re selling the base token of that pool, directions = 0; if selling the quote token, directions = 1
• isIncentive: Flag for DODO mining incentives, typically set to false
• Pool discovery requires off-chain lookup via DODO’s API or subgraph to find the right pool addresses
• Input token must be ERC20-approved to the V2 Proxy contract
• DODO also supports single-token LP (provide only one side of liquidity)
• From a Pot program, @sauce/router swaps at a DODO V2 pool (DVM, DPP or DSP) directly, with no proxy and no approval: dodoV2(pool, tokenIn, tokenOut, amountIn, baseToken, quoteToken, minOut, recipient) transfers the input to the pool and calls sellBase(to) when tokenIn is the base, sellQuote(to) when it is the quote, returning the amount out. The side cannot come from address order, and the wrong one reverts nothing and donates the input, so the function takes the pool’s _BASE_TOKEN_() and _QUOTE_TOKEN_() and reverts unless tokenIn and tokenOut are those two. The pool books its whole balance as its reserve, so the swap consumes its input or reverts; name a minOut, since a thin pool pays out at most its quote reserve for any input. tryDodoV2, with the same arguments, first reads the pool’s own querySellBase or querySellQuote and returns 0, having moved nothing, when the quote is below minOut (or below 1) or the view reverts; the pool prices that view for the Pot’s fee but charges the transaction’s origin, so where its fee model tells the two apart the swap can deliver less than the quote and revert at the floor. The dodoV2Swap action is the same call; legacy V1 pairs are the dodoV1Swap action’s, through the proxy

​

Its names in a program

function main() {
  // Ethereum's dodoV2Proxy, `0xa356867fDCEa8e71AEaF87805808803806231FdC`.
  require(Dodo.DODOV2Proxy != 0);
}

​

Deployments

​

ABI

​

DODOV2ProxyABI

• dodoSwapV2TokenToToken(address fromToken, address toToken, uint256 fromTokenAmount, uint256 minReturnAmount, address[] dodoPairs, uint256 directions, bool isIncentive, uint256 deadLine) returns (uint256 returnAmount)

​

Next steps

• Protocols: the other protocols, by what they do.
• Protocols and tokens: calling a contract by its namespace, or through its ABI.
• Glossary: the words these pages use, in plain terms.