標題：工程警示：處理 Etherscan API 的重大變更（2026年7月）

多年來，Etherscan 一直是以太坊數據索引的支柱。然而，一個重大轉變即將到來。自2026年7月1日起，Etherscan 將對其免費層 API 限制實施破壞性變更。
如果您的 dApp、索引器或分析工具依賴於 Etherscan，您需要立即重構您的數據獲取邏輯，以避免服務中斷。
1. 分頁限制：從 10k 到 1k 的記錄限制
最重要的更新是每次請求返回的最大記錄數量的降低。對於免費層用戶，限制將從 10,000 降至 1,000 記錄。
技術影響：
對高頻地址（如 CEX 熱錢包或熱門 DeFi 協議）的標準抓取請求，若您的偏移量之前設置在 1,000 以上，現在將返回不完整的數據集。
受影響的端點：
帳戶模組：txlist、txlistinternal、tokentx、tokennfttx、token1155tx。
日誌與其他：getLogs、getWithdrawals 以及 Token 持有人列表。
所需行動：實施積極的分頁策略
您必須重構您的抓取循環。
2. 端點遷移：區塊範圍內部交易到專業層
“按區塊範圍獲取內部交易”端點將被移至付費方案的付費牆後面。
技術影響：
使用免費層 API 金鑰請求此端點，從2026年7月起將返回 403 禁止訪問或特定層級限制錯誤。
緩解策略：
升級層級：對於企業級應用來說，這是最直接的解決方案。
細粒度查詢：您可能需要通過特定交易哈希（txhash）來獲取內部交易，而不是按區塊範圍查詢，這會顯著增加 API 請求數量，並可能觸發速率限制。
3. 管理速率限制（節流）
免費層仍然維持每秒 5 次請求（RPS）的限制。由於您現在需要 10 次請求才能獲得之前一次請求的數據，您更容易遇到 429 Too Many Requests 錯誤。
建議：
實施指數退避（Exponential Backoff）或請求排隊管理器（如 p-throttle 或 bottleneck），以確保您的多頁面抓取邏輯不會導致 API 金鑰崩潰。
開發者遷移檢查清單：
審核：在您的代碼庫中搜索任何偏移量大於 1000 的 Etherscan API 調用。
重構：使用 page 參數實現遞歸或循環式分頁。