【使用go开发区块链】之智能合约交互(03)

本章我们就来学习一下如何使用abigen生成合约go文件并进行调用

前两篇文章,我们讲解了go如何通过函数选择器、abi调用的方式与智能合约交互,那么有没有一种更加便捷的方式(就好像调用预先定义好的方法一样)与智能合约交互呢?答案是有的,本章我们就来学习一下如何使用abigen生成合约go文件并进行调用

本系列课程:

第一节:【使用go开发区块链】之智能合约交互(01)

第二节:【使用go开发区块链】之智能合约交互(02)

第三节:【使用go开发区块链】之智能合约交互(03)

<!--StartFragment-->

一、配置环境

<!--EndFragment--> <!--StartFragment-->

1、安装 go-ethereum

<!--EndFragment--> <!--StartFragment-->

 首先我们要安装 go-ethereum,本篇文章是在windows系统下操作,其他系统操作步骤基本类似,可自行参考安装

<!--EndFragment-->

image.png <!--StartFragment-->

 下载完成之后 直接默认/自定义目录安装即可,安装完成后我们打开安装目录,可以看到里面有很多.exe后缀的可执行文件

<!--EndFragment-->

image.png <!--StartFragment-->

 2、配置环境变量

<!--EndFragment--> <!--StartFragment-->

右键我的电脑-》高级系统设置-》环境变量-》系统变量,找到Path这个变量,然后点编辑按钮,在里面添加我们刚刚的安装目录,如下:

<!--EndFragment-->

image.png

<!--StartFragment-->

然后我们打开 命令行终端,快捷键:windows+R,输入cmd,然后回车,在终端输入 abigen -v

<!--EndFragment-->

image.png

<!--StartFragment-->

能正确输出安装版本号证明我们环境变量已经配置成功

<!--EndFragment--> <!--StartFragment-->

二、通过abigen生成go文件

<!--EndFragment--> <!--StartFragment-->

1、准备智能合约编译后生成的abi.json

<!--EndFragment-->

<!--StartFragment-->

(本文以标准ERC20合约作为示例,不知道怎么生成的可关注公众号私信我)

<!--EndFragment-->

[
  {
    "inputs": [],
    "stateMutability": "nonpayable",
    "type": "constructor"
  },
  {
    "anonymous": false,
    "inputs": [
      {
        "indexed": true,
        "internalType": "address",
        "name": "owner",
        "type": "address"
      },
      {
        "indexed": true,
        "internalType": "address",
        "name": "spender",
        "type": "address"
      },
      {
        "indexed": false,
        "internalType": "uint256",
        "name": "value",
        "type": "uint256"
      }
    ],
    "name": "Approval",
    "type": "event"
  },
  ……
]

<!--StartFragment-->

 2、通过abigen生成go文件

<!--EndFragment--> <!--StartFragment-->

2.1、我们先打开一个命令行终端,然后路径跳转到我们的abi.json存放目录下

<!--EndFragment-->

<!--StartFragment-->

2.2、在命令行终端输入以下命令:

<!--EndFragment-->

abigen --abi abi.json --pkg main --type Token --out Token.go

--abi abi.json 为我们要通过abigen生成go文件的 源文件路径

--pkg main 为我们要生成go文件里面的包名(生成的go文件第一行代码 如:package main)

--type Token 为我们生成go文件里可操作对象/方法/变量的组成部分,比如我这里写的是Token,那么生成的go文件里面的代码格式大概如下:

image.png <!--StartFragment-->

可以看到,里面无论是结构体、方法、变量,均会以该名字进行命名

--out Token.go 为生成go文件的名称 (ps:如果省略此命令,生成的go文件内容会打印在命令行终端上)

我们执行此命令后,可以看到当前目录下多了一个Token.go的文件,我们打开看一下:

<!--EndFragment-->

// Code generated - DO NOT EDIT.
// This file is a generated binding and any manual changes will be lost.

package main

import (
    "errors"
    "math/big"
    "strings"

    ethereum "github.com/ethereum/go-ethereum"
    "github.com/ethereum/go-ethereum/accounts/abi"
    "github.com/ethereum/go-ethereum/accounts/abi/bind"
    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/core/types"
    "github.com/ethereum/go-ethereum/event"
)

// Reference imports to suppress errors if they are not otherwise used.
var (
    _ = errors.New
    _ = big.NewInt
    _ = strings.NewReader
    _ = ethereum.NotFound
    _ = bind.Bind
    _ = common.Big1
    _ = types.BloomLookup
    _ = event.NewSubscription
    _ = abi.ConvertType
)

// TokenMetaData contains all meta data concerning the Token contract.
var TokenMetaData = &bind.MetaData{
    ABI: "……"
}
var TokenABI = TokenMetaData.ABI

// Token is an auto generated Go binding around an Ethereum contract.
type Token struct {
    TokenCaller     // Read-only binding to the contract
    TokenTransactor // Write-only binding to the contract
    TokenFilterer   // Log filterer for contract events
}
func (_Token *TokenSession) BalanceOf(account common.Address) (*big.Int, error) {
    return _Token.Contract.BalanceOf(&_Token.CallOpts, account)
}
func (_Token *TokenTransactorRaw) Transfer(opts *bind.TransactOpts) (*types.Transaction, error) {
    return _Token.Contract.contract.Transfer(opts)
}
…………

<!--StartFragment-->

可以看到,里面定义了很多结构体以及我们在合约里定义的方法在go文件里都有具体的实现,其实就是abigen帮我们把我们合约里定义的方法转成了go可以直接调用的方法,从而简化了我们的操作

<!--EndFragment--> <!--StartFragment-->

三、使用go调用生成的智能合约go文件

[]()1、安装go-ethereum

<!--EndFragment-->

go get -u github.com/ethereum/go-ethereum

<!--StartFragment-->

2、新建main.go文件,添加依赖

<!--EndFragment-->

    "context"
    "fmt"
    "github.com/ethereum/go-ethereum/accounts/abi/bind"
    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/crypto"
    "github.com/ethereum/go-ethereum/ethclient"
    "math/big"
    "os"

<!--StartFragment-->

3、定义常量

<!--EndFragment-->

const (
    privateKey      = "你的钱包私钥"
    contractAddress = "调用合约地址"
    toAddress       = "接收转账地址" //这里我使用transfer方法作为案例,所以需要一个接收转账地址
)

<!--StartFragment-->

4、调用演示

[]()4.1、新建main方法

<!--EndFragment-->

func main() {}

<!--StartFragment-->

 4.2、创建ethclient对象

<!--EndFragment-->

client, err := ethclient.Dial("https://goerli.infura.io/v3/……")
if err  != nil {
    fmt.Println("ethclient.Dial error : ", err)
    os.Exit(0)
}

<!--StartFragment-->

4.3、创建智能合约对象

<!--EndFragment--> 这里的NewToken其实就是我们生成的Token.go文件里的一个方法,通过传递合约地址、ethclient对象,他便会帮我们创建一个合约对象,我们通过这个合约对象就可以很方便调用合约里定义好的各种方法

token, err := NewToken(common.HexToAddress(contractAddress), client)
if err != nil {
    fmt.Println("NewToken error : ", err)
}

<!--StartFragment-->

4.4、方法调用

4.4.1、call方法演示

<!--EndFragment-->

<!--StartFragment-->

call方法主要用来调用智能合约的查询方法(即不修改链上数据,不花费gas

<!--EndFragment--> <!--StartFragment-->

这里,我们调用的是智能合约的TotalSupply方法,它会返回该智能合约(本案例以ERC20 为例)的总供应量

<!--EndFragment-->

totalSupply, err := token.TotalSupply(nil)
if err != nil {
    fmt.Println("token.TotalSupply error : ", err)
}
fmt.Println("totalSupply is : ", totalSupply)

image.png <!--StartFragment-->

可以看到,控制台成功打印出合约返回的信息

<!--EndFragment--> <!--StartFragment-->

4.4.2、send方法演示

send方法,主要用来调用智能合约里会修改链上数据的方法(花费gas) 

<!--EndFragment--> <!--StartFragment-->

我们以Transfer方法为例,进行一笔账号之间的转账操作:

<!--EndFragment-->

// 获取当前区块链的ChainID
chainID, err := client.ChainID(context.Background())
if err != nil {
        fmt.Println("获取ChainID失败:", err)
        return
}
privateKeyECDSA, err := crypto.HexToECDSA(privateKey)
if err != nil {
        fmt.Println("crypto.HexToECDSA error ,", err)
        return
}

gasTipCap, _ := client.SuggestGasTipCap(context.Background())

//构建参数对象
opts, err := bind.NewKeyedTransactorWithChainID(privateKeyECDSA, chainID)
if err != nil {
        fmt.Println("bind.NewKeyedTransactorWithChainID error ,", err)
        return
}
//设置参数
opts.GasFeeCap = big.NewInt(108694000460)
opts.GasLimit = uint64(100000)
opts.GasTipCap = gasTipCap

amount, _ := new(big.Int).SetString("100000000000000000000", 10)
//调用合约transfer方法
tx, err := token.Transfer(opts, common.HexToAddress(toAddress), amount)
if err != nil {
        fmt.Println("token.Transfer error ,", err)
        return
}

fmt.Println("使用go调用智能合约第三讲:transfer tx : ", tx.Hash().Hex())

image.png

<!--StartFragment-->

成功返回哈希值,让我们去区块链浏览器里看一下 

<!--EndFragment-->

image.png

image.png <!--StartFragment-->

可以看到链上交易已经完成

<!--EndFragment-->

到此,使用go与智能合约的教程全部完成,你学会了吗?没有学会不要紧,多做两遍,熟能生巧,你一定也可以的!如果在学习过程中有任何问题,欢迎给我留言,另外公众号也会不定期分享关于区块链、web3的前沿信息,感兴趣的朋友可以保持关注

请关注公众号:外柏叁布道者(web3_preacher),回复 “go合约调用” 领取完整代码

点赞 3
收藏 1
分享
本文参与登链社区写作激励计划 ,好文好收益,欢迎正在阅读的你也加入。

0 条评论

请先 登录 后评论
外柏叁布道者
外柏叁布道者
0x6ea1...9dbe
全网同名 资深区块链专家 更多web3、区块链技术与前沿信息 请关注公众号:外柏叁布道者(web3_preacher) Web3工具网站现已上线: https://utools.me 不定时更新各种实用工具,敬请关注 接各种Dapp、合约、web3相关工具开发