环境： fisco2.8.0
go 1.17
go-sdk 1.0.0
solidity 0.4.25
前言
请提前启动好四个fisco节点。
请准备好一个属于此fisco节点的账户私钥【待会调用合约和部署合约会用到】
此文章将讲解 官方文档使用gosdk部署helloworld合约并调用其方法 合约开发样例
官网提示
Golang, 版本需不低于1.13.6，本项目采用go module进行包管理。具体可查阅Using Go Modules，环境配置
FISCO BCOS 2.2.0+, 需要提前运行 FISCO BCOS 区块链平台，可参考安装搭建
Solidity编译器，默认0.4.25版本
gosdk的拉取
# 拉取代码
git clone https://github.com/FISCO-BCOS/go-sdk.git
# 若因为网络问题导致长时间无法执行上面的命令，请尝试以下命令：
git clone https://gitee.com/FISCO-BCOS/go-sdk.git
root@192-168-19-133:/usr/project/goproject# ll
drwxr-xr-x 17 root root 4096 11月 16 10:29 go-sdk/
go-sdk的tag版本
root@192-168-19-133:/usr/project/goproject/go-sdk# git show
commit d1a8411d0e7600e2ece7c50c6da523ee52f32a45 (HEAD -> master, tag: v1.0.0, origin/master, origin/HEAD)
Merge: 5ca92a0 797900f
Author: XingQiang Bai <bxq2011hust@qq.com>
Date: Thu May 12 17:22:46 2022 +0800
Merge pull request #148 from FISCO-BCOS/release-v1.0.0
Release v1.0.0
创建 helloworld的项目
我选择不跟官网的步骤，不在go-sdk目录进行创建，选择在gopath的工作目录下面进行项目创建【这样比较方便管理】
root@192-168-19-133:/usr/project/goproject# mkdir helloworld
然后进行go项目初始化
root@192-168-19-133:/usr/project/goproject/helloworld# go mod init helloworld
go: creating new go.mod: module helloworld
然后在helloworld目录下，编写一个HelloWorld.sol的合约
pragma solidity>=0.4.24 <0.6.11;
contract HelloWorld {
string value;
constructor() public {
value = "你好，golang!";
}
function get() public view returns (string memory) {
return value;
}
function set(string v) public {
value = v;
}
}
进行安装solc编译器
在helloworld项目下执行此命令，需要用到在go-sdk里面的下载编译器脚本文件， go-sdk的目录需要根据各自的实际情况来选择
bash /usr/project/goproject/go-sdk/tools/download_solc.sh -v 0.4.25 # 它会做链接到当前目录下
root@192-168-19-133:/usr/project/goproject/helloworld# bash /usr/project/goproject/go-sdk/tools/download_solc.sh -v 0.4.25
Downloading solc 0.4.25 solc-linux.tar.gz from https://github.com/FISCO-BCOS/solidity/releases/download/v0.4.25/solc-linux.tar.gz
==============================================================
[INFO] os : linux
[INFO] solc version : 0.4.25
[INFO] solc location : ./solc-0.4.25
==============================================================
[INFO] ./solc-0.4.25 --version
solc, the solidity compiler commandline interface
Version: 0.4.25+commit.46d177ad.mod.Linux.g++
root@192-168-19-133:/usr/project/goproject/helloworld# ll
总用量 12
drwxr-xr-x 2 root root 4096 11月 16 10:46 ./
drwxrwxrwx 8 root root 4096 11月 16 10:38 ../
-rw-r--r-- 1 root root 294 11月 16 10:43 HelloWorld.sol
lrwxrwxrwx 1 root root 29 11月 16 10:46 solc-0.4.25 -> /root/.fisco/solc/solc-0.4.25*
生成abi,bin文件
使用solc 进行编译 命令的意思是，根据HelloWorld.sol生成abi,bin文件到当前目录下
root@192-168-19-133:/usr/project/goproject/helloworld# ./solc-0.4.25 --bin --abi -o ./ ./HelloWorld.sol #
root@192-168-19-133:/usr/project/goproject/helloworld# ll
总用量 20
drwxr-xr-x 2 root root 4096 11月 16 10:49 ./
drwxrwxrwx 8 root root 4096 11月 16 10:38 ../
-rw-r--r-- 1 root root 375 11月 16 10:49 HelloWorld.abi
-rw-r--r-- 1 root root 2010 11月 16 10:49 HelloWorld.bin
-rw-r--r-- 1 root root 294 11月 16 10:43 HelloWorld.sol
lrwxrwxrwx 1 root root 29 11月 16 10:46 solc-0.4.25 -> /root/.fisco/solc/solc-0.4.25*
构建go-sdk的代码生成工具abigen
该工具用于将 abi 和 bin 文件转换为 go 文件
进入go-sdk目录，编译生成abigen工具 [会生成一个abigen的二进制文件]
root@192-168-19-133:/usr/project/goproject/go-sdk# go build ./cmd/abigen/
root@192-168-19-133:/usr/project/goproject/go-sdk# ll | grep abigen
-rwxr-xr-x 1 root root 21519720 11月 16 11:33 abigen*
若 上面步骤报错：可以在go-sdk目录执行此命令，把依赖重新下载导入一下
go mod tidy
然后将此文件复制到helloworld项目,[此abigen可以复用，以后想用abigen，直接复制就可以了，不需要再去go-sdk里再编译]
cp -r abigen ../helloworld/`
编译生成go文件
在helloworld目录下执行命令编译
./abigen --bin ./HelloWorld.bin --abi ./HelloWorld.abi --pkg helloworld --type HelloWorld --out ./HelloWorld.go
命令的意思是使用bin,abi文件在当前目录下 生成一个包为helloworld ，类型为HelloWorld的HelloWorld.go文件
root@192-168-19-133:/usr/project/goproject/helloworld# ll
drwxrwxrwx 4 root root 4096 11月 16 11:36 ./
drwxrwxrwx 8 root root 4096 11月 16 11:35 ../
-rwxrwxrwx 1 root root 21519720 11月 16 11:37 abigen*
-rwxrwxrwx 1 root root 531 11月 16 11:06 config.toml*
-rw-r--r-- 1 root root 1970 11月 16 11:31 go.mod
-rwxrwxrwx 1 root root 375 11月 16 10:49 HelloWorld.abi*
-rwxrwxrwx 1 root root 2010 11月 16 10:49 HelloWorld.bin*
-rwxrwxrwx 1 root root 13739 11月 16 11:03 HelloWorld.go*
-rwxrwxrwx 1 root root 294 11月 16 10:43 HelloWorld.sol*
lrwxrwxrwx 1 root root 29 11月 16 10:46 solc-0.4.25 -> /root/.fisco/solc/solc-0.4.25*
准备部署合约的相关文件
拷贝 config.toml 并修改配置
将 go-sdk目录下config.toml拷贝到helloworld目录下
cp -r ../go-sdk/config.toml .
拷贝节点的sdk文件目录到helloworld目录下【根据自己的机子存放情况来执行命令】
拷贝账户私钥到helloworld目录下【前言有说明】
当前目录存在的文件
root@192-168-19-133:/usr/project/goproject/helloworld# ll
总用量 21120
drwxrwxrwx 4 root root 4096 11月 16 12:41 ./
drwxrwxrwx 8 root root 4096 11月 16 11:35 ../
-rwxrwxrwx 1 root root 21519720 11月 16 11:37 abigen*
-rwxrwxrwx 1 root root 249 11月 16 11:05 admin.pem* ## 私钥
-rwxrwxrwx 1 root root 531 11月 16 11:06 config.toml* ## 配置文件
-rw-r--r-- 1 root root 1970 11月 16 11:31 go.mod # go mod文件
-rwxrwxrwx 1 root root 375 11月 16 10:49 HelloWorld.abi*
-rwxrwxrwx 1 root root 2010 11月 16 10:49 HelloWorld.bin*
-rwxrwxrwx 1 root root 13739 11月 16 11:03 HelloWorld.go*
-rwxrwxrwx 1 root root 294 11月 16 10:43 HelloWorld.sol*
drwxrwxrwx 2 root root 4096 11月 16 11:03 sdk/ # 节点连接证书
lrwxrwxrwx 1 root root 29 11月 16 10:46 solc-0.4.25 -> /root/.fisco/solc/solc-0.4.25*
修该config.toml
[Network]
#type rpc or channel
Type="channel"
# 三个节点证书，使用相对路径
CAFile="./sdk/ca.crt"
Cert="./sdk/sdk.crt"
Key="./sdk/sdk.key"
# if the certificate context is not empty, use it, otherwise read from the certificate file
# multi lines use triple quotes
CAContext=''''''
KeyContext=''''''
CertContext=''''''
[[Network.Connection]]
NodeURL="127.0.0.1:20200" # 节点的地址
GroupID=1 # 群组id
# [[Network.Connection]]
# NodeURL="127.0.0.1:20200"
# GroupID=2
[Account]
# only support PEM format for now
KeyFile="./admin.pem" #使用什么账户调用合约
[Chain]
ChainID=1 #链id
SMCrypto=false # 费国密
[log]
Path="./"
编写部署合约的go文件 并部署
在helloworld目录下创建cmd文件夹，在cmd文件夹下创建一个main.go文件
代码如下
package main
import (
"fmt"
"log"
"helloworld" //导入本地项目helloworld
"github.com/FISCO-BCOS/go-sdk/client"
"github.com/FISCO-BCOS/go-sdk/conf"
)
func main(){
configs, err := conf.ParseConfigFile("config.toml") //读取config.toml文件
if err != nil {
log.Fatal(err)
}
config := &configs[0]
client, err := client.Dial(config) //加载配置文件，生成client进行相关链操作
if err != nil {
log.Fatal(err)
}
address, tx, instance, err := helloworld.DeployHelloWorld(client.GetTransactOpts(), client) // 调用hellowrold的部署合约方法
if err != nil {
log.Fatal(err)
}
fmt.Println("contract address: ", address.Hex()) // 合约的地址
fmt.Println("transaction hash: ", tx.Hash().Hex()) //此次部署合约的交易hash
_ = instance
}
然后在helloworld目录下执行依赖包导入命令
go mod tidy
如果导入失败了，可以复制go-sdk的go.mod和go.sum文件，修改好项目名，进行go mod tidy
还有确保GO111MODULE是on
此时项目的目录
root@192-168-19-133:/usr/project/goproject/helloworld# ll
总用量 21120
drwxrwxrwx 4 root root 4096 11月 16 12:50 ./
drwxrwxrwx 8 root root 4096 11月 16 11:35 ../
-rwxrwxrwx 1 root root 21519720 11月 16 11:37 abigen*
-rwxrwxrwx 1 root root 249 11月 16 11:05 admin.pem*
drwxrwxrwx 2 root root 4096 11月 16 12:47 cmd/
-rwxrwxrwx 1 root root 531 11月 16 12:42 config.toml*
-rw-r--r-- 1 root root 1970 11月 16 11:31 go.mod
-rw-r--r-- 1 root root 46323 11月 16 11:31 go.sum
-rwxrwxrwx 1 root root 375 11月 16 10:49 HelloWorld.abi*
-rwxrwxrwx 1 root root 2010 11月 16 10:49 HelloWorld.bin*
-rwxrwxrwx 1 root root 13739 11月 16 11:03 HelloWorld.go*
-rwxrwxrwx 1 root root 294 11月 16 10:43 HelloWorld.sol*
drwxrwxrwx 2 root root 4096 11月 16 11:03 sdk/
lrwxrwxrwx 1 root root 29 11月 16 10:46 solc-0.4.25 -> /root/.fisco/solc/solc-0.4.25*
在helloworld 文件夹下执行命令 go run cmd/main.go
root@192-168-19-133:/usr/project/goproject/helloworld# go run cmd/main.go
contract address: 0xA2132f9E796F954f4483A7078a357114F54D2f1B
transaction hash: 0x741fe11c3f1da7ad2ca43deb3b7045c170ce43aa5b3581bdfbf86a6fc323e331
然后就获得了部署合约的地址，部署成功
编写get/set方法的go文件，并调用
根据官网的例子，在helloworld文件夹下创建contract文件夹，并在在contract文件夹下编写go文件helloworld_set_get.go文件
package main
import (
"fmt"
"log"
"helloworld" //导入本地项目helloworld
"github.com/FISCO-BCOS/go-sdk/client"
"github.com/FISCO-BCOS/go-sdk/conf"
"github.com/ethereum/go-ethereum/common"
)
func main() {
configs, err := conf.ParseConfigFile("config.toml") //读取配置文件
if err != nil {
log.Fatal(err)
}
config := &configs[0]
client, err := client.Dial(config) //加载配置文件，生成client
if err != nil {
log.Fatal(err)
}
// load the contract
contractAddress := common.HexToAddress("0xA2132f9E796F954f4483A7078a357114F54D2f1B") // 这里请放入刚刚部署的合约地址，注意，是你自己的机子部署的地址
instance, err := helloworld.NewHelloWorld(contractAddress, client) //根据地址和client生成helloworld合约对象
if err != nil {
log.Fatal(err)
}
helloworldSession := &helloworld.HelloWorldSession{Contract: instance, CallOpts: *client.GetCallOpts(), TransactOpts: *client.GetTransactOpts()} //根据合约对象和client的call和transact进行实例化一个合约通信对象 helloworldSession
value, err := helloworldSession.Get() // 调用get方法
if err != nil {
log.Fatal(err)
}
fmt.Println("value :", value)
value = "Hello, Hello，Hello"
tx, receipt, err := helloworldSession.Set(value) // 调用set方法
if err != nil {
log.Fatal(err)
}
fmt.Printf("tx sent: %s\n", tx.Hash().Hex()) //调用set方法的交易hash
fmt.Printf("transaction hash of receipt: %s\n", receipt.GetTransactionHash()) //调用set方法的交易hash ,与上面的hash是一样，只是存在不同的地方而已
}
执行go文件,在helloworld目录下
go run contract/helloworld_set_get.go
结果
root@192-168-19-133:/usr/project/goproject/helloworld# go run contract/helloworld_set_get.go
value : 你好，golang!
tx sent: 0x5a49ac1b48ebe717c75cbeb3a3144a031db8cfd5a0cdf7c38a151a87f1454583
transaction hash of receipt: 0x5a49ac1b48ebe717c75cbeb3a3144a031db8cfd5a0cdf7c38a151a87f1454583
结语
相较于fisco的java-sdk ，go-sdk的使用起来还是比较困难，因为webase也集成了java-sdk，一键就能导出所有所需要的java项目文件。
若有空，我将讲解如果结合goweb的框架，集成fisco和使用go文件调用合约，生成web项目【我比较倾向讲解beego框架】。
3033
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
