From 7e6583f05f3f7f66e8abb1439b96431e767fa310 Mon Sep 17 00:00:00 2001
From: gerg <69520747+gerrrg@users.noreply.github.com>
Date: Tue, 31 Oct 2023 06:12:53 -0400
Subject: [PATCH] Add notes about contract immutability

---
 docs/reference/contracts/security.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/reference/contracts/security.md b/docs/reference/contracts/security.md
index b2ddc3fa..8117f0c6 100644
--- a/docs/reference/contracts/security.md
+++ b/docs/reference/contracts/security.md
@@ -29,6 +29,9 @@ Balancer has completed full audits with Certora, OpenZeppelin, Trail of Bits, an
 
 Audit reports can also be found in the [Balancer V2 Core repository](https://github.com/balancer/balancer-core-v2/tree/master/audits).
 
+## Code Immutability
+The core contracts that make up the Balancer V2 Protocol, such as the Vault and Pools (Weighted, Stable, LBP, Managed, Linear, etc), are immutable by design. Any pool updates are made by deploying brand new factories/pools and require users to electively migrate.
+
 ## Balancer x Certora Accelerator
 
 On the 10th [of October 2022](https://medium.com/balancer-protocol/balancer-and-certora-launch-security-accelerator-420d3b839a37), Balancer launched the Balancer Certora Security Accelerator in partnership with [Certora](https://www.certora.com/). The Security Accelerator helps projects building on Balancer increase their code security.