在区块链开发中，查询以太坊主币及代币余额是一项基础且关键的操作。本文将详细解析如何通过 Web3.js 库实现地址余额的获取与数据格式化，帮助开发者快速掌握相关技能。
以太坊主币余额查询
以太坊主币（ETH）的查询相对直接，可通过 Web3.js 提供的 API 方法快速实现。
核心方法与步骤
使用 web3.eth.getBalance() 方法，传入公钥地址即可获取主币余额：
const baseValue = web3.eth.getBalance(address); // address 为以太坊公钥地址数据单位转换
需要注意的是，该方法返回的余额值是以 Wei（以太坊最小单位）为单位的数值。在实际应用中，通常需要将其转换为更易读的单位（如 Ether）。转换方法如下：
baseValue = web3.utils.fromWei(baseValue, "ether");转换后的 baseValue 即为以 Ether 为单位的余额数值，便于直接阅读和使用。
代币余额查询流程
代币余额的查询需借助智能合约的 ABI 接口和合约地址，通过合约实例调用相关方法实现。
获取合约实例
首先，需通过合约 ABI 和合约地址创建合约实例：
const myContract = new web3.eth.Contract(contractAbi, contractAddress); // contractAddress 为代币合约地址，contractAbi 为合约 ABI 接口查询代币信息
通过合约实例可获取代币的详细信息，包括名称、符号、余额及小数位数：
- 代币名称：
myContract.methods.name().call() - 代币符号：
myContract.methods.symbol().call() - 代币余额：
myContract.methods.balanceOf(address).call()// 需传入查询地址 - 小数位数：
myContract.methods.decimals().call()
余额单位转换
与主币类似，代币余额返回的数值也是以最小单位（如 Wei）为单位的。需根据代币的小数位数进行转换：
// 假设 decimals 为代币的小数位数
const formattedBalance = balance / (10 ** decimals);转换后的余额即为用户友好的实际代币数量。
常见问题
如何获取合约 ABI？
合约 ABI（Application Binary Interface）通常可在代币项目的官方文档、区块链浏览器（如 Etherscan）或开源代码库中找到。确保使用与合约版本匹配的 ABI。
为什么余额查询返回的是十六进制数？
Web3.js 默认返回十六进制格式的数据。可使用 web3.utils.hexToNumberString() 或 parseInt() 将其转换为十进制数后再处理。
主币和代币余额查询的主要区别是什么？
主币查询直接通过以太坊网络 API 实现，而代币查询需通过智能合约接口进行。代币余额还需依赖合约地址和 ABI，步骤稍复杂。
查询余额时出现错误如何排查？
首先检查地址格式是否正确，其次确认网络连接是否正常。对于代币查询，还需验证合约地址和 ABI 是否匹配，以及合约是否已部署生效。
除了 Web3.js，还有哪些库可用于余额查询？
ethers.js 和 web3.py（Python 版）等库也支持类似功能。选择取决于开发环境和偏好，但核心逻辑相通。
如何实时监控余额变化？
可通过订阅区块链事件或定时轮询实现。对于高频需求，建议使用 WebSocket 连接以提升效率并降低延迟。👉 查看实时监控工具
结语
掌握以太坊主币和代币余额查询是区块链开发的基础。通过本文介绍的方法，您可快速实现余额获取与数据处理。实际应用中，记得处理网络异常和数据类型转换，确保代码的健壮性。