Qtum是一个基于比特币UTXO模型,权益证明机制(pos)和支持EVM智能合约的区块链项目。它通过创新的账户抽象层(Account Abstraction Layer)实现了比特币与以太坊两大生态的融合。如果想了解更多关于Qtum的信息,可以访问我们的官网www.qtum.org,欢迎加入我们的社区。
首先需要说明的是,使用Qtum的智能合约接口仍然需要一定的技术储备。本文对智能合约的操作在命令行中使用qtum-cli
,或者在图形钱包qtum-qt
的debug窗口中使用。 为了演示如何简单创建和操作一个智能合约,我们将会使用如下的合约代码:
pragma solidity ^0.4.0;
contract QtumTest {
uint storedNumber;
function QtumTest() {
storedNumber=1;
}
function setNumber(uint number) public{
storedNumber = number;
}
function logNumber() constant public{
log1("storedNumber", uintToBytes(storedNumber));
}
function returnNumber() constant public returns (uint){
return storedNumber;
}
function deposit() public payable{
}
function withdraw() public{
if(!msg.sender.send(this.balance)){
throw;
}
}
//utility function
function uintToBytes(uint v) constant returns (bytes32 ret) {
if (v == 0) {
ret = '0';
}
else {
while (v > 0) {
ret = bytes32(uint(ret) / (2 ** 8));
ret |= bytes32(((v % 10) + 48) * 2 ** (8 * 31));
v /= 10;
}
}
return ret;
}
}
编译以上的合约代码,生成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。
跑完以上的代码之后,我们将会得到一个如下所示的结果:
{
"txid": "72b0e0576d289c1e4e6c777431e4845f77d0884d3b3cff0387a5f4a1a3a874ea",
"sender": "qZbjaE8N18ZU1m7851G7QGhvxKL74SRBTt",
"hash160": "aff3e34ab836edb8d214a993d9da105915e4a6e9",
"address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9"
}
现在可以将上面结果中的address
保存起来,方便后面使用。
export CONTRACT=5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9
现在需要等待你创建的合约被打包进一个区块,你可以通过如下的方法去确认是否被打包:
./qtum-cli getaccountinfo $CONTRACT
如果提示说Address does not exist
,那么不是你的交易还未被打包进新的区块(可以通过getrawtransaction
加上你的交易id来确认是否打包),就是你未提供足够多的gas。如果合约被成功的创建并且被打包到区块链上,你将会看到类似如下的结果:
{
"address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",
"balance": 0,
"storage": {
"290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563": {
"0000000000000000000000000000000000000000000000000000000000000000": "0000000000000000000000000000000000000000000000000000000000000001"
}
},
"code": "..."
}
为了执行合约中的函数,你必须要使用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
:
{
"address": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",
"executionResult": {
"gasUsed": 21664,
"excepted": "None",
"newAddress": "5bde092dbecb84ea1a229b4c5b25dfc9cdc674d9",
"output": "0000000000000000000000000000000000000000000000000000000000000001",
"codeDeposit": 0,
"gasRefunded": 0,
"depositSize": 0,
"gasForDeposit": 0
},
"transactionReceipt": {
"stateRoot": "ffbeb0377d43c6ed443a2840259ff5ead5158016ab54d55ef21b7b11aa71947f",
"gasUsed": 21664,
"bloom": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"log": [
]
}
}
为了改变storeNumber
的数值,我们可以使用命令sendtocontract
来在链上执行合约函数。首先我们还是需要ABI的数据:
ethabi encode function ~/interface.json setNumber -p 123456 --lenient
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
中
Q: 使用 createcontract
创建了合约,但是无法调用合约或者合约不在合约列表中
A:很有可能是你的gas不够,查看vm.log
日志可以看到实际需要的gas是多少,然后再手动设置gas limit
Q: 我的gas设置的很大,可是多余的却没有退还
A: 退款将会在coinstake中生成,需要等待500个区块时间才能被使用
Q: 我开启进程时使用了选项-reindex
,然后节点就一直处于同步的状态
A: 现在reindex的话,所有的合约都会被重新执行,所以链上的合约越多,需要等待的时间越长。未来我们会加速这个过程,同时也会缩短初始的同步时间。
Q: "我觉得我发现了一个Qtum的bug"
A: 欢迎报送到这里 https://github.com/qtumproject/qtum/issues
Qtum支持所有比特币的RPC命令,并且还新加了如下的命令:
createcontract
- 在Qtum上创建和发布智能合约,会消耗gascallcontract
- 这是一个与Qtum上已经部署好的合约进行交互的接口,所有的计算都是在链下进行,不需要消耗gassendtocontract
- 这也是一个与Qtum上已经部署好的合约进行交互的接口,但是所有的计算都是在链上进行的,并且所有的状态改变都会同步到链上。这个命令可以向合约发送代币,会消耗gasgetaccountinfo
- 这个命令可以返回一个合约的基本信息,包括bytecode,存储的数据,合约的余额等listcontracts
- 这个命令会列出当前所有已部署的合约地址和余额,未来这个命令有可能被变更或者删除reservebalance
- 预留一定数额的代币,不用参与staking。如果你的这个数值设置的足够大,超过你的拥有的代币数量,那么你就不会参与到staking和创造新区块的过程中。getstakinginfo
- 显示当前节点的staking状态,包括当前的难度,生成下个区块的期望时间等Qtum支持所有的比特币命令行参数,另外Qtum新增如下的参数:
-record-log-opcodes
- 在Qtum的数据目录(一般是在~/.qtum)下新建一个log文件,名字是vmExecLogs.json
,所有的EVM LOG操作都会被记录。