Skip to content

Commit 7eea088

Browse files
committed
adding additional deployment configuration details
1 parent 8570d17 commit 7eea088

File tree

1 file changed

+49
-20
lines changed
  • pages/builders/chain-operators/configuration

1 file changed

+49
-20
lines changed

pages/builders/chain-operators/configuration/rollup.mdx

+49-20
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,10 @@ Optimism repository. You can see example configurations in the
2525
this [governance thread](https://gov.optimism.io/t/season-6-draft-standard-rollup-charter/8135).
2626
</Callout>
2727

28-
## Configuration Values
28+
## Deployment Configuration Values
29+
30+
These values are provided to the deployment configuration JSON file when
31+
deploying the L1 contracts.
2932

3033
### Offset Values
3134

@@ -40,6 +43,7 @@ disable Regolith.
4043

4144
* **Type:** Number of seconds
4245
* **Default:** nil
46+
* **Recommended value:** "0x0"
4347

4448
***
4549

@@ -51,6 +55,7 @@ disable Canyon.
5155

5256
* **Type:** Number of seconds
5357
* **Default:** nil
58+
* **Recommended value:** "0x0"
5459

5560
***
5661

@@ -62,6 +67,7 @@ Delta.
6267

6368
* **Type:** Number of seconds
6469
* **Default:** nil
70+
* **Recommended value:** "0x0"
6571

6672
***
6773

@@ -73,6 +79,7 @@ Ecotone.
7379

7480
* **Type:** Number of seconds
7581
* **Default:** nil
82+
* **Recommended value:** "0x0"
7683

7784
***
7885

@@ -84,6 +91,7 @@ disable Fjord.
8491

8592
* **Type:** Number of seconds
8693
* **Default:** nil
94+
* **Recommended value:** "0x0"
8795

8896
***
8997

@@ -229,7 +237,7 @@ information in L1 block n must be incorporated by L1 block n+10.
229237

230238
* **Type:** Number of blocks
231239
* **Default value:** None
232-
* **Notes:* Must not be `0`. 3600 (12 hours) is suggested.
240+
* **Notes:** Must not be `0`. 3600 (12 hours) is suggested.
233241
* **Standard Config Requirement:** 3\_600 base layer blocks (12 hours for an
234242
L2 on Ethereum, assuming 12 second L1 blocktime). This is an important value
235243
for constraining the sequencer's ability to re-order transactions; higher
@@ -265,9 +273,14 @@ Address that Sequencer transaction batches are sent to on L1.
265273

266274
* **Type:** L1 Address
267275
* **Default value:** None
268-
* **Standard Config Requirement:** Current convention is
269-
`0xff000...000{chainId}`.
270-
276+
* **Standard Config Requirement:** Convention is `versionByte` || `keccak256(bytes32(chainId))[:19]`, where || denotes concatenation, `versionByte` is `0x00`, and `chainId` is a `uint256`.
277+
This is to cover the full range of chain ids, to the full `uint256` size. Here's how you can get this address:
278+
```solidity
279+
bytes32 hash = keccak256(abi.encodePacked(bytes32(uint256(chainId))));
280+
# [:19] means taking the first 19 bytes of the hash
281+
# then preppending a version byte of zero: 0x00
282+
# `0x00{hash[:19]}`
283+
```
271284
***
272285

273286
#### batchSenderAddress
@@ -305,7 +318,7 @@ It is generally recommended to use a finalized block to avoid issues with reorgs
305318

306319
* **Type:** Block hash
307320
* **Default value:** None
308-
* **Notes:* Must not be `0`.
321+
* **Notes:** Must not be `0`.
309322

310323
***
311324

@@ -315,7 +328,7 @@ Chain ID of the L1 chain.
315328

316329
* **Type:** Number
317330
* **Default value:** None
318-
* **Notes:* Must not be `0`. 1 for L1 Ethereum mainnet, 11155111 for the
331+
* **Notes:** Must not be `0`. 1 for L1 Ethereum mainnet, 11155111 for the
319332
Sepolia test network, and See [here](https://chainlist.org/?testnets=true)
320333
for other blockchains.
321334

@@ -327,7 +340,7 @@ Chain ID of the L2 chain.
327340

328341
* **Type:** Number
329342
* **Default value:** None
330-
* **Notes:* Must not be `0`. For security reasons, should be unique.
343+
* **Notes:** Must not be `0`. For security reasons, should be unique.
331344
* **Standard Config Requirement:** Foundation-approved, globally unique value
332345

333346
***
@@ -361,13 +374,29 @@ SuperchainConfig. Has the ability to pause withdrawals.
361374
operators are driven to maintain a stable and reliable chain. When considering
362375
a change to this value, careful deliberation is necessary.
363376

377+
#### l2GenesisBlockGasLimit
378+
379+
L2GenesisBlockGasLimit represents the chain's block gas limit.
380+
381+
* **Type:** Number
382+
* **Default value:** None
383+
* **Notes:** Must not be `0`. Must be greater than `MaxResourceLimit` + `SystemTxMaxGas`.
384+
385+
#### l2GenesisBlockBaseFeePerGas
386+
387+
L2GenesisBlockBaseFeePerGas represents the base fee per gas.
388+
389+
* **Type:** Number
390+
* **Default value:** None
391+
* **Notes:** L2 genesis block base fee per gas cannot be `nil`.
392+
364393
#### eip1559Elasticity
365394

366395
EIP1559Elasticity is the elasticity of the EIP1559 fee market.
367396

368397
* **Type:** Number
369398
* **Default value:** None
370-
* **Notes:* Must not be `0`.
399+
* **Notes:** Must not be `0`.
371400

372401
***
373402

@@ -377,7 +406,7 @@ EIP1559Denominator is the denominator of EIP1559 base fee market.
377406

378407
* **Type:** Number
379408
* **Default value:** None
380-
* **Notes:* Must not be `0`.
409+
* **Notes:** Must not be `0`.
381410

382411
***
383412

@@ -388,7 +417,7 @@ Canyon is active.
388417

389418
* **Type:** Number
390419
* **Default value:** None
391-
* **Notes:* Must not be `0` if Canyon is activated.
420+
* **Notes:** Must not be `0` if Canyon is activated.
392421

393422
***
394423

@@ -399,7 +428,7 @@ for fee calculations.
399428

400429
* **Type:** Number
401430
* **Default value:** None
402-
* **Notes:* Should not be `0`.
431+
* **Notes:** Should not be `0`.
403432

404433
***
405434

@@ -410,7 +439,7 @@ scalar used for fee calculations.
410439

411440
* **Type:** Number
412441
* **Default value:** None
413-
* **Notes:* Should not be `0`.
442+
* **Notes:** Should not be `0`.
414443

415444
***
416445

@@ -429,7 +458,7 @@ proposals.
429458

430459
* **Type:** Number
431460
* **Default value:** None
432-
* **Notes:* Should be `0` for new chains.
461+
* **Notes:** Should be `0` for new chains.
433462

434463
***
435464

@@ -441,7 +470,7 @@ addition of permissionless proposals.
441470

442471
* **Type:** Number
443472
* **Default value:** None
444-
* **Notes:* his MUST be the timestamp corresponding to the block defined by
473+
* **Notes:** his MUST be the timestamp corresponding to the block defined by
445474
the l1StartingBlockTag.
446475

447476
***
@@ -453,7 +482,7 @@ the addition of permissionless proposals.
453482

454483
* **Type:** Number of blocks
455484
* **Default value:** None
456-
* **Notes:* Must not be `0`. 120 (4 minutes) is suggested.
485+
* **Notes:** Must not be `0`. 120 (4 minutes) is suggested.
457486

458487
***
459488

@@ -464,7 +493,7 @@ considered finalized by the OptimismPortal contract.
464493

465494
* **Type:** Number of seconds
466495
* **Default value:** None
467-
* **Notes:* Must not be `0`. Recommend 12 on test networks, seven days on
496+
* **Notes:** Must not be `0`. Recommend 12 on test networks, seven days on
468497
production ones.
469498
* **Standard Config Requirement:** 7 days. High security. Excessively safe
470499
upper bound that leaves enough time to consider social layer solutions to a
@@ -730,7 +759,7 @@ before it can be used to finalize a withdrawal.
730759

731760
* **Type:** Number
732761
* **Default value:** None
733-
* **Notes:* Should not be `0`.
762+
* **Notes:** Should not be `0`.
734763

735764
***
736765

@@ -741,7 +770,7 @@ game must wait before it can be used to finalize a withdrawal.
741770

742771
* **Type:** Number
743772
* **Default value:** None
744-
* **Notes:* Should not be `0`.
773+
* **Notes:** Should not be `0`.
745774

746775
***
747776

@@ -762,7 +791,7 @@ instead of the older output oracle mechanism.
762791

763792
* **Type:** Boolean
764793
* **Default value:** None
765-
* **Notes:* You should understand the implications of running a Fault Proof
794+
* **Notes:** You should understand the implications of running a Fault Proof
766795
chain.
767796

768797
***

0 commit comments

Comments
 (0)