ethers.jsV5.4文档
安装ethers
npm install ethers@5.4.0
// 引入
import { ethers } from 'ethers'
Providers
/** Provider类* Provider类是对以太坊网络连接的抽象，为标准以太坊节点功能提供简洁、一致的接口。
*/
const provider = new ethers.providers.Web3Provider(window.ethereum);
console.log(provider);
getNetwork()，查询provider连接到了哪条链，homestead代表ETH主网
let network = await provider.getNetwork();
console.log('network：',network);
getBalance()，查询主链ETH余额
let getBalance = await provider.getBalance("myAddress");
console.log('余额：',ethers.utils.formatEther(getBalance));
getGasPrice()，查询gasPrice最准预测
getFeeData()，返回一个更详细的maxFeePerGas/maxPriorityFeePerGas/gasPrice
let gasPrice = await provider.getGasPrice(); // 燃料价格 (单位： wei)
let gasPrice2 = ethers.utils.formatUnits(gasPrice, "gwei"); // 通常来说燃料的价格用 gwei 会更好理解
console.log('gasPrice：',gasPrice2);
let feeData = await provider.getFeeData();
console.log('maxFeePerGas',ethers.utils.formatUnits(feeData.maxFeePerGas, "gwei"));
console.log('maxPriorityFeePerGas',ethers.utils.formatUnits(feeData.maxPriorityFeePerGas, "gwei"));
console.log('gasPrice',ethers.utils.formatUnits(feeData.gasPrice, "gwei"));
交易查询
查询交易是否成功
transactionHash：拿的之前转账的哈希值过来查询测试，查询该交易是否成功。
getTransaction 和 getTransactionReceipt 返回交易的详细数据，如果交易未知，则返回null。
getTransaction() 可以理解为为该笔交易发送的参数。
getTransactionReceipt() 理解为该笔交易返回的结果，如果res.status == 1 说明交易成功了（通常需要使用轮询查询这笔交易状态）
provider.getTransaction("0x958e0340e49f80e67703245fd82b556491dcbbbf6f059cadf853f577d12d70fb").then(res=>{console.log('getTransaction_res',res);
}).catch(err=>{console.log('getTransaction_err',err);
})provider.getTransactionReceipt("0x958e0340e49f80e67703245fd82b556491dcbbbf6f059cadf853f577d12d70fb").then(res=>{console.log('getTransactionReceipt_res',res);
}).catch(err=>{console.log('getTransactionReceipt_err',err);
})
监听行为
/** 监听行为* EventEmitter API允许注册 各种事件 发生时的回调函数。* provider.on(eventName,listener) 为每一个参数为eventName的 事件添加监听器。* provider.once(eventName,listener) 为参数为eventName的 事件添加监听器，监听使用过后将会被移除。* provider.emit( eventName , ...args ) 通知所有的eventName event监听器，并把参数传递给它们。这通常只在内部使用。* provider.off( eventName [ , listener ] ) 移除一个参数为eventName的事件监听器，如果没有提供listener参数，则移除所有关于eventName的监听器。* provider.removeAllListeners( [ eventName ] )移除所有参数为eventName的事件监听器，如果没有提供eventName参数，则移除所有事件* provider.listenerCount( [ eventName ] ) 返回所有参数为eventName事件的监听器数量。如果没有提供eventName参数，返回所有监听器的数量。* provider.listeners( eventName ) 返回参数为eventName事件监听器的list集合。* * * eventName参数包括以下：* "block" blockNumber 当一个区块被挖出时触发 * "error" error 只要有错误就触发 * "pending" pendingTransaction 当一个新交易进入内存池时触发;只有特定的providers提供此事件，从而在运行在自己的节点上获得可靠的数据 * "willPoll" pollId 在一个polling loop开始之前触发;(大多数开发者很少使用) * "poll" pollId, blockNumber 在每个poll cycle中，`blockNumber`更新之后(如果改变了)，以及与在poll loop中任何其他的事件(如果有)之前触发; (大多数开发者很少使用) * "didPoll" pollId 在polling loop中的所有事件被触发后触发;(大多数开发者很少使用) * "debug" provider dependent 每个Provider可以使用它来发出有用的调试信息，格式由开发者决定;(大多数开发者很少使用) (very rarely used by most developers)* *
*/
