比特币源码研读12-程序入口函数解析(11)

接着上一讲,这一讲继续讲解函数AppInitParameterInteraction。这个函数代码有点多,刚大概数了下,到RPC命令注册函数这里差不多一半,也就是说,我们已经研读了该函数的一半代码,只剩下一半了。坚持吧,骚年,胜利女神就在不远处向我们招手。

下面就是RPC命令注册函数,一行代码,看似简单,实则内涵丰富的很呢。

RegisterAllCoreRPCCommands(tableRPC);

在 register.h 便可找到其定义,函数里面又包含有五个格式类似的函数。这几乎注册了所有核心的命令,包括区块链、P2P网络、常用工具、挖矿以及交易等核心命令。

static inline void RegisterAllCoreRPCCommands(CRPCTable &t)

{

    RegisterBlockchainRPCCommands(t);

    RegisterNetRPCCommands(t);

    RegisterMiscRPCCommands(t);

    RegisterMiningRPCCommands(t);

    RegisterRawTransactionRPCCommands(t);

}

1. 区块链之RPC命令

根据目录结构以及命名规则,很容易就可以找到第一个注册函数RegisterBlockchainRPCCommands实现于 rpc 目录下的blockchain.cpp.

void RegisterBlockchainRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

commands 是一个命令数组,存储了所有blockchain命令,如下图所示。然后将命令追加到CRPCTable,CRPCTable 即调度表变量,专门用来存储RPC命令。

2. P2P网络之RPC命令

位于 net.cpp,与blockchain RPC同样的道理,将P2P 网络的命令添加到 CRPCTable变量,完成注册命令的功能。

void RegisterNetRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

以下为P2P网络的命令集合:

3. 常用工具之RPC命令

misc.cpp 中定义RegisterMiscRPCCommands函数如下:

void RegisterMiscRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有命令都存于常量数组 commands。

下面的截图就是调用getinfo命令返回的结果,其中就有客户端版本,网络协议版本,钱包版本以及该钱包余额,当前区块高度,挖矿难度等,都是经常看到也经常用到的数据,有兴趣可以看看源码深入了解下。

tips: 命令输入路径:比特币核心 -- Help 菜单 -- Debug window

4. 挖矿之RPC命令

挖矿命令注册函数RegisterMiningRPCCommands定义于mining.cpp:

void RegisterMiningRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有挖矿命令如下图所示,其中,getmininginfo命令可以查看当前的区块高度,大小,挖矿难度值,网络哈希值,交易池大小等。

5. 交易之RPC命令

交易命令注册函数RegisterRawTransactionRPCCommands定义于rawtransaction.cpp:

void RegisterRawTransactionRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有交易命令如下图所示,

接下来就是注册钱包的RPC命令,根据宏定义判断是否使用了钱包模块,是的话才需要注册RPC命令。

#ifdef ENABLE_WALLET

    RegisterWalletRPCCommands(tableRPC);

#endif

首先判断参数-disablewallet,如果为true,那么直接退出;反之,将所有钱包命令加总在CRPCTable。其中,命令均在 rpcwallet.cpp文件里面。

void RegisterWalletRPCCommands(CRPCTable &t)

{

    if (GetBoolArg("-disablewallet", false))

        return;

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}


继续往下看,-timeout是设置连接超时的参数,如果该值为非正数,那么将设置为默认的5000毫秒,即5秒。

nConnectTimeout = GetArg("-timeout", DEFAULT_CONNECT_TIMEOUT);

    if (nConnectTimeout <= 0)

        nConnectTimeout = DEFAULT_CONNECT_TIMEOUT;

这一节讲的RPC命令挺实用的,大家可以多了解一下,方便以后的网站或应用开发。下一节继续我们的参数交互之旅。有问题欢迎留言,一起探讨哦。

区块链研习社源码研读班 Jacky

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容