使用 Web3.js 與智能合約交互的指南

了解智能合約交互基礎知識

1. 智能合約駐留在以太坊區塊鏈上，並完全按照編程執行代碼，而不會出現審查、停機或第三方乾擾的情況。

2. Web3.js 作為 JavaScript 庫，可通過 HTTP 或 IPC 連接與以太坊節點進行交互。

3. 每次合約交互都需要讀取狀態數據或寫入新狀態，每種都需要不同的事務處理邏輯。

4. ABI（應用程序二進制接口）作為合約的接口定義，以 JSON 格式指定函數、輸入、輸出和事件簽名。

5. 合約地址是部署到網絡的不可變的 20 字節十六進制標識符，是 Web3.js 中實例化所需的。

設置Web3.js環境

1. 在 Node.js 項目中使用npm install web3通過 npm 安裝 Web3.js，或通過 CDN 將其包含在基於瀏覽器的應用程序中。

2. 通過連接到以太坊節點（本地 Geth/Parity、Infura、Alchemy 或 MetaMask 注入的提供商）來初始化 Web3 實例。

3. 使用window.ethereum檢測 MetaMask 是否存在，並使用ethereum.request({ method: 'eth_requestAccounts' })請求用戶帳戶。

4. 使用web3.eth.defaultAccount設置用於簽名交易的默認帳戶或從交易對像中顯式傳遞。

5. 通過調用web3.eth.net.isListening()驗證連接狀態，如果節點響應，則返回一個解析為 true 的 Promise。

部署和實例化合約

1. 使用 solc-js 或 Hardhat 編譯 Solidity 源代碼以生成字節碼和 ABI 工件。

2. 使用new web3.eth.Contract(abi)創建合約對象，然後使用contract.deploy({ data: bytecode, Arguments: [...] })進行部署。

3. 使用send({ from: account,gas:estimatedGas })發送部署交易，其中gas估算依賴於contract.deploy().estimateGas() 。

4.挖礦後，從交易收據的contractAddress字段中檢索部署的地址。

5. 使用new web3.eth.Contract(abi,contractAddress)實例化現有合約以開始讀/寫操作。

讀取和寫入合約

1. 使用contract.methods.methodName().call({ from: account })調用常量函數（標記的view或pure ）——不會產生gas費用。

2. 使用Contract.methods.methodName().send({ from: account, value: weiAmount,gas: limit })觸發狀態修改函數。

3. 在發送之前通過contract.methods.methodName().estimateGas({ from: account })估算所需的gas，以避免gas耗盡故障。

4. 處理交易收據，其中包含日誌、狀態、區塊編號和確認後使用的累積氣體。

5. 使用contract.events.EventName({ fromBlock: 0 })訂閱合約事件並附加回調處理程序以進行實時更新。

常見問題及解答

問：Web3.js 可以與以太坊以外的網絡上的合約交互嗎？答：是的。只要正確配置 RPC 端點和鏈 ID，Web3.js 支持任何與 EVM 兼容的鏈，包括 BNB Chain、Polygon、Arbitrum 和 Optimism。

問：如果合約函數在執行過程中恢復，會發生什麼情況？答：如果使用 Solidity 0.8.0+ 編譯並通過調試跟踪啟用，則交易失敗，消耗所有分配的 Gas，並拋出包含恢復原因字符串的錯誤。

問：公開暴露 ABI 和合約地址安全嗎？答：是的。兩者都是公共工件； ABI 定義了接口結構，而地址是鏈上的透明標識符，既不會授予未經授權的訪問或控制。

問：使用 ERC-20 代幣時如何處理小數精度？ A：在傳遞給合約方法之前，將代幣數量乘以 10^小數；使用web3.utils.toWei()表示 ETH，使用web3.utils.fromWei()表示顯示格式。