Web3.js 库使用指南

最新推荐文章于 2025-04-03 17:13:58 发布

阿贾克斯的黎明

最新推荐文章于 2025-04-03 17:13:58 发布

阅读量989

点赞数 5

分类专栏：前端文章标签： web3 javascript 开发语言

本文链接：https://blog.csdn.net/m0_57836225/article/details/142407949

版权

前端专栏收录该内容

501 篇文章

订阅专栏

一、引言

在区块链开发中，与以太坊区块链进行交互是一项关键任务。web3.js是一个强大的 JavaScript 库，它提供了一系列工具和方法，使开发者能够轻松地与以太坊区块链进行通信、查询数据、发送交易以及与智能合约交互。本文将详细介绍web3.js库的使用方法。

二、安装 Web3.js

可以通过 npm 或 yarn 来安装web3.js。

使用 npm：

npm install web3

使用 yarn：

yarn add web3

三、连接到以太坊节点

使用 HTTP 提供商连接到远程节点：

const Web3 = require('web3');

const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');

这里我们使用 Infura 作为远程节点提供商。Infura 是一个可靠的区块链节点服务，你需要在 Infura 上注册并获取自己的项目 ID，然后替换YOUR_INFURA_PROJECT_ID。

使用 WebSocket 提供商连接：

const web3 = new Web3('wss://mainnet.infura.io/ws/v3/YOUR_INFURA_PROJECT_ID');

四、查询区块链数据

获取当前区块号：

web3.eth.getBlockNumber().then(blockNumber => {
    console.log('当前区块号：', blockNumber);
});

查询账户余额：

const accountAddress = '0xYOUR_ACCOUNT_ADDRESS';
web3.eth.getBalance(accountAddress).then(balance => {
    console.log('账户余额：', web3.utils.fromWei(balance, 'ether'));
});

在查询账户余额时，web3.utils.fromWei方法用于将以太币的最小单位 Wei 转换为更易读的单位，这里我们转换为以太（ether）。

五、发送交易

发送以太币：

const senderAddress = '0xSENDER_ADDRESS';
const privateKey = 'YOUR_PRIVATE_KEY';
const receiverAddress = '0xRECEIVER_ADDRESS';
const amountToSend = web3.utils.toWei('1', 'ether');

const sendTransaction = async () => {
    const gasPrice = await web3.eth.getGasPrice();
    const nonce = await web3.eth.getTransactionCount(senderAddress);

    const txObject = {
        nonce: nonce,
        to: receiverAddress,
        value: amountToSend,
        gasPrice: gasPrice,
        gas: 21000,
    };

    const signedTx = await web3.eth.accounts.signTransaction(txObject, privateKey);
    const receipt = await web3.eth.sendSignedTransaction(signedTx.rawTransaction);
    console.log('交易已发送，交易哈希：', receipt.transactionHash);
};

sendTransaction();

在发送交易时，需要注意以下几点：

gasPrice是交易的 gas 价格，可以通过web3.eth.getGasPrice获取当前的平均 gas 价格。
nonce是发送者地址的交易计数，每次发送交易时都会递增。可以通过web3.eth.getTransactionCount获取。
gas是交易所需的 gas 数量，对于简单的以太币转账，通常设置为 21000。
privateKey是发送者的私钥，用于对交易进行签名。请务必妥善保管私钥，不要在不安全的环境中暴露私钥。

六、与智能合约交互

首先，需要 ABI（Application Binary Interface）和合约地址：

假设已经有了智能合约的 ABI 和地址，可以这样初始化合约对象：

const contractABI = [/* 你的智能合约 ABI 定义 */];
const contractAddress = '0xYOUR_CONTRACT_ADDRESS';
const contract = new web3.eth.Contract(contractABI, contractAddress);

调用合约函数：

const functionName = 'yourFunctionName';
const functionParams = [/* 参数列表 */];
contract.methods[functionName](...functionParams).call()
  .then(result => {
        console.log('函数调用结果：', result);
    })
  .catch(error => {
        console.error('函数调用错误：', error);
    });

这里使用call方法来调用合约函数，它不会在区块链上执行交易，只是模拟执行并返回结果。

发送交易调用合约函数：

const functionName = 'yourFunctionName';
const functionParams = [/* 参数列表 */];
const gasEstimate = await contract.methods[functionName](...functionParams).estimateGas({ from: senderAddress });
const txObject = {
    from: senderAddress,
    to: contractAddress,
    data: contract.methods[functionName](...functionParams).encodeABI(),
    gas: gasEstimate,
};
const signedTx = await web3.eth.accounts.signTransaction(txObject, privateKey);
const receipt = await web3.eth.sendSignedTransaction(signedTx.rawTransaction);
console.log('交易已发送，交易哈希：', receipt.transactionHash);

发送交易调用合约函数时，需要先估计交易所需的 gas 数量，然后构建交易对象，使用私钥对交易进行签名，最后发送交易并获取交易哈希。

七、注意事项