简介:Web3.eth.getBalance是一个用于查询以太坊账户余额的JavaScript函数。本文将详细介绍该函数的工作原理、参数、返回值以及如何使用它来获取以太坊账户的余额。
Web3.eth.getBalance是一个JavaScript函数,用于查询以太坊区块链上指定地址的账户余额。它是Web3.js库的一部分,一个用于与以太坊区块链交互的JavaScript库。通过使用Web3.eth.getBalance,开发者可以轻松地获取以太坊账户的余额,以便在智能合约或DApp中进行进一步的操作。
函数签名:
web3.eth.getBalance(addressHexString[, defaultBlock][, callback])
参数:
addressHexString(必需):要查询余额的以太坊地址,以十六进制字符串格式提供。defaultBlock(可选):指定要查询的区块。如果不设置此值,将使用web3.eth.defaultBlock设定的块。可以是区块号(Number)或字符串(如’latest’表示最新区块,’earliest’表示最早区块,’pending’表示待处理的区块)。callback(可选):回调函数,用于支持异步的执行方式。回调函数接受两个参数:第一个参数是错误对象(如果有的话),第二个参数是包含给定地址的当前余额的BigNumber实例。在上述示例中,我们首先引入Web3库,然后初始化Web3实例并连接到本地的Ganache节点(以太坊测试网络)。接下来,我们使用
// 引入Web3库const Web3 = require('web3');// 初始化Web3与以太坊节点连接const web3 = new Web3('http://localhost:8545'); // 假设使用本地的Ganache节点// 查询指定地址的账户余额const address = '0x407d73d8a49eeb85d32cf465507dd71d507100c1'; // 示例地址web3.eth.getBalance(address).then(console.log).catch(console.error);
web3.eth.getBalance函数查询指定地址的账户余额,并通过.then()方法处理返回的结果。如果发生错误,则通过.catch()方法处理错误。