Node.js + Web3.js,从零开始玩转以太坊开发
随着区块链技术的普及,以太坊(Ethereum)作为最活跃的智能合约平台,吸引了越来越多的开发者,而对于想要进入 Web3 世界的开发者来说,Node.js + Web3.js 无疑是最经典的组合之一。
JavaScript 是以太坊生态的“母语”,无论是智能合约开发语言 Solidity 的语法,还是 DApp 前端,都与 JavaScript 息息相关,用 Node.js 搭建区块链应用后端,可以让你快速地与以太坊网络交互,本文将带你一步步入门。
为什么选择 Node.js 做以太坊开发?
- 生态契合:Web3.js 是以太坊官方维护的 JavaScript 库,与 Node.js 无缝集成。
- 全栈统一:前端用 JavaScript,后端也用 Node.js,DApp 开发不需要切换语言。
- 异步友好:Node.js 天生的异步 I/O 模型非常适合处理网络请求频繁的区块链交互场景。
- 工具丰富:npm 上有海量相关包,如
web3、ethers、truffle、hardhat等。
环境准备
首先确保你的机器上安装了 Node.js(建议 16 以上版本),然后初始化项目并安装 Web3.js:
mkdir eth-demo && cd eth-demo npm init -y npm install web3
你需要一个以太坊节点的 RPC 接口,自己搭建节点成本较高,通常使用第三方服务:
- Infura(现 MetaMask Developer)
- Alchemy
- QuickNode
注册后即可获得一个 API 地址,类似:
https://mainnet.infura.io/v3/你的项目ID
连接以太坊网络
const { Web3 } = require('web3');
// 连接主网
const web3 = new Web3('https://mainnet.infura.io/v3/你的项目ID');
async function main() {
// 查询当前区块高度
const blockNumber = await web3.eth.getBlockNumber();
console.log('当前区块高度:', blockNumber);
// 查询链 ID
const chainId = await web3.eth.getChainId();
console.log('链 ID:', chainId);
}
main();
如果输出类似 当前区块高度: 19000000,说明连接成功。
💡 建议:开发阶段先用测试网(如 Sepolia),将 RPC 地址换成测试网端点即可,避免消耗真实的 ETH。
查询账户余额与交易信息
查询账户余额
async function getBalance(address) {
const wei = await web3.eth.getBalance(address);
const eth = web3.utils.fromWei(wei, 'ether');
console.log(`余额: ${eth} ETH`);
}
getBalance('0x某个地址');
注意:以太坊中最小单位是 Wei,1 ETH = 10¹⁸ Wei,fromWei 和 toWei 是最常用的工具函数。
查询交易详情
async function getTx(txHash) {
const tx = await web3.eth.getTransaction(txHash);
console.log(`发起者: ${tx.from}`);
console.log(`接收者: ${tx.to}`);
console.log(`金额: ${web3.utils.fromWei(tx.value, 'ether')} ETH`);
}
发送一笔交易
发送交易需要私钥签名。千万不要把私钥硬编码提交到代码仓库,实际项目中应使用环境变量或密钥管理服务。
require('dotenv').config();
async function sendTx() {
const from = process.env.WALLET_ADDRESS;
const privateKey = process.env.PRIVATE_KEY;
const to = '0x接收方地址';
// 构造交易对象
const txObject = {
from,
to,
value: web3.utils.toWei('0.01', 'ether'),
gas: 21000,
};
// 获取当前 gas 价格(EIP-1559 可用 maxFeePerGas)
const gasPrice = await web3.eth.getGasPrice();
txObject.gasPrice = gasPrice;
// 签名交易
const signedTx = await web3.eth.accounts.signTransaction(txObject, privateKey);
// 发送交易
web3.eth.sendSignedTransaction(signedTx.rawTransaction)
.on('transactionHash', hash => console.log('交易哈希:', hash))
.on('receipt', receipt => console.log('已打包进区块:', receipt.blockNumber))
.on('error', err => console.error('交易失败:', err));
}
与智能合约交互
智能合约交互需要两个要素:合约 ABI(接口描述)和合约地址。
const contractABI = [
// ABI 数组,通常从编译器或 Etherscan 获取
];
const contract = new web3.eth.Contract(
contractABI,
'0x合约地址'
);
// 读取数据(不需要花费 gas)
const name = await contract.methods.name().call();
console.log('代币名称:', name);
// 写入数据(需要签名并发送交易)
const tx = contract.methods.transfer('0x目标地址', web3.utils.toWei('1', 'ether'));
const encodedTx = tx.encodeABI
The End
发布于:2026-10-31,除非注明,否则均为原创文章,转载请注明出处。

