Getting there

.env.example

@@ -1,7 +1,25 @@
-# Polymarket Authentication
-PK=your_private_key_here
-BROWSER_ADDRESS=your_wallet_address_here
+# polymaker secrets. Copy to .env and fill in. NEVER commit .env.
+#
+# IMPORTANT: use the SAME wallet you use in the Polymarket browser UI, and make
+# sure it has traded at least once through the UI so allowances are set.
 
-# Google Sheets (for data_updater)
-SPREADSHEET_URL=https://docs.google.com/spreadsheets/d/1Kt6yGY7CZpB75cLJJAdWo7LSp9Oz7pjqfuVWwgtn7Ns/edit?gid=97507557#gid=97507557
-#replace with YOUR url
+# Private key of the signing wallet (EOA that controls the funder).
+PK=
+
+# The funder = the smart-contract wallet that actually holds your pUSD and
+# positions (NOT your signing EOA/MetaMask address above). Polymarket's UI labels
+# this inconsistently (may show as "deposit" or "developer" address) — the one
+# that holds the funds is the funder. `polymaker doctor` reads the balance so you
+# can confirm you picked the right one. Set signature_type in config/config.toml
+# to match how the account was made (new deposit wallets = 3).
+BROWSER_ADDRESS=
+
+# Optional: override the default public Polygon RPC with your own (Alchemy/Infura).
+# POLYGON_RPC=
+
+# Optional: webhook (Discord/Telegram/ntfy) POST URL for critical alerts.
+# ALERT_WEBHOOK_URL=
+
+# Optional: route outbound traffic through an SSH tunnel / proxy, e.g. to test
+# from a colocated box. Standard env var; httpx and web3 pick it up automatically.
+# ALL_PROXY=socks5://127.0.0.1:1080