Standard Gas Flow

Transfer tokens from EOA to any receiver wallet address.

The executeMigration function in our SDK enables the transfer of tokens from an Externally Owned Account (EOA) to any designated receiver's wallet address. This operation falls under the "Standard Gas Flow" model, which implies that the user initiating the transfer will be responsible for paying the gas fees that the transaction incurs.

Expected parameters

executeMigration accepts the following parameters:

ethers.js

Parameter	Type	Description
senderSigner	ethers.Signer	Signer object obtained from ethers
chainId	number	The chain id of the current network.
receiverAddress	string	The address of the recipient.
transferTokenDetails[OPTIONAL]	TransferTokenDetails[]	The object specifies tokens with respective amounts to transfer or, in the case of NFTs tokenIds need to be mentioned

viem

Parameter	Type	Description
senderSigner	WalletClient	Wallet client object obtained from viem
chainId	number	The chain id of the current network.
account	JSON RPC Account	A JSON RPC account generated using viem and window.ethereum
receiverAddress	string	The address of the recipient.
transferTokenDetails[OPTIONAL]	TransferTokenDetails[]	The object specifies tokens with respective amounts to transfer or, in the case of NFTs tokenIds need to be mentioned

TransferTokenDetails {
    tokenAddress: string,
    amount?: string, // ERC20
    tokenIds?: string[] // ERC721
}

NOTE: If transferTokenDetails is not passed, then all the assets will be transferred.

Function Call

Transfer All tokens

ethers.js

await aarcSDK.executeMigration({
  senderSigner: signer, // ethers.signer object
  chainId: number,
  receiverAddress:'RECEIVER_WALLET_ADDRESS'
})

viem

import { createWalletClient, custom } from 'viem'
import { mainnet } from 'viem/chains'

const walletClient = createWalletClient({
  chain: mainnet,
  transport: custom(window.ethereum!),
})
 
const [account] = await walletClient.getAddresses();

await aarcSDK.executeMigration({
  senderSigner: walletClient,
  chainId: number,
  receiverAddress:'RECEIVER_WALLET_ADDRESS',
  account: account
})

Transfer-specific tokens

ethers.js

await aarcSDK.executeMigration({
  senderSigner: signer, // ethers.signer object
  receiverAddress:'RECEIVER_WALLET_ADDRESS',
  chainId: 137,
  transferTokenDetails: // Optional. If not passed, the SDK will migrate all the tokens of the wallet
  [
    {
        tokenAddress:"0x2271e3Fef9e15046d09E1d78a8FF038c691E9Cf9",
        // .toString(16) is to convert TOKEN_AMOUNT to hex in string format
        amount:TOKEN_AMOUNT.toString(16) 
    },
    {
      tokenAddress:"0x932ca55b9ef0b3094e8fa82435b3b4c50d713043",
      tokenIds:["28507"] 
    },
  ],
})

viem

import { createWalletClient, custom } from 'viem'
import { mainnet } from 'viem/chains'

const walletClient = createWalletClient({
  chain: mainnet,
  transport: custom(window.ethereum!),
})
 
const [account] = await walletClient.getAddresses();

await aarcSDK.executeMigration({
  senderSigner: walletClient,
  chainId: number,
  receiverAddress:'RECEIVER_WALLET_ADDRESS',
  account: account,
  transferTokenDetails: // Optional. If not passed, the SDK will migrate all the tokens of the wallet
  [
    {
        tokenAddress:"0x2271e3Fef9e15046d09E1d78a8FF038c691E9Cf9",
        // .toString(16) is to convert TOKEN_AMOUNT to hex in string format
        amount:TOKEN_AMOUNT.toString(16) 
    },
    {
      tokenAddress:"0x932ca55b9ef0b3094e8fa82435b3b4c50d713043",
      tokenIds:["28507"] 
    },
  ],
})

Response

The response of the executeMigration will be:

[
  {
  tokenInfo: [
     {
        tokenAddress: string,
        amount: BigInt
     }
  ];
  type: string,
  taskId: string,
  txHash: string,
  status: string | boolean
  },
]

Support

If you face any trouble, feel free to reach out to our engineers in the Telegram support group.