From 808b9ec3c600ebae28b4e6ecb271a37adaec851e Mon Sep 17 00:00:00 2001
From: ayaanoncrypto <1.06945712e+08+ayaanoncrypto@users.noreply.github.com>
Date: Wed, 19 Aug 2026 20:14:51 +0000
Subject: [PATCH] docs: use pinned Foundry toolchain for semver-lock

---
 README.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index b1aa36e80..9f86ab355 100644
--- a/README.md
+++ b/README.md
@@ -34,15 +34,18 @@ If the `semver-lock` CI check fails, regenerate locally and commit:
 just semver-lock
 ```
 
-If CI still rejects it (Foundry version mismatch), update your local Foundry first:
+If CI still rejects it because of a Foundry version mismatch, install and run the repository-pinned toolchain:
 
 ```bash
-foundryup
-just semver-lock
+mise install
+mise exec -- just semver-lock
 ```
 
+The Foundry version is pinned in `.mise.toml`. Use the pinned version when regenerating lock files and snapshots so local output matches CI.
+
 ### setup and testing
 
-- If you don't have foundry installed, run `just install-foundry`.
+- Install the pinned toolchain with `mise install`.
+- If you do not use mise, run `just install-foundry` and verify the installed version matches `.mise.toml`.
 - `just deps`
 - Test contracts: `just test`