-Infura Logo from Consensys-
Infura 提供公开的 Ethereum 主网和测试网络节点。到 Infura 官网申请,只要输入一点基本资料和 Email,就可以收到 API-key。
-Infura API keys-
使用 RPC 查询合约内储存的状态
最常需要查询的状态就是 Token 的余额啦。我就用 EOS Token 合约做为范例试看看。
取得合约信息
可以透过 Etherscan,大部分知名的合约可以直接搜寻到。
要呼叫合约,至少需要:
合约地址,例如:0x86Fa049857E0209aa7D9e616F7eb3b3B78ECfdb0
要呼叫的 function signature,例如以 ERC 20 Token 合约来说,查询余额要呼叫的 function 是 ,其对应的 function signature 是 。
如何取得 function signature 呢?
以 为例:
i. 把 经过 sha3
ii. 取除了 外,前面的 8 位
以上流程可以用任何工具完成,以 web3.js 为例:
另外也可以把 contract code 贴到 Remix(编者注:可见文末链接)。在合约的 Details 中可以看到完整的合约接口和对应的 function signature。
使用 RPC
可以透过一个简单的 POST 用 Infura 提供的节点呼叫一个 RPC。有哪些 RPC method 可以看 Ethereum RPC doc。
如果要呼叫的 function 只是查询,而没有要更新合约的状态,那就
用 这个 RPC。POST Data 如下:
其中 的值包含:
:合约地址
:丢给合约的参数。由三个部分组成: 、 和一个 32 bytes 的参数 (也就是我要查询的账户)
,代表使用最新的区块链数据
范例
是十六进制,换算成十进制是 。EOS token 的 为 ,也就是小弟的账户只有少少的 。
web3.js(Ethereum JavaScript API)
如果要更新合约的状态,就需要送 transaction,要送 transaction 就需要钱包或是说 private key 来 sign transaction 和提供 Ether 做手续费。因为送 transaction 要手续费,为了省点钱,我就部一个合约在 Ropsten 测试链上做这次的试验。以上步骤比较麻烦,我用 web3.js 写两个简单的程序,一个查询合约状态、一个更新合约状态。web3.js 的功能和 RPC 差不多,但是个 JavaScript 套件。有哪些 API 可以用请看 JavaScript API doc。
安装
官方建议的初始化方式
部署测试合约
这次部署一个很简单的合约。合约只储存一个状态 ,并可透过 更新状态。详细如何部署合约,可参考我的另一篇文章(编者注:亦可见文末链接)。
合约程序代码:
合约地址:
合约的 function signatures:
查询合约状态
使用 。
Print 出来结果会是 ,因为还没更新过状态。
更新合约状态
使用 。
RPC 和 web3.js 提供的 都是连到一节点,使用节点中的账户发送 transaction。而如果要用自己的账户就要用 ,也就是说要自己建立 transaction、自己 sign 过,再透过 发送。
Define raw transaction
中包含:
:纪录目前帐户送出的交易数,用来避免 replay attack,每次送要加 1。可以用 RPC 查询目前账户的 nonce。也可以用 Etherscan 查,但 Etherscan 显示的 会包含送出去但没有成功的交易,所以会不准
:一般用 1 Gwei(= 1000000000 = 0x3B9ACA00)
:gaslimit 估算可参考 使用ethereum browser计算gas cost
:合约地址
:要送的 Ether 数量,因为只是要呼叫合约所以设 0
:丢给合约的参数。由三个部分组成: 、 和一个 32 bytes 的参数 (*也就是我要更新的值,这边设 *)
Create and Sign raw transaction
要引入另一个套件 。记得先用 npm 安装。
建立 raw transaction。
用自己的 private key sign。
Send raw transaction
Result
成功就会回传一个 transaction hash,像是:
交易成功送出且被收进 block 后,再次查询合约状态,*Print 出来结果就会是 10 *。
可以透过 Etherscan 确认交易有没有被收进 block 以及合约执行的结果(可能因为参数错误导致执行失败)。
References
在区块链上建立可更新的智慧合约(一)
Ethereum JSON RPC Document
We3.js API Document
本文原文为繁体中文,为大陆读者阅读需要,转为简体中文。感谢中国台湾社群的网友。
http://ethfans.org/posts/building-blockchain-in-go-part-1
领取专属 10元无门槛券
私享最新 技术干货