合約 ABI 入門：函數、事件與自定義錯誤

ABI描述接口不保證實現

ABI告訴工具怎樣編碼函數調用、返回值和事件，但不證明部署字節碼與文檔相同，也不等於安全審計。先核對合約地址、鏈、代理實現和ABI來源，再解釋解碼結果。

公開ABI可能來自過期版本或錯誤地址，先核對區塊瀏覽器的實現和源碼說明。代理的入口與實際業務邏輯不同，工具選錯ABI可能給出看似自然但錯誤的函數名稱，因此解碼顯示仍需證據支持。

理解selector與類型

函數選擇器來自完整簽名，重載函數需要準確類型。地址、整數、數組和tuple的編碼方式不同，界面顯示可讀名稱也可能來自錯誤ABI。讀調用前確認參數單位和小數位，不把原始十六進制直接當作人類金額。

函數選擇器只佔有限字節，不能在所有情況下唯一證明函數含義。完整簽名、合約上下文和實現一起看，尤其不要把陌生簽名請求里的可讀文字當成全部交易效果。教學用只讀調用更容易控制風險。

事件的索引字段不同

indexed字段進入topics，動態類型可能只留下哈希，無法從日誌還原原文。非索引參數在data中編碼，事件同名不意味著來自同一合約版本。對賬時記錄日誌位置、交易和合約，而不是只複製頁面標籤。

事件不是合約狀態快照，某條Transfer日誌也需確認真正資產合約與執行結果。動態參數哈希無法憑空恢復，頁面顯示的名稱可能由外部索引補足。引用時說明鏈上字段與工具推斷的差別，避免精確但來源不明的結論。

錯誤資料幫助診斷

自定義錯誤或標準錯誤可以從revert資料解碼，但狀態變化、代理和缺少ABI都會限制解釋。錯誤說明調用被拒絕的路徑，不證明發送者惡意，也不保證重試一定成功。不要為了“測試錯誤”向真實合約廣播未知交易。

錯誤資訊可以被合約自行定義，友好文字並不自動可信。某次調用失敗後狀態通常按執行規則回滾，但Gas費用處理需另看。診斷時保留原始返回和區塊，不通過反復提高金額試探未知合約。

用只讀樣本建立習慣

選擇公開、低風險的只讀函數，記錄selector、參數、返回和事件，再與源碼說明交叉核對。保存ABI版本和區塊高度，後續實現升級時重新判斷。ABI是編碼地圖，不是對資金或權限安全的承諾。

練習記錄可以按原始字節、解碼值、來源和限制四列，遇到未知類型注明未能解碼。不要為填滿表格猜值或下載陌生解碼插件。只有確有必要的公開資料進入文章，敏感業務資料不因ABI可解碼就適合公開。

練習記錄可以圍繞“函數簽名”“參數編碼”“事件字段”“錯誤資料”分別填寫概念、假想輸入、觀察結果和適用限制。逐步核對單位與時間，明確哪個結果來自公式、哪個來自工具，無法確認的地方不靠猜測填滿。練習不需要真實私鑰或大額交易，完成後保存方法和版本即可。把學習結果遷移到真實服務前，還要核對當地資格、費用和當前軟體行為。