gotron-sdk的简要介绍

gotron-sdk是基于gRPC的Go SDK实现和cli工具

这东西看起来大多数人都是作cli使用，如果想要拿来当go-ethereum，没有任何文档的可以用来参考，唯一能做的，只能翻源码……

为了让更多人少踩坑，特作此简易教程，愿能帮助到深受波场毒害的科学家们（

连接到gRPC节点

gotron-sdk仅支持gRPC方式的连接

NewGrpcClient方法可以传入gRPC地址，默认将Start时使用grpc.trongrid.io:50051，返回GrpcClient实例

请注意，NewGrpcClient并不会真正建立RPC连接，需要调用Start方法，可变参为grpc.DialOption

import "github.com/fbsobreira/gotron-sdk/pkg/client"
rpcClient := client.NewGrpcClient("")
err := rpcClient.Start(grpc.WithInsecure())

地址转换

波场地址以大写字母 T 开头，是以太坊地址前增加字节 0x41 后 Base58check 得到的，共34位字符

import "github.com/fbsobreira/gotron-sdk/pkg/address"
addr, err := address.Base58ToAddress("TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t")
log.Println(addr.String())

另：gotron-sdk中大多数对外方法都使用string，并且在每个方法中都调用Base58ToAddress

私钥导入

需要注意下列方法导入并非临时使用，而是真的导入了本地存储，之后可以凭借钱包地址与密码直接使用

import "github.com/fbsobreira/gotron-sdk/pkg/account"
accountName, err := account.ImportFromPrivateKey(privateKey, "", accountPassword)
accountName, err := account.ImportKeyStore("keystoreFilePath", "", accountPassword)

TODO：目前没有找到临时使用的方法

合约调用

调用无参constant方法

调用TRC20代币的name()查询代币名称，这里以USDT为例

为展示TRC20Call的用法，这里不使用已经封装好的TRC20GetName

import "github.com/fbsobreira/gotron-sdk/pkg/common"
// 获得方法名的SHA-3
nameSign := common.BytesToHexString(abi.Signature("name()"))
result, err := rpcClient.TRC20Call("", "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", nameSign, true, 0)
if err != nil {
    log.Println(err)
    return
}
data, _ := rpcClient.ParseTRC20StringProperty(common.BytesToHexString(result.GetConstantResult()[0]))
log.Println(data)

调用有参与需要签名的方法

没有文档，真的坑啊！这里演示如何与有参数、需要签名的方法进行交互

参数的构建

在client的TriggerContract方法里，有jsonString 这样一个奇怪的参数……常规来说，这肯定是ABI的参数，但是，怎么用，这是个问题（

阅读abi.LoadFromJSON与abi.GetPaddedParam的源码，可以确定，这个jsonString应该长成这样：

// ABI（有简化
{
    "inputs": [
        {
            "name": "_to",
            "type": "address"
        },
        {
            "name": "_value",
            "type": "uint256"
        }
    ],
    "name": "transfer"
}
// jsonString是以类型为key，值为value的数组，且uint应使用字符串类型
[
    {
        "address": "TWRhFW2AQg8Ae2j8BynFnGNfj7xg95qhvQ"
    },
    {
        "uint256": "100000"
    }
]

以transfer为例

本例调用USDT的transfer方法对其他地址进行转账，直接上代码，为了简洁err省略，实际使用还请认真处理

一定要注意，TriggerContract方法并不会发送Tx，这可以说是这个包最坑的地方了

// 携带的数据
triggerData := "[{\"address\":\"TWRhFW2AQg8Ae2j8BynFnGNfj7xg95qhvQ\"},{\"uint256\":\"100000\"}]"

// 构建Tx，注意，此处只是构造，tx并没有被发送
// 参数分别为 发送者地址 合约地址 调用方法(正常字符串) gas Tx发送的TRX数量 Tx发送的TRC20代币 代币数量
tx, _ := rpcClient.TriggerContract(wallet, contract, "transfer(address,uint256)", triggerData, 300000000, 0, "", 0)

// 获得keystore与account
ks, acct, _ := store.UnlockedKeystore(wallet, accountPassword)
// 封装Tx
ctrlr := transaction.NewController(rpcClient, ks, acct, tx.Transaction)
// 真正执行Tx，并判断执行结果
if err = ctrlr.ExecuteTransaction(); err != nil {
    log.Println(err.Error())
    return
}
// 此时Tx才上链
log.Println(common.BytesToHexString(tx.GetTxid()))
log.Println(common.BytesToHexString(tx.GetResult().GetMessage()))