如何使用Ethers.js與智能合約互動？

Ethers.js是一個JavaScript庫，用於與以太坊智能合約進行交互，使開發人員能夠與節點連接，讀取數據並安全地發送交易。

2025/07/29 09:01

什麼是智能合約，為什麼要使用ethers.js？

智能合約是一項自執行的合同，並與直接寫入法規的協議條款。這些合同在以太坊區塊鏈上運行，並使開發人員能夠創建無中介機構運行的分散應用程序（DAPP）。為了以編程方式與這些合同進行互動，開發人員經常使用Ethers.js ，這是一個輕巧的JavaScript庫，提供了一套與以太坊區塊鏈進行交互的全面工具。

Ethers.js簡化了任務，例如連接到以太坊節點，簽署交易和調用智能合約功能。它支持讀寫操作，使其成為從事基於以太坊應用程序的開發人員的首選選擇。

建立開發環境

在使用Ethers.js與智能合約進行互動之前，請確保正確配置您的開發環境。您需要：

• 安裝在系統上的node.js
• NPM或紗線等軟件包經理
• 本地或遠程以太坊節點（例如， Infura或Alchemy ）
• 目標智能合約的ABI （應用二進制界面）
• 合同地址

首先初始化一個新項目並安裝Ethers.js ：

 mkdir my-ethers-project
 cd my-ethers-project
 npm init -y
 npm install ethers

安裝後，您可以開始編寫JavaScript代碼以連接到以太坊網絡並與合同進行交互。

連接到以太坊提供商

要與智能合約互動，您必須首先連接到以太坊節點。 Ethers.js提供了幾種提供商選項，包括JSONRPCPROVIDER ， INFURAPROVIDER和ALCHEMYPROVIDER 。

這是使用infura連接的方法：

 const { ethers } = require('ethers'); const infuraurl ='https://mainnet.infura.io/v3/your_infura_project_id';
 const提供者= new ethers.jsonrpcprovider（infuraurl）;

用實際的Infura項目ID替換YOUR_INFURA_PROJECT_ID 。該提供商允許您查詢區塊鏈數據並發送交易。

如果您使用的是本地節點，則可以通過：

 const provider = new ethers.JsonRpcProvider('http://localhost:8545');

此連接對於閱讀合同狀態並將交易發送到網絡至關重要。

加載智能合約接口

要與智能合約進行互動，您需要它的ABI ，以定義可用的功能和事件。 ABI通常作為JSON數組提供。您可以將其加載到腳本中，並將其與Ethers.contract一起使用。

假設您有一個名為MyContract.json包含ABI的JSON文件：

 const contractABI = require('./MyContract.json');
 const contractAddress = '0x...'; // Replace with your contract address const Contract = new Ethers.contract（ContractAddress，Contractabi，提供商）；

這創建了合同實例，該實例使您可以調用功能並收聽合同發出的事件。

如果您打算發送交易（即調用狀態改變功能），則需要將簽名者附加到合同實例上。

將交易發送給智能合同

要對智能合約執行寫操作，例如鑄造令牌或更新變量 - 您需要使用簽名者。簽名者代表一個可以簽名和發送交易的以太坊帳戶。

這是使用私鑰創建簽名者的方法：

 const privateKey = '0x...';
 const wallet = new ethers.Wallet(privateKey, provider);
 const contractWithSigner = contract.connect(wallet);

現在，您可以調用修改區塊鏈狀態的合同功能。例如，如果合同具有稱為mint()的函數：

 async function mintToken() {
 const tx = await contractWithSigner.mint(1);
 await tx.wait();
 console.log('Transaction mined:', tx.hash);
 }

這將交易發送到網絡，並等待它得到確認。 Ethers.js自動處理交易的簽名和提交。

從智能合同中讀取數據

從智能合約中讀取數據不需要交易，因此是免費的。您可以使用合同實例直接調用視圖或純函數。

例如，如果合同具有稱為balanceOf(address)的函數：

 async function getBalance(address) {
 const balance = await contract.balanceOf(address);
 console.log( Balance of ${address}: , balance.toString());
 }

這檢索了給定以太坊地址的令牌平衡。返回的值通常是bignumber ，您可以將其轉換為字符串或數字以進行顯示目的。

您還可以一次檢索多個值，也可以調用返回結構化數據的複雜函數。 ethers.js確保根據函數的ABI定義正確解碼返回值。

常見問題

問：除了以太坊之外，我可以將ethers.js與其他區塊鏈一起使用嗎？

是的， ethers.js支持兼容EVM兼容的區塊鏈，例如二元鍊鍊，多邊形和仲裁。您只需要更改提供商的URL，並確保合同ABI和地址適用於目標鏈。

問：如何處理Ethers.js的合同事件？

您可以使用on()或once()方法收聽智能合約事件。例如，聆聽Transfer事件：

 contract.on('Transfer', (from, to, amount, event) => {
 console.log( Transfer from ${from} to ${to} of ${amount} );
 });

問：揭露智能合同的ABI是否安全？

是的， ABI不是敏感的數據，是外部交互所必需的。但是，絕不應在客戶端代碼或公共存儲庫中暴露私鑰和簽名者。

問：如何通過Ethers.js調試失敗的交易？

您可以檢查交易收據，並使用Etherscan或Remix IDE等工具來模擬和調試交易。此外， ethers.js允許您使用call()方法模擬交易而無需將其發送到網絡。