scroll/contracts/docs/apis/ZKRollup.md

ZKRollup

ZKRollup

This contract maintains essential data for zk rollup, including: 1. a list of pending messages, which will be relayed to layer 2; 2. the block tree generated by layer 2 and it's status.

the message queue is not used yet, the offline relayer only use events in L1ScrollMessenger.

Methods

appendMessage

function appendMessage(address _sender, address _target, uint256 _value, uint256 _fee, uint256 _deadline, bytes _message, uint256 _gasLimit) external nonpayable returns (uint256)

Append a cross chain message to message queue.

This function should only be called by L1ScrollMessenger for safety.

Parameters

Name	Type	Description
_sender	address	The address of message sender in layer 1.
_target	address	The address of message recipient in layer 2.
_value	uint256	The amount of ether sent to recipient in layer 2.
_fee	uint256	The amount of ether paid to relayer in layer 2.
_deadline	uint256	The deadline of the message.
_message	bytes	The content of the message.
_gasLimit	uint256	Unused, but included for potential forward compatibility considerations.

Returns

Name	Type	Description
_0	uint256	undefined

blocks

function blocks(bytes32) external view returns (struct IZKRollup.BlockHeader header, bytes32 transactionRoot, bool verified)

Mapping from block hash to block index.

Parameters

Name	Type	Description
_0	bytes32	undefined

Returns

Name	Type	Description
header	IZKRollup.BlockHeader	undefined
transactionRoot	bytes32	undefined
verified	bool	undefined

commitBlock

function commitBlock(IZKRollup.BlockHeader _header, IZKRollup.Layer2Transaction[] _txn) external nonpayable

Parameters

Name	Type	Description
_header	IZKRollup.BlockHeader	undefined
_txn	IZKRollup.Layer2Transaction[]	undefined

finalizeBlockWithProof

function finalizeBlockWithProof(bytes32 _blockHash, uint256[] _proof, uint256[] _instances) external nonpayable

finalize commited block in layer 1

will add more parameters if needed.

Parameters

Name	Type	Description
_blockHash	bytes32	The block hash of the commited block.
_proof	uint256[]	The corresponding proof of the commited block.
_instances	uint256[]	Instance used to verify, generated from block.

finalizedBlocks

function finalizedBlocks(uint256) external view returns (bytes32)

Mapping from block height to finalized block hash.

Parameters

Name	Type	Description
_0	uint256	undefined

Returns

Name	Type	Description
_0	bytes32	undefined

getMessageHashByIndex

function getMessageHashByIndex(uint256 _index) external view returns (bytes32)

Return the message hash by index.

Parameters

Name	Type	Description
_index	uint256	The index to query.

Returns

Name	Type	Description
_0	bytes32	undefined

getNextQueueIndex

function getNextQueueIndex() external view returns (uint256)

Return the index of the first queue element not yet executed.

Returns

Name	Type	Description
_0	uint256	undefined

getQeueuLength

function getQeueuLength() external view returns (uint256)

Return the total number of appended message.

Returns

Name	Type	Description
_0	uint256	undefined

importGenesisBlock

function importGenesisBlock(IZKRollup.BlockHeader _genesis) external nonpayable

Parameters

Name	Type	Description
_genesis	IZKRollup.BlockHeader	undefined

initialize

function initialize(uint256 _chainId) external nonpayable

Parameters

Name	Type	Description
_chainId	uint256	undefined

lastFinalizedBlockHash

function lastFinalizedBlockHash() external view returns (bytes32)

The hash of the latest finalized block.

Returns

Name	Type	Description
_0	bytes32	undefined

layer2ChainId

function layer2ChainId() external view returns (uint256)

The chain id of the corresponding layer 2 chain.

Returns

Name	Type	Description
_0	uint256	undefined

layer2GasLimit

function layer2GasLimit(uint256) external view returns (uint256)

Return the layer 2 block gas limit.

Parameters

Name	Type	Description
_0	uint256	undefined

Returns

Name	Type	Description
_0	uint256	undefined

messenger

function messenger() external view returns (address)

The address of L1ScrollMessenger.

Returns

Name	Type	Description
_0	address	undefined

operator

function operator() external view returns (address)

The address of operator.

Returns

Name	Type	Description
_0	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.

revertBlock

function revertBlock(bytes32 _blockHash) external nonpayable

revert a pending block.

one can only revert unfinalized blocks.

Parameters

Name	Type	Description
_blockHash	bytes32	The block hash of the block.

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

updateMessenger

function updateMessenger(address _newMessenger) external nonpayable

Update the address of messenger.

This function can only called by contract owner.

Parameters

Name	Type	Description
_newMessenger	address	The new messenger address to update.

updateOperator

function updateOperator(address _newOperator) external nonpayable

Update the address of operator.

This function can only called by contract owner.

Parameters

Name	Type	Description
_newOperator	address	The new operator address to update.

verifyMessageStateProof

function verifyMessageStateProof(uint256 _blockNumber) external view returns (bool)

Verify a state proof for message relay.

add more fields.

Parameters

Name	Type	Description
_blockNumber	uint256	undefined

Returns

Name	Type	Description
_0	bool	undefined

Events

CommitBlock

event CommitBlock(bytes32 indexed _blockHash, uint64 indexed _blockHeight, bytes32 _parentHash)

Parameters

Name	Type	Description
_blockHash indexed	bytes32	undefined
_blockHeight indexed	uint64	undefined
_parentHash	bytes32	undefined

FinalizeBlock

event FinalizeBlock(bytes32 indexed _blockHash, uint64 indexed _blockHeight)

Parameters

Name	Type	Description
_blockHash indexed	bytes32	undefined
_blockHeight indexed	uint64	undefined

OwnershipTransferred

event OwnershipTransferred(address indexed previousOwner, address indexed newOwner)

Parameters

Name	Type	Description
previousOwner indexed	address	undefined
newOwner indexed	address	undefined

RevertBlock

event RevertBlock(bytes32 indexed _blockHash)

Parameters

Name	Type	Description
_blockHash indexed	bytes32	undefined

UpdateMesssenger

event UpdateMesssenger(address _oldMesssenger, address _newMesssenger)

Emitted when owner updates address of messenger

Parameters

Name	Type	Description
_oldMesssenger	address	The address of old messenger contract.
_newMesssenger	address	The address of new messenger contract.

UpdateOperator

event UpdateOperator(address _oldOperator, address _newOperator)

Emitted when owner updates address of operator

Parameters

Name	Type	Description
_oldOperator	address	The address of old operator.
_newOperator	address	The address of new operator.