github/scroll
1
1
Fork 0
mirror of https://github.com/scroll-tech/scroll.git synced 2026-01-14 08:28:02 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
manager_api
scroll/contracts/docs/apis/L2GatewayRouter.md
Xi Lin 7e99c5148d feat(contracts): new bridge contracts (#288) 
Co-authored-by: Haichen Shen <shenhaichen@gmail.com>
Co-authored-by: Thegaram <th307q@gmail.com>
Co-authored-by: colin <102356659+colinlyguo@users.noreply.github.com>
2023-02-20 13:44:49 -08:00

11 KiB
Raw Permalink Blame History

L2GatewayRouter

L2GatewayRouter

The L2GatewayRouter is the main entry for withdrawing Ether and ERC20 tokens. All deposited tokens are routed to corresponding gateways.

One can also use this contract to query L1/L2 token address mapping. In the future, ERC-721 and ERC-1155 tokens will be added to the router too.

Methods

ERC20Gateway

function ERC20Gateway(address) external view returns (address)

Mapping from L2 ERC20 token address to corresponding L2ERC20Gateway.

Parameters

Name Type Description
_0 address undefined

Returns

Name Type Description
_0 address undefined

defaultERC20Gateway

function defaultERC20Gateway() external view returns (address)

The addess of default L2 ERC20 gateway, normally the L2StandardERC20Gateway contract.

Returns

Name Type Description
_0 address undefined

ethGateway

function ethGateway() external view returns (address)

The address of L2ETHGateway.

Returns

Name Type Description
_0 address undefined

finalizeDepositERC20

function finalizeDepositERC20(address, address, address, address, uint256, bytes) external payable

Complete a deposit from L1 to L2 and send fund to recipient's account in L2.

Make this function payable to handle WETH deposit/withdraw. The function should only be called by L2ScrollMessenger. The function should also only be called by L1ERC20Gateway in L1.

Parameters

Name Type Description
_0 address undefined
_1 address undefined
_2 address undefined
_3 address undefined
_4 uint256 undefined
_5 bytes undefined

finalizeDepositETH

function finalizeDepositETH(address, address, uint256, bytes) external payable

Complete ETH deposit from L1 to L2 and send fund to recipient's account in L2.

This function should only be called by L2ScrollMessenger. This function should also only be called by L1GatewayRouter in L1.

Parameters

Name Type Description
_0 address undefined
_1 address undefined
_2 uint256 undefined
_3 bytes undefined

getERC20Gateway

function getERC20Gateway(address _token) external view returns (address)

Return the corresponding gateway address for given token address.

Parameters

Name Type Description
_token address The address of token to query.

Returns

Name Type Description
_0 address undefined

getL1ERC20Address

function getL1ERC20Address(address _l2Address) external view returns (address)

Return the corresponding l1 token address given l2 token address.

Parameters

Name Type Description
_l2Address address undefined

Returns

Name Type Description
_0 address undefined

getL2ERC20Address

function getL2ERC20Address(address) external pure returns (address)

Return the corresponding l2 token address given l1 token address.

Parameters

Name Type Description
_0 address undefined

Returns

Name Type Description
_0 address undefined

initialize

function initialize(address _ethGateway, address _defaultERC20Gateway) external nonpayable

Parameters

Name Type Description
_ethGateway address undefined
_defaultERC20Gateway address undefined

owner

function owner() external view returns (address)

Returns the address of the current owner.

Returns

Name Type Description
_0 address undefined

renounceOwnership

function renounceOwnership() external nonpayable

Leaves the contract without owner. It will not be possible to call onlyOwner functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.

setDefaultERC20Gateway

function setDefaultERC20Gateway(address _defaultERC20Gateway) external nonpayable

Update the address of default ERC20 gateway contract.

This function should only be called by contract owner.

Parameters

Name Type Description
_defaultERC20Gateway address The address to update.

setERC20Gateway

function setERC20Gateway(address[] _tokens, address[] _gateways) external nonpayable

Update the mapping from token address to gateway address.

This function should only be called by contract owner.

Parameters

Name Type Description
_tokens address[] The list of addresses of tokens to update.
_gateways address[] The list of addresses of gateways to update.

setETHGateway

function setETHGateway(address _ethGateway) external nonpayable

Update the address of ETH gateway contract.

This function should only be called by contract owner.

Parameters

Name Type Description
_ethGateway address The address to update.

transferOwnership

function transferOwnership(address newOwner) external nonpayable

Transfers ownership of the contract to a new account (newOwner). Can only be called by the current owner.

Parameters

Name Type Description
newOwner address undefined

withdrawERC20

function withdrawERC20(address _token, uint256 _amount, uint256 _gasLimit) external payable

Withdraw of some token to a caller's account on L1.

Make this function payable to send relayer fee in Ether.

Parameters

Name Type Description
_token address undefined
_amount uint256 undefined
_gasLimit uint256 undefined

withdrawERC20

function withdrawERC20(address _token, address _to, uint256 _amount, uint256 _gasLimit) external payable

Withdraw of some token to a recipient's account on L1.

Make this function payable to send relayer fee in Ether.

Parameters

Name Type Description
_token address undefined
_to address undefined
_amount uint256 undefined
_gasLimit uint256 undefined

withdrawERC20AndCall

function withdrawERC20AndCall(address _token, address _to, uint256 _amount, bytes _data, uint256 _gasLimit) external payable

Withdraw of some token to a recipient's account on L1 and call.

Make this function payable to send relayer fee in Ether.

Parameters

Name Type Description
_token address undefined
_to address undefined
_amount uint256 undefined
_data bytes undefined
_gasLimit uint256 undefined

withdrawETH

function withdrawETH(address _to, uint256 _amount, uint256 _gasLimit) external payable

Withdraw ETH to caller's account in L1.

Parameters

Name Type Description
_to address undefined
_amount uint256 undefined
_gasLimit uint256 undefined

withdrawETH

function withdrawETH(uint256 _amount, uint256 _gasLimit) external payable

Withdraw ETH to caller's account in L1.

Parameters

Name Type Description
_amount uint256 undefined
_gasLimit uint256 undefined

withdrawETHAndCall

function withdrawETHAndCall(address _to, uint256 _amount, bytes _data, uint256 _gasLimit) external payable

Withdraw ETH to caller's account in L1.

Parameters

Name Type Description
_to address undefined
_amount uint256 undefined
_data bytes undefined
_gasLimit uint256 undefined

Events

FinalizeDepositERC20

event FinalizeDepositERC20(address indexed l1Token, address indexed l2Token, address indexed from, address to, uint256 amount, bytes data)

Emitted when ERC20 token is deposited from L1 to L2 and transfer to recipient.

Parameters

Name Type Description
l1Token indexed address undefined
l2Token indexed address undefined
from indexed address undefined
to address undefined
amount uint256 undefined
data bytes undefined

FinalizeDepositETH

event FinalizeDepositETH(address indexed from, address indexed to, uint256 amount, bytes data)

Emitted when ETH is deposited from L1 to L2 and transfer to recipient.

Parameters

Name Type Description
from indexed address undefined
to indexed address undefined
amount uint256 undefined
data bytes undefined

OwnershipTransferred

event OwnershipTransferred(address indexed previousOwner, address indexed newOwner)

Parameters

Name Type Description
previousOwner indexed address undefined
newOwner indexed address undefined

SetDefaultERC20Gateway

event SetDefaultERC20Gateway(address indexed defaultERC20Gateway)

Emitted when the address of default ERC20 Gateway is updated.

Parameters

Name Type Description
defaultERC20Gateway indexed address undefined

SetERC20Gateway

event SetERC20Gateway(address indexed token, address indexed gateway)

Emitted when the gateway for token is updated.

Parameters

Name Type Description
token indexed address undefined
gateway indexed address undefined

SetETHGateway

event SetETHGateway(address indexed ethGateway)

Emitted when the address of ETH Gateway is updated.

Parameters

Name Type Description
ethGateway indexed address undefined

WithdrawERC20

event WithdrawERC20(address indexed l1Token, address indexed l2Token, address indexed from, address to, uint256 amount, bytes data)

Emitted when someone withdraw ERC20 token from L2 to L1.

Parameters

Name Type Description
l1Token indexed address undefined
l2Token indexed address undefined
from indexed address undefined
to address undefined
amount uint256 undefined
data bytes undefined

WithdrawETH

event WithdrawETH(address indexed from, address indexed to, uint256 amount, bytes data)

Emitted when someone withdraw ETH from L2 to L1.

Parameters

Name Type Description
from indexed address undefined
to indexed address undefined
amount uint256 undefined
data bytes undefined
Reference in New Issue View Git Blame Copy Permalink