From 0b6236ace241fbe4405b71d74d1ec8f07e46dedc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Claudio=20Nale?= Date: Mon, 14 Oct 2024 11:50:49 -0300 Subject: [PATCH 1/2] deployment: playbook template --- deployment/deployment-playbook.md | 35 +++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 deployment/deployment-playbook.md diff --git a/deployment/deployment-playbook.md b/deployment/deployment-playbook.md new file mode 100644 index 00000000..d9397a63 --- /dev/null +++ b/deployment/deployment-playbook.md @@ -0,0 +1,35 @@ +# Build Solana and EVM contracts + +1. Change directory to root of TBRv3 repository. +2. Run `git checkout 97834ccdddd492bd250c1ff1d0b7eb215434794e` +3. Run `yarn` to link dependencies +4. Bring submodules with ```git submodule update --init --recursive``` +5. Clean with `yarn clean` +6. Ensure you have the following: + - rustc v1.81.0 + - Solana v1.18.23 + - Anchor v0.30.1 + - Foundry tag nightly-fd565286372b42a19b22d6a756e59a1b60a4135c +7. Choose one: + - Build for mainnet with `yarn build:all-mainnet` + - Build for testnet with `yarn build:all-devnet` +8. Run contract tests: + - `yarn ./evm test ` + - `yarn ./solana test` +9. Typecheck deployment scripts with `yarn ./deployment test:build` + +After running, you should be ready to execute the deployment if no errors occurred. Otherwise, fix the errors and start again. + + +# Deploy EVM on testnet + +1. Make sure you built both Solana and EVM contracts following above instructions first. +2. Change directory to root of TBRv3 repository. +3. Update or create `./deployment/config/testnet/key.env` with deployment key. +4. Adjust `./deployment/config/testnet/ecosystem.json` with desired operating chains. +5. Execute +```shell +cd deployment +source ./evm/testnet.env && yarn tsx ./evm/deploy.ts +``` +6. Register peers with `source ./evm/testnet.env && yarn tsx ./evm/register-peers.ts` \ No newline at end of file From e482147ae73fb10a0535b4df0ee02096dce96ebd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Hern=C3=A1n=20Di=20Pietro?= Date: Mon, 14 Oct 2024 16:45:57 -0300 Subject: [PATCH 2/2] Update deployment-playbook.md --- deployment/deployment-playbook.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/deployment/deployment-playbook.md b/deployment/deployment-playbook.md index d9397a63..16d51ccc 100644 --- a/deployment/deployment-playbook.md +++ b/deployment/deployment-playbook.md @@ -27,9 +27,10 @@ After running, you should be ready to execute the deployment if no errors occurr 2. Change directory to root of TBRv3 repository. 3. Update or create `./deployment/config/testnet/key.env` with deployment key. 4. Adjust `./deployment/config/testnet/ecosystem.json` with desired operating chains. -5. Execute +5. Export ENV=testnet +6. Execute ```shell cd deployment -source ./evm/testnet.env && yarn tsx ./evm/deploy.ts +source ./config/testnet/key.env && yarn tsx ./evm/deploy.ts ``` -6. Register peers with `source ./evm/testnet.env && yarn tsx ./evm/register-peers.ts` \ No newline at end of file +6. Register peers with `source ./config/testnet/key.env && yarn tsx ./evm/register-peers.ts`