From b42ddbfb5c7d7edc67e55aac94fac68b538309e0 Mon Sep 17 00:00:00 2001
From: stalim17 <118949211+stalim17@users.noreply.github.com>
Date: Fri, 14 Nov 2025 14:53:46 +0900
Subject: [PATCH] docs: clarify deterministic lowering behavior in Cairo
 compiler

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 49469d1a..e4104961 100644
--- a/README.md
+++ b/README.md
@@ -57,3 +57,6 @@ Once the docker image is built, you can fetch the python package zip file using:
 > docker cp ${container_id}:/app/cairo-lang-0.14.1.zip .
 > docker rm -v ${container_id}
 ```
+> Note: The Starknet compiler performs deterministic Cairo-to-Sierra
+> lowering. Any nondeterministic behavior indicates an upstream toolchain issue.
+