Skip to content

Commit

Permalink
docs: add env instruction
Browse files Browse the repository at this point in the history
  • Loading branch information
gzeoneth committed Aug 20, 2024
1 parent 9e73bef commit 7005cbc
Show file tree
Hide file tree
Showing 7 changed files with 22 additions and 1 deletion.
3 changes: 3 additions & 0 deletions scripts/foundry/arbos-upgrades/at-timestamp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ forge script --sender $DEPLOYER --rpc-url $CHILD_CHAIN_RPC --broadcast --slow ./
```
This would deploy the upgrade action. Update your .env file with the address of the upgrade action.

> [!CAUTION]
> The .env file must be in project root.
2. Next step is to execute the ArbOs upgrade action. Assumption is that child chain UpgradeExecutor is the arbowner, and there is an EOA which has executor rights on the child chain UpgradeExecutor. Upgrade can be executed using `cast` CLI command (part of Foundry installation), using the owner account (the one with executor rights on child chain UpgradeExecutor) to send the transaction:
```bash
(export $(cat .env | xargs) && cast send $CHILD_UPGRADE_EXECUTOR_ADDRESS "execute(address, bytes)" $UPGRADE_ACTION_ADDRESS $(cast calldata "perform()") --rpc-url $CHILD_CHAIN_RPC --account EXECUTOR)
Expand Down
3 changes: 3 additions & 0 deletions scripts/foundry/contract-upgrades/1.2.1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,9 @@ Please refers to the top [README](../../README.md) `Check Version and Upgrade Pa

1. Setup .env according to the example files, make sure you have everything correctly defined. The script do some sanity checks but not everything can be checked.

> [!CAUTION]
> The .env file must be in project root.
2. (Skip this step if you can use the deployed instances of action contract)
`DeployNitroContracts1Point2Point1UpgradeAction.s.sol` script deploys OSPs and ChallengeManager templates, blob reader and SequencerInbox template, and finally the upgrade action itself. It can be executed in this directory like this:
```bash
Expand Down
5 changes: 4 additions & 1 deletion scripts/foundry/contract-upgrades/2.1.0/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,10 @@ Also, expectation is that rollup being upgraded currently uses official ArbOS20

## How to use it

1. Setup .env according to the example files, make sure you have everything correctly defined. The script will do some sanity checks but not everything can be checked.
1. Setup .env according to the example files, make sure you have everything correctly defined. The script will do some sanity checks but not everything can be checked. The .env file must be in project root for recent foundary versions.

> [!CAUTION]
> The .env file must be in project root.
2. (Skip this step if you can use the deployed instances of action contract)
`DeployNitroContracts2Point1Point0UpgradeActionScript.s.sol` script deploys templates, and upgrade action itself. It can be executed in this directory like this:
Expand Down
3 changes: 3 additions & 0 deletions scripts/foundry/creator-upgrades/1.2.1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@ This script is used to deploy new 1.2.1 templates (if not already deployed) and

1. Setup .env according to the example files, make sure you have everything correctly defined. The script do some sanity checks but not everything can be checked. Template addresses should be set to address zero if they're supposed to be deployed. If templates are already deployed, provide the respective addresses.

> [!CAUTION]
> The .env file must be in project root.
2.
`UpgradeCreatorTemplatesScript.s.sol` script deploys templates if necessary and updates the creators if possible. RollupCreator and BridgeCreator will be updated if `CREATOR_OWNER_IS_MULTISIG` is set to false and wallet running the script is the owner, otherwise the update calldatas will be generated and stored in `${root}/scripts/foundry/creator-upgrades1.2.1/output/${chainId}.json`.

Expand Down
3 changes: 3 additions & 0 deletions scripts/foundry/creator-upgrades/1.2.2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,9 @@ This script is used to deploy new token bridge creator 1.2.2 logic contracts (L1

Prepare the .env file according to the templates.

> [!CAUTION]
> The .env file must be in project root.
Script can be simulated in this directory like this (note that you may need to create the output directory `mkdir -p output`):

```bash
Expand Down
3 changes: 3 additions & 0 deletions scripts/foundry/fast-confirm/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,9 @@ Please refer to the top [README](../../README.md) `Check Version and Upgrade Pat
## How to use it
1. Setup .env according to the example files, make sure your fast confirm committee is secure (it should match your DAS committee). See the previous section for predeployed instances of the action contract. If you need to deploy the action contract yourself, follow the steps below.

> [!CAUTION]
> The .env file must be in project root.
`DeployEnableFastConfirmAction.s.s.sol` script deploys `EnableFastConfirmAction` contract. It can be executed in this directory like this:
```bash
forge script --sender $DEPLOYER --rpc-url $PARENT_CHAIN_RPC --broadcast --slow DeployEnableFastConfirmAction -vvv --verify
Expand Down
3 changes: 3 additions & 0 deletions scripts/foundry/stylus/setCacheManager/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,9 @@ This script empowers `AddWasmCacheManagerAction` contract which enables CacheMan

1. Setup .env according to the example files, make sure you provide correct values. You can use default values for `INIT_CACHE_SIZE` and `INIT_DECAY`.

> [!CAUTION]
> The .env file must be in project root.
`DeployAddWasmCacheManagerAction.s.sol` script deploys `AddWasmCacheManagerAction` contract. It can be executed in this directory like this:

```bash
Expand Down

0 comments on commit 7005cbc

Please sign in to comment.