Transfer EVER
The Native coin of Everscale, known as EVER, can be transferred to another EVM network through two methods. The first method involves manual asset minting on EVM network, while the second method automatically mints the assets on the EVM network. The code sample provided below demonstrates the implementation of your preferred approach.
In order to have a complete token bridging, if the EVM fees are paid with an Evm gas token, once you have initiated a transaction on this section, get your event address and use it to complete the token bridging on saveWithdrawNative section.
To perform such an operation we need WEVERVaultContract ABI which is as follows :
WEVERVault Contract ABI
typescript
abstract class EverAbi {
static WeverVault = {
"ABI version": 2,
version: "2.2",
header: ["pubkey", "time", "expire"],
functions: [
{
name: "constructor",
inputs: [
{ name: "owner_", type: "address" },
{ name: "root", type: "address" },
{ name: "root_tunnel", type: "address" },
{ name: "receive_safe_fee", type: "uint128" },
{ name: "settings_deploy_wallet_grams", type: "uint128" },
{ name: "initial_balance", type: "uint128" },
],
outputs: [],
},
{
name: "receiveTokenWalletAddress",
inputs: [{ name: "wallet", type: "address" }],
outputs: [],
},
{
name: "drain",
inputs: [{ name: "receiver", type: "address" }],
outputs: [],
},
{
name: "setConfiguration",
inputs: [
{
components: [
{ name: "root_tunnel", type: "address" },
{ name: "root", type: "address" },
{ name: "receive_safe_fee", type: "uint128" },
{ name: "settings_deploy_wallet_grams", type: "uint128" },
{ name: "initial_balance", type: "uint128" },
],
name: "_configuration",
type: "tuple",
},
],
outputs: [],
},
{
name: "withdraw",
inputs: [{ name: "amount", type: "uint128" }],
outputs: [],
},
{
name: "grant",
inputs: [{ name: "amount", type: "uint128" }],
outputs: [],
},
{
name: "wrap",
inputs: [
{ name: "tokens", type: "uint128" },
{ name: "owner_address", type: "address" },
{ name: "gas_back_address", type: "address" },
{ name: "payload", type: "cell" },
],
outputs: [],
},
{
name: "onAcceptTokensTransfer",
inputs: [
{ name: "tokenRoot", type: "address" },
{ name: "amount", type: "uint128" },
{ name: "sender", type: "address" },
{ name: "senderWallet", type: "address" },
{ name: "remainingGasTo", type: "address" },
{ name: "payload", type: "cell" },
],
outputs: [],
},
{
name: "transferOwnership",
inputs: [{ name: "newOwner", type: "address" }],
outputs: [],
},
{
name: "renounceOwnership",
inputs: [],
outputs: [],
},
{
name: "_randomNonce",
inputs: [],
outputs: [{ name: "_randomNonce", type: "uint256" }],
},
{
name: "owner",
inputs: [],
outputs: [{ name: "owner", type: "address" }],
},
{
name: "configuration",
inputs: [],
outputs: [
{
components: [
{ name: "root_tunnel", type: "address" },
{ name: "root", type: "address" },
{ name: "receive_safe_fee", type: "uint128" },
{ name: "settings_deploy_wallet_grams", type: "uint128" },
{ name: "initial_balance", type: "uint128" },
],
name: "configuration",
type: "tuple",
},
],
},
{
name: "token_wallet",
inputs: [],
outputs: [{ name: "token_wallet", type: "address" }],
},
{
name: "total_wrapped",
inputs: [],
outputs: [{ name: "total_wrapped", type: "uint128" }],
},
],
data: [{ key: 1, name: "_randomNonce", type: "uint256" }],
events: [
{
name: "OwnershipTransferred",
inputs: [
{ name: "previousOwner", type: "address" },
{ name: "newOwner", type: "address" },
],
outputs: [],
},
],
fields: [
{ name: "_pubkey", type: "uint256" },
{ name: "_timestamp", type: "uint64" },
{ name: "_constructorFlag", type: "bool" },
{ name: "_randomNonce", type: "uint256" },
{ name: "owner", type: "address" },
{
components: [
{ name: "root_tunnel", type: "address" },
{ name: "root", type: "address" },
{ name: "receive_safe_fee", type: "uint128" },
{ name: "settings_deploy_wallet_grams", type: "uint128" },
{ name: "initial_balance", type: "uint128" },
],
name: "configuration",
type: "tuple",
},
{ name: "token_wallet", type: "address" },
{ name: "total_wrapped", type: "uint128" },
],
} as const;
}Initiating the token transfer on Everscale
Transfer EVER
typescript
// Import the required libraries
import { ethers } from "ethers";
import { Address } from "everscale-inpage-provider";
// Initiate the Tvm provider as mentioned in prerequisites section
// User's Everscale address
const everSender: Address = new Address("0:12345");
/**
* @param WeverVaultAbi {JSON} WEVER contract ABI
* @param WEVERVaultAddress {Address} address of the WEVERVault contract
*/
const WEVERVaultContract: =
new provider.Contract(WeverVaultAbi, WEVERVaultAddress);
// Token amount
let amount: string;
// Pay EVM network fees with EVER ?
let payWithEver: boolean;
// Amount to attach to the transaction if payWithEver = true
/// @dev This parameter represents the estimated gas fees for one of the saveWithdraws functions in EVER coins.
const auto_value: string;
// Amount to attach to the transaction if payWithEver = false
const manual_value: string = 6;
// See building payloads -> Everscale Native Coin Payload
let EverNativeCoinPayload: string;
/**
* @param tokens {string} EVER amount
* @param owner_address {Address} Always compounder address
* @param gas_back_address {Address} Address to send the change back
* @param payload {string} Operational payload
* @param from {Address} Sender address
* @notice @param amount {string} this parameter is important when asset releasing on EVM network is done automatically
* @param bounce {boolean} return remaining gas ? always true
*/
await WEVERVaultContract.methods
.wrap({
tokens: ethers.parseUnits(amount, 9).toString(),
owner_address: Compounder,
gas_back_address: payWithEver ? EventCloser : everSender,
payload: EverNativeCoinPayload,
})
.send({
from: everSender,
amount: ethers.parseUnits((payWithEver ? auto_value : manual_value ), 9).toString(),
bounce: true,
});WARNING
Kindly be aware that you are signing a transaction on the mainnet (this is not a testnet).
The addresses of all the referenced contracts and tokens can be found at Links.