pybitcointools源码分析之BIP32实现

在看本篇之前,需要了解一个很重要的背景知识。那就是 HD钱包和 比特币协议 BIP32

关于HD钱包的概念,建议大家去看看<<精通比特币>>。BIP32可以看下下面这篇翻译:

http://blog.csdn.net/pony_maggie/article/details/76178228


开始源码分析。

master = bip32_master_key(safe_from_hex("000102030405060708090a0b0c0d0e0f"))

safe_from_hex把字符串形式的16进制数字转换成byte形式, 例如"1234"->b"\x12\x34"。
比较简单不详述。

bip32_master_key函数是用于产生符合bip32的主密钥。那边问题来了,什么是 bip32的主密钥呢?

根据bip32约定,主密钥是从一个短种子值生成的,步骤如下:

  • 从(P)RNG生成所选长度(128到512位;建议256位)的种子字节序列S。

  • 计算I = HMAC-SHA512(Key =“Bitcoin seed”,Data = S)

  • 将I分为两个32字节序列,IL和IR。

  • 使用parse256(IL)作为主密钥,IR作为主链码。


有了上面的理论支撑,再来看代码就比较容易理解了。

def bip32_master_key(seed, vbytes=MAINNET_PRIVATE):
    I = hmac.new(from_string_to_bytes("Bitcoin seed"), seed, hashlib.sha512).digest()

    return bip32_serialize((vbytes, 0, b'\x00'*4, 0, I[32:], I[:32]+b'\x01'))

I是hmac-sha512算法计算得到的,用的key是"Bitcoin seed",data是前面传过来的短种子值:

b"\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f"

I[32:]就是IR, I[:32]是IL。根据规范IL就可以作为主密钥了,那bip32_serialize是干啥的呢?

原来是为了方便表示,bip32引入序列化的概念,过程如下:

  • 4字节:版本字节(mainnet:0x0488B21E public,0x0488ADE4 private; testnet:0x043587CF public,0x04358394 private)

  • 1字节:深度:主节点为0x00,级别1派生密钥为0x01。

  • 4字节:父密钥的指纹(如果主密钥为0x00000000)

  • 4字节:子数字。这是对于i在xi = xpar / i中的ser32(i),其中xi是键序列化。 (如果主密钥为0x00000000)

  • 32字节:链码

  • 33字节:公钥或私钥数据(公钥的serP(K),私钥的0x00 || ser256(k))

可以通过首先添加32个校验和位(从双SHA-256校验和派生),然后转换为Base58表示。

bip32_serialize入参有六个,我们可以和上面一一对应下,

vbytes是版本字节,0x0488ADE4。

0表示深度,这里是主密钥,深度表示为0。

b'\x00'*4在python中就是b'\x00\x00\x00\x00',对应父密钥的指纹。

接下来的0对应子数字,在bip32_serialize函数里会转为4字节。

I[32:]也叫IR,对应链码。

I[:32]+b'\x01',33字节对应私钥数据(这里是私钥)。

进入bip32_serialize里面,

def bip32_serialize(rawtuple):
    vbytes, depth, fingerprint, i, chaincode, key = rawtuple
    i = encode(i, 256, 4)

    keydata = b'\x00'+key[:-1] if vbytes in PRIVATE else key
    bindata = vbytes + from_int_to_byte(depth % 256) + fingerprint + i + chaincode + keydata

    return changebase(bindata+bin_dbl_sha256(bindata)[:4], 256, 58)

i的值是0, i = encode(i, 256, 4)把0转换为b'\x00\x00\x00\x00'。

keydata是就是公钥或者私钥数据(这里是私钥)。

最后拼接然后转换为base58表示。


下面看看如何用主密钥衍生出第一个子密钥。

bip32_ckd(master, "0")

参数0是一个索引值,表示第一个子密钥。

def bip32_ckd(data, i):
    return bip32_serialize(raw_bip32_ckd(bip32_deserialize(data), i))

bip32_serialize这个之前说过了,bip32_deserialize很明显是相对的,反序列化。就是把主密钥再变回元组的表示。

所以核心的函数是raw_bip32_ckd。在分析这个函数之前还是要先来点理论知识,看看BIP32里对于主密钥(私钥)衍生子密钥是怎么说的,

函数CKDpriv((kpar,cpar),i)→(ki,ci)从父扩展私钥计算子扩展私钥:

  1. 检查 是否 i ≥ 2^31(子私钥)。

    如果是(硬化的子密钥):让I= HMAC-SHA512(Key = cpar,Data = 0x00 || ser256(kpar)|| ser32(i))。 (注意:0x00将私钥补齐到33字节长。)

    如果不是(普通的子密钥):让I= HMAC-SHA512(Key = cpar,Data = serP(point(kpar))|| ser32(i))。

  1. 将I分为两个32字节序列,IL和IR。
  1. 返回的子密钥ki是parse256(IL)+ kpar(mod n)。
  1. 返回的链码ci是IR。

如果parse256(IL)≥n或ki = 0,则生成的密钥无效,并且应继续下一个i值。 (注:概率低于1/2127)

def raw_bip32_ckd(rawtuple, i):
    vbytes, depth, fingerprint, oldi, chaincode, key = rawtuple
    i = int(i)

    if vbytes in PRIVATE:
        priv = key
        pub = privtopub(key)
    else:
        pub = key

    if i >= 2**31:
        if vbytes in PUBLIC:
            raise Exception("Can't do private derivation on public key!")
        I = hmac.new(chaincode, b'\x00'+priv[:32]+encode(i, 256, 4), hashlib.sha512).digest()
    else:
        I = hmac.new(chaincode, pub+encode(i, 256, 4), hashlib.sha512).digest()

    if vbytes in PRIVATE:
        newkey = add_privkeys(I[:32]+B'\x01', priv)
        fingerprint = bin_hash160(privtopub(key))[:4]
    if vbytes in PUBLIC:
        newkey = add_pubkeys(compress(privtopub(I[:32])), key)
        fingerprint = bin_hash160(key)[:4]

    return (vbytes, depth + 1, fingerprint, i, I[32:], newkey)

代码比较简单,都是按照协议的流程编写的。这里只需要特别说明密钥指纹(fingerprint)的计算规则,

fingerprint = bin_hash160(privtopub(key))[:4]

根据BIP32,扩展密钥可以由序列化的ECSDA公钥K的Hash160(SHA256之后的RIPEMD160)标识。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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

推荐阅读更多精彩内容