*The AddressDictator (glory to Arstotzka) is a contract that allows us to safely manipulate many different addresses in the AddressManager without transferring ownership of the AddressManager to a hot wallet or hardware wallet.*
## Methods
### finalOwner
```solidity
function finalOwner() external view returns (address)
```
...
...
@@ -30,27 +21,16 @@ function finalOwner() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### getNamedAddresses
```solidity
function getNamedAddresses() external view returns (struct AddressDictator.NamedAddress[])
```
Returns the full namedAddresses array.
...
...
@@ -58,27 +38,16 @@ Returns the full namedAddresses array.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | AddressDictator.NamedAddress[] | undefined
### manager
```solidity
function manager() external view returns (contract Lib_AddressManager)
Transfers ownership of this contract to the finalOwner. Only callable by the Final Owner, which is intended to be our multisig. This function shouldn't be necessary, but it gives a sense of reassurance that we can recover if something really surprising goes wrong.
...
...
@@ -114,17 +72,10 @@ Transfers ownership of this contract to the finalOwner. Only callable by the Fin
### setAddresses
```solidity
function setAddresses() external nonpayable
```
Called to finalize the transfer, this function is callable by anyone, but will only result in an upgrade if this contract is the owner Address Manager.
...
...
@@ -135,11 +86,3 @@ Called to finalize the transfer, this function is callable by anyone, but will o
*This contract is, for now, a stub of the "real" BondManager that does nothing but allow the "OVM_Proposer" to submit state root batches.*
## Methods
### isCollateralized
```solidity
function isCollateralized(address _who) external view returns (bool)
```
Checks whether a given address is properly collateralized and can perform actions within the system.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _who | address | Address to check.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | true if the address is properly collateralized, false otherwise.
### libAddressManager
```solidity
function libAddressManager() external view returns (contract Lib_AddressManager)
*The Canonical Transaction Chain (CTC) contract is an append-only log of transactions which must be applied to the rollup state. It defines the ordering of rollup transactions by writing them to the 'CTC:batches' instance of the Chain Storage Container. The CTC also allows any account to 'enqueue' an L2 transaction, which will require that the Sequencer will eventually append it to the rollup state.*
## Methods
### MAX_ROLLUP_TX_SIZE
```solidity
function MAX_ROLLUP_TX_SIZE() external view returns (uint256)
```
...
...
@@ -30,27 +21,16 @@ function MAX_ROLLUP_TX_SIZE() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### MIN_ROLLUP_TX_GAS
```solidity
function MIN_ROLLUP_TX_GAS() external view returns (uint256)
```
...
...
@@ -58,45 +38,27 @@ function MIN_ROLLUP_TX_GAS() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### appendSequencerBatch
```solidity
function appendSequencerBatch() external nonpayable
```
Allows the sequencer to append a batch of transactions.
*This function uses a custom encoding scheme for efficiency reasons. .param _shouldStartAtElement Specific batch we expect to start appending to. .param _totalElementsToAppend Total number of batch elements we expect to append. .param _contexts Array of batch contexts. .param _transactionDataFields Array of raw transaction data.*
### batches
```solidity
function batches() external view returns (contract IChainStorageContainer)
```
Accesses the batch storage container.
...
...
@@ -104,60 +66,34 @@ Accesses the batch storage container.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | contract IChainStorageContainer | Reference to the batch storage container.
### enqueue
```solidity
function enqueue(address _target, uint256 _gasLimit, bytes _data) external nonpayable
```
Adds a transaction to the queue.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _target | address | Target L2 contract to send the transaction to.
| _gasLimit | uint256 | Gas limit for the enqueued L2 transaction.
| _data | bytes | Transaction data.
### enqueueGasCost
```solidity
function enqueueGasCost() external view returns (uint256)
```
...
...
@@ -165,27 +101,16 @@ function enqueueGasCost() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### enqueueL2GasPrepaid
```solidity
function enqueueL2GasPrepaid() external view returns (uint256)
```
...
...
@@ -193,27 +118,16 @@ function enqueueL2GasPrepaid() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### getLastBlockNumber
```solidity
function getLastBlockNumber() external view returns (uint40)
```
Returns the blocknumber of the last transaction.
...
...
@@ -221,27 +135,16 @@ Returns the blocknumber of the last transaction.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Blocknumber for the last transaction.
### getLastTimestamp
```solidity
function getLastTimestamp() external view returns (uint40)
```
Returns the timestamp of the last transaction.
...
...
@@ -249,27 +152,16 @@ Returns the timestamp of the last transaction.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Timestamp for the last transaction.
### getNextQueueIndex
```solidity
function getNextQueueIndex() external view returns (uint40)
```
Returns the index of the next element to be enqueued.
...
...
@@ -277,27 +169,16 @@ Returns the index of the next element to be enqueued.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Index for the next queue element.
### getNumPendingQueueElements
```solidity
function getNumPendingQueueElements() external view returns (uint40)
```
Get the number of queue elements which have not yet been included.
...
...
@@ -305,64 +186,38 @@ Get the number of queue elements which have not yet been included.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Number of pending queue elements.
### getQueueElement
```solidity
function getQueueElement(uint256 _index) external view returns (struct Lib_OVMCodec.QueueElement _element)
```
Gets the queue element at a particular index.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Index of the queue element to access.
#### Returns
| Name | Type | Description |
|---|---|---|
| _element | Lib_OVMCodec.QueueElement | Queue element at the given index.
### getQueueLength
```solidity
function getQueueLength() external view returns (uint40)
```
Retrieves the length of the queue, including both pending and canonical transactions.
...
...
@@ -370,27 +225,16 @@ Retrieves the length of the queue, including both pending and canonical transact
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Length of the queue.
### getTotalBatches
```solidity
function getTotalBatches() external view returns (uint256 _totalBatches)
```
Retrieves the total number of batches submitted.
...
...
@@ -398,27 +242,16 @@ Retrieves the total number of batches submitted.
#### Returns
| Name | Type | Description |
|---|---|---|
| _totalBatches | uint256 | Total submitted batches.
### getTotalElements
```solidity
function getTotalElements() external view returns (uint256 _totalElements)
```
Retrieves the total number of elements submitted.
...
...
@@ -426,27 +259,16 @@ Retrieves the total number of elements submitted.
#### Returns
| Name | Type | Description |
|---|---|---|
| _totalElements | uint256 | Total submitted elements.
### l2GasDiscountDivisor
```solidity
function l2GasDiscountDivisor() external view returns (uint256)
```
...
...
@@ -454,27 +276,16 @@ function l2GasDiscountDivisor() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### libAddressManager
```solidity
function libAddressManager() external view returns (contract Lib_AddressManager)
function maxTransactionGasLimit() external view returns (uint256)
```
...
...
@@ -510,251 +310,149 @@ function maxTransactionGasLimit() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### resolve
```solidity
function resolve(string _name) external view returns (address)
```
Resolves the address associated with a given name.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _name | string | Name to resolve an address for.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address associated with the given name.
### setGasParams
```solidity
function setGasParams(uint256 _l2GasDiscountDivisor, uint256 _enqueueGasCost) external nonpayable
```
Allows the Burn Admin to update the parameters which determine the amount of gas to burn. The value of enqueueL2GasPrepaid is immediately updated as well.
*The Chain Storage Container provides its owner contract with read, write and delete functionality. This provides gas efficiency gains by enabling it to overwrite storage slots which can no longer be used in a fraud proof due to the fraud window having passed, and the associated chain state or transactions being finalized. Three distinct Chain Storage Containers will be deployed on Layer 1: 1. Stores transaction batches for the Canonical Transaction Chain 2. Stores queued transactions for the Canonical Transaction Chain 3. Stores chain state batches for the State Commitment Chain*
## Methods
### deleteElementsAfterInclusive
```solidity
function deleteElementsAfterInclusive(uint256 _index, bytes27 _globalMetadata) external nonpayable
```
Removes all objects after and including a given index. Also allows setting the global metadata field.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Object index to delete from.
| _globalMetadata | bytes27 | New global metadata for the container.
### deleteElementsAfterInclusive
```solidity
function deleteElementsAfterInclusive(uint256 _index) external nonpayable
```
Removes all objects after and including a given index.
Removes all objects after and including a given index. Also allows setting the global metadata field.
...
...
@@ -66,57 +24,34 @@ Removes all objects after and including a given index.
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Object index to delete from.
### get
```solidity
function get(uint256 _index) external view returns (bytes32)
```
Retrieves an object from the container.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Index of the particular object to access.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | 32 byte object value.
### getGlobalMetadata
```solidity
function getGlobalMetadata() external view returns (bytes27)
```
Retrieves the container's global metadata field.
...
...
@@ -124,27 +59,16 @@ Retrieves the container's global metadata field.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes27 | Container global metadata field.
### length
```solidity
function length() external view returns (uint256)
```
Retrieves the number of objects stored in the container.
...
...
@@ -152,27 +76,16 @@ Retrieves the number of objects stored in the container.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | Number of objects in the container.
### libAddressManager
```solidity
function libAddressManager() external view returns (contract Lib_AddressManager)
@@ -208,63 +110,19 @@ function owner() external view returns (string)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### push
```solidity
function push(bytes32 _object, bytes27 _globalMetadata) external nonpayable
```
Pushes an object into the container. Function allows setting the global metadata since we'll need to touch the "length" storage slot anyway, which also contains the global metadata (it's an optimization).
#### Parameters
| Name | Type | Description |
|---|---|---|
| _object | bytes32 | A 32 byte value to insert into the container.
| _globalMetadata | bytes27 | New global metadata for the container.
### push
```solidity
function push(bytes32 _object) external nonpayable
```
Pushes an object into the container.
Pushes an object into the container. Function allows setting the global metadata since we'll need to touch the "length" storage slot anyway, which also contains the global metadata (it's an optimization).
...
...
@@ -272,81 +130,46 @@ Pushes an object into the container.
| Name | Type | Description |
|---|---|---|
| _object | bytes32 | A 32 byte value to insert into the container.
### resolve
```solidity
function resolve(string _name) external view returns (address)
```
Resolves the address associated with a given name.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _name | string | Name to resolve an address for.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address associated with the given name.
### setGlobalMetadata
```solidity
function setGlobalMetadata(bytes27 _globalMetadata) external nonpayable
```
Sets the container's global metadata field. We're using `bytes27` here because we use five bytes to maintain the length of the underlying data structure, meaning we have an extra 27 bytes to store arbitrary data.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _globalMetadata | bytes27 | New global metadata to set.
*Like the AddressDictator, but specifically for the Proxy__OVM_L1StandardBridge. We're working on a generalized version of this but this is good enough for the moment.*
## Methods
### bridgeSlotKey
```solidity
function bridgeSlotKey() external view returns (bytes32)
```
...
...
@@ -30,27 +21,16 @@ function bridgeSlotKey() external view returns (bytes32)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
### bridgeSlotVal
```solidity
function bridgeSlotVal() external view returns (bytes32)
```
...
...
@@ -58,27 +38,16 @@ function bridgeSlotVal() external view returns (bytes32)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
### codeHash
```solidity
function codeHash() external view returns (bytes32)
```
...
...
@@ -86,54 +55,32 @@ function codeHash() external view returns (bytes32)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
### doActions
```solidity
function doActions(bytes _code) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _code | bytes | undefined
### finalOwner
```solidity
function finalOwner() external view returns (address)
```
...
...
@@ -141,27 +88,16 @@ function finalOwner() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### isUpgrading
```solidity
function isUpgrading() external view returns (bool)
```
...
...
@@ -169,27 +105,16 @@ function isUpgrading() external view returns (bool)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### messengerSlotKey
```solidity
function messengerSlotKey() external view returns (bytes32)
```
...
...
@@ -197,27 +122,16 @@ function messengerSlotKey() external view returns (bytes32)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
### messengerSlotVal
```solidity
function messengerSlotVal() external view returns (bytes32)
```
...
...
@@ -225,27 +139,16 @@ function messengerSlotVal() external view returns (bytes32)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
### returnOwnership
```solidity
function returnOwnership() external nonpayable
```
Transfers ownership of this contract to the finalOwner. Only callable by the finalOwner, which is intended to be our multisig. This function shouldn't be necessary, but it gives a sense of reassurance that we can recover if something really surprising goes wrong.
...
...
@@ -253,17 +156,10 @@ Transfers ownership of this contract to the finalOwner. Only callable by the fin
### target
```solidity
function target() external view returns (contract L1ChugSplashProxy)
*Provides information about the current execution context, including the sender of the transaction and its data. While these are generally available via msg.sender and msg.data, they should not be accessed in such a direct manner, since when dealing with meta-transactions the account sending and paying for execution may not be the actual sender (as far as an application is concerned). This contract is only required for intermediate, library-like contracts.*
*Provides information about the current execution context, including the sender of the transaction and its data. While these are generally available via msg.sender and msg.data, they should not be accessed in such a direct manner, since when dealing with meta-transactions the account sending and paying for execution may not be the actual sender (as far as an application is concerned). This contract is only required for intermediate, library-like contracts.*
*Library used to query support of an interface declared via {IERC165}. Note that these functions return the actual result of the query: they do not `revert` if an interface is not supported. It is up to the caller to decide what to do in these cases.*
*Implementation of the {IERC20} interface. This implementation is agnostic to the way tokens are created. This means that a supply mechanism has to be added in a derived contract using {_mint}. For a generic mechanism see {ERC20PresetMinterPauser}. TIP: For a detailed writeup see our guide https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How to implement supply mechanisms]. We have followed general OpenZeppelin Contracts guidelines: functions revert instead returning `false` on failure. This behavior is nonetheless conventional and does not conflict with the expectations of ERC20 applications. Additionally, an {Approval} event is emitted on calls to {transferFrom}. This allows applications to reconstruct the allowance for all accounts just by listening to said events. Other implementations of the EIP may not emit these events, as it isn't required by the specification. Finally, the non-standard {decreaseAllowance} and {increaseAllowance} functions have been added to mitigate the well-known issues around setting allowances. See {IERC20-approve}.*
## Methods
### allowance
```solidity
function allowance(address owner, address spender) external view returns (uint256)
```
*See {IERC20-allowance}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*See {IERC20-approve}. Requirements: - `spender` cannot be the zero address.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*See {IERC20-balanceOf}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### decimals
```solidity
function decimals() external view returns (uint8)
```
*Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the value {ERC20} uses, unless this function is overridden; NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint8 | undefined
### decreaseAllowance
```solidity
function decreaseAllowance(address spender, uint256 subtractedValue) external nonpayable returns (bool)
```
*Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| subtractedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### increaseAllowance
```solidity
function increaseAllowance(address spender, uint256 addedValue) external nonpayable returns (bool)
```
*Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| addedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### name
```solidity
function name() external view returns (string)
```
*Returns the name of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### symbol
```solidity
function symbol() external view returns (string)
```
*Returns the symbol of the token, usually a shorter version of the name.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*See {IERC20-totalSupply}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*See {IERC20-transfer}. Requirements: - `recipient` cannot be the zero address. - the caller must have a balance of at least `amount`.*
*See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. Requirements: - `sender` and `recipient` cannot be the zero address. - `sender` must have a balance of at least `amount`. - the caller must have allowance for ``sender``'s tokens of at least `amount`.*
function appendSequencerBatch() external nonpayable
```
Allows the sequencer to append a batch of transactions.
*This function uses a custom encoding scheme for efficiency reasons. .param _shouldStartAtElement Specific batch we expect to start appending to. .param _totalElementsToAppend Total number of batch elements we expect to append. .param _contexts Array of batch contexts. .param _transactionDataFields Array of raw transaction data.*
### batches
```solidity
function batches() external view returns (contract IChainStorageContainer)
```
Accesses the batch storage container.
...
...
@@ -48,60 +32,34 @@ Accesses the batch storage container.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | contract IChainStorageContainer | Reference to the batch storage container.
### enqueue
```solidity
function enqueue(address _target, uint256 _gasLimit, bytes _data) external nonpayable
```
Adds a transaction to the queue.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _target | address | Target contract to send the transaction to.
| _gasLimit | uint256 | Gas limit for the given transaction.
| _data | bytes | Transaction data.
### getLastBlockNumber
```solidity
function getLastBlockNumber() external view returns (uint40)
```
Returns the blocknumber of the last transaction.
...
...
@@ -109,27 +67,16 @@ Returns the blocknumber of the last transaction.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Blocknumber for the last transaction.
### getLastTimestamp
```solidity
function getLastTimestamp() external view returns (uint40)
```
Returns the timestamp of the last transaction.
...
...
@@ -137,27 +84,16 @@ Returns the timestamp of the last transaction.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Timestamp for the last transaction.
### getNextQueueIndex
```solidity
function getNextQueueIndex() external view returns (uint40)
```
Returns the index of the next element to be enqueued.
...
...
@@ -165,27 +101,16 @@ Returns the index of the next element to be enqueued.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Index for the next queue element.
### getNumPendingQueueElements
```solidity
function getNumPendingQueueElements() external view returns (uint40)
```
Get the number of queue elements which have not yet been included.
...
...
@@ -193,64 +118,38 @@ Get the number of queue elements which have not yet been included.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Number of pending queue elements.
### getQueueElement
```solidity
function getQueueElement(uint256 _index) external view returns (struct Lib_OVMCodec.QueueElement _element)
```
Gets the queue element at a particular index.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Index of the queue element to access.
#### Returns
| Name | Type | Description |
|---|---|---|
| _element | Lib_OVMCodec.QueueElement | Queue element at the given index.
### getQueueLength
```solidity
function getQueueLength() external view returns (uint40)
```
Retrieves the length of the queue, including both pending and canonical transactions.
...
...
@@ -258,27 +157,16 @@ Retrieves the length of the queue, including both pending and canonical transact
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint40 | Length of the queue.
### getTotalBatches
```solidity
function getTotalBatches() external view returns (uint256 _totalBatches)
```
Retrieves the total number of batches submitted.
...
...
@@ -286,27 +174,16 @@ Retrieves the total number of batches submitted.
#### Returns
| Name | Type | Description |
|---|---|---|
| _totalBatches | uint256 | Total submitted batches.
### getTotalElements
```solidity
function getTotalElements() external view returns (uint256 _totalElements)
```
Retrieves the total number of elements submitted.
...
...
@@ -314,214 +191,127 @@ Retrieves the total number of elements submitted.
#### Returns
| Name | Type | Description |
|---|---|---|
| _totalElements | uint256 | Total submitted elements.
### setGasParams
```solidity
function setGasParams(uint256 _l2GasDiscountDivisor, uint256 _enqueueGasCost) external nonpayable
```
Allows the Burn Admin to update the parameters which determine the amount of gas to burn. The value of enqueueL2GasPrepaid is immediately updated as well.
function deleteElementsAfterInclusive(uint256 _index, bytes27 _globalMetadata) external nonpayable
```
Removes all objects after and including a given index. Also allows setting the global metadata field.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Object index to delete from.
| _globalMetadata | bytes27 | New global metadata for the container.
### deleteElementsAfterInclusive
```solidity
function deleteElementsAfterInclusive(uint256 _index) external nonpayable
```
Removes all objects after and including a given index.
Removes all objects after and including a given index. Also allows setting the global metadata field.
...
...
@@ -66,57 +24,34 @@ Removes all objects after and including a given index.
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Object index to delete from.
### get
```solidity
function get(uint256 _index) external view returns (bytes32)
```
Retrieves an object from the container.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _index | uint256 | Index of the particular object to access.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | 32 byte object value.
### getGlobalMetadata
```solidity
function getGlobalMetadata() external view returns (bytes27)
```
Retrieves the container's global metadata field.
...
...
@@ -124,27 +59,16 @@ Retrieves the container's global metadata field.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bytes27 | Container global metadata field.
### length
```solidity
function length() external view returns (uint256)
```
Retrieves the number of objects stored in the container.
...
...
@@ -152,63 +76,19 @@ Retrieves the number of objects stored in the container.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | Number of objects in the container.
### push
```solidity
function push(bytes32 _object, bytes27 _globalMetadata) external nonpayable
```
Pushes an object into the container. Function allows setting the global metadata since we'll need to touch the "length" storage slot anyway, which also contains the global metadata (it's an optimization).
#### Parameters
| Name | Type | Description |
|---|---|---|
| _object | bytes32 | A 32 byte value to insert into the container.
| _globalMetadata | bytes27 | New global metadata for the container.
### push
```solidity
function push(bytes32 _object) external nonpayable
```
Pushes an object into the container.
Pushes an object into the container. Function allows setting the global metadata since we'll need to touch the "length" storage slot anyway, which also contains the global metadata (it's an optimization).
...
...
@@ -216,44 +96,24 @@ Pushes an object into the container.
| Name | Type | Description |
|---|---|---|
| _object | bytes32 | A 32 byte value to insert into the container.
### setGlobalMetadata
```solidity
function setGlobalMetadata(bytes27 _globalMetadata) external nonpayable
```
Sets the container's global metadata field. We're using `bytes27` here because we use five bytes to maintain the length of the underlying data structure, meaning we have an extra 27 bytes to store arbitrary data.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _globalMetadata | bytes27 | New global metadata to set.
*Interface of the ERC165 standard, as defined in the https://eips.ethereum.org/EIPS/eip-165[EIP]. Implementers can declare support of contract interfaces, which can then be queried by others ({ERC165Checker}). For an implementation, see {ERC165}.*
## Methods
### supportsInterface
```solidity
function supportsInterface(bytes4 interfaceId) external view returns (bool)
```
*Returns true if this contract implements the interface defined by `interfaceId`. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] to learn more about how these ids are created. This function call must use less than 30 000 gas.*
*Interface of the ERC20 standard as defined in the EIP.*
## Methods
### allowance
```solidity
function allowance(address owner, address spender) external view returns (uint256)
```
*Returns the remaining number of tokens that `spender` will be allowed to spend on behalf of `owner` through {transferFrom}. This is zero by default. This value changes when {approve} or {transferFrom} are called.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*Returns the amount of tokens owned by `account`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*Returns the amount of tokens in existence.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*Moves `amount` tokens from the caller's account to `recipient`. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*Moves `amount` tokens from `sender` to `recipient` using the allowance mechanism. `amount` is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*Interface for the optional metadata functions from the ERC20 standard. _Available since v4.1._*
## Methods
### allowance
```solidity
function allowance(address owner, address spender) external view returns (uint256)
```
*Returns the remaining number of tokens that `spender` will be allowed to spend on behalf of `owner` through {transferFrom}. This is zero by default. This value changes when {approve} or {transferFrom} are called.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*Returns the amount of tokens owned by `account`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### decimals
```solidity
function decimals() external view returns (uint8)
```
*Returns the decimals places of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint8 | undefined
### name
```solidity
function name() external view returns (string)
```
*Returns the name of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### symbol
```solidity
function symbol() external view returns (string)
```
*Returns the symbol of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*Returns the amount of tokens in existence.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*Moves `amount` tokens from the caller's account to `recipient`. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*Moves `amount` tokens from `sender` to `recipient` using the allowance mechanism. `amount` is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*deposit an amount of the ERC20 to the caller's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _amount | uint256 | Amount of the ERC20 to deposit
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*deposit an amount of ERC20 to a recipient's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _to | address | L2 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the L1 ERC20 token. This call will fail if the initialized withdrawal from L2 has not been finalized.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of L1 token to finalizeWithdrawal for.
| _l2Token | address | Address of L2 token where withdrawal was initiated.
| _from | address | L2 address initiating the transfer.
| _to | address | L1 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _data | bytes | Data provided by the sender on L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### l2TokenBridge
```solidity
function l2TokenBridge() external nonpayable returns (address)
```
*get the address of the corresponding L2 bridge contract.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address of the corresponding L2 bridge contract.
*deposit an amount of the ERC20 to the caller's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _amount | uint256 | Amount of the ERC20 to deposit
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*deposit an amount of ERC20 to a recipient's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _to | address | L2 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### depositETH
```solidity
function depositETH(uint32 _l2Gas, bytes _data) external payable
```
*Deposit an amount of the ETH to the caller's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### depositETHTo
```solidity
function depositETHTo(address _to, uint32 _l2Gas, bytes _data) external payable
```
*Deposit an amount of ETH to a recipient's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | L2 address to credit the withdrawal to.
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the L1 ERC20 token. This call will fail if the initialized withdrawal from L2 has not been finalized.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of L1 token to finalizeWithdrawal for.
| _l2Token | address | Address of L2 token where withdrawal was initiated.
| _from | address | L2 address initiating the transfer.
| _to | address | L1 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _data | bytes | Data provided by the sender on L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called before the withdrawal is finalized.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _from | address | L2 address initiating the transfer.
| _to | address | L1 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### l2TokenBridge
```solidity
function l2TokenBridge() external nonpayable returns (address)
```
*get the address of the corresponding L2 bridge contract.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address of the corresponding L2 bridge contract.
*Complete a deposit from L1 to L2, and credits funds to the recipient's balance of this L2 token. This call will fail if it did not originate from a corresponding deposit in L1StandardTokenBridge.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address for the l1 token this is called with
| _l2Token | address | Address for the l2 token this is called with
| _from | address | Account to pull the deposit from on L2.
| _to | address | Address to receive the withdrawal at
| _amount | uint256 | Amount of the token to withdraw
| _data | bytes | Data provider by the sender on L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### l1TokenBridge
```solidity
function l1TokenBridge() external nonpayable returns (address)
```
*get the address of the corresponding L1 bridge contract.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address of the corresponding L1 bridge contract.
*initiate a withdraw of some tokens to the caller's account on L1*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Token | address | Address of L2 token where withdrawal was initiated.
| _amount | uint256 | Amount of the token to withdraw. param _l1Gas Unused, but included for potential forward compatibility considerations.
| _l1Gas | uint32 | undefined
| _data | bytes | Optional data to forward to L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*initiate a withdraw of some token to a recipient's account on L1.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Token | address | Address of L2 token where withdrawal is initiated.
| _to | address | L1 adress to credit the withdrawal to.
| _amount | uint256 | Amount of the token to withdraw. param _l1Gas Unused, but included for potential forward compatibility considerations.
| _l1Gas | uint32 | undefined
| _data | bytes | Optional data to forward to L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
function allowance(address owner, address spender) external view returns (uint256)
```
*Returns the remaining number of tokens that `spender` will be allowed to spend on behalf of `owner` through {transferFrom}. This is zero by default. This value changes when {approve} or {transferFrom} are called.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*Returns the amount of tokens owned by `account`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### burn
```solidity
function burn(address _from, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _from | address | undefined
| _amount | uint256 | undefined
### l1Token
```solidity
function l1Token() external nonpayable returns (address)
```
...
...
@@ -177,319 +106,188 @@ function l1Token() external nonpayable returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### mint
```solidity
function mint(address _to, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | undefined
| _amount | uint256 | undefined
### supportsInterface
```solidity
function supportsInterface(bytes4 interfaceId) external view returns (bool)
```
*Returns true if this contract implements the interface defined by `interfaceId`. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] to learn more about how these ids are created. This function call must use less than 30 000 gas.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| interfaceId | bytes4 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*Returns the amount of tokens in existence.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*Moves `amount` tokens from the caller's account to `recipient`. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*Moves `amount` tokens from `sender` to `recipient` using the allowance mechanism. `amount` is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed behind a proxy. Since a proxied contract can't have a constructor, it's common to move constructor logic to an external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.*
*Basic ChugSplash proxy contract for L1. Very close to being a normal proxy but has added functions `setCode` and `setStorage` for changing the code or storage of the contract. Nifty! Note for future developers: do NOT make anything in this contract 'public' unless you know what you're doing. Anything public can potentially have a function signature that conflicts with a signature attached to the implementation contract. Public functions SHOULD always have the 'proxyCallIfNotOwner' modifier unless there's some *really* good reason not to have that modifier. And there almost certainly is not a good reason to not have that modifier. Beware!*
## Methods
### getImplementation
```solidity
function getImplementation() external nonpayable returns (address)
```
Queries the implementation address. Can only be called by the owner OR by making an eth_call and setting the "from" address to address(0).
...
...
@@ -30,27 +21,16 @@ Queries the implementation address. Can only be called by the owner OR by making
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Implementation address.
### getOwner
```solidity
function getOwner() external nonpayable returns (address)
```
Queries the owner of the proxy contract. Can only be called by the owner OR by making an eth_call and setting the "from" address to address(0).
...
...
@@ -58,108 +38,61 @@ Queries the owner of the proxy contract. Can only be called by the owner OR by m
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Owner address.
### setCode
```solidity
function setCode(bytes _code) external nonpayable
```
Sets the code that should be running behind this proxy. Note that this scheme is a bit different from the standard proxy scheme where one would typically deploy the code separately and then set the implementation address. We're doing it this way because it gives us a lot more freedom on the client side. Can only be triggered by the contract owner.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _code | bytes | New contract code to run inside this contract.
### setOwner
```solidity
function setOwner(address _owner) external nonpayable
```
Changes the owner of the proxy contract. Only callable by the owner.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _owner | address | New owner of the proxy contract.
### setStorage
```solidity
function setStorage(bytes32 _key, bytes32 _value) external nonpayable
```
Modifies some storage slot within the proxy contract. Gives us a lot of power to perform upgrades in a more transparent way. Only callable by the owner.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _key | bytes32 | Storage key to modify.
| _value | bytes32 | New value for the storage key.
*The L1 Cross Domain Messenger contract sends messages from L1 to L2, and relays messages from L2 onto L1. In the event that a message sent from L1 to L2 is rejected for exceeding the L2 epoch gas limit, it can be resubmitted via this contract's replay function.*
## Methods
### allowMessage
```solidity
function allowMessage(bytes32 _xDomainCalldataHash) external nonpayable
```
Allow a message.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _xDomainCalldataHash | bytes32 | Hash of the message to block.
### blockMessage
```solidity
function blockMessage(bytes32 _xDomainCalldataHash) external nonpayable
```
Block a message.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _xDomainCalldataHash | bytes32 | Hash of the message to block.
### blockedMessages
```solidity
function blockedMessages(bytes32) external view returns (bool)
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### initialize
```solidity
function initialize(address _libAddressManager) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _libAddressManager | address | Address of the Address Manager.
### libAddressManager
```solidity
function libAddressManager() external view returns (contract Lib_AddressManager)
| _message | bytes | Message to send to the target.
| _messageNonce | uint256 | Nonce for the provided message.
| _proof | IL1CrossDomainMessenger.L2MessageInclusionProof | Inclusion proof for the given message.
### relayedMessages
```solidity
function relayedMessages(bytes32) external view returns (bool)
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _0 | bytes32 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### renounceOwnership
```solidity
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.*
*The L1 ETH and ERC20 Bridge is a contract which stores deposited L1 funds and standard tokens that are in use on L2. It synchronizes a corresponding L2 Bridge, informing it of deposits and listening to it for newly finalized withdrawals.*
*deposit an amount of the ERC20 to the caller's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _amount | uint256 | Amount of the ERC20 to deposit
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*deposit an amount of ERC20 to a recipient's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of the L1 ERC20 we are depositing
| _l2Token | address | Address of the L1 respective L2 ERC20
| _to | address | L2 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### depositETH
```solidity
function depositETH(uint32 _l2Gas, bytes _data) external payable
```
*Deposit an amount of the ETH to the caller's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### depositETHTo
```solidity
function depositETHTo(address _to, uint32 _l2Gas, bytes _data) external payable
```
*Deposit an amount of ETH to a recipient's balance on L2.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | L2 address to credit the withdrawal to.
| _l2Gas | uint32 | Gas limit required to complete the deposit on L2.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### deposits
```solidity
function deposits(address, address) external view returns (uint256)
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
| _1 | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### donateETH
```solidity
function donateETH() external payable
```
*Adds ETH balance to the account. This is meant to allow for ETH to be migrated from an old gateway to a new gateway. NOTE: This is left for one upgrade only so we are able to receive the migrated ETH from the old contract*
*Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the L1 ERC20 token. This call will fail if the initialized withdrawal from L2 has not been finalized.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address of L1 token to finalizeWithdrawal for.
| _l2Token | address | Address of L2 token where withdrawal was initiated.
| _from | address | L2 address initiating the transfer.
| _to | address | L1 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _data | bytes | Data provided by the sender on L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called before the withdrawal is finalized.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _from | address | L2 address initiating the transfer.
| _to | address | L1 address to credit the withdrawal to.
| _amount | uint256 | Amount of the ERC20 to deposit.
| _data | bytes | Optional data to forward to L2. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### initialize
```solidity
function initialize(address _l1messenger, address _l2TokenBridge) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1messenger | address | L1 Messenger address being used for cross-chain communications.
| _l2TokenBridge | address | L2 standard bridge address.
### l2TokenBridge
```solidity
function l2TokenBridge() external view returns (address)
```
*get the address of the corresponding L2 bridge contract.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address of the corresponding L2 bridge contract.
### messenger
```solidity
function messenger() external view returns (address)
```
...
...
@@ -368,161 +205,95 @@ function messenger() external view returns (address)
*The L2 Standard bridge is a contract which works together with the L1 Standard bridge to enable ETH and ERC20 transitions between L1 and L2. This contract acts as a minter for new tokens when it hears about deposits into the L1 Standard bridge. This contract also acts as a burner of the tokens intended for withdrawal, informing the L1 bridge to release L1 funds.*
*Complete a deposit from L1 to L2, and credits funds to the recipient's balance of this L2 token. This call will fail if it did not originate from a corresponding deposit in L1StandardTokenBridge.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l1Token | address | Address for the l1 token this is called with
| _l2Token | address | Address for the l2 token this is called with
| _from | address | Account to pull the deposit from on L2.
| _to | address | Address to receive the withdrawal at
| _amount | uint256 | Amount of the token to withdraw
| _data | bytes | Data provider by the sender on L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
### l1TokenBridge
```solidity
function l1TokenBridge() external view returns (address)
```
*get the address of the corresponding L1 bridge contract.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address of the corresponding L1 bridge contract.
### messenger
```solidity
function messenger() external view returns (address)
```
...
...
@@ -100,209 +59,117 @@ function messenger() external view returns (address)
*initiate a withdraw of some tokens to the caller's account on L1*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Token | address | Address of L2 token where withdrawal was initiated.
| _amount | uint256 | Amount of the token to withdraw. param _l1Gas Unused, but included for potential forward compatibility considerations.
| _l1Gas | uint32 | undefined
| _data | bytes | Optional data to forward to L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
*initiate a withdraw of some token to a recipient's account on L1.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| _l2Token | address | Address of L2 token where withdrawal is initiated.
| _to | address | L1 adress to credit the withdrawal to.
| _amount | uint256 | Amount of the token to withdraw. param _l1Gas Unused, but included for potential forward compatibility considerations.
| _l1Gas | uint32 | undefined
| _data | bytes | Optional data to forward to L1. This data is provided solely as a convenience for external contracts. Aside from enforcing a maximum length, these contracts provide no guarantees about its content.
function allowance(address owner, address spender) external view returns (uint256)
```
*See {IERC20-allowance}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*See {IERC20-approve}. Requirements: - `spender` cannot be the zero address.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*See {IERC20-balanceOf}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### burn
```solidity
function burn(address _from, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _from | address | undefined
| _amount | uint256 | undefined
### decimals
```solidity
function decimals() external view returns (uint8)
```
*Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the value {ERC20} uses, unless this function is overridden; NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint8 | undefined
### decreaseAllowance
```solidity
function decreaseAllowance(address spender, uint256 subtractedValue) external nonpayable returns (bool)
```
*Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| subtractedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### increaseAllowance
```solidity
function increaseAllowance(address spender, uint256 addedValue) external nonpayable returns (bool)
```
*Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| addedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### l1Token
```solidity
function l1Token() external view returns (address)
```
...
...
@@ -285,27 +169,16 @@ function l1Token() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### l2Bridge
```solidity
function l2Bridge() external view returns (address)
```
...
...
@@ -313,375 +186,222 @@ function l2Bridge() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### mint
```solidity
function mint(address _to, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | undefined
| _amount | uint256 | undefined
### name
```solidity
function name() external view returns (string)
```
*Returns the name of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### supportsInterface
```solidity
function supportsInterface(bytes4 _interfaceId) external pure returns (bool)
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _interfaceId | bytes4 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### symbol
```solidity
function symbol() external view returns (string)
```
*Returns the symbol of the token, usually a shorter version of the name.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*See {IERC20-totalSupply}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*See {IERC20-transfer}. Requirements: - `recipient` cannot be the zero address. - the caller must have a balance of at least `amount`.*
*See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. Requirements: - `sender` and `recipient` cannot be the zero address. - `sender` must have a balance of at least `amount`. - the caller must have allowance for ``sender``'s tokens of at least `amount`.*
function getAddress(string _name) external view returns (address)
```
Retrieves the address associated with a given name.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _name | string | Name to retrieve an address for.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | Address associated with the given name.
### owner
```solidity
function owner() external view returns (address)
```
*Returns the address of the current owner.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### renounceOwnership
```solidity
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.*
### setAddress
```solidity
function setAddress(string _name, address _address) external nonpayable
```
Changes the address associated with a particular name.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _name | string | String name to associate an address with.
| _address | address | Address to associate with the name.
### transferOwnership
```solidity
function transferOwnership(address newOwner) external nonpayable
```
*Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.*
*This library implements a bytes32 storage array with some additional gas-optimized functionality. In particular, it encodes its length as a uint40, and tightly packs this with an overwritable "extra data" field so we can store more information with a single SSTORE.*
*The Deployer Whitelist is a temporary predeploy used to provide additional safety during the initial phases of our mainnet roll out. It is owned by the Optimism team, and defines accounts which are allowed to deploy contracts on Layer2. The Execution Manager will only allow an ovmCREATE or ovmCREATE2 operation to proceed if the deployer's address whitelisted.*
## Methods
### enableArbitraryContractDeployment
```solidity
function enableArbitraryContractDeployment() external nonpayable
```
Permanently enables arbitrary contract deployment and deletes the owner.
...
...
@@ -30,54 +21,32 @@ Permanently enables arbitrary contract deployment and deletes the owner.
### isDeployerAllowed
```solidity
function isDeployerAllowed(address _deployer) external view returns (bool)
```
Checks whether an address is allowed to deploy contracts.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _deployer | address | Address to check.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | _allowed Whether or not the address can deploy contracts.
### owner
```solidity
function owner() external view returns (address)
```
...
...
@@ -85,202 +54,120 @@ function owner() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### setOwner
```solidity
function setOwner(address _owner) external nonpayable
```
Updates the owner of this contract.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _owner | address | Address of the new owner.
### setWhitelistedDeployer
```solidity
function setWhitelistedDeployer(address _deployer, bool _isWhitelisted) external nonpayable
```
Adds or removes an address from the deployment whitelist.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _deployer | address | Address to update permissions for.
| _isWhitelisted | bool | Whether or not the address is whitelisted.
### whitelist
```solidity
function whitelist(address) external view returns (bool)
*The ETH predeploy provides an ERC20 interface for ETH deposited to Layer 2. Note that unlike on Layer 1, Layer 2 accounts do not have a balance field.*
## Methods
### allowance
```solidity
function allowance(address owner, address spender) external view returns (uint256)
```
*See {IERC20-allowance}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | undefined
| spender | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### approve
```solidity
function approve(address spender, uint256 amount) external nonpayable returns (bool)
```
*Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| amount | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### balanceOf
```solidity
function balanceOf(address account) external view returns (uint256)
```
*See {IERC20-balanceOf}.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| account | address | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### burn
```solidity
function burn(address _from, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _from | address | undefined
| _amount | uint256 | undefined
### decimals
```solidity
function decimals() external view returns (uint8)
```
*Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the value {ERC20} uses, unless this function is overridden; NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint8 | undefined
### decreaseAllowance
```solidity
function decreaseAllowance(address spender, uint256 subtractedValue) external nonpayable returns (bool)
```
*Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| subtractedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### increaseAllowance
```solidity
function increaseAllowance(address spender, uint256 addedValue) external nonpayable returns (bool)
```
*Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.*
#### Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | undefined
| addedValue | uint256 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### l1Token
```solidity
function l1Token() external view returns (address)
```
...
...
@@ -285,27 +169,16 @@ function l1Token() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### l2Bridge
```solidity
function l2Bridge() external view returns (address)
```
...
...
@@ -313,375 +186,222 @@ function l2Bridge() external view returns (address)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### mint
```solidity
function mint(address _to, uint256 _amount) external nonpayable
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | undefined
| _amount | uint256 | undefined
### name
```solidity
function name() external view returns (string)
```
*Returns the name of the token.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### supportsInterface
```solidity
function supportsInterface(bytes4 _interfaceId) external pure returns (bool)
```
#### Parameters
| Name | Type | Description |
|---|---|---|
| _interfaceId | bytes4 | undefined
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
### symbol
```solidity
function symbol() external view returns (string)
```
*Returns the symbol of the token, usually a shorter version of the name.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | string | undefined
### totalSupply
```solidity
function totalSupply() external view returns (uint256)
```
*See {IERC20-totalSupply}.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### transfer
```solidity
function transfer(address recipient, uint256 amount) external nonpayable returns (bool)
```
*Moves `amount` tokens from the caller's account to `recipient`. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*Moves `amount` tokens from `sender` to `recipient` using the allowance mechanism. `amount` is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.*
*This contract exposes the current l2 gas price, a measure of how congested the network currently is. This measure is used by the Sequencer to determine what fee to charge for transactions. When the system is more congested, the l2 gas price will increase and fees will also increase as a result. All public variables are set while generating the initial L2 state. The constructor doesn't run in practice as the L2 state generation script uses the deployed bytecode instead of running the initcode.*
## Methods
### decimals
```solidity
function decimals() external view returns (uint256)
```
...
...
@@ -30,27 +21,16 @@ function decimals() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### gasPrice
```solidity
function gasPrice() external view returns (uint256)
```
...
...
@@ -58,101 +38,60 @@ function gasPrice() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### getL1Fee
```solidity
function getL1Fee(bytes _data) external view returns (uint256)
```
Computes the L1 portion of the fee based on the size of the RLP encoded tx and the current l1BaseFee
| _0 | uint256 | L1 fee that should be paid for the tx
### getL1GasUsed
```solidity
function getL1GasUsed(bytes _data) external view returns (uint256)
```
Computes the amount of L1 gas used for a transaction The overhead represents the per batch gas overhead of posting both transaction and state roots to L1 given larger batch sizes. 4 gas for 0 byte https://github.com/ethereum/go-ethereum/blob/9ada4a2e2c415e6b0b51c50e901336872e028872/params/protocol_params.go#L33 16 gas for non zero byte https://github.com/ethereum/go-ethereum/blob/9ada4a2e2c415e6b0b51c50e901336872e028872/params/protocol_params.go#L87 This will need to be updated if calldata gas prices change Account for the transaction being unsigned Padding is added to account for lack of signature on transaction 1 byte for RLP V prefix 1 byte for V 1 byte for RLP R prefix 32 bytes for R 1 byte for RLP S prefix 32 bytes for S Total: 68 bytes of padding
| _0 | uint256 | Amount of L1 gas used for a transaction
### l1BaseFee
```solidity
function l1BaseFee() external view returns (uint256)
```
...
...
@@ -160,27 +99,16 @@ function l1BaseFee() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### overhead
```solidity
function overhead() external view returns (uint256)
```
...
...
@@ -188,73 +116,44 @@ function overhead() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### owner
```solidity
function owner() external view returns (address)
```
*Returns the address of the current owner.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### renounceOwnership
```solidity
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.*
### scalar
```solidity
function scalar() external view returns (uint256)
```
...
...
@@ -262,343 +161,208 @@ function scalar() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### setDecimals
```solidity
function setDecimals(uint256 _decimals) external nonpayable
```
Allows the owner to modify the decimals.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _decimals | uint256 | New decimals
### setGasPrice
```solidity
function setGasPrice(uint256 _gasPrice) external nonpayable
```
Allows the owner to modify the l2 gas price.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _gasPrice | uint256 | New l2 gas price.
### setL1BaseFee
```solidity
function setL1BaseFee(uint256 _baseFee) external nonpayable
```
Allows the owner to modify the l1 base fee.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _baseFee | uint256 | New l1 base fee
### setOverhead
```solidity
function setOverhead(uint256 _overhead) external nonpayable
```
Allows the owner to modify the overhead.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _overhead | uint256 | New overhead
### setScalar
```solidity
function setScalar(uint256 _scalar) external nonpayable
```
Allows the owner to modify the scalar.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _scalar | uint256 | New scalar
### transferOwnership
```solidity
function transferOwnership(address newOwner) external nonpayable
```
*Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.*
*The L2 to L1 Message Passer is a utility contract which facilitate an L1 proof of the of a message on L2. The L1 Cross Domain Messenger performs this proof in its _verifyStorageProof function, which verifies the existence of the transaction hash in this contract's `sentMessages` mapping.*
## Methods
### passMessageToL1
```solidity
function passMessageToL1(bytes _message) external nonpayable
```
Passes a message to L1.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _message | bytes | Message to pass to L1.
### sentMessages
```solidity
function sentMessages(bytes32) external view returns (bool)
*Contract module which provides a basic access control mechanism, where there is an account (an owner) that can be granted exclusive access to specific functions. By default, the owner account will be the one that deploys the contract. This can later be changed with {transferOwnership}. This module is used through inheritance. It will make available the modifier `onlyOwner`, which can be applied to your functions to restrict their use to the owner.*
## Methods
### owner
```solidity
function owner() external view returns (address)
```
*Returns the address of the current owner.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### renounceOwnership
```solidity
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.*
### transferOwnership
```solidity
function transferOwnership(address newOwner) external nonpayable
```
*Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.*
*Contract module which provides a basic access control mechanism, where there is an account (an owner) that can be granted exclusive access to specific functions. By default, the owner account will be the one that deploys the contract. This can later be changed with {transferOwnership}. This module is used through inheritance. It will make available the modifier `onlyOwner`, which can be applied to your functions to restrict their use to the owner.*
## Methods
### owner
```solidity
function owner() external view returns (address)
```
*Returns the address of the current owner.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | address | undefined
### renounceOwnership
```solidity
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.*
### transferOwnership
```solidity
function transferOwnership(address newOwner) external nonpayable
```
*Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.*
*Contract module which allows children to implement an emergency stop mechanism that can be triggered by an authorized account. This module is used through inheritance. It will make available the modifiers `whenNotPaused` and `whenPaused`, which can be applied to the functions of your contract. Note that they will not be pausable by simply including this module, only once the modifiers are put in place.*
## Methods
### paused
```solidity
function paused() external view returns (bool)
```
*Returns true if the contract is paused, and false otherwise.*
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | bool | undefined
## Events
### Paused
```solidity
event Paused(address account)
```
*Emitted when the pause is triggered by `account`.*
*Contract module that helps prevent reentrant calls to a function. Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier available, which can be applied to functions to make sure there are no nested (reentrant) calls to them. Note that because there is a single `nonReentrant` guard, functions marked as `nonReentrant` may not call one another. This can be worked around by making those functions `private`, and then adding `external` `nonReentrant` entry points to them. TIP: If you would like to learn more about reentrancy and alternative ways to protect against it, check out our blog post https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].*
*Wrappers around ERC20 operations that throw on failure (when the token contract returns false). Tokens that return no value (and instead revert or throw on failure) are also supported, non-reverting calls are assumed to be successful. To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, which allows you to call the safe operations as `token.safeTransfer(...)`, etc.*
*The State Commitment Chain (SCC) contract contains a list of proposed state roots which Proposers assert to be a result of each transaction in the Canonical Transaction Chain (CTC). Elements here have a 1:1 correspondence with transactions in the CTC, and should be the unique state root calculated off-chain by applying the canonical transactions one by one.*
## Methods
### FRAUD_PROOF_WINDOW
```solidity
function FRAUD_PROOF_WINDOW() external view returns (uint256)
```
...
...
@@ -30,27 +21,16 @@ function FRAUD_PROOF_WINDOW() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### SEQUENCER_PUBLISH_WINDOW
```solidity
function SEQUENCER_PUBLISH_WINDOW() external view returns (uint256)
```
...
...
@@ -58,57 +38,33 @@ function SEQUENCER_PUBLISH_WINDOW() external view returns (uint256)
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | uint256 | undefined
### appendStateBatch
```solidity
function appendStateBatch(bytes32[] _batch, uint256 _shouldStartAtElement) external nonpayable
```
Appends a batch of state roots to the chain.
#### Parameters
| Name | Type | Description |
|---|---|---|
| _batch | bytes32[] | Batch of state roots.
| _shouldStartAtElement | uint256 | Index of the element at which this batch should start.
### batches
```solidity
function batches() external view returns (contract IChainStorageContainer)
```
Accesses the batch storage container.
...
...
@@ -116,33 +72,19 @@ Accesses the batch storage container.
#### Returns
| Name | Type | Description |
|---|---|---|
| _0 | contract IChainStorageContainer | Reference to the batch storage container.
### deleteStateBatch
```solidity
function deleteStateBatch(Lib_OVMCodec.ChainBatchHeader _batchHeader) external nonpayable
```
Deletes all state roots after (and including) a given batch.
...
...
@@ -150,20 +92,12 @@ function deleteStateBatch(Lib_OVMCodec.ChainBatchHeader _batchHeader) external n
