在 Web3 和去中心化应用（DApps）的浪潮中，以太坊作为智能合约的领军平台，其重要性不言而喻，而 Web3.js 则是以太坊生态中最核心、最流行的 JavaScript API 库，它像一座桥梁，将传统的 Web 应用与区块链的强大功能连接起来，本文将深入探讨如何使用 Web3.js 与以太坊智能合约进行交互，从基本概念到实际操作，为您揭开 DApp 开发的神秘面纱。
在深入代码之前，我们必须先理解三个核心概念,它们是我们后续所有操作的基础。
以太坊：全球计算机 以太坊不仅仅是一种加密货币（ETH），更是一个去中心化的、可编程的区块链平台，你可以把它想象成一台分布在世界各地的、由成千上万台计算机组成的“全球超级计算机”，在这台计算机上，你可以运行被称为“智能合约”的程序。
智能合约：自动执行的协议 智能合约是部署在以太坊区块链上的代码，它存储在特定的地址上，一旦部署，就无法被篡改，它定义了双方或多方之间的规则和惩罚，并在满足预设条件时自动执行，一个简单的代币合约可以定义“当收到 1 ETH 时，自动向发送者转账 100 个代币”,它的代码即法律。
在开始编码前,请确保你已经准备好以下工具：
使用 Web3.js 与合约交互，主要分为两大步骤：读取数据和写入数据，前者成本极低（几乎免费），而后者需要支付 gas 费。
我们需要在项目中引入 Web3.js 库,并连接到我们的以太坊节点。
npm install web3
在 JavaScript 文件中初始化 Web3 实例：
const Web3 = require('web3');
// 使用 Infura 提供的节点地址 (请替换为你自己的)
const INFURA_URL = 'https://mainnet.infura.io/v3/YOUR_PROJECT_ID';
// 创建 Web3 实例
const web3 = new Web3(INFURA_URL);
// 检查连接是否成功
web3.eth.getBlockNumber().then(console.log);
// 如果连接成功，会打印出最新的区块号
智能合约的源代码是 Solidity 语言，但 JavaScript 无法直接理解它，我们需要一个“翻译手册”，这就是 ABI (Application Binary Interface)。
// 假设我们有一个简单的 ERC20 代币合约
// 1. 从编译后的 artifacts 中复制 ABI
const tokenABI = [
{
"constant": true,
"inputs": [{"name": "_owner", "type": "address"}],
"name": "balanceOf",
"outputs": [{"name": "balance", "type": "uint256"}],
"type": "function"
},
// ... 其他函数的 ABI
];
// 2. 部署合约后得到的地址 (USDT 合约地址)
const tokenAddress = '0xdAC17F958D2ee523a2206206994597C13D831ec7';
// 3. 创建合约实例
const tokenContract = new web3.eth.Contract(tokenABI, tokenAddress);
tokenContract 对象就代表了区块链上那个特定的 USDT 合约,我们可以通过它来调用合约的函数。
读取数据，如查询某个地址的代币余额，不会改变区块链的状态，因此不需要用户签名，也无需支付 gas 费，我们可以使用 call() 方法。
// 查询地址 '0x742d35Cc6634C0532925a3b844Bc9e7595f8e5a4' 的 USDT 余额
const addressToQuery = '0x742d35Cc6634C0532925a3b844Bc9e7595f8e5a4';
tokenContract.methods.balanceOf(addressToQuery).call()
.then(balance => {
// balance 是一个大整数，通常需要格式化
const formattedBalance = web3.utils.fromWei(balance, 'mwei'); // USDT 通常使用 6 位精度
console.log(`The balance of ${addressToQuery} is: ${formattedBalance} USDT`);
})
.catch(error => {
console.error("An error occurred:", error);
});
写入数据，如调用合约的 transfer() 函数来转账代币，会改变区块链的状态，这需要构建一笔交易，由用户的钱包（如 MetaMask）签名，并支付 gas 费。
这个过程稍微复杂,因为它需要用户的交互。
// 1. 准备交易参数
const fromAddress = '0xYourAccountAddress'; // 发送方地址
const privateKey = '0xYourPrivateKey'; // 发送方私钥 (注意：在生产环境中，请使用更安全的方式管理私钥)
// 2. 构建交易对象
const transferData = tokenContract.methods.transfer('0xRecipientAddress', web3.utils.toWei('100', 'mwei')).encodeABI();
web3.eth.getTransactionCount(fromAddress, 'latest').then(nonce => {
const tx = {
from: fromAddress,
to: tokenAddress,
value: '0x0', // 对于代币转账，value 通常为 0
gas: 200000, // 估算的 gas 限制
gasPrice: web3.utils.toHex(web3.utils.toWei('10', 'gwei')), // 设置 gas 价格
data: transferData,
nonce: nonce
};
// 3. 签名交易
return web3.eth.accounts.signTransaction(tx, privateKey);
}).then(signedTx => {
// 4. 发送交易
return web3.eth.sendSignedTransaction(signedTx.rawTransaction);
}).then(receipt => {
// 5. 回执处理
console.log('Transaction successful! Receipt:', receipt);
console.log('Transaction hash:', receipt.transactionHash);
}).catch(error => {
console.error("Transaction failed:", error);
});
重要提示： 在实际的 DApp 中，你绝不应该在前端代码中硬编码私钥，正确的做法是，让用户通过 MetaMask 等钱包来签名交易，Web3.js 提供了 web3.eth.sendTransaction 方法，它会弹出 MetaMask 的签名窗口,让用户手动完成授权。
通过以上步骤，你已经掌握了使用 Web3.js 与以太坊智能合约进行交互的核心技能，从连接网络、加载合约，到读取数据和发送交易，我们一步步构建了 DApp 与区块链通信的完整链条。
Web3.js 以其强大的功能和广泛的社区支持，仍然是 DApp 开发的基石，随着技术的发展，像 ethers.js 这样的新兴库也以其更优雅的 API 和更优化的设计赢得了开发者的青睐，但无论工具如何变化，理解“账户”、“交易”、“gas”和“ABI”这些底层逻辑，都是通往 Web3 开发大师之路的必
友情链接：
