From a221871f29c220699a3b8e2ff08d896e32a21683 Mon Sep 17 00:00:00 2001
From: Marius Poke <marius.poke@posteo.de>
Date: Wed, 4 Sep 2024 15:54:20 +0200
Subject: [PATCH] docs: prepare v5.2.0 release (#2212)

prepare v5.2.0 release
---
 .../bug-fixes/provider/1dd3885-msg-validation.md |  2 ++
 .../provider/1dd3885-msg-validation.md           |  2 ++
 .changelog/v5.2.0/summary.md                     |  1 +
 CHANGELOG.md                                     | 16 ++++++++++++++++
 RELEASE_NOTES.md                                 | 10 ++++------
 UPGRADING.md                                     | 10 ++++++++++
 6 files changed, 35 insertions(+), 6 deletions(-)
 create mode 100644 .changelog/v5.2.0/bug-fixes/provider/1dd3885-msg-validation.md
 create mode 100644 .changelog/v5.2.0/state-breaking/provider/1dd3885-msg-validation.md
 create mode 100644 .changelog/v5.2.0/summary.md

diff --git a/.changelog/v5.2.0/bug-fixes/provider/1dd3885-msg-validation.md b/.changelog/v5.2.0/bug-fixes/provider/1dd3885-msg-validation.md
new file mode 100644
index 0000000000..379e981ac0
--- /dev/null
+++ b/.changelog/v5.2.0/bug-fixes/provider/1dd3885-msg-validation.md
@@ -0,0 +1,2 @@
+- Improve provider message validation.
+  ([1dd3885](https://github.com/cosmos/interchain-security/commit/1dd38851dbb9e0d98c61bd11375ee7e140527833))
\ No newline at end of file
diff --git a/.changelog/v5.2.0/state-breaking/provider/1dd3885-msg-validation.md b/.changelog/v5.2.0/state-breaking/provider/1dd3885-msg-validation.md
new file mode 100644
index 0000000000..379e981ac0
--- /dev/null
+++ b/.changelog/v5.2.0/state-breaking/provider/1dd3885-msg-validation.md
@@ -0,0 +1,2 @@
+- Improve provider message validation.
+  ([1dd3885](https://github.com/cosmos/interchain-security/commit/1dd38851dbb9e0d98c61bd11375ee7e140527833))
\ No newline at end of file
diff --git a/.changelog/v5.2.0/summary.md b/.changelog/v5.2.0/summary.md
new file mode 100644
index 0000000000..9ef6348423
--- /dev/null
+++ b/.changelog/v5.2.0/summary.md
@@ -0,0 +1 @@
+*September 4, 2024*
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 503e13c020..f4cdbf4bcf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # CHANGELOG
 
+## v5.2.0
+
+*September 4, 2024*
+
+### BUG FIXES
+
+- [Provider](x/ccv/provider)
+  - Improve provider message validation.
+    ([1dd3885](https://github.com/cosmos/interchain-security/commit/1dd38851dbb9e0d98c61bd11375ee7e140527833))
+
+### STATE BREAKING
+
+- [Provider](x/ccv/provider)
+  - Improve provider message validation.
+    ([1dd3885](https://github.com/cosmos/interchain-security/commit/1dd38851dbb9e0d98c61bd11375ee7e140527833))
+
 ## v5.1.1
 
 *July 26, 2024*
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d0e71928d8..92230465ad 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -1,13 +1,11 @@
-# Replicated Security v5.1.1  Release Notes
+# Replicated Security v5.2.0  Release Notes
 
 ## 📝 Changelog
-Check out the [changelog](https://github.com/cosmos/interchain-security/blob/v5.1.1/CHANGELOG.md) for a list of relevant changes or [compare all changes](https://github.com/cosmos/interchain-security/compare/v5.1.0...v5.1.1) from last release.
+Check out the [changelog](https://github.com/cosmos/interchain-security/blob/v5.2.0/CHANGELOG.md) for a list of relevant changes or [compare all changes](https://github.com/cosmos/interchain-security/compare/v5.1.1...v5.2.0) from last release.
 
 <!-- Add the following line for major or minor releases -->
-Refer to the [upgrading guide](https://github.com/cosmos/interchain-security/blob/release/v5.1.x/UPGRADING.md) when migrating from `v4.3.x` to `v5.1.x`.
+Refer to the [upgrading guide](https://github.com/cosmos/interchain-security/blob/release/v5.2.x/UPGRADING.md) when migrating from `v5.1.x` to `v5.2.x`.
 
 ## 🚀 Highlights
 
-API- and state-breaking change:
-
-This release fixes some bugs found in the message definitions of the provider module, see [\#2095](https://github.com/cosmos/interchain-security/pull/2095) for more details.
+This release fixes a security vulnerability found in the provider module -- it improves the provider message validation
diff --git a/UPGRADING.md b/UPGRADING.md
index a9de7407ed..5e40cc47e1 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -1,5 +1,15 @@
 # Upgrading Replicated Security
 
+## v5.2.x
+
+### Provider
+
+Providers using versions `v5.1.x` can upgrade to `v5.2.x`.
+
+### Consumer
+
+***This release does not affect the consumer chains.***
+
 ## [v5.1.x](https://github.com/cosmos/interchain-security/releases/tag/v5.1.1)
 
 ### Provider