合约流程

编辑合约

您可以基于任何支持solidity的编辑器编写合约。下述将基于remix在线编辑器 为例，进行说明。

为了叙述方便，我们使用如下的简单合约示例：

pragma solidity >=0.4.24 <=0.7.6 ;

contract SimpleStorage {
    uint storedData;

    function set(uint x) public {
        storedData = x;
    }

    function get() public view returns (uint) {
        return storedData;
    }
}

(注意：由于SCDO主网兼容 Istanbul版本的EVM，开发合约时建议使用的solidity版本不大于0.7.6。SCDO 合约虚拟机目前不支持 EVM Berlin 版本的功能。)

下面的图片是 Remix 在线编辑器的首页演示:

RemixIde

编译合约

将合约写好并保存后，可以使用remix的编译功能来编译合约并检查可能的语法错误。如屏幕截图所示，单击“编译”按钮以编译示例合约。如果有错误，编译器将指向可能发生错误的位置。

Compile smart contract

设置自己的测试环境

成功编译合约后，我们可以部署合约并对其进行测试。我们建议的最佳实践是设置SCDO私有链/专有链节点，然后部署合约在此链上，并进行测试。如果您对测试结果满意，则可以将合约部署到SCDO主网。我们的测试节点是在Ubuntu中设置的。

获取合同bytecode

如 Remix IDE显示的, 在合约成功编译后, 点击 Remix IDE 左边显示栏 的 "Deploy" 图标。见下图：

delpoy icon

如果没有错误， 你将会看到下图所示的：

deploy

点击绿色查看图标。

correct

您将见到

input

“input”字段中的值是合约的字节码。单击字节码字符串旁边的复制图标，将其复制到剪贴板。然后将副本保存到安全的地方。字节码如下：

0x608060405234801561001057600080fd5b5060df8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058209e18a0a3a2dc0fa6b26ca8a3b915b69344f7a214ce5510d0bc21f948fb0ff0750029

用client tool 部署合约

• 准备一个SCDO帐户，并确保有足够的余额来部署合约。在这里，我们使用片1的帐户1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1,同时并保存帐户密钥文件。

• 您可以下载 SCDO release Mac/Windows/Linux node 和 client tools.

注意：密钥库文件是由以下命令生成的

./client savekey --privatekey "the private key paired with 1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1" --file 1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1.keystore --shard 1

• 启动一个私链节点 node (我们的例子启动的是片1的一个节点）

• 使用sendtx 命令部署合同.

 ./client sendtx --amount 0  --address 0.0.0.0:8027 --payload 0x608060405234801561001057600080fd5b5060df8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058209e18a0a3a2dc0fa6b26ca8a3b915b69344f7a214ce5510d0bc21f948fb0ff0750029 --from 1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1.keystore

sendtx 参数 address 是启动的node的 ip 地址，这里用的是局部ip 地址; "amount" 是交易token量 (以 Wen为单位), 对部署合约，一般设置为0; from 是前面用savekey 命令生成的密码文件；payload 是合约的bytecode（字节码）; gas 是交易需要的最低gas (默认值 20000).

上述命令执行的结果是：

transaction sent successfully
{
    "Data": {
        "AccountNonce": 12,
        "Amount": 0,
        "From": "1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1",
        "GasLimit": 200000,
        "GasPrice": 10,
        "Payload": "0x608060405234801561001057600080fd5b5060df8061001f6000396000f3006080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058209e18a0a3a2dc0fa6b26ca8a3b915b69344f7a214ce5510d0bc21f948fb0ff0750029",
        "Timestamp": 0,
        "To": "0S0000000000000000000000000000000000000000",
        "Type": 0
    },
    "Hash": "0x08c45b71dd7c151071f222fb6d1216248425e977255d5923dbade76c32abd1b0",
    "Signature": {
        "Sig": "9IawOq9cHp6Cmmj7i7YD7oxMNB+Zc28YmJuUzpA7S9INLiGP6ysdYK/AC9jZH3CF+kUJYvBWsIwXEWx2s/s/aQA="
    }
}

根据返回结果的Hash查看合约部署结果：

./client getreceipt --address 0.0.0.0:8027 --hash 0x08c45b71dd7c151071f222fb6d1216248425e977255d5923dbade76c32abd1b0

得到如下结果：

{
    "contract": "1S01f671dfc64128d285e178c1f6e7bf640d420002",
    "failed": false,
    "poststate": "0x3c7e3c77abf149d2d59e2d94d134611314751e22b940a2f22be9b2e2c74fb9b6",
    "result": "0x6080604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c146078575b600080fd5b348015605957600080fd5b5060766004803603810190808035906020019092919050505060a0565b005b348015608357600080fd5b50608a60aa565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058209e18a0a3a2dc0fa6b26ca8a3b915b69344f7a214ce5510d0bc21f948fb0ff0750029",
    "totalFee": 802130,
    "txhash": "0x08c45b71dd7c151071f222fb6d1216248425e977255d5923dbade76c32abd1b0",
    "usedGas": 80213
}

结果中failed为false表明合约部署成功，contract的值为合约地址。

调用合约

通过remix获得调用方法的字节码

使用client sendtx命令调用合约需要提供合约调用方法（包括参数设定）的payload信息(bytecode/字节码)。这个信息可以通过remix获得。在Remix IDE 左边的控制窗口，Deploy 的下面，可以看到本示例合同的set和get方法。在set右侧填入参数值（这里是22)，点击set，即可得到调用set方法（包括参数值设定）的字节码了。

methods

在Remix IDE 右下方日志窗口可以看到上面点击结果。点击详情可查看调用详情，其中input的值即为本示例set方法调用的字节码 (参数设置为22)。如下图所示：

set method

调用set方法的字节码是：

0x60fe47b10000000000000000000000000000000000000000000000000000000000000016

使用 sendtx 调用合约方法

如下的命令调用上述合约中的set方法，参数payload 是我们前面得到的字节码，from为发起交易的账户，to为合约地址

./client sendtx --amount 0   --payload  --address 0.0.0.0:8027 --payload 0x60fe47b10000000000000000000000000000000000000000000000000000000000000016 --from 1S017f6215c30f1505e0d42769c5472b410d6bf961.keystore --to 1S01f671dfc64128d285e178c1f6e7bf640d420002

执行结果如下：

transaction sent successfully
{
    "Data": {
        "AccountNonce": 13,
        "Amount": 0,
        "From": "1S010a3fe1668c7cab5923fe0f77cb25ec21f644f1",
        "GasLimit": 200000,
        "GasPrice": 10,
        "Payload": "0x60fe47b10000000000000000000000000000000000000000000000000000000000000016",
        "Timestamp": 0,
        "To": "1S0126ba0710ad416638a7f0e5a113e9b6be4b0002",
        "Type": 0
    },
    "Hash": "0xb26dae6efc9942c6655a6e5baa372f6d3388b62ac50011466a7b6c105ee6e01e",
    "Signature": {
        "Sig": "bt/Nh0UyKrCxTxoP/gyeTgE8mHVmVmZHCQHJ14pGePJHblZrS1vI/6aE2d2WXUSqLYGnSqFWoaXkxbOa7hco+wA="
    }
}

使用上面结果的hash, 通过查询receipt信息，可以获取set方法的调用结果：

./client getreceipt --hash 0xb26dae6efc9942c6655a6e5baa372f6d3388b62ac50011466a7b6c105ee6e01e

得到如下结果：

{ "contract": "0x", "failed": false, "poststate": "0x328868cd36c074185bd1ccf4e905728b0f36de9fd06743e93b87483ae3872bd1", "result": "0x", "totalFee": 266690, "txhash": "0xb26dae6efc9942c6655a6e5baa372f6d3388b62ac50011466a7b6c105ee6e01e", "usedGas": 26669 }

注意：调用合约的账户必须是与合约地址同一分片，SCDO目前不支持跨片合约调用

使用call调用合约方法

对于仅获取变量值而不改变合约状态的方法，可以通过call来调用。在我们的示例中，获取get的bytecode (字节码） 和获取set 方法的字节码类似。get的字节码如下：

 0x6d4ce63c

用call调用get 方法：

client call --payload 0x6d4ce63c --to 0x47a99059219055cf8277d5d7dff933446edb0012

得到如下结果：

{
    "contract": "0x",
    "failed": false,
    "poststate": "0x2673977b8565ad747d1dff04dccaa424afcb1e81c3e07e994eeef538d25a1a06",
    "result": "0x0000000000000000000000000000000000000000000000000000000000000016",
    "totalFee": 21696,
    "txhash": "0x169ac2e722ddfc99a2368aecd4462cbf92a43320c2cf5e18341492bfb00fd4ec",
    "usedGas": 21696
}

可以看到，result显示的变量值为之前通过set方法设置的22 (十六进制表示）。

Deploy to SCDO mainnet

如前面几节中所示，对合同进行了充分的测试后，您可以按照与将其部署到专用网络相同的步骤，将其部署到SCDO主网上。