diff --git a/contracts/README.md b/contracts/README.md
index 82895bfac..7c9cd6ca1 100644
--- a/contracts/README.md
+++ b/contracts/README.md
@@ -19,6 +19,10 @@ This changelog tracks deployments of **Ethereum mainnet** contracts. This change
 | MevCommitAVS          | `0xBc77233855e3274E1903771675Eb71E602D9DC2e` | `release/v1.1.x`    | `v1.1.0-contracts`      |
 | L1Gateway             | `0x5d64B933739558101F9359E2750ACC228f0CB64F` | `release/v1.2.x`    | `v1.2.0`                |
 | MevCommitMiddleware   | `0x21fD239311B050bbeE7F32850d99ADc224761382` | `release/v1.1.x`    | `v1.1.0-contracts`         |
+| ValidatorOptInHub     | `0x1059155bD5854224bF58e43CD3EEC6B07b4F30Ad` | `release/v1.2.x`    | `v1.2.3`         |
+| BlockRewardsManager   | `0x531D19cFEB3e685745DA1e1897485E9F351e7Aa0` | `release/v1.2.x`    | `v1.2.3`         |
+| RewardDistributor     | `0xccf10d9911c2e1b2d589cbc8a3878d1b138aa2c2` | `release/v1.2.x`    | `v1.2.3`         |
+
 
 ### Upgrade History
 
@@ -43,7 +47,6 @@ This changelog tracks contract deployments on the mev-commit chain. This changel
 
 
 
-
 ### Upgrade history related to current deployments
 
 | Timestamp (UTC)             | Contract            | New Impl Version      | Upgrade Tag       |
diff --git a/contracts/contracts/validator-registry/README.md b/contracts/contracts/validator-registry/README.md
index 316784233..187ca86fd 100644
--- a/contracts/contracts/validator-registry/README.md
+++ b/contracts/contracts/validator-registry/README.md
@@ -1,12 +1,14 @@
 # Validator Registry Design doc
 
-Validators are able to _opt-in to mev-commit_ in one of three ways:
+Validators are able to _opt-in to mev-commit_ in any of the following ways:
 
 1. Restaking with the `MevCommitAVS` contract.
 2. Restaking with the `MevCommitMiddleware` contract.
-3. Simple staking with the `VanillaRegistry` contract.
+3. Simple staking with the Reputational `VanillaRegistry` contract.
 
-The `ValidatorOptInHub` contract acts as a query router between all three solutions, allowing any actor to query whether a group of validator pubkeys is opted-in to mev-commit. This is an updated version of the ValidatorOptInRouter contract for ease of use and to add future registry support.
+The `ValidatorOptInHub` contract acts as a query router between all three solutions, allowing any actor to query whether a group of validator pubkeys is opted-in to mev-commit. This is an updated version of the `ValidatorOptInRouter` contract for ease of use and to add future registry support. 
+
+More details on the `ValidatorOptInHub` and differences between the Router and Hub [can be found here](https://www.notion.so/primev/Validator-OptInHub-vs-ValidatorOptInRouter-2806865efd6f80ce9529e392ae3190c7?source=copy_link).
 
 ## Mev-commit AVS - Eigenlayer Restaking Solution