From 4412fae0d58bf730cf4dada0787835f00dddae12 Mon Sep 17 00:00:00 2001
From: kaylachi <309505611+kaylachi@users.noreply.github.com>
Date: Sun, 30 Aug 2026 17:46:01 +0100
Subject: [PATCH] feat(config): document paired per-network SAC and NFT
 watch-list env vars (#162)

---
 .env.example | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/.env.example b/.env.example
index b9ff57df..83c2b360 100644
--- a/.env.example
+++ b/.env.example
@@ -59,9 +59,15 @@ POLL_INTERVAL_MS=6000
 # Example (watch XLM + USDC on mainnet):
 #   SAC_CONTRACT_IDS=CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC,CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA
 #
+# Per-network watch lists (for dual-network deployments when NETWORKS=testnet,mainnet):
+#   SAC_CONTRACT_IDS_TESTNET=CDMLFMKMMD7MWZP3FKUBZPVHTUEDLSX4BYGYKH4GCESXYHS3IHQ4EIG4
+#   SAC_CONTRACT_IDS_MAINNET=CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC
+#
 # Soroban RPC's getEvents accepts multiple contract IDs in a single request —
 # there is no N+1 query penalty for watching multiple contracts.
 SAC_CONTRACT_IDS=
+SAC_CONTRACT_IDS_TESTNET=
+SAC_CONTRACT_IDS_MAINNET=
 
 # ─── NFT Contract IDs ───────────────────────────────────────────────────────
 # Comma-separated list of CAP-46 NFT contract IDs to explicitly watch.
@@ -70,7 +76,13 @@ SAC_CONTRACT_IDS=
 #
 # Example (watch a known testnet NFT contract):
 #   NFT_CONTRACT_IDS=CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
+#
+# Per-network NFT watch lists (for dual-network deployments):
+#   NFT_CONTRACT_IDS_TESTNET=
+#   NFT_CONTRACT_IDS_MAINNET=
 NFT_CONTRACT_IDS=
+NFT_CONTRACT_IDS_TESTNET=
+NFT_CONTRACT_IDS_MAINNET=
 
 # Legacy alias — CONTRACT_IDS is still accepted for backwards-compatibility.
 # SAC_CONTRACT_IDS takes precedence when both are set.