• Stars
    star
    124
  • Rank 288,207 (Top 6 %)
  • Language
    Solidity
  • License
    GNU General Publi...
  • Created over 3 years ago
  • Updated 5 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

On-chain dex aggregator

Java YakSwap

Dex aggregator for EVM chains. UI available here.

About

YakSwap is a set of smart contracts for optimal path finding between two assets and execution of that path. For input&output token and input-amount optimal path should have a greatest net amount-out by considering execution gas-cost.

Search is performed by calling on-chain query-methods and can be called by anyone. However, user should avoid calling query-methods in a mutative call due to a very large gas-cost associated with a call.

Usage

Router

YakRouter is the user-facing interface to check prices and make trades. See example off-chain usage here.

Chain Address
Avalanche 0xC4729E56b831d74bBc18797e0e17A295fA77488c
Arbitrum 0xb32C79a25291265eF240Eb32E9faBbc6DcEE3cE3
Optimism 0xCd887F78c77b36B0b541E77AfD6F91C0253182A2

findBestPathWithGas

Finds the best path from tokenA to tokenB. Considers path's amount-out and its gas-cost.

function findBestPathWithGas(
    uint256 _amountIn,
    address _tokenIn,
    address _tokenOut,
    uint256 _maxSteps,
    uint256 _gasPrice
) external view returns (FormattedOffer memory);
Input params Details
amountIn Amount of tokens being sold
tokenIn ERC20 token being sold
tokenOut ERC20 token being bought
steps Max number of steps for path finding (must be less than 4)
gasPrice Gas price in gwei that will be used to estimate gasCost of each step
struct FormattedOffer {
    uint256[] amounts;
    address[] adapters;
    address[] path;
    uint256 gasEstimate;
}
Return arg Details
amounts Amount of token being swapped for each step. First amount is _amountIn and last amountOut.
adapters Addresses of adapters through which trade goes.
path Addresses of tokens through which trade goes. First token is _tokenIn and last _tokenOut.
gasEstimate Rough estimate for gas-cost of all swaps. Gas estimates only include gas-cost of swapping and querying on adapter and not intermediate logic, nor tx-gas-cost.

swapNoSplit

Executes trades through provided path.

function swapNoSplit(
    Trade calldata _trade,
    address _to,
    uint256 _fee
) external;
Input param Details
_trade Arguments used for swapping
_to Reciever address
_fee Optional fee in bps taken before the trades
struct Trade {
    uint256 amountIn;
    uint256 amountOut;
    address[] path;
    address[] adapters;
}
Param Details
amountIn Amount of tokens being sold
amountOut Amount of tokens being bought
path Tokens being traded in respective order
adapters Adapters through which tokens will be traded in respective order

Adapter

Adapters act as a common interface for YakRouter to interact with external contracts.

Adapters offers methods: query and swap.

function query(
    uint256 _amountIn,
    address _tokenIn,
    address _tokenOut
) external view returns (uint256);

function swap(
    uint256 _amountIn,
    uint256 _amountOut,
    address _fromToken,
    address _toToken,
    address _to
) external;

After setting up this repo call npx hardhat list-adapters --network {network-id} to get a list of live adapters and their addresses. Or see deployOptions for a list of live adapters per chain.

Local Development and testing

Install Dependencies

yarn install

Set Environmental Variables

cp .env.sample > .env

Actions

Test

Test for chain:

yarn test:{network-id}

Test individual:

npx hardhat test {path to the test/tests | empty to run all}

Deploy

yarn deploy:{network-id}

Verify

npx hardhat verify-contract --deployment-file-path {path to deployment file} --network {your network tag}

Query

npx hardhat find-best-path {fixed-amount-in} {token-in symbol/address} {token-in symbol/address}  --network {network tag}

Example:

npx hardhat find-best-path 1000 USDC yyAVAX  --network avalanche

Misc

  • Static-Quoters used in KyberElastic, UniswapV3 and Quickswap adapters are published here.

Audits and Security

This project is not audited. Use at your own risk. For any questions or bug reports reach out via Telegram group YakDevs or its admins.


Project is licensed under GPL-3, although some parts of it might be less restrictive. Copyrightยฉ 2021 Yield Yak