eos系统合约提案合约eosio.msig (下)
简介
本篇将为大家介绍eosio.msig的源码实现，合约代码库详见：eosio.msig。eosio.msig主要有propose、approve、unapprove、cancel、exec、invalidate这几种方法，下面会详细逐一介绍每种方法的功能和实现细节。
主要合约方法
eosio.msig合约，在eosio.msig.hpp头文件中，主要定义了以下六个合约方法：
- propose：提出提案
- approve：通过提案
- unapprove：不通过提案
- cancel：取消提案
- exec：执行提案
- invalidate：撤回对之前所有该账户通过、但未被最终执行的提案的通过授权
eosio.msig合约头文件
propose方法
propose方法主要功能是提出提案，对应上篇提到的 `cleos multisig propose` 命令，传参如下：
- proposer：提案账户
- proposal_name：提案名
- requested：提案通过所需权限
- trx：提案具体执行的交易内容
为了节省资源开销，propose方法并不会根据 `cleos multisig propose` 传入的参数一一做解析，而是直接解析input data
propose方法获取提案详细内容
之后，会做一系列前置检验工作：proposer提案账户授权是否正确、交易是否超时、propose_name是否存在、提案通过所需权限是否正确等
propose的前置检验
之后，将提案和提案合约的内容存表，将提案通过所需的权限存入requested_approvals表中，我们上篇文章所提到 `cleos get table eosio.msig
propose提案数据、提案所需通过权限存表
approve方法
approve方法的主要功能是通过提案，对应上篇提到的 `cleos multisig approve` 命令，传参如下：
- proposer：提案人
- proposal_name：提案名
- permissions：使用哪个权限批准这个提案
首先，系统会查找提案合约内容，查找 requested_approvals 表中需要通过的权限中，是否有和传入permission匹配项。若有匹配项，将此权限加入 provided_approvals 表，即表示该权限通过此提案，并从 requested_approvals 表中移除该权限。
approve方法实现细节
unapprove方法
unapprove方法的主要功能是不通过提案，对应上篇提到的 `cleos multisig unapprove` 命令，传参如下：
- proposer：提案人
- proposal_name：提案名
- permissions：使用哪个权限拒绝这个提案
首先，系统会查找提案合约内容，查找 provided_approvals 表中通过的权限中，是否有和传入permission匹配项。若有匹配项，将此权限加入requested_approvals 表，即表示该权限还没通过此提案，并从 provided_approvals 表中移除该权限。
unapprove方法实现细节
cancel方法
cancel方法的主要功能是取消提案，对应上篇提到的 `cleos multisig cancel` 命令，传参如下：
- proposer：提案账户
- proposal_name：提案名
- canceler：取消账户
首先，先查找表获取提案内容。如果canceler账户和提案账户不同，则在提案交易过期之前，canceler都不能取消提案。若能取消，将提案从表中移除。
cancel方法实现细节
exec方法
exec方法的主要功能是执行提案，对应上篇提到的 `cleos multisig exec` 命令，传参如下：
- proposer：提案账户
- proposal_name：提案名
- executer：执行账户
首先，需要做前置检查，检查交易是否过期
前置检查
然后，查 provided_approvals 表获取通过提案交易的权限们，对比 inv_table 表，如果权限不在 inv_table 表中或者 last_invalidation_time 已经小于当前时间，代表权限有效，放入approvals表中。inv_table 表的用途在下一个invalidate方法中介绍
获取通过提案的权限们
最后，执行提案。如果交易执行权限检验无误，会发起一个defer延迟合约，去执行提案交易。如果执行成功，`cleos get actions
exec方法的详细实现
invalidate方法
invalidate方法的主要功能是：如果account之前通过的提案还未执行，就可以使用该方法将提案一键设置为无效。这个方法主要是解决：账户权限变更时，之前通过但未执行的提案一旦执行会盗取账户权限的问题，详见issue。该方法传参如下：
- account：提案的批准账户
该功能的实现非常简单，首先，inv_table 是用来存放权限的，它的两个字段 account 和last_invalidation_time 分别是账户名和账户权限最近失效时间。last_invalidation_time 时间之前，account的提案批准权限都不可用，在该时间之后account的提案批准权限才能生效。
因此，如果想使account之前审批通过的所有提案都失效的话，就将 last_invalidation_time 设置为当前时间即可。exec方法在执行之前会检查 inv_table，则包含在 inv_table 中的account，即便批准了该提案，该批准也会作废
invalidate方法实现细节
后记
不好意思，最近因为杂七杂八的事情，很久没更新博文，以后会更新的稍微勤快点，请各位看客见谅。eosio.msig合约的介绍就到这里。后面的文章，将为大家介绍eosio.system合约，该合约是投票选举超级节点的核心合约，尽请期待！