Skip to content

depositERC20

Initiates a ERC20 deposit transaction on an L1, which executes a transaction on an L2.

Internally performs a contract write to the depositERC20 function on the Mantle L1StandardBridge contract.

Usage

example.ts
import { mantle } from '@mantleio/viem/chains'
import { account, walletClientL1 } from './config'
 
const hash = await walletClientL1.depositERC20({
  account,
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  targetChain: mantle,
})

Returns

Hash

The L1 Transaction hash.

Parameters

account

  • Type: Account | Address

The Account to send the transaction from.

Accepts a JSON-RPC Account or Local Account (Private Key, etc).

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266', 
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  targetChain: mantle,
})

args.l1Token

  • Type: Address

The L1 token contract address.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c', 
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  targetChain: mantle,
})

args.l2Token

  • Type: Address

The L2 token contract address.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828', 
    amount: parseEther('1'),
  },
  targetChain: mantle,
})

args.amount

  • Type: bigint

Value in wei sent with this ERC20 deposit transaction on the L2. Debited from the caller's L2 balance.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'), 
  },
  targetChain: mantle,
})

args.to (optional)

  • Type: Address

L2 Transaction recipient.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
    to: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266', 
  },
  targetChain: mantle,
})

targetChain

The L2 chain to execute the transaction on.

import { mainnet } from 'viem/chains'
 
const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  chain: mainnet,
  targetChain: mantle, 
})

chain (optional)

  • Type: Chain
  • Default: client.chain

The L1 chain. If there is a mismatch between the wallet's current chain & this chain, an error will be thrown.

import { mainnet } from 'viem/chains'
 
const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  chain: mainnet, 
  targetChain: mantle,
})

gas (optional)

  • Type: bigint

Gas limit for transaction execution on the L1.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  gas: 420_000n, 
  chain: mainnet,
  targetChain: mantle,
})

maxFeePerGas (optional)

  • Type: bigint

Total fee per gas (in wei), inclusive of maxPriorityFeePerGas.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  maxFeePerGas: parseGwei('20'), 
  targetChain: mantle,
})

maxPriorityFeePerGas (optional)

  • Type: bigint

Max priority fee per gas (in wei). Only applies to EIP-1559 Transactions

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  maxFeePerGas: parseGwei('20'),
  maxPriorityFeePerGas: parseGwei('2'), 
  targetChain: mantle,
})

nonce (optional)

  • Type: number

Unique number identifying this transaction.

const hash = await client.depositERC20({
  account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  request: {
    l1Token: '0x072d71b257ECa6B60b5333626F6a55ea1B0c451c',
    l2Token: '0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828',
    amount: parseEther('1'),
  },
  nonce: 69, 
  targetChain: mantle,
})