每天进步一点点：custom_json & follow\unfollow\mute\unmute

我们都知道，HIVE上我们追随或者拉黑一个人，对应的操作是follow以及mute，相应的取消操作分别为mute与unmute，实际上在链上，这些都是通过同一个操作实现的，那就是custom_json。

(图源：pixabay)

说到custom_json，那简直是一个百宝箱，可以配合链上/链下的应用实现好多功能，举例来说以前SE的好多功能都是用custom_json来实现的，还有现在的社区功能，也是基于custom_json的。

结构

custom_json的模板大致如下：

op_custom_json = ['custom_json', {
    'required_auths': [],
    'required_posting_auths': [],
    'id': '',
    'json': ''
  }]

其中required_auths中需要填写需要ACTIVE授权的用户组，required_posting_auths填写需要POSTING权限的用户组，两者均可以留空，但是不能同时为空，相应的检查代码如下：

FC_ASSERT( (required_auths.size() + required_posting_auths.size()) > 0, "at least one account must be specified" );

id这个名字起的比较怪，我看到id就会以为它是一个数字，其实不然，id是一个字符串。在代码注释中，说id长度必须小于32个字符：

custom_id_type id; ///< must be less than 32 characters long

但是实际上，检查代码如下：

FC_ASSERT( id.size() <= STEEM_CUSTOM_OP_ID_MAX_LENGTH, "Operation ID length exceeded. Max: ${max} Current: ${n}", ("max", STEEM_CUSTOM_OP_ID_MAX_LENGTH)("n", id.size()) );

而STEEM_CUSTOM_OP_ID_MAX_LENGTH定义为32，所以 id的最大长度实际上是32啦。

至于json就不用多说了，就是转化成UTF8编码字符串的JSON啦。

实现

知道了custom_json的定义，实现起来就比较简单了，下面是大致的实现逻辑：

给对应项赋值：

op[1]['id'] = id
op[1]['json'] = json.dumps(json_data)
op[1]['required_auths'] = required_auths
op[1]['required_posting_auths'] = required_posting_auths

追加进transaction，对其签名并广播：

trx.append_op(op)
trx.sign_digest(wif)
ret = trx.broadcast()

follow\unfollow\mute\unmute

有了custom_json，我们就可以实现follow\unfollow\mute\unmute功能了。

以@oflyhigh.test账户为例，几个操作对应JSON如下：

json_follow = ["follow",{"follower":"oflyhigh.test","following":"oflyhigh","what":["blog"]}]
json_unfollow = ["follow",{"follower":"oflyhigh.test","following":"oflyhigh","what":[]}]
json_mute = ["follow",{"follower":"oflyhigh.test","following":"oflyhigh","what":["ignore"]}]
json_unmute = ["follow",{"follower":"oflyhigh.test","following":"oflyhigh","what":[]}]

我们不难看出unfollow和unmute其实是一样的，都是把what中的内容清空。

将上述json内容放入我们实现的custom_json函数中，就会实现对应的功能，比如: