9f30823d70
* Strip erc20 package of legacy nonsense and add foundry basics * Make foundry build * Remove obsoleted test/UntransferrableDummyERC20Token.sol contract * Remove obsoleted ERC20 lib variant contracts * Remove obsoleted DummyMultipleReturnERC20Token and DummyNoReturnERC20Token contracts * Move test contract to dedicated folder and remove obsoleted TypeScript contract wrappers * Remove src/interfaces/IEtherToken.sol only used in v3 staking which is being obsoleted [skip ci] * Add foundry test for token * Migrate ZRX token tests to foundry * Fix paths to erc20 contracts * Remove obsoleted references * Pin erc20-contracts package on treasury * Ignore foundry imports in link checker * Run only forge tests for erc20 contracts * Remove DummyERC20Token and its dependencies * Merge IERC20TokenV06 and IERC20TokenV08 into range pragma to cover solidity 0.6.5 to 0.8.x * Merge IEtherTokenV06 and IEtherTokenV08 into range pragma to cover solidity 0.6.5 to 0.8.x * Migrate weth9 tests to foundry * Upload code coverage for erc20 package * Update changelog * Fix review comments Co-authored-by: duncancmt <1207590+duncancmt@users.noreply.github.com> --------- Co-authored-by: duncancmt <1207590+duncancmt@users.noreply.github.com>
33 lines
1.7 KiB
ReStructuredText
33 lines
1.7 KiB
ReStructuredText
###############################
|
|
Optimized Uniswap Router
|
|
###############################
|
|
|
|
The 0x Protocol is equipped with a highly optimized `UniswapV2 Router <https://uniswap.org/docs/v2/smart-contracts/router02/>`_, which can reduce the transaction cost of trading with Uniswap. Call the ``sellToUniswap`` function to execute a trade on Uniswap through the 0x Protocol.
|
|
|
|
.. code-block:: solidity
|
|
|
|
/// @dev Efficiently sell directly to uniswap/sushiswap.
|
|
/// @param tokens Sell path.
|
|
/// @param sellAmount of `tokens[0]` Amount to sell.
|
|
/// @param minBuyAmount Minimum amount of `tokens[-1]` to buy.
|
|
/// @param isSushi Use sushiswap if true.
|
|
/// @return buyAmount Amount of `tokens[-1]` bought.
|
|
function sellToUniswap(
|
|
IERC20Token[] calldata tokens,
|
|
uint256 sellAmount,
|
|
uint256 minBuyAmount,
|
|
bool isSushi
|
|
)
|
|
external
|
|
payable
|
|
returns (uint256 buyAmount);
|
|
|
|
This function sells ``sellAmount`` of ``tokens[0]`` for at least ``minBuyAmount`` of ``tokens[-1]``. The ``tokens`` array defines how to route the trade between Uniswap pools. This function does not emit any events, although Uniswap pools will emit their own events. This function reverts if amount bought from Uniswap is less than ``minBuyAmount``, or if Uniswap reverts.
|
|
|
|
See the source code for our router `here <https://github.com/0xProject/protocol/blob/development/contracts/zero-ex/contracts/src/features/UniswapFeature.sol>`_.
|
|
|
|
See the official `Uniswap V2 Documentation <https://uniswap.org/docs/v2/>`_ for information on events/reverts/allowances.
|
|
|
|
.. note::
|
|
This function does not use allowances set on 0x. The ``msg.sender`` must have allowances set on Uniswap (or SushiSwap).
|