Overview of Everscale to EVM Transfer Mechanics ​

1. Locking or Burning the Target Tokens Based on Their Type:

   • If the target token is a Native token, it will be locked on Everscale.
   • If it is an Alien token, it will be burned.

2. Event Contract Deployment and Confirmation:

   • The event contract is deployed on Everscale through a previous transaction.
   • After a few seconds, relayers confirm the event contract by voting on it.

3. Releasing or Minting Tokens on the EVM Network:

   3.1 Paying Gas Fees for an EVM Network with EVER:

   In this case, the process of token release or minting on the EVM network is automated.

   • The Credit Modules will call the relevant function on the MultiVault contract. After that the MultiVault contract handles the minting or releasing the token based on its type.

   3.2 Paying Gas Fees for an EVM Network with an EVM Gas Token:

   In this case, the process of token release or minting on the EVM network is done manually.

   • For Native tokens, call the saveWithdrawNative function to mint tokens.
   • For Alien tokens, call the saveWithdrawAlien function to release tokens. “Locking or Burning Target Tokens Based on Their Type:

   TIP

   Note that these functions must be called on the MultiVault contract.

4. At this point, the desired amount of target tokens must be deposited to the recipient EVM address.

Step-by-Step Guide: Everscale to EVM Transfer ​

Native Coin transfer ​

• 1 - Call the wrap function on the WEVERVault contract and mint WEVER tokens :

Function ​

function wrap(
        uint128 tokens,
        address owner_address,
        address gas_back_address,
        TvmCell payload
    ) external;

• 2 - Mint WEVER tokens in the EVM network by calling the saveWithdrawNative function on the MultiVault contract :

Function ​

function saveWithdrawNative(
        bytes memory payload,
        bytes[] memory signatures
    ) external;

Native Token Transfer ​

1 - Transfer the tokens to the ProxyMultiVaultNativeV-4's TokenWallet contract by calling the transfer function on your TokenWallet contract :

Function ​

function transfer(
        uint128 amount,
        address recipient,
        uint128 deployWalletValue,
        address remainingGasTo,
        bool notify,
        TvmCell payload
    ) external;

• 2 - Mint the tokens in the EVM network by calling the saveWithdrawNative function on the MultiVault contract:

Function ​

function saveWithdrawNative(
        bytes memory payload,
        bytes[] memory signatures
    ) external;

Alien Token Transfer ​

Function ​

function burn(
        uint128 amount,
        address remainingGasTo,
        address callbackTo,
        TvmCell payload
    ) external;

• 2 - Release the tokens in the EVM network by calling the saveWithdrawAlien function on the MultiVault contract:

Function ​

function saveWithdrawAlien(
        bytes memory payload,
        bytes[] memory signatures
    ) external;

EVM Gas Token Transfer ​

1 - Burn the tokens on Everscale network by calling the burn function on your tokenWallet contract :

Function ​

function burn(
        uint128 amount,
        address remainingGasTo,
        address callbackTo,
        TvmCell payload
    ) external;

• 2 - Release the tokens in EVM network by calling the saveWithdrawAlien function on the MultiVault contract:

Function ​

function saveWithdrawAlien(
        bytes memory payload,
        bytes[] memory signatures
    ) external;

Interactive code samples related to examples above can be found here

The addresses of all the referenced contracts and tokens can be found at Links.