V2Router02
V2Router02 is used as a intermediate contract to interact with liquidity pools, or the lower level V2Pair contract. The contract can be used to swap, add liquidity, withdraw liquidity. The contract also contains many variations of these three tasks that can be used for each unique situation like using native gas tokens (i.e. ETH), and Fee-On-Transfer tokens with a tax when transfers happen.
The full contract can be found here.
Read-Only Functions
factory
Returns factory address.
WETH
Returns the canonical WETH address on the Ethereum mainnet, or the canonical native wrapped address for the network the contracts are deployed on.
quote
See quote.
getAmountOut
See getAmountOut.
getAmountIn
See getAmountIn.
getAmountsOut
See getAmountsOut.
getAmountsIn
See getAmountsIn.
State-Changing Functions
addLiquidity
Adds liquidity to an ERC-20⇄ERC-20 pool.
To cover all possible scenarios,
msg.sender
should have already given the router an allowance of at least amountADesired/amountBDesired on tokenA/tokenB.Always adds assets at the ideal ratio, according to the price when the transaction is executed.
If a pool for the passed tokens does not exists, one is created automatically, and exactly amountADesired/amountBDesired tokens are added.
amountAMin
andamountBMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | address for one of the tokens in the pair |
| address | address for the other token in the pair |
| uint | amount of tokenA to add as liquidity if the B/A price is <= amountBDesired/amountADesired (A depreciates) |
| uint | amount of tokenB to add as liquidity if the A/B price is <= amountADesired/amountBDesired (B depreciates) |
| uint | bounds the extent to which the B/A price can go up before the transaction reverts. Must be <= amountADesired |
| uint | bounds the extent to which the A/B price can go up before the transaction reverts. Must be <= amountBDesired |
| address | recipient of the liquidity tokens |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of tokenA added to the pair |
| uint | amount of tokenB added to the pair |
| uint | amount of liquidity tokens minted |
addLiquidityETH
Adds liquidity to an ERC-20⇄WETH pool with ETH.
To cover all possible scenarios,
msg.sender
should have already given the router an allowance of at least amountTokenDesired on token.Always adds assets at the ideal ratio, according to the price when the transaction is executed.
msg.value
is treated as a amountETHDesired.Leftover ETH, if any, is returned to
msg.sender
.If a pool for the passed token and WETH does not exists, one is created automatically, and exactly amountTokenDesired/
msg.value
tokens are added.amountTokenMin
andamountETHMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | other token besides WETH in the pair |
| uint | amount of token to add as liquidity if the WETH/token price is <= |
| uint | amount of ETH to add as liquidity if the token/WETH price is <= amountTokenDesired/ |
| uint | bounds the extent to which the WETH/token price can go up before the transaction reverts. Must be <= amountTokenDesire |
| address | recipient of the liquidity tokens |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of token sent to the pair |
| uint | amount of ETH converted to WETH and sent to the pool |
| uint | amount of liquidity tokens minted |
removeLiquidity
Removes liquidity from an ERC-20⇄ERC-20 pool.
msg.sender
should have already given the router an allowance of at least liquidity on the pool.amountAMin
andamountBMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | address for one of the tokens in the pair |
| address | address for the other token in the pair |
| uint | amount of liquidity tokens to remove or burn |
| uint | minimum amount of tokenA that must be received for the transaction not to revert |
| uint | minimum amount of tokenB that must be received for the transaction not to revert |
| address | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of tokenA received |
| uint | amount of tokenB received |
removeLiquidityETH
Removes liquidity from an ERC-20⇄WETH pool and receive ETH.
msg.sender
should have already given the router an allowance of at least liquidity on the pool.amountTokenMin
andamountETHMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | other token besides ETH in the pair |
| uint | amount of liquidity tokens to remove or burn |
| uint | minimum amount of token that must be received for the transaction not to revert |
| uint | minimum amount of ETH that must be received for the transaction not to revert |
| uint | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of token received |
| uint | amount of ETH received |
removeLiquidityWithPermit
Removes liquidity from an ERC-20⇄ERC-20 pool without pre-approval.
amountAMin
andamountBMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | address for one of the tokens in the pair |
| address | address for the other token in the pair |
| uint | amount of liquidity tokens to remove |
| uint | minimum amount of tokenA that must be received for the transaction not to revert |
| uint | minimum amount of tokenB that must be received for the transaction not to revert |
| address | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
| bool | whether or not the approval amount in the signature is for liquidity or |
| uint8 | v component of the permit signature |
| bytes32 | r component of the permit signature |
| bytes32 | s component of the permit signature |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of tokenA received |
| uint | amount of tokenB received |
removeLiquidityETHWithPermit
Removes liquidity from an ERC-20⇄WETTH pool and receive ETH without pre-approval.
amountAMin
andamountBMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| address | other token besides WETH in the pair |
| uint | amount of liquidity tokens to remove |
| uint | minimum amount of token that must be received for the transaction not to revert |
| uint | minimum amount of ETH that must be received for the transaction not to revert |
| address | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
| bool | whether or not the approval amount in the signature is for liquidity or |
| uint8 | v component of the permit signature |
| bytes32 | r component of the permit signature |
| bytes32 | s component of the permit signature |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of token received |
| uint | amount of ETH received |
removeLiquidityETHSupportingFeeOnTransferTokens
Identical to removeLiquidityETH, but succeeds for tokens that take a fee on transfer.
Parameters
Name | Type | Description |
---|---|---|
| address | other token besides WETH in the pair |
| uint | amount of liquidity tokens to remove |
| uint | minimum amount of token that must be received for the transaction not to revert |
| uint | minimum amount of ETH that must be received for the transaction not to revert |
| address | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint | amount of ETH received |
removeLiquidityETHWithPermitSupportingFeeOnTransferTokens
Identical to removeLiquidityETHWithPermit, but succeeds for tokens that take a fee on transfer.
Parameters
Name | Type | Description |
---|---|---|
| address | other token besides WETH in the pair |
| uint | the amount of liquidity tokens to remove |
| uint | minimum amount of token that must be received for the transaction not to revert |
| uint | minimum amount of ETH that must be received for the transaction not to revert |
| address | recipient of the underlying assets |
| uint | unix timestamp after which the transaction will revert |
| bool | whether or not the approval amount in the signature is for liquidity or |
| uint8 | v component of the permit signature |
| bytes32 | r component of the permit signature |
| bytes32 | s component of the permit signature |
Returns
Name | Type | Description |
---|---|---|
| uint | The amount of ETH received. |
swapExactTokensForTokens
Swaps an exact amount of input tokens for as many output tokens as possible, along the route determined by the path. The first element of path is the input token, the last is the output token, and any intermediate elements represent intermediate pairs to trade through (if, for example, a direct pair does not exist).
path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.msg.sender
should have already given the router an allowance of at least amountIn on the input token.amountOutMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of input tokens to send |
| uint | minimum amount of output tokens that must be received for the transaction not to revert |
| address[] calldata | array of token addresses |
| address | recipient of the output tokens |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint[] memory | The input token amount and all subsequent output token amounts. |
swapTokensForExactTokens
Receive an exact amount of output tokens for as few input tokens as possible, along the route determined by the path. The first element of path is the input token, the last is the output token, and any intermediate elements represent intermediate tokens to trade through (if, for example, a direct pair does not exist).
path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.msg.sender
should have already given the router an allowance of at least amountIn on the input token.amountInMax
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
amountOut | uint | amount of output tokens to receive |
amountInMax | uint | maximum amount of input tokens that can be required before the transaction reverts |
path | address[] calldata | array of token addresses |
to | address | recipient of the output tokens |
deadline | uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
amounts | uint[] memory | input token amount and all subsequent output token amounts |
swapExactETHForTokens
Swaps an exact amount of ETH for as many output tokens as possible, along the route determined by the path. The first element of path must be WETH, the last is the output token, and any intermediate elements represent intermediate pairs to trade through (if, for example, a direct pair does not exist).
path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.amountOutMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of ETH to send |
|
| minimum amount of output tokens that must be received for the transaction not to revert |
|
| array of token addresses |
|
| recipient of the output tokens |
|
| unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
amounts |
| input token amount and all subsequent output token amounts |
swapTokensForExactETH
Receive an exact amount of ETH for as few input tokens as possible, along the route determined by the path. The first element of path is the input token, the last must be WETH, and any intermediate elements represent intermediate pairs to trade through (if, for example, a direct pair does not exist).
msg.sender
should have already given the router an allowance of at least amountInMax on the input token.If the to address is a smart contract, it must have the ability to receive ETH.
path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.amountInMax
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of ETH to receive |
| uint | maximum amount of input tokens that can be required before the transaction reverts |
| address[] calldata | array of token addresses |
| address | recipient of ETH |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint[] memory | input token amount and all subsequent output token amounts |
swapExactTokensForETH
Swaps an exact amount of tokens for as much ETH as possible, along the route determined by the path. The first element of path is the input token, the last must be WETH, and any intermediate elements represent intermediate pairs to trade through (if, for example, a direct pair does not exist).
If the to address is a smart contract, it must have the ability to receive ETH.
path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.amountOutMin
can be used for slippage protection.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of input tokens to send |
| uint | minimum amount of output tokens that must be received for the transaction not to revert |
| address[] calldata | array of token addresses |
| address | recipient of the ETH |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint[] memory | input token amount and all subsequent output token amounts |
swapETHForExactTokens
Receive an exact amount of tokens for as little ETH as possible, along the route determined by the path. The first element of path must be WETH, the last is the output token and any intermediate elements represent intermediate pairs to trade through (if, for example, a direct pair does not exist).
Leftover ETH, if any, is returned to
msg.sender
.path.length
must be >= 2. Pools for each consecutive pair of addresses must exist and have liquidity.deadline
is used to set a time restriction on how long it can take for the tx to be executed.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of tokens to receive |
| uint | maximum amount of ETH that can be required before the transaction reverts |
| address[] calldata | array of token addresses |
| address | recipient of the output tokens |
| uint | unix timestamp after which the transaction will revert |
Returns
Name | Type | Description |
---|---|---|
| uint[] memory | input token amount and all subsequent output token amounts |
swapExactTokensForTokensSupportingFeeOnTransferTokens
Identical to swapExactTokensForTokens, but succeeds for tokens that take a fee on transfer.
msg.sender
should have already given the router an allowance of at least amountIn on the input token.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of input tokens to send. |
| uint | minimum amount of output tokens that must be received for the transaction not to revert. |
| address[] calldata | array of token addresses |
| address | recipient of the output tokens |
| uint | unix timestamp after which the transaction will revert |
swapExactETHForTokensSupportingFeeOnTransferTokens
Identical to swapExactETHForTokens, but succeeds for tokens that take a fee on transfer.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of ETH to send |
| uint | minimum amount of output tokens that must be received for the transaction not to revert |
| address[] calldata | array of token addresses |
| address | recipient of the output tokens |
| uint | unix timestamp after which the transaction will revert |
swapExactTokensForETHSupportingFeeOnTransferTokens
Identical to swapExactTokensForETH, but succeeds for tokens that take a fee on transfer.
If the to address is a smart contract, it must have the ability to receive ETH.
Parameters
Name | Type | Description |
---|---|---|
| uint | amount of input tokens to send |
| uint | minimum amount of output tokens that must be received for the transaction not to revert |
| address[] calldata | array of token addresses. |
| address | recipient of the ETH |
| uint | unix timestamp after which the transaction will revert |
Interface
Last updated