跳到主要内容

Ethers极简入门: 5. 合约交互

我最近在重新学ethers.js,巩固一下细节,也写一个WTF Ethers极简入门,供小白们使用。

推特@0xAA_Science

WTF Academy社群: 官网 wtf.academy | WTF Solidity教程 | discord | 微信群申请

所有代码和教程开源在github: github.com/WTFAcademy/WTFEthers


这一讲,我们将介绍如何声明可写的Contract合约变量,并利用它与测试网的WETH合约交互。

创建可写Contract变量

声明可写的Contract变量的规则:

const contract = new ethers.Contract(address, abi, signer)

其中address为合约地址,abi是合约的abi接口,signerwallet对象。注意,这里你需要提供signer,而在声明可读合约时你只需要提供provider

你也可以利用下面的方法,将可读合约转换为可写合约:

const contract2 = contract.connect(signer)

合约交互

我们在第三讲介绍了读取合约信息。它不需要gas。这里我们介绍写入合约信息,你需要构建交易,并且支付gas。该交易将由整个网络上的每个节点以及矿工验证,并改变区块链状态。

你可以用下面方法方法进行合约交互:

// 发送交易
const tx = await contract.METHOD_NAME(args [, overrides])
// 等待链上确认交易
await tx.wait()

其中METHOD_NAME为调用的函数名,args为函数参数,[, overrides]是可以选择传入的数据,包括:

  • gasPrice:gas价格
  • gasLimit:gas上限
  • value:调用时传入的ether(单位是wei)
  • nonce:nounce

注意: 此方法不能获取合约运行的返回值,如有需要,要使用Solidity事件记录,然后利用交易收据去查询。

例子:与测试网WETH合约交互

WETH (Wrapped ETH)是ETH的带包装版本,将以太坊原生代币用智能合约包装成了符合ERC20的代币。对WETH合约更详细的内容可以参考WTF Solidity极简合约的第41讲 WETH

  1. 创建providerwallet变量。

    import { ethers } from "ethers";

    // 利用Infura的rpc节点连接以太坊网络
    const INFURA_ID = '184d4c5ec78243c290d151d3f1a10f1d'
    // 连接Rinkeby测试网
    const provider = new ethers.providers.JsonRpcProvider(`https://rinkeby.infura.io/v3/${INFURA_ID}`)

    // 利用私钥和provider创建wallet对象
    const privateKey = '0x227dbb8586117d55284e26620bc76534dfbd2394be34cf4a09cb775d593b6f2b'
    const wallet = new ethers.Wallet(privateKey, provider)
  2. 创建可写WETH合约变量,我们在ABI中加入了3个我们要调用的函数:

    • balanceOf():查询地址的WETH余额。
    • deposit():将转入合约的ETH转为WETH
    • transfer():转账。
    // WETH的ABI
    const abiWETH = [
    "function balanceOf(address) public view returns(uint)",
    "function deposit() public payable",
    "function transfer(address, uint) public returns (bool)",
    "function withdraw(uint) public",
    ];
    // WETH合约地址(Rinkeby测试网)
    const addressWETH = '0xc778417e063141139fce010982780140aa0cd5ab' // WETH Contract

    // 声明可写合约
    const contractWETH = new ethers.Contract(addressWETH, abiWETH, wallet)
  3. 读取账户WETH余额,可以看到余额为1.001997

    const address = await wallet.getAddress()
    // 读取WETH合约的链上信息(WETH abi)
    console.log("\n1. 读取WETH余额")
    const balanceWETH = await contractWETH.balanceOf(address)
    console.log(`存款前WETH持仓: ${ethers.utils.formatEther(balanceWETH)}\n`)

    读取WETH余额

  1. 调用WETH合约的deposit()函数,将0.001 ETH转换为0.001 WETH,打印交易详情和余额。deposit()函数没有参数,可以看到余额变为1.002997

        console.log("\n2. 调用desposit()函数,存入0.001 ETH")
    // 发起交易
    const tx = await contractWETH.deposit({value: ethers.utils.parseEther("0.001")})
    // 等待交易上链
    await tx.wait()
    console.log(`交易详情:`)
    console.log(tx)
    const balanceWETH_deposit = await contractWETH.balanceOf(address)
    console.log(`存款后WETH持仓: ${ethers.utils.formatEther(balanceWETH_deposit)}\n`)

    调用deposit

  2. 调用WETH合约的transfer()函数,给V神转账0.001 WETH,并打印余额。可以看到余额变为1.001997

        console.log("\n3. 调用transfer()函数,给vitalik转账0.001 WETH")
    // 发起交易
    const tx2 = await contractWETH.transfer("vitalik.eth", ethers.utils.parseEther("0.001"))
    // 等待交易上链
    await tx2.wait()
    const balanceWETH_transfer = await contractWETH.balanceOf(address)
    console.log(`转账后WETH持仓: ${ethers.utils.formatEther(balanceWETH_transfer)}\n`)

    给V神转WETH

总结

这一讲,我们介绍了如何声明可写的Contract合约变量,并利用它与测试网的WETH合约交互。我们不仅调用WETHdeposit()函数,将0.001 ETH转换为WETH,并转账给了V神。