upgrade md

.changelog/v4.2.0/api-breaking/provider/1732-assigning-already-assigned-key-fix.md

@@ -0,0 +1,2 @@
+- Assigning a key that is already assigned by the same validator will now be a no-op instead of throwing an error.
+  ([\#1732](https://github.com/cosmos/interchain-security/pull/1732))

.changelog/v4.2.0/features/provider/1587-enable-opt-in-chains-through-gov-proposals.md

@@ -0,0 +1,2 @@
+- Enable Opt In and Top N chains through gov proposals.
+  ([\#1587](https://github.com/cosmos/interchain-security/pull/1587))

.changelog/v4.2.0/features/provider/1809-pss.md

@@ -0,0 +1,3 @@
+- Adding the Partial Set Security (PSS) feature cf. [ADR 015](https://cosmos.github.io/interchain-security/adrs/adr-015-partial-set-security).
+  PSS enables consumer chains to join ICS as _Top N_ or _Opt In_ chains and enables validators to opt to validate the consumer chains they want.
+  ([\#1809](https://github.com/cosmos/interchain-security/pull/1809))

.changelog/v4.2.0/features/provider/1830-introduce-power-shaping.md

@@ -0,0 +1,2 @@
+- Introduce power-shaping features for consumer chains. The features: (i) allow us to cap the total number of validators that can validate the consumer chain, (ii) set a cap on the maximum voting power (percentage-wise) a validator can have on a consumer chain, and (iii) introduce allowlist and denylists to restrict which validators are allowed or not to validate a consumer chain.
+  ([\#1830](https://github.com/cosmos/interchain-security/pull/1830))

.changelog/v4.2.0/state-breaking/provider/1587-enable-opt-in-chains-through-gov-proposals.md

@@ -0,0 +1,2 @@
+- Enable Opt In and Top N chains through gov proposals.
+  ([\#1587](https://github.com/cosmos/interchain-security/pull/1587))

.changelog/v4.2.0/state-breaking/provider/1732-assigning-already-assigned-key-fix.md

@@ -0,0 +1,2 @@
+- Assigning a key that is already assigned by the same validator will now be a no-op instead of throwing an error.
+  ([\#1732](https://github.com/cosmos/interchain-security/pull/1732))

.changelog/v4.2.0/state-breaking/provider/1809-pss.md

@@ -0,0 +1,2 @@
+- Adding the Partial Set Security feature cf. [ADR 015](https://cosmos.github.io/interchain-security/adrs/adr-015-partial-set-security).
+  ([\#1809](https://github.com/cosmos/interchain-security/pull/1809))

.changelog/v4.2.0/state-breaking/provider/1830-introduce-power-shaping.md

@@ -0,0 +1,2 @@
+- Introduce power-shaping features for consumer chains. The features: (i) allow us to cap the total number of validators that can validate the consumer chain, (ii) set a cap on the maximum voting power (percentage-wise) a validator can have on a consumer chain, and (iii) introduce allowlist and denylists to restrict which validators are allowed or not to validate a consumer chain.
+  ([\#1830](https://github.com/cosmos/interchain-security/pull/1830))

.changelog/v4.2.0/summary.md

@@ -0,0 +1 @@
+May 1, 2024

UPGRADING.md

@@ -2,7 +2,7 @@
 
 This guide provides instructions for upgrading to specific versions of Replicated Security.
 
-## [v5.0.x-provider](https://github.com/cosmos/interchain-security/releases/tag/v5.0.0-provider-rc1)
+## [v4.2.x](https://github.com/cosmos/interchain-security/releases/tag/v4.2.x-rc0)
 
 ### Provider