bitcoin cash的地址格式 cash addr 简介

傷城~ 2021-07-28 19:17 411阅读 0赞

## 摘要 ##

这篇文章主要阐述用于bitcoin cash的地址格式。它是一种base32编码格式，使用BCH 代码作为校验和，可以直接用于链接或QR码。

这种格式重用了Bech32的工作，在某些方面类似，但在其他方面有所改进。

## 规范 ##

新的bitcoin cash地址是由：

1.  能够表示该地址有效的网络的前缀，一般为主网、测试网、回归测试网三种。
2.  一个分隔符：`:`
3.  一个base32编码的payload，表示这个地址的目的地和包含的checksum（校验和）。

### prefix ###

这个前缀标明了该address所属于的有效网络是哪一个，前缀的命名主要如下：

*  主网：`bitcoincash`
 *  测试网：`bchtest`
 *  回归测试：`bchreg`

紧接着在前缀后面跟一个分隔符：`:`

当用户在使用时，可以省略前缀，但这是校验和计算的一部分。校验和可确保不同网络上的地址相互之间不兼容，即使没有标明前缀也是如此。

### payload ###

payload是base32编码的数据流：

payload由三个元素组成：

1.  指示地址字节的版本类型。
2.  一个hash值。
3.  一个40字节的校验和。

Version byte

版本字节的 most signficant bit是保留的，必须为0。接下来的4位表示地址类型，3个最低有效位表示hash的大小。

在版本字段中，编码hash的大小可确保地址的长度是否正确。

<table> 
 <thead> 
  <tr> 
   <th>Type bits</th> 
   <th>Meaning</th> 
   <th>Version byte value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0</td> 
   <td>P2KH</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>P2SH</td> 
   <td>8</td> 
  </tr> 
 </tbody> 
</table>

随着新功能的添加，将添加更多类型。

Hash

hash含义取决于版本字段。它是表示数据的hash，即P2KH的pubkey hash和P2SH的reedemScript哈希。

Checksum

校验和是在GF（2 ^ 5）上定义的40比特BCH码。它可确保检测到地址中最多6到8个错误。结合长度检查，这可以非常有效地防止错误。

校验和根据以下代码计算：

uint64_t PolyMod(const data &v) {
        uint64_t c = 1;
        for (uint8_t d : v) {
            uint8_t c0 = c >> 35;
            c = ((c & 0x07ffffffff) << 5) ^ d;
            
            if (c0 & 0x01) c ^= 0x98f2bc8e61;
            if (c0 & 0x02) c ^= 0x79b76d99e2;
            if (c0 & 0x04) c ^= 0xf33e5fb3c4;
            if (c0 & 0x08) c ^= 0xae2eabe2a8;
            if (c0 & 0x10) c ^= 0x1e4f43e470;
        }
        
        return c ^ 1;
    }

校验和是根据以下数据计算的（0-31范围内的整数列表）：

1.  前缀的每个字符的低5位。 - 例如“位...”变成2,9,20，......
2.  分隔符为零（5个零位）
3.  payload由5位的块组成。如有必要，payload将以零位填充到右侧，以完成那些unfinished的块。
4.  八个零作为校验和的“模板”。

PolyMod返回的40位数字被分成8个5位数字（msb优先）。然后根据base32字符表对payload和checksum进行编码。

要验证base32格式的地址，它将在冒号“：”中拆分为prefix和payload。 PolyMod功能的输入数据（整数列表）由以下部分组装而成：

1.  前缀的每个字符的低5位。
2.  分隔符为零（5个零位）。
3.  payload的每个base32字符映射到它的相应数字。如果PolyMod返回非零值，则地址被破坏。

以下地址可用作校验和计算的测试向量：

*  prefix:x64nx6hz
 *  p:gpf8m4h7
 *  bitcoincash:qpzry9x8gf2tvdw0s3jn54khce6mua7lcw20ayyn
 *  bchtest:testnetaddress4d6njnut
 *  bchreg:555555555555555555555555555555555555555555555udxmlmrz

注意：这些地址故意没有有效的payload。

## Error correction ##

BCH码允许纠错。但是，强烈建议不要以自动方式进行纠错，因为如果做错了可能会导致资金无法恢复。然而，它可以用于暗示用户可能的错误。

## Double prefix ##

在某些情况下，例如付款URL或QR码，地址目前以bitcoincash为前缀：在这些上下文中，地址不得重复添加前缀。

## Examples of address translation ##

以下地址以旧格式和新格式给出。

<table> 
 <thead> 
  <tr> 
   <th>Legacy</th> 
   <th>CashAddr</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1BpEi6DfDAUFd7GtittLSdBeYJvcoaVggu</td> 
   <td>bitcoincash:qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a</td> 
  </tr> 
  <tr> 
   <td>1KXrWXciRDZUpQwQmuM1DbwsKDLYAYsVLR</td> 
   <td>bitcoincash:qr95sy3j9xwd2ap32xkykttr4cvcu7as4y0qverfuy</td> 
  </tr> 
  <tr> 
   <td>16w1D5WRVKJuZUsSRzdLp9w3YGcgoxDXb</td> 
   <td>bitcoincash:qqq3728yw0y47sqn6l2na30mcw6zm78dzqre909m2r</td> 
  </tr> 
  <tr> 
   <td>3CWFddi6m4ndiGyKqzYvsFYagqDLPVMTzC</td> 
   <td>bitcoincash:ppm2qsznhks23z7629mms6s4cwef74vcwvn0h829pq</td> 
  </tr> 
  <tr> 
   <td>3LDsS579y7sruadqu11beEJoTjdFiFCdX4</td> 
   <td>bitcoincash:pr95sy3j9xwd2ap32xkykttr4cvcu7as4yc93ky28e</td> 
  </tr> 
  <tr> 
   <td>31nwvkZwyPdgzjBJZXfDmSWsC4ZLKpYyUw</td> 
   <td>bitcoincash:pqq3728yw0y47sqn6l2na30mcw6zm78dzq5ucqzc37</td> 
  </tr> 
 </tbody> 
</table>

## Larger Test Vectors ##

该表定义了具有各种前缀的各种大小为160-512位的有效载荷的测试向量。这些测试向量不以传统地址格式给出，因为传统格式限于160比特的有效载荷。

<table> 
 <thead> 
  <tr> 
   <th>Payload Size (bytes)</th> 
   <th>Type</th> 
   <th>CashAddr</th> 
   <th>Payload (hex)</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>20</td> 
   <td>0</td> 
   <td>bitcoincash:qr6m7j9njldwwzlg9v7v53unlr4jkmx6eylep8ekg2</td> 
   <td>F5BF48B397DAE70BE82B3CCA4793F8EB2B6CDAC9</td> 
  </tr> 
  <tr> 
   <td>20</td> 
   <td>1</td> 
   <td>bchtest:pr6m7j9njldwwzlg9v7v53unlr4jkmx6eyvwc0uz5t</td> 
   <td>F5BF48B397DAE70BE82B3CCA4793F8EB2B6CDAC9</td> 
  </tr> 
  <tr> 
   <td>20</td> 
   <td>0</td> 
   <td>pref:pr6m7j9njldwwzlg9v7v53unlr4jkmx6ey65nvtks5</td> 
   <td>F5BF48B397DAE70BE82B3CCA4793F8EB2B6CDAC9</td> 
  </tr> 
  <tr> 
   <td>20</td> 
   <td>15</td> 
   <td>prefix:0r6m7j9njldwwzlg9v7v53unlr4jkmx6ey3qnjwsrf</td> 
   <td>F5BF48B397DAE70BE82B3CCA4793F8EB2B6CDAC9</td> 
  </tr> 
  <tr> 
   <td>24</td> 
   <td>0</td> 
   <td>bitcoincash:q9adhakpwzztepkpwp5z0dq62m6u5v5xtyj7j3h2ws4mr9g0</td> 
   <td>7ADBF6C17084BC86C1706827B41A56F5CA32865925E946EA</td> 
  </tr> 
  <tr> 
   <td>24</td> 
   <td>1</td> 
   <td>bchtest:p9adhakpwzztepkpwp5z0dq62m6u5v5xtyj7j3h2u94tsynr</td> 
   <td>7ADBF6C17084BC86C1706827B41A56F5CA32865925E946EA</td> 
  </tr> 
  <tr> 
   <td>24</td> 
   <td>0</td> 
   <td>pref:p9adhakpwzztepkpwp5z0dq62m6u5v5xtyj7j3h2khlwwk5v</td> 
   <td>7ADBF6C17084BC86C1706827B41A56F5CA32865925E946EA</td> 
  </tr> 
  <tr> 
   <td>24</td> 
   <td>15</td> 
   <td>prefix:09adhakpwzztepkpwp5z0dq62m6u5v5xtyj7j3h2p29kc2lp</td> 
   <td>7ADBF6C17084BC86C1706827B41A56F5CA32865925E946EA</td> 
  </tr> 
  <tr> 
   <td>28</td> 
   <td>0</td> 
   <td>bitcoincash:qgagf7w02x4wnz3mkwnchut2vxphjzccwxgjvvjmlsxqwkcw59jxxuz</td> 
   <td>3A84F9CF51AAE98A3BB3A78BF16A6183790B18719126325BFC0C075B</td> 
  </tr> 
  <tr> 
   <td>28</td> 
   <td>1</td> 
   <td>bchtest:pgagf7w02x4wnz3mkwnchut2vxphjzccwxgjvvjmlsxqwkcvs7md7wt</td> 
   <td>3A84F9CF51AAE98A3BB3A78BF16A6183790B18719126325BFC0C075B</td> 
  </tr> 
  <tr> 
   <td>28</td> 
   <td>0</td> 
   <td>pref:pgagf7w02x4wnz3mkwnchut2vxphjzccwxgjvvjmlsxqwkcrsr6gzkn</td> 
   <td>3A84F9CF51AAE98A3BB3A78BF16A6183790B18719126325BFC0C075B</td> 
  </tr> 
  <tr> 
   <td>28</td> 
   <td>15</td> 
   <td>prefix:0gagf7w02x4wnz3mkwnchut2vxphjzccwxgjvvjmlsxqwkc5djw8s9g</td> 
   <td>3A84F9CF51AAE98A3BB3A78BF16A6183790B18719126325BFC0C075B</td> 
  </tr> 
  <tr> 
   <td>32</td> 
   <td>0</td> 
   <td>bitcoincash:qvch8mmxy0rtfrlarg7ucrxxfzds5pamg73h7370aa87d80gyhqxq5nlegake</td> 
   <td>3173EF6623C6B48FFD1A3DCC0CC6489B0A07BB47A37F47CFEF4FE69DE825C060</td> 
  </tr> 
  <tr> 
   <td>32</td> 
   <td>1</td> 
   <td>bchtest:pvch8mmxy0rtfrlarg7ucrxxfzds5pamg73h7370aa87d80gyhqxq7fqng6m6</td> 
   <td>3173EF6623C6B48FFD1A3DCC0CC6489B0A07BB47A37F47CFEF4FE69DE825C060</td> 
  </tr> 
  <tr> 
   <td>32</td> 
   <td>0</td> 
   <td>pref:pvch8mmxy0rtfrlarg7ucrxxfzds5pamg73h7370aa87d80gyhqxq4k9m7qf9</td> 
   <td>3173EF6623C6B48FFD1A3DCC0CC6489B0A07BB47A37F47CFEF4FE69DE825C060</td> 
  </tr> 
  <tr> 
   <td>32</td> 
   <td>15</td> 
   <td>prefix:0vch8mmxy0rtfrlarg7ucrxxfzds5pamg73h7370aa87d80gyhqxqsh6jgp6w</td> 
   <td>3173EF6623C6B48FFD1A3DCC0CC6489B0A07BB47A37F47CFEF4FE69DE825C060</td> 
  </tr> 
  <tr> 
   <td>40</td> 
   <td>0</td> 
   <td>bitcoincash:qnq8zwpj8cq05n7pytfmskuk9r4gzzel8qtsvwz79zdskftrzxtar994cgutavfklv39gr3uvz</td> 
   <td>C07138323E00FA4FC122D3B85B9628EA810B3F381706385E289B0B25631197D194B5C238BEB136FB</td> 
  </tr> 
  <tr> 
   <td>40</td> 
   <td>1</td> 
   <td>bchtest:pnq8zwpj8cq05n7pytfmskuk9r4gzzel8qtsvwz79zdskftrzxtar994cgutavfklvmgm6ynej</td> 
   <td>C07138323E00FA4FC122D3B85B9628EA810B3F381706385E289B0B25631197D194B5C238BEB136FB</td> 
  </tr> 
  <tr> 
   <td>40</td> 
   <td>0</td> 
   <td>pref:pnq8zwpj8cq05n7pytfmskuk9r4gzzel8qtsvwz79zdskftrzxtar994cgutavfklv0vx5z0w3</td> 
   <td>C07138323E00FA4FC122D3B85B9628EA810B3F381706385E289B0B25631197D194B5C238BEB136FB</td> 
  </tr> 
  <tr> 
   <td>40</td> 
   <td>15</td> 
   <td>prefix:0nq8zwpj8cq05n7pytfmskuk9r4gzzel8qtsvwz79zdskftrzxtar994cgutavfklvwsvctzqy</td> 
   <td>C07138323E00FA4FC122D3B85B9628EA810B3F381706385E289B0B25631197D194B5C238BEB136FB</td> 
  </tr> 
  <tr> 
   <td>48</td> 
   <td>0</td> 
   <td>bitcoincash:qh3krj5607v3qlqh5c3wq3lrw3wnuxw0sp8dv0zugrrt5a3kj6ucysfz8kxwv2k53krr7n933jfsunqex2w82sl</td> 
   <td>E361CA9A7F99107C17A622E047E3745D3E19CF804ED63C5C40C6BA763696B98241223D8CE62AD48D863F4CB18C930E4C</td> 
  </tr> 
  <tr> 
   <td>48</td> 
   <td>1</td> 
   <td>bchtest:ph3krj5607v3qlqh5c3wq3lrw3wnuxw0sp8dv0zugrrt5a3kj6ucysfz8kxwv2k53krr7n933jfsunqnzf7mt6x</td> 
   <td>E361CA9A7F99107C17A622E047E3745D3E19CF804ED63C5C40C6BA763696B98241223D8CE62AD48D863F4CB18C930E4C</td> 
  </tr> 
  <tr> 
   <td>48</td> 
   <td>0</td> 
   <td>pref:ph3krj5607v3qlqh5c3wq3lrw3wnuxw0sp8dv0zugrrt5a3kj6ucysfz8kxwv2k53krr7n933jfsunqjntdfcwg</td> 
   <td>E361CA9A7F99107C17A622E047E3745D3E19CF804ED63C5C40C6BA763696B98241223D8CE62AD48D863F4CB18C930E4C</td> 
  </tr> 
  <tr> 
   <td>48</td> 
   <td>15</td> 
   <td>prefix:0h3krj5607v3qlqh5c3wq3lrw3wnuxw0sp8dv0zugrrt5a3kj6ucysfz8kxwv2k53krr7n933jfsunqakcssnmn</td> 
   <td>E361CA9A7F99107C17A622E047E3745D3E19CF804ED63C5C40C6BA763696B98241223D8CE62AD48D863F4CB18C930E4C</td> 
  </tr> 
  <tr> 
   <td>56</td> 
   <td>0</td> 
   <td>bitcoincash:qmvl5lzvdm6km38lgga64ek5jhdl7e3aqd9895wu04fvhlnare5937w4ywkq57juxsrhvw8ym5d8qx7sz7zz0zvcypqscw8jd03f</td> 
   <td>D9FA7C4C6EF56DC4FF423BAAE6D495DBFF663D034A72D1DC7D52CBFE7D1E6858F9D523AC0A7A5C34077638E4DD1A701BD017842789982041</td> 
  </tr> 
  <tr> 
   <td>56</td> 
   <td>1</td> 
   <td>bchtest:pmvl5lzvdm6km38lgga64ek5jhdl7e3aqd9895wu04fvhlnare5937w4ywkq57juxsrhvw8ym5d8qx7sz7zz0zvcypqs6kgdsg2g</td> 
   <td>D9FA7C4C6EF56DC4FF423BAAE6D495DBFF663D034A72D1DC7D52CBFE7D1E6858F9D523AC0A7A5C34077638E4DD1A701BD017842789982041</td> 
  </tr> 
  <tr> 
   <td>56</td> 
   <td>0</td> 
   <td>pref:pmvl5lzvdm6km38lgga64ek5jhdl7e3aqd9895wu04fvhlnare5937w4ywkq57juxsrhvw8ym5d8qx7sz7zz0zvcypqsammyqffl</td> 
   <td>D9FA7C4C6EF56DC4FF423BAAE6D495DBFF663D034A72D1DC7D52CBFE7D1E6858F9D523AC0A7A5C34077638E4DD1A701BD017842789982041</td> 
  </tr> 
  <tr> 
   <td>56</td> 
   <td>15</td> 
   <td>prefix:0mvl5lzvdm6km38lgga64ek5jhdl7e3aqd9895wu04fvhlnare5937w4ywkq57juxsrhvw8ym5d8qx7sz7zz0zvcypqsgjrqpnw8</td> 
   <td>D9FA7C4C6EF56DC4FF423BAAE6D495DBFF663D034A72D1DC7D52CBFE7D1E6858F9D523AC0A7A5C34077638E4DD1A701BD017842789982041</td> 
  </tr> 
  <tr> 
   <td>64</td> 
   <td>0</td> 
   <td>bitcoincash:qlg0x333p4238k0qrc5ej7rzfw5g8e4a4r6vvzyrcy8j3s5k0en7calvclhw46hudk5flttj6ydvjc0pv3nchp52amk97tqa5zygg96mtky5sv5w</td> 
   <td>D0F346310D5513D9E01E299978624BA883E6BDA8F4C60883C10F28C2967E67EC77ECC7EEEAEAFC6DA89FAD72D11AC961E164678B868AEEEC5F2C1DA08884175B</td> 
  </tr> 
  <tr> 
   <td>64</td> 
   <td>1</td> 
   <td>bchtest:plg0x333p4238k0qrc5ej7rzfw5g8e4a4r6vvzyrcy8j3s5k0en7calvclhw46hudk5flttj6ydvjc0pv3nchp52amk97tqa5zygg96mc773cwez</td> 
   <td>D0F346310D5513D9E01E299978624BA883E6BDA8F4C60883C10F28C2967E67EC77ECC7EEEAEAFC6DA89FAD72D11AC961E164678B868AEEEC5F2C1DA08884175B</td> 
  </tr> 
  <tr> 
   <td>64</td> 
   <td>0</td> 
   <td>pref:plg0x333p4238k0qrc5ej7rzfw5g8e4a4r6vvzyrcy8j3s5k0en7calvclhw46hudk5flttj6ydvjc0pv3nchp52amk97tqa5zygg96mg7pj3lh8</td> 
   <td>D0F346310D5513D9E01E299978624BA883E6BDA8F4C60883C10F28C2967E67EC77ECC7EEEAEAFC6DA89FAD72D11AC961E164678B868AEEEC5F2C1DA08884175B</td> 
  </tr> 
  <tr> 
   <td>64</td> 
   <td>15</td> 
   <td>prefix:0lg0x333p4238k0qrc5ej7rzfw5g8e4a4r6vvzyrcy8j3s5k0en7calvclhw46hudk5flttj6ydvjc0pv3nchp52amk97tqa5zygg96ms92w6845</td> 
   <td>D0F346310D5513D9E01E299978624BA883E6BDA8F4C60883C10F28C2967E67EC77ECC7EEEAEAFC6DA89FAD72D11AC961E164678B868AEEEC5F2C1DA08884175B</td> 
  </tr> 
 </tbody> 
</table>