docs: upgrade docs [WIP]

Author: JuArce

docs/0_internal/0_guides.md

@@ -2,12 +2,6 @@
 
 This guide will walk you through the deployment of the Aligned Layer contracts.
 
-## Prerequisites
-
-- Clone the repository
-   ```
-   git clone https://github.com/yetanotherco/aligned_layer.git
-   ```
 
 ## Setup
 
@@ -19,3 +13,6 @@ This guide will walk you through the deployment of the Aligned Layer contracts.
 
     After finishing the deployment, you will have the deployed contract addresses.
 
+3. Once you have deployed the Aligned contracts, you can perform upgrades on them.
+
+    a. If you are not using a Multisig wallet, you can follow the [Upgrade Guide](./3_a_upgrade_contracts.md).

docs/0_internal/2_deploy_contracts.md

@@ -4,6 +4,21 @@ This guide will walk you through the deployment of the Aligned Layer contracts.
 
 Also, you will be able to deploy the Batch Payment Service contract.
 
+## Prerequisites
+
+- You need to have installed git and make.
+
+- Clone the repository
+   ```
+   git clone https://github.com/yetanotherco/aligned_layer.git
+   ```
+
+- Install foundry
+    ```shell
+    make install_foundry
+    foundryup -v nightly-a428ba6ad8856611339a6319290aade3347d25d9
+    ```
+
 ## Eigenlayer Contracts
 
 To deploy Aligned contracts, you need previously deployed EigenLayer contracts.
@@ -175,7 +190,7 @@ For the batcher payment service, you can set the Multisig address in the `owner`
 
 ### Deploy the contracts
 
-Once you have configured the `.env` and `DEPLOY_CONFIG_PATH` files, you can run the following command:
+Once you have configured the `.env` and `BATCHER_PAYMENT_SERVICE_CONFIG_PATH` files, you can run the following command:
 
 ```bash
 make deploy_batcher_payment_service

docs/0_internal/3_a_upgrade_contracts.md

@@ -0,0 +1,45 @@
+# Upgrade Contracts
+
+This guide is for upgrading contracts deployed without a multisig wallet. If you deployed the contract using a Multisig wallet, you can follow the [Upgrade Contracts with Multisig](./3_b_upgrade_contracts_with_multisig.md) tutorial.
+
+## Prerequisites
+
+- To upgrade any of the contracts, you need to have set the `.env`, `DEPLOY_CONFIG_PATH` and `BATCHER_PAYMENT_SERVICE_CONFIG_PATH`
+
+- You need to have installed git and make.
+
+- Clone the repository
+   ```
+   git clone https://github.com/yetanotherco/aligned_layer.git
+   ```
+
+- Install foundry
+    ```shell
+    make install_foundry
+    foundryup -v nightly-a428ba6ad8856611339a6319290aade3347d25d9
+    ```
+
+## Upgrade Service Manager
+
+To upgrade the Service Manager Contract, run:
+
+```bash
+make upgrade_aligned_contracts
+```
+
+## Upgrade Registry Coordinator
+
+To upgrade the Registry Coordinator, run:
+
+```bash
+make upgrade_registry_coordinator
+```
+
+## Upgrade Batcher Payment Service
+
+To upgrade the Batcher Payment Service, run:
+
+```bash
+make upgrade_batcher_payment_service
+```
+

docs/0_internal/3_b_1_deploy_new_impl.md

@@ -0,0 +1,3 @@
+# Deploy New Implementation
+
+

docs/0_internal/3_b_2_propose_upgrade.md

@@ -0,0 +1,39 @@
+# Upgrade Contracts using a Multisig
+
+> [!WARNING]  
+> Safe Multisig Wallet is not currently supported in Holesky Testnet.
+> For this reason, we deployed EigenLayer contracts in Sepolia to test the upgrade on AlignedLayer Contracts.
+
+> [!NOTE]
+> EigenLayer Sepolia contracts information is available in `contracts/script/output/sepolia/eigenlayer_deployment_output.json`.
+
+> [!NOTE]
+> You can find a guide on how to Deploy the contracts [here](./2_deploy_contracts.md).
+
+
+This guide is for upgrading contracts deployed using a Multisig wallet. If you deployed the contract without a Multisig wallet, you can follow the [Upgrade Contracts](./3_a_upgrade_contracts.md) tutorial.
+
+In this guide we make an upgrade of Aligned Layer Service Manager contract using a multisig wallet. This is important to ensure not one party can do an upgrade, and helps ensure the team is not locked out of upgrading the network due to a loss of keys.
+
+## Prerequisites
+
+- To upgrade any of the contracts, you need to have set the `.env`, `DEPLOY_CONFIG_PATH` and `BATCHER_PAYMENT_SERVICE_CONFIG_PATH`
+
+- You need to have installed git and make.
+
+- Clone the repository
+   ```
+   git clone https://github.com/yetanotherco/aligned_layer.git
+   ```
+
+- Install foundry
+    ```shell
+    make install_foundry
+    foundryup -v nightly-a428ba6ad8856611339a6319290aade3347d25d9
+    ```
+
+## Deploy the new implementation
+
+The first step is to deploy the new implementation of the contract. 
+
+You need to