当前位置: 玩币族首页 > 区块链资讯 > EOS从单签名到多签名

EOS从单签名到多签名

2020-01-02 流浪诗人来源：区块链网络

一、基本知识

账户：是存储在区块链上的人们可识别的ID。
权限：每个事务都有，它是由已配置许可的账户所评估的。
阈值：每个被命名的权限都有一个有效范围，必须满足是在许可下的一个签名事务，将被视为有效。
签名：事务的签名是通过利用一个客户端来执行，该客户端拥有一个已加载并已解锁的钱包。
钱包：可以保护及使用你的keys的一个软件。这些keys可能是也可能不是区块链授权的一个许可账户。
钱包
钱包是一个客户端，用于存储keys，可能与也可能不与一个或多个账户进行关联。一个钱包会有锁定和解锁两种状态，理想状态下，它是被一个高熵密码所保护。EOSIO有一个命令行客户端cleos，与一个轻客户端keosd交互，它俩构成了eos钱包的这种模式。

账户
一个私人个体或者一个组织都可以拥有账户，在交易或者其他push一个事务到区块链上的时候，账户是必须的。
Authorities（权限）和 Permissions（许可）
这两个概念特别容易搞混为一谈，这里给做一下区分。

Authorities决定了是否每一个给出的action都被正确授权。

每个账户都有两个与生俱来的权限命名：

owner，象征着一个账户的所有权。只有很少的事务会需要这种权限。但最值得注意的是，actions可以对owner的权限做出各种改变。所以一般来说，建议owner被冷藏存储，不告诉任何人。owner可以用来回复另一个可能已遭泄露的许可。
active，用于转移资金，投票生产者以及做其他高级账户的变更操作。唯一不同的是，它不能够改变owner。
除了这两个与生俱来的权限。一个账户也能拥有自定义命名的权限，它可以进一步扩展账户管理。自定义权限非常灵活并且提出了众多可能的用例实现。在开发者社区，这些问题已经被提了出来，包括他们是如何工作的，以及如果有的话是什么约定被采用了。许可对于任何给定的权限可以被分配到一个或多个公钥或者一个有效的账户名称。

二、单签名账户（默认账户配置）

这里主要讲述当一个账户被创建以后，它是如何配置的。它分别拥有owner和active权限，可独立设置key，两个keys都是权重为1，且许可的阈值也都是1。该账户在执行某个操作action时，需要通过默认的配置，单独签名授权一个本机权限。
创建账户

cleos create account [OPTIONS] creator name OwnerKey [ActiveKey]
1

（在eos正式版本中，activeKey已不强制，变为可选）在创建账户时，需要指定其owner和active两个权限的key，这里要使用公钥。所以，

cleos create account eosio alice EOS5JUBZXokmgHR7yHFgxoZdQZyfvu2oCHiPBeGUE3fQyZ9MHdmi8
返回结果如下：
executed transaction: ac51aea40af91e283b7e99b431e36b4556bc8487d73c807118e30dd3324c4136  200 bytes  149 us
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"alice","owner":{"threshold":1,"keys":[{"key":"EOS5JUBZXokmgHR7yHFgxoZdQZy...

1
2
3
4
5

这个版本只需要指定一个owner权限的key即可创建账户。active权限是小于owner的，所以显得不那么重要。

三、多签名账户

上面单签名的内容很简单，之所以介绍它，是为了与本节多签名账户进行比较学习。

多签名账户，一个账户假设为Jack的owner和active权限分别被授权为其他两个账户Alice和Bob的许可。

@Jack
在这里插入图片描述
首先，我们创建至少三对key：

cleos wallet keys
[
  "EOS5JUBZXokmgHR7yHFgxoZdQZyfvu2oCHiPBeGUE3fQyZ9MHdmi8",
  "EOS6FMtV7gnbBLQ2CbD7J3YAKA8hY6u6jZ2KGtcy628z8QQ8MvXBz",
  "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
  "EOS8H7CydzSJ2y5xXdnM5JBKZ2N1A8mE83Lg751G7q3gQqUzrmzwt",
  "EOS8YMWk6vxawJEDML7mYXA3mGUap7L68L3GroGUpDhpbuadwHXom",
  "EOS8fURVqUA6YHeKEHD6fLMvqj6NYEcFTqj6bNApCz24SVzFxKqev"
]

1
2
3
4
5
6
7
8
9
10

然后，分别使用不同的public key创建三个账户：jack, alice和bob，创建成功以后，我们先来查看当前jack账户的permission内容：

 cleos get account alice
permissions: 
     owner     1:    1 EOS5JUBZXokmgHR7yHFgxoZdQZyfvu2oCHiPBeGUE3fQyZ9MHdmi8
        active     1:    1 EOS5JUBZXokmgHR7yHFgxoZdQZyfvu2oCHiPBeGUE3fQyZ9MHdmi8
memory: 
     quota:       unlimited  used:      2.66 KiB 
1
2
3
4
5
6

接着，按照上面我们设计的表格内容，我们先对jack的owner权限进行修改：

cleos set account permission jack owner '{"threshold":2,"keys":[],"accounts":[{"permission":{"actor":"alice","permission":"owner"},"weight":1},{"permission":{"actor":"bob","permission":"owner"},"weight":1}],"waits":[]}' -p jack@owner
executed transaction: 494777ac55fa19144027ba5fdf75dcdaab4c4d52cdcaa13c0b6ecabfe622ffd1  160 bytes  136 us
#         eosio <= eosio::updateauth            {"account":"jack","permission":"owner","parent":"","auth":{"threshold":2,"keys":[],"accounts":[{"per...
warning: transaction executed locally, but may not be confirmed by the network yet
1
2
3
4

注意这里使用到了 cleos set account permission 命令。这条命令中比较重要的部分是第三个参数authority的内容。

authority的内容可以是：

NULL，代表删除权限
public key，将该权限的内容设置为一个公钥
JSON字符串，完整地复杂地设置一个账户某个权限的内容
一个文件名，同上，只不过改为将完整配置放在文件中读取

根据我们以上对jack owner权限的设计方案，是属于比较复杂的权限内容，因此这里采用的是第三种方式，及JSON字符串的方式。那么JSON字符串的格式是什么？我们例举本次生效的配置格式化如下：

{
    "threshold": 2,
    "keys": [],
    "accounts": [
        {
            "permission": {
                "actor": "alice",
                "permission": "owner"
            },
            "weight": 1
        },
        {
            "permission": {
                "actor": "bob",
                "permission": "owner"
            },
            "weight": 1
        }
    ],
    "waits": []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

我们分别来介绍这里面的字段：

threshold
目前最多只有两个账户，每个账户的权重都是1，所以threshold的取值范围是1或者2。

1：在@Jack账户上执行任何需要owner权限的操作必须由@Alice或者@Bob账户任意一个账户进行签名授权。
2：在@Jack账户上执行任何需要owner权限的操作必须由@Alice和@Bob账户进行多签名授权。
keys
也可以通过JSON字符串设置秘钥，这与在命令中第三个参数直接使用公钥是相同的效果。但是要注意的是，如果该账户已经通过JSON设置了复杂的权限内容，再次修改的时候一定还需要使用原JSON数据进行增量修改，若使用命令行加公钥的方式会直接覆盖掉原JSON设置的复杂权限内容。

accounts
权限是通过其他账户来授权，其中包括：

permission：某个账户actor的某个权限
weight，与上面的threshold呼应使用
我们这里就是通过设置该字段来实现的多账户签名。
waits
设置延时时间，最大不超过max_transacton_delay的配置值。
下面来设置其active权限，active权限与owner权限不同的是threshold的值，以及

账户除了owner权限是根权限以外，active本身是其子权限，而 cleos set account permission
命令设置的权限默认都是active的子权限，注意，我们在设置active权限本身的时候，要手动指定其父权限为owner，否则会默认指向自己，报错。

cleos set account permission jack active '{"threshold":1,"keys":[],"accounts":[{"permission":{"actor":"alice","permission":"owner"},"weight":1},{"permission":{"actor":"bob","permission":"owner"},"weight":1}],"waits":[]}' owner -p jack@owner
executed transaction: 0865e7e9122354a2c29fd9ab48bb39b8a7bd758fdd7c4dc376e21ce45d8e23fb  176 bytes  461 us
#         eosio <= eosio::updateauth            {"account":"jack","permission":"active","parent":"owner","auth":{"threshold":1,"keys":[],"accounts":...
warning: transaction executed locally, but may not be confirmed by the network yet
1
2
3
4

这样，jack账户的权限就全部按照以上权限设计表格设置完毕了，下面我们使用命令来验证一下目前jack账户的权限内容：

cleos get account jack
permissions:
     owner     2:    1 alice@owner, 1 bob@owner,
        active     1:    1 alice@owner, 1 bob@owner
1
2
3
4

四、多签名过程实战

1.部署eosio.msig合约
首先要注意的是，EOS中对多签名的支持是通过eosio.msig智能合约来支持的，因此秉承eos"专人专责"的设计规范，我们先创建一个账户eosio.msig，并用该账户部署eosio.msig合约。

cleos create account eosio eosio.msig EOS8H7CydzSJ2y5xXdnM5JBKZ2N1A8mE83Lg751G7q3gQqUzrmzwt
1

如果不是自己新增或者对原合约有修改的话，推荐直接使用build目录下的contract，已经生成好了相关的wast以及abi文件。

2.部署eosio.token合约
这里我们使用token合约的相关权限操作进行多签名的演示。同样的，我们也创建一个账户eosio.token并用其部署eosio.token合约。

cleos create account eosio eosio.token EOS8YMWk6vxawJEDML7mYXA3mGUap7L68L3GroGUpDhpbuadwHXom
executed transaction: c922c4767f23d4526261a7ca0b6554e5c02b5b4aea95b83510eecd81a9696ce3  200 bytes  165 us
#         eosio <= eosio::newaccount            "0000000000ea305500a6823403ea305501000000010003e110a468d88b85b1257ee1d6949836c68a84a4c694c5cbd4297a6...

1
2
3
4

cleos set contract eosio.token /home/kris/eos/build/contracts/eosio.token -p eosio.token
Reading WAST/WASM from /home/kris/eos/build/contracts/eosio.token/eosio.token.wasm...
Using already assembled WASM...
Publishing contract...
executed transaction: 127adf7ee9b404ccd8d7fa5645f33591cadabfb9dbb5feb619ce0c19130730ce  8104 bytes  886 us
#         eosio <= eosio::setcode               "00a6823403ea305500009594010061736d01000000017e1560037f7e7f0060057f7e7e7f7f0060047f7e7f7f00600000600...
#         eosio <= eosio::setabi                "00a6823403ea3055b4030e656f73696f3a3a6162692f312e30010c6163636f756e745f6e616d65046e616d6505087472616...

1
2
3
4
5
6
7
8

3.创建一个SYS token，并发放给jack,bob和alice三人分别100个。

cleos push action eosio.token create '["eosio","100000000.0000 SYS"]' -p eosio.token
executed transaction: 260b8183e4d4e0d5c227971473791c8aecebf647856dd84c2eca8ae5365498df  120 bytes  257 us
#   eosio.token <= eosio.token::create          {"issuer":"eosio","maximum_supply":"100000000.0000 SYS"}

1
2
3
4

转账之前先创建发行代币用户bank

cleos create account eosio bank EOS8fURVqUA6YHeKEHD6fLMvqj6NYEcFTqj6bNApCz24SVzFxKqev
executed transaction: 8f98a0681cd1f2d787ef55583e93e7d7e250b4de7e24ea859de709e06be6b3ea  200 bytes  179 us
#         eosio <= eosio::newaccount            "0000000000ea3055000000000000a73901000000010003f13ad86a535895877f448556649f9548631da55a1891a37f12e9e...
1
2
3

cleos push action eosio.token issue '["bank","100000000.0000 SOS","issue token"]' -p eosio
executed transaction: 8f04ae4a2bdd8442a8339f488c6cdf51175dabe9fc6e911c7c61dd8482390b31  128 bytes  810 us
#   eosio.token <= eosio.token::issue           {"to":"bank","quantity":"100000000.0000 SYS","memo":"issue token"}
#   eosio.token <= eosio.token::transfer        {"from":"eosio","to":"bank","quantity":"100000000.0000 SOS","memo":"issue token"}
#         eosio <= eosio.token::transfer        {"from":"eosio","to":"bank","quantity":"100000000.0000 SOS","memo":"issue token"}
#          bank <= eosio.token::transfer        {"from":"eosio","to":"bank","quantity":"100000000.0000 SOS","memo":"issue token"}

1
2
3
4
5
6
7

cleos push action eosio.token transfer '["bank","jack","100.0000 SYS","transfer from bank to jack"]' -p bank
1

cleos push action eosio.token transfer '["bank","alice","100.0000 SYS","transfer from bank to alice"]' -p bank
1

cleos push action eosio.token transfer '["bank","bob","100.0000 SYS","transfer from bank to bob"]' -p bank
1

4.然后我们调用命令，从jack转50SYS给bob：

cleos push action eosio.token transfer '["jack","bob","50 SYS"]' -p jack@owner
executed transaction: 8166f8503a098eeab6642afe375167e18bf79d0d904015f5bba19524ce2d56d6  144 bytes  846 us
#   eosio.token <= eosio.token::transfer        {"from":"jack","to":"bob","quantity":"50 SYS","memo":""}
#          jack <= eosio.token::transfer        {"from":"jack","to":"bob","quantity":"50 SYS","memo":""}
#           bob <= eosio.token::transfer        {"from":"jack","to":"bob","quantity":"50 SYS","memo":""}
1
2
3
4
5

5.查询余额

cleos get currency balance eosio.token alice
100 SYS
$ cleos get currency balance eosio.token jack
50 SYS
$ cleos get currency balance eosio.token bob
150 SYS
1
2
3
4
5
6

该命令执行成功，是由jack@owner权限许可的该命令操作。到这里并没有结束，jack的owner权限是与bob和alice相关的。所以可能遇到这么一个情况，jack今天不在，而它又需要以上的操作怎么办？那么是否可以通过上面对jack权限的设置，在jack不在的情况下通过bob和alice的操作完成本属于jack权限许可的操作呢？是的，这就是多签名的概念和意义。

6. 建立多签名操作提案
首先，eos中关于多签名的命令是multisig，这也是通过第一步中eosio.msig合约实现的。
jack不在，要想通过bob和alice两个人来审批本属于jack的操作，这就要比jack本人操作要麻烦一点，需要新建一个提案。

cleos multisig propose nojack '[{"actor":"alice","permission":"owner"},{"actor":"bob","permission":"owner"}]' '[{"actor":"jack","permission":"owner"}]' eosio.token transfer '{"from":"jack","to":"bob","quantity":"5 SYS","memo":"test multisig"}' -p eosio.msig
executed transaction: a223945e79c92cd5ca5243d64dce02ecf9bb1420e6ca3b5e5ac3fdae3dd4e8c3  240 bytes  389 us
#    eosio.msig <= eosio.msig::propose          {"proposer":"eosio.msig","proposal_name":"nojack","requested":[{"actor":"alice","permission":"owner"...
warning: transaction executed locally, but may not be confirmed by the network yet
1
2
3
4

注意在提案中的定义操作要输入完整的key-value对应参数关系。本例中，transfer后面的参数的定义内容与上面直接用jack是一致的，但格式是完整格式，上面jack单签名时是使用的简略版，可自行对比发现。

这个提案结尾需要一个账户授权，这个账户是不做限制的，只是为了日后操作这个提案本身，因此这里选择一个不想关的用来部署eosio.msig合约的账户eosio.msig签名授权该提案。

7. 查看提案

cleos multisig review eosio.msig nojack
{
  "proposal_name": "nojack",
  "packed_transaction": "38d0295b000000000000000000000100a6823403ea3055000000572d3ccdcd0100000000000091790000000080ab26a72e00000000000091790000000000000e3d320000000000000000535953000000000d74657374206d756c746973696700",
  "transaction": {
    "expiration": "2018-06-20T03:55:36",
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "max_net_usage_words": 0,
    "max_cpu_usage_ms": 0,
    "delay_sec": 0,
    "context_free_actions": [],
    "actions": [{
        "account": "eosio.token",
        "name": "transfer",
        "authorization": [{
            "actor": "jack",
            "permission": "owner"
          }
        ],
        "data": {
          "from": "jack",
          "to": "bob",
          "quantity": "50 SYS",
          "memo": "test multisig"
        },
        "hex_data": "00000000000091790000000000000e3d320000000000000000535953000000000d74657374206d756c7469736967"
      }
    ],
    "transaction_extensions": []
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

重点查看该提案设定的action，包括该action需要的权限，操作名，参数等。

8.查看提案审批情况
multisig合约定义了两个数据表，其中一个approvals表就是记录了提案的审批状态。

 cleos get table eosio.msig eosio.msig approvals                                {
  "rows": [{
      "proposal_name": "nojack",
      "requested_approvals": [{
          "actor": "alice",
          "permission": "owner"
        },{
          "actor": "bob",
          "permission": "owner"
        }
      ],
      "provided_approvals": []
    }],
  "more": false
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

9.审批提案
提案创建完成以后，就需要alice和bob这两个账户分别进行审批，他们各自都需要使用自己的owner权限签名审批这个动作。

 cleos multisig approve eosio.msig nojack '{"actor":"alice","permission":"owner"}' -p alice@owner
executed transaction: be473b9abcc361a6d4c00d726318d06cb98775bd9390f2ebe1e4e8d72afd5de2  128 bytes  269 us
#    eosio.msig <= eosio.msig::approve          {"proposer":"eosio.msig","proposal_name":"nojack","level":{"actor":"alice","permission":"owner"}}
warning: transaction executed locally, but may not be confirmed by the network yet
 cleos multisig approve eosio.msig nojack '{"actor":"bob","permission":"owner"}' -p bob@owner
executed transaction: 98c707b04ef43b17e25bfb5fb6700300f438ea3af08f5c5f44724bb7f66c9eb2  128 bytes  441 us
#    eosio.msig <= eosio.msig::approve          {"proposer":"eosio.msig","proposal_name":"nojack","level":{"actor":"bob","permission":"owner"}}
warning: transaction executed locally, but may not be confirmed by the network yet
1
2
3
4
5
6
7
8

10.重新查看提案情况

 cleos get table eosio.msig eosio.msig approvals                                {
  "rows": [{
      "proposal_name": "nojack",
      "requested_approvals": [],
      "provided_approvals": [{
          "actor": "alice",
          "permission": "owner"
        },{
          "actor": "bob",
          "permission": "owner"
        }
       ]
    }],
  "more": false
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

可以看到，原requested_approvals中的待审批项已经全部转到了provided_approvals 已审批列表中。

这里我们可以通过unapprove命令将已审批项转至未审批集合中去。unapprove的参数与以上approve完全相同。

11.执行提案
以上两个非jack账户的审批过程就是多签名的内容，多签名执行成功以后，可以开始执行提案。

$ cleos multisig exec eosio.msig nojack -p eosio.msig
executed transaction: 8734cd573e33c0bbc9f13372f4950908312afdac0146bccae624dba53995bf4b  160 bytes  441 us
#    eosio.msig <= eosio.msig::exec             {"proposer":"eosio.msig","proposal_name":"nojack","executer":"eosio.msig"}
warning: transaction executed locally, but may not be confirmed by the network yet
1
2
3
4

解决问题：以上提案执行过程会出现执行失败的情况，错误信息：

{"auth":{"actor":"jack","permission":"owner"},"provided_delay":0,"provided_permissions":[{"actor":"eosio.msig","permission":"eosio.code"}],"provided_keys":[],"delay_max_limit_ms":388800000}
1

解决方法是要部署system合约并利用system合约为多签名合约的功能授权，授权成功以后再执行即可成功。

cleos push action eosio setpriv '["eosio.msig", 1]' -p eosio
1

1个小坑：是在部署system合约时报错transaction took too long，这种情况只需要在执行命令时加 -x 参数，默认值是30s，改为60让时间延长一些即可执行成功。

12. 验证结果
执行成功以后，再次检查各账户的SYS余额，能够发现此提案的转账50个SYS的操作已经生效。

~$ cleos get currency balance eosio.token alice
100 SYS
~$ cleos get currency balance eosio.token jack
45 SYS
~$ cleos get currency balance eosio.token bob
155 SYS
1
2
3
4
5
6

五、自定义权限

上面提到了，除了owner和active权限之外，我们还可以自定义权限。仍在以上@Jack账户中进行补充，增加一个自定义权限，名为publish：
在这里插入图片描述
weight:

权重，这是相对于上面threshold阈值的概念，就拿上面的属于账户@Jack的publish权限来讲，它包含三个子权限分别是：

@Alice账户，权重为2
@Bob账户，权重为2
一个keys，权重为1
而此时publish权限的阈值设定为2，也就是说，@Alice或@Bob任意一个账户均可以签名授权@Jack账户的publish权限，因为这两个账户的权重均为2，任意一个签名都可保证够到publish权限的阈值2。而如果只有权重为1的keys签名，则必须再有以上任意一个账户来同时签名，总权重达到了3，超过了publish阈值2才可以成功授权。

自定义权限部分的演示与上面的类似，通过set account permission可以设置有key，有账户，不同权重的十分复杂的权限内容。这里不再赘述。

—-

编译者/作者：流浪诗人

玩币族申明：玩币族作为开放的资讯翻译/分享平台，所提供的所有资讯仅代表作者个人观点，与玩币族平台立场无关，且不构成任何投资理财建议。文章版权归原作者所有。

知识钱包合约公钥账户