The StarkGate bridge guide overview

This guide is a hands-on tutorial for using StarkGate. To learn about the different components of StarkGate, go to Architecture.

StarkGate, developed by StarkWare, bridges ETH and ERC-20 tokens between Ethereum and Starknet. StarkGate supports many tokens, each by its own L1 and L2 contracts.

For a comprehensive list of tokens that StarkGate supports, including their L1 and L2 addresses, see Chain info. You can also check if a token is supported using the getBridge function.

This guide will walk you through the various procedures enabled by StarkGate, including:

  • Depositing funds: Depositing ETH and ERC-20 tokens from your L1 wallet on Ethereum to your L2 wallet on Starknet, using a lock-and-mint mechanism.

  • Performing a Smart Deposit: Depositing ETH and ERC-20 tokens from your L1 wallet on Ethereum to your L2 wallet on Starknet, with an option to add subsequent actions (e.g., depositing funds and transferring those funds to another recipient within the same transaction).

  • Canceling a deposit: Canceling a previous deposit or deposit with message, if you don’t see your deposited funds appear on L2 within a reasonable amount of time.

  • Withdrawing funds: Withdrawing ETH and ERC-20 tokens from your L2 wallet on Starknet to your L1 wallet on Ethereum, using a burn-and-unlock mechanism.

  • Adding a token: Permissionlessly enrolling a token bridge on StarkGate.

StarkGate enforces fees for all procedures to account for L1→L2 message costs.

Fees for depositing funds or enrolling a token bridge on StarkGate, can be estimated using the estimateDepositFeeWei or estimateEnrollmentFeeWei function.