JobPlus知识库 IT 其它 文章
区块链Qtum智能合约使用方法及说明

Qtum是一个基于比特币UTXO模型,权益证明机制(pos)和支持EVM智能合约的区块链项目。它通过创新的账户抽象层(Account Abstraction Layer)实现了比特币与以太坊两大生态的融合。如果想了解更多关于Qtum的信息。

基于Qtum的智能合约

首先需要说明的是,使用Qtum的智能合约接口仍然需要一定的技术储备。本文对智能合约的操作在命令行中使用qtum-cli,或者在图形钱包qtum-qt的debug窗口中使用。 为了演示如何简单创建和操作一个智能合约,我们将会使用如下的合约代码:

  1. pragma solidity ^0.4.0;

  2. contract QtumTest {

  3. uint storedNumber;

  4. function QtumTest() {

  5. storedNumber=1;

  6. }

  7. function setNumber(uint number) public{

  8. storedNumber = number;

  9. }

  10. function logNumber() constant public{

  11. log1("storedNumber", uintToBytes(storedNumber));

  12. }

  13. function returnNumber() constant public returns (uint){

  14. return storedNumber;

  15. }

  16. function deposit() public payable{

  17. }

  18. function withdraw() public{

  19. if(!msg.sender.send(this.balance)){

  20. throw;

  21. }

  22. }

  23. //utility function

  24. function uintToBytes(uint v) constant returns (bytes32 ret) {

  25. if (v == 0) {

  26. ret = '0';

  27. }

  28. else {

  29. while (v > 0) {

  30. ret = bytes32(uint(ret) / (2 ** 8));

  31. ret |= bytes32(((v % 10) + 48) * 2 ** (8 * 31));

  32. v /= 10;

  33. }

  34. }

  35. return ret;

  36. }

  37. }

编译以上的合约代码,生成EVM的bytecode如下:

6060604052341561000c57fe5b5b60016000819055505b5b6102bd806100266000396000f30060606040523615610076576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680633450bd6a146100785780633ccfd60b1461009e5780633fb5c1cb146100b057806394e8767d146100d05780639f2c436f1461010c578063d0e30db01461011e575bfe5b341561008057fe5b610088610128565b6040518082815260200191505060405180910390f35b34156100a657fe5b6100ae610133565b005b34156100b857fe5b6100ce6004808035906020019091905050610190565b005b34156100d857fe5b6100ee600480803590602001909190505061019b565b60405180826000191660001916815260200191505060405180910390f35b341561011457fe5b61011c610246565b005b61012661028e565b005b600060005490505b90565b3373ffffffffffffffffffffffffffffffffffffffff166108fc3073ffffffffffffffffffffffffffffffffffffffff16319081150290604051809050600060405180830381858888f19350505050151561018d57610000565b5b565b806000819055505b50565b600060008214156101ce577f3000000000000000000000000000000000000000000000000000000000000000905061023d565b5b600082111561023c5761010081600190048115156101e957fe5b0460010290507f01000000000000000000000000000000000000000000000000000000000000006030600a8481151561021e57fe5b06010260010281179050600a8281151561023457fe5b0491506101cf565b5b8090505b919050565b61025160005461019b565b6000191660405180807f73746f7265644e756d6265720000000000000000000000000000000000000000815250600c01905060405180910390a15b565b5b5600a165627a7a72305820326efcd34df5fdba07e7a1afe7ffd4b42873ef749ae9a5915db46fd20b9c251c0029

同时还会得到如下的JSON接口文件:

[{"constant":true,"inputs":[],"name":"returnNumber","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"withdraw","outputs":[],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"number","type":"uint256"}],"name":"setNumber","outputs":[],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"v","type":"uint256"}],"name":"uintToBytes","outputs":[{"name":"ret","type":"bytes32"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"logNumber","outputs":[],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"deposit","outputs":[],"payable":true,"type":"function"},{"inputs":[],"payable":false,"type":"constructor"}]

任何一个合约的这些信息都可以通过Browser Solidity这个网站获得,输入你的合约代码后,在右方点击"contract details"即可查询。

(提示:如果使用QT钱包中的debug窗口,在以下的命令中都不需要再包含./qtum-cli)

首先我们创建合约:

./qtum-cli createcontract 6060604052341561000c57fe5b5b60016000819055505b5b6102bd806100266000396000f30060606040523615610076576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680633450bd6a146100785780633ccfd60b1461009e5780633fb5c1cb146100b057806394e8767d146100d05780639f2c436f1461010c578063d0e30db01461011e575bfe5b341561008057fe5b610088610128565b6040518082815260200191505060405180910390f35b34156100a657fe5b6100ae610133565b005b34156100b857fe5b6100ce6004808035906020019091905050610190565b005b34156100d857fe5b6100ee600480803590602001909190505061019b565b60405180826000191660001916815260200191505060405180910390f35b341561011457fe5b61011c610246565b005b61012661028e565b005b600060005490505b90565b3373ffffffffffffffffffffffffffffffffffffffff166108fc3073ffffffffffffffffffffffffffffffffffffffff16319081150290604051809050600060405180830381858888f19350505050151561018d57610000565b5b565b806000819055505b50565b600060008214156101ce577f3000000000000000000000000000000000000000000000000000000000000000905061023d565b5b600082111561023c5761010081600190048115156101e957fe5b0460010290507f01000000000000000000000000000000000000000000000000000000000000006030600a8481151561021e57fe5b06010260010281179050600a8281151561023457fe5b0491506101cf565b5b8090505b919050565b61025160005461019b565b6000191660405180807f73746f7265644e756d6265720000000000000000000000000000000000000000815250600c01905060405180910390a15b565b5b5600a165627a7a72305820326efcd34df5fdba07e7a1afe7ffd4b42873ef749ae9a5915db46fd20b9c251c0029 300000

注意,最后的参数300000是表示这笔交易的gas limit,对于这个合约,默认的数值太小,所以我们将其提升到300000。

跑完以上的代码之后,我们将会得到一个如下所示的结果:

  1. {

  2. "txid": "72b0e0576d289c1e4e6c777431e4845f77d0884d3b3cff0387a5f4a1a3a874ea",

  3. "sender": "qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt",

  4. "hash160": "aff3e34ab836edb8d214a993d9da105915e4a6e9",

  5. "address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9"

  6. }

现在可以将上面结果中的address保存起来,方便后面使用。

export CONTRACT=5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9

现在需要等待你创建的合约被打包进一个区块,你可以通过如下的方法去确认是否被打包:

./qtum-cli getaccountinfo $CONTRACT

如果提示说Address does not exist,那么不是你的交易还未被打包进新的区块(可以通过getrawtransaction加上你的交易id来确认是否打包),就是你未提供足够多的gas。如果合约被成功的创建并且被打包到区块链上,你将会看到类似如下的结果:

  1. {

  2. "address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",

  3. "balance": 0,

  4. "storage": {

  5. "290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563": {

  6. "0000000000000000000000000000000000000000000000000000000000000000": "0000000000000000000000000000000000000000000000000000000000000001"

  7. }

  8. },

  9. "code": "..."

  10. }

为了执行合约中的函数,你必须要使用JSON的接口文件来创建ABI数据。有一个简单的工具叫做ethabi可以帮助你实现这个目的。确保JSON文件被保存下来了,假设名字是interface.json

为了得到合约中的变量storedNumber,我们需要调用函数returnNumber(),通过ethabi可以构建出ABI的数值:

ethabi encode function ~/interface.json returnNumber

返回的结果是

3450bd6a

因为我们的state还没有发生改变,所以调用命令callcontract:

./qtum-cli callcontract $CONTRACT 3450bd6a

这个命令跑完之后的结果包含了很多有用的字段,但是当前我们只关于字段output,它的数值代表了storedNumber:

  1. {

  2. "address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",

  3. "executionResult": {

  4. "gasUsed": 21664,

  5. "excepted": "None",

  6. "newAddress": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",

  7. "output": "0000000000000000000000000000000000000000000000000000000000000001",

  8. "codeDeposit": 0,

  9. "gasRefunded": 0,

  10. "depositSize": 0,

  11. "gasForDeposit": 0

  12. },

  13. "transactionReceipt": {

  14. "stateRoot": "ffbeb0377d43c6ed443a2840259ff5ead5158016ab54d55ef21b7b11aa71947f",

  15. "gasUsed": 21664,

  16. "bloom": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",

  17. "log": [

  18. ]

  19. }

  20. }

为了改变storeNumber的数值,我们可以使用命令sendtocontract来在链上执行合约函数。首先我们还是需要ABI的数据:

  1. ethabi encode function ~/interface.json setNumber -p 123456 --lenient

  2. 3fb5c1cb000000000000000000000000000000000000000000000000000000000001e240

提示,我们加上了--lenient这个选项后,可以不用将参数补齐至256bit。现在我们来调用合约:

./qtum-cli sendtocontract $CONTRACT 3fb5c1cb000000000000000000000000000000000000000000000000000000000001e240

同样,做完之后我们可以再次调用 returnNumber()来检查output字段:

"output": "000000000000000000000000000000000000000000000000000000000001e240",

上面的结果是我们设置的数值123456的16进制形式。

此外,你还可以使用logNumber()函数来打印日志。如果你的节点启动的时候有带上参数-record-log-opcodes,那么文件 vmExecLogs.json中会包含所有的操作日志。

你还可以通过deposit() 和 withdraw() 这两个函数来从测试合约中存入和提取代币。 deposit和withdraw的ABI数值分别是d0e30db0和3ccfd60b。 如下的命令将会向合约中发送10个token:

./qtum-cli sendtocontract $CONTRACT d0e30db0 10

同样,从合约中提取代币也非常的简单,调用如下的命令:

./qtum-cli sendtocontract $CONTRACT 3ccfd60b

你也可以手动指定以什么地址为sender调用合约,假设我的一个钱包地址是qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt,我可以使用如下的命令:

./qtum-cli sendtocontract $CONTRACT 3ccfd60b 0 190000 0.0000001 qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt

如果你的地址里没有足够的代币,会提示Sender address does not have any unspent outputs,这个时候你需要先向地址内转入一定的代币:

./qtum-cli sendtoaddress qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt 0.001

下面就可以调用sendtocontract了:

./qtum-cli sendtocontract $CONTRACT 3ccfd60b 0 190000 0.0000001 qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt

等以上的交易被打包进一个区块之后,合约中所有的代币就会被提取到指定的地址qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt中

FAQ

  • Q: 使用 createcontract创建了合约,但是无法调用合约或者合约不在合约列表中

    A:很有可能是你的gas不够,查看vm.log日志可以看到实际需要的gas是多少,然后再手动设置gas limit

  • Q: 我的gas设置的很大,可是多余的却没有退还

    A: 退款将会在coinstake中生成,需要等待500个区块时间才能被使用

  • Q: 我开启进程时使用了选项-reindex,然后节点就一直处于同步的状态

    A: 现在reindex的话,所有的合约都会被重新执行,所以链上的合约越多,需要等待的时间越长。未来我们会加速这个过程,同时也会缩短初始的同步时间。

  • Q: "我觉得我发现了一个Qtum的bug"

    A: 欢迎报送到这里 

Qtum新增的RPC命令

Qtum支持所有比特币的RPC命令,并且还新加了如下的命令:

  • createcontract - 在Qtum上创建和发布智能合约,会消耗gas
  • callcontract - 这是一个与Qtum上已经部署好的合约进行交互的接口,所有的计算都是在链下进行,不需要消耗gas
  • sendtocontract - 这也是一个与Qtum上已经部署好的合约进行交互的接口,但是所有的计算都是在链上进行的,并且所有的状态改变都会同步到链上。这个命令可以向合约发送代币,会消耗gas
  • getaccountinfo - 这个命令可以返回一个合约的基本信息,包括bytecode,存储的数据,合约的余额等
  • listcontracts - 这个命令会列出当前所有已部署的合约地址和余额,未来这个命令有可能被变更或者删除
  • reservebalance - 预留一定数额的代币,不用参与staking。如果你的这个数值设置的足够大,超过你的拥有的代币数量,那么你就不会参与到staking和创造新区块的过程中。
  • getstakinginfo - 显示当前节点的staking状态,包括当前的难度,生成下个区块的期望时间等

Qtum新增命令行参数

Qtum支持所有的比特币命令行参数,另外Qtum新增如下的参数:

  • -record-log-opcodes - 在Qtum的数据目录(一般是在~/.qtum)下新建一个log文件,名字是vmExecLogs.json,所有的EVM LOG操作都会被记录。


如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!

¥ 打赏支持
336人赞 举报
分享到
用户评价(0)

暂无评价,你也可以发布评价哦:)

扫码APP

扫描使用APP

扫码使用

扫描使用小程序