Links

EverToTip3

With this smart contract you can swap evers to Tip3 tokens.
Smart contract responsible for swapping evers to Tip3 tokens.
Derives following classes and interfaces: IAcceptTokensMintCallback, IAcceptTokensTransferCallback, IAcceptTokensBurnCallback, IEverTip3SwapEvents.

constructor

constructor() public
Deploys wallet with EverToTip3 contract address.

buildExchangePayload

function buildExchangePayload(uint64 id, uint128 amount, address pair, uint128 expectedAmount, uint128 deployWalletValue) external pure returns (TvmCell)
Creates payload constructor for swap between Ever and Tip-3 token - takes id, amount, pair address, expectedAmount, deployWalletValue from params and store those values to the TVMBuilder instance.
Parameters:
Name
Type
Description
id
uint64
Payload Id
amount
uint128
Amount to exchange
pair
address
Exchange pair root address
expectedAmount
uint128
Expected amount after exchange
deployWalletValue
uint128
Value for deploying new wallet
Return Value:
Type
Description
TvmCell
Exchange payload in cell format

Swap

swapEvers

function swapEvers(address user, TvmCell payload) external
Takes user address and payload as params if there are enough EVERs swap them with Tip-3 token, if not cancel.
Parameters:
Name
Type
Description
user
address
Address of the user initiating exchange
payload
TvmCell
Payload used for wrapping EVERs

Callbacks

onWeverWallet

function onWeverWallet(address _weverWallet) external
Deploys Wever wallet for the contract using _weverWallet address from the function params.
Parameters:
Name
Type
Description
_weverWallet
address
Address used to initialize wever wallet

onAcceptTokensMint

function onAcceptTokensMint(address /*tokenRoot*/, uint128 amount, address user, TvmCell payload) override external
Checks if weverWallet is the message sender and message sender value is greater than 0, if value is ge then SWAP_EVER_TO_TIP_3_MIN_VALUE, if so emit SwapEverToTip3WeverMint event, create success, cancel and result payload, transfer the amount from the function params of tokens from EverToTip3 wallet to the pair’s address, else transfer to the weverVault address (burn Wevers).
Parameters:
Name
Type
Description
token_root
address
Address of the token root
amount
uint128
Amount of tokens to transfer to user
user
address
Address of the user to transfer remaining gas
payload
TvmCell
Payload with exchange data (id, amount, pair, expectedAmount, deploy value…)

onAcceptTokensTransfer

function onAcceptTokensTransfer(address /*tokenRoot*/, uint128 amount, address sender, address /*senderWallet*/, address user, TvmCell payload) override external
If operationStatus is cancel, burn WEVERs (transfer them to weverVault address), if it is SUCCESS call the callback function for swapping evers to tip 3 (onSwapEversToTip3Success), emit SwapEversToTip3SuccessTransfer event and send tip 3 tokens to the user using TokenWallet’s transfer function. If it’s not SUCCESS or CANCEL set needCancel var to true and transfer the amount back to the sender.
Parameters:
Name
Type
Description
tokenRoot
address
Address of token root
amount
uint128
Amount of tokens to transfer
sender
address
Address of tokens sender
senderWallet
address
Tokens sender’s wallet address
user
address
User’s address for receiving tip3 tokens
payload
TvmCell
Transfer payload data

onAcceptTokensBurn

function onAcceptTokensBurn(uint128 /*amount*/, address /*walletOwner*/, address /*wallet*/, address user, TvmCell payload) override external
Callback function used when swap is canceled. Emit SwapEverToTip3CancelTransfer and call callback function onSwapEverToTip3CancelTransfer.
Parameters:
Name
Type
Description
amount
uint128
Amount of tokens to burn (optional)
walletOwner
address
Address of wallet owner
wallet
address
Wallet address
user
address
User’s address that canceled exchange
payload
TvmCell
Burn tokens payload data

Key Events

SwapEverToTip3WeverMint

SwapEverToTip3WeverMint(uint64 id, uint128 amount, address pair, uint128 expectedAmount, uint128 deployWalletValue);
Emitted inside onAcceptTokensMint callback.

SwapEverToTip3SuccessTransfer

SwapEverToTip3SuccessTransfer(address user, uint64 id);
Emitted inside onAcceptTokensTransfer callback when EVERs are successfully swapped to Tip3 tokens.

SwapEverToTip3CancelTransfer

SwapEverToTip3CancelTransfer(address user, uint64 id);
Emitted inside of the onAcceptTokensBurn when swap is canceled .