chore: update readme

Signed-off-by: Tomás Migone <[email protected]>

Author: tmigone

packages/horizon/README.md

@@ -9,10 +9,7 @@ The following environment variables might be required:
 | Variable | Description |
 |----------|-------------|
 | `ARBISCAN_API_KEY` | Arbiscan API key |
-| `DEPLOYER_PRIVATE_KEY` | Deployer private key - for testnet deployments |
-| `GOVERNOR_PRIVATE_KEY` | Governor private key - for testnet deployments |
 | `ARBITRUM_SEPOLIA_RPC` | Arbitrum Sepolia RPC URL |
-| `VIRTUAL_ARBITRUM_SEPOLIA_RPC` | Virtual Arbitrum Sepolia RPC URL |
 
 You can set them using Hardhat:
 
@@ -27,7 +24,7 @@ yarn install
 yarn build
 ```
 
-## Deploy
+## Deployment
 
 Note that this instructions will help you deploy Graph Horizon contracts, but no data service will be deployed. If you want to deploy the Subgraph Service please refer to the [Subgraph Service README](../subgraph-service/README.md) for deploy instructions.
 
@@ -39,13 +36,13 @@ npx hardhat deploy:protocol --network hardhat
 ```
 
 ### Upgrade deployment
-Usually you would run this against a network (or a fork) where the original Graph Protocol was previously deployed. To upgrade an existing deployment of the original Graph Protocol to Graph Horizon, run the following commands. Note that each step might need to be run by different accounts (deployer vs governor):
+Usually you would run this against a network (or a fork) where the original Graph Protocol was previously deployed. To upgrade an existing deployment of the original Graph Protocol to Graph Horizon, run the following commands. Note that some steps might need to be run by different accounts (deployer vs governor):
 
 ```bash
 npx hardhat deploy:migrate --network hardhat --step 1
-npx hardhat deploy:migrate --network hardhat --step 2 # Optionally add --patch-config
+npx hardhat deploy:migrate --network hardhat --step 2 # Run with governor. Optionally add --patch-config
 npx hardhat deploy:migrate --network hardhat --step 3
-npx hardhat deploy:migrate --network hardhat --step 4 # Optionally add --patch-config
+npx hardhat deploy:migrate --network hardhat --step 4 # Run with governor. Optionally add --patch-config
 ```
 
 Steps 2 and 4 require patching the configuration file with addresses from previous steps. The files are located in the `ignition/configs` directory and need to be manually edited. You can also pass `--patch-config` flag to the deploy command to automatically patch the configuration reading values from the address book. Note that this will NOT update the configuration file.

packages/subgraph-service/README.md

@@ -2,16 +2,50 @@
 
 The Subgraph Service is a data service designed to work with Graph Horizon that supports indexing subgraphs and serving queries to consumers.
 
-## Deployment 
+## Configuration
 
-We use Hardhat Ignition to deploy the contracts. To build and deploy the Subgraph Service run the following commands:
+The following environment variables might be required:
+
+| Variable | Description |
+|----------|-------------|
+| `ARBISCAN_API_KEY` | Arbiscan API key |
+| `ARBITRUM_SEPOLIA_RPC` | Arbitrum Sepolia RPC URL |
+
+You can set them using Hardhat:
+
+```bash
+npx hardhat vars set <variable>
+```
+
+## Build
 
 ```bash
 yarn install
 yarn build
-npx hardhat run scripts/deploy.ts --network hardhat
 ```
 
-You can use any network defined in `hardhat.config.ts` by replacing `hardhat` with the network name.
+## Deployment
+
+Note that this instructions will help you deploy Graph Horizon contracts alongside the Subgraph Service. If you want to deploy just the core Horizon contracts please refer to the [Horizon README](../horizon/README.md) for deploy instructions.
+
+### New deployment
+To deploy Graph Horizon from scratch including the Subgraph Service run the following command:
+
+```bash
+npx hardhat deploy:protocol --network hardhat
+```
+
+### Upgrade deployment
+Usually you would run this against a network (or a fork) where the original Graph Protocol was previously deployed. To upgrade an existing deployment of the original Graph Protocol to Graph Horizon including the Subgraph Service, run the following commands. Note that some steps might need to be run by different accounts (deployer vs governor):
+
+```bash
+cd ../
+cd horizon && npx hardhat deploy:migrate --network hardhat --step 1 && cd ..
+cd subgraph-service && npx hardhat deploy:migrate --network hardhat --step 1 && cd ..
+cd horizon && npx hardhat deploy:migrate --network hardhat --step 2 && cd .. # Run with governor. Optionally add --patch-config
+cd horizon && npx hardhat deploy:migrate --network hardhat --step 3 && cd ..
+cd subgraph-service && npx hardhat deploy:migrate --network hardhat --step 2 && cd .. # Optionally add --patch-config
+cd horizon && npx hardhat deploy:migrate --network hardhat --step 4 && cd .. # Run with governor. Optionally add --patch-config
+```
 
-Note that this will deploy and configure Graph Horizon contracts as well as the Subgraph Service.
+Horizon Steps 2 and 4, and Subgraph Service Step 2 require patching the configuration file with addresses from previous steps. The files are located in the `ignition/configs` directory and need to be manually edited. You can also pass `--patch-config` flag to the deploy command to automatically patch the configuration reading values from the address book. Note that this will NOT update the configuration file.