Node.js + Web3.js,从零开始玩转以太坊开发

博主:neragonerago 2026-10-31 05:50:50 32

随着区块链技术的普及,以太坊(Ethereum)作为最活跃的智能合约平台,吸引了越来越多的开发者,而对于想要进入 Web3 世界的开发者来说,Node.js + Web3.js 无疑是最经典的组合之一。

Node.js + Web3.js,从零开始玩转以太坊开发

JavaScript 是以太坊生态的“母语”,无论是智能合约开发语言 Solidity 的语法,还是 DApp 前端,都与 JavaScript 息息相关,用 Node.js 搭建区块链应用后端,可以让你快速地与以太坊网络交互,本文将带你一步步入门。


为什么选择 Node.js 做以太坊开发?

  1. 生态契合:Web3.js 是以太坊官方维护的 JavaScript 库,与 Node.js 无缝集成。
  2. 全栈统一:前端用 JavaScript,后端也用 Node.js,DApp 开发不需要切换语言。
  3. 异步友好:Node.js 天生的异步 I/O 模型非常适合处理网络请求频繁的区块链交互场景。
  4. 工具丰富: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,除非注明,否则均为区块链社区- 欧亿APP下载原创文章,转载请注明出处。