其他分享
首页 > 其他分享> > API：BUMO Keypair 指导

API：BUMO Keypair 指导

作者：互联网

BUMO Keypair 指导

概述

本文档详细介绍了Keypair（公、私钥对）的生成过程以及在此基础上如何生成地址（address）并对交易签名，介绍了执行交易调用的两种接口方式以及相关流程，提供了多种ProtoBuf数据结构参考信息，最后以示例的方式详细介绍了两种交易提交方式，即调用接口生成transaction blob和自己生成transaction blob。

原理图

下图说明了私钥、公钥和地址的生成原理。

生成私钥

生成私钥需要使用随机算法、SHA256 等多个算法才能实现。生成私钥包括以下步骤：

  1. 利用随机算法生成一个256位的随机数（数学意义上的私钥），得到字节数组即 raw private key，如下所示：

    [17,236,24,183,207,250,207,180,108,87,224,39,189,99,246,85,138,120,236,78, 228,233,41,192,124,109,156,104,235,66,194,24]

  2. 在 raw private key前面加上3个字节的前缀（Prefix），然后再加上1个字节的版本号（Version），并在后面添加1个字节的填充位（Fill），得到新的字节数组，如下所示：

    [218,55,159,1,17,236,24,183,207,250,207,180,108,87,224,39,189,99,246,85,138,120,236,78,228,233,41,192,124,109,156,104,235,66,194,24,0]

    Note : 关于Prefix、Version、Checksum和Fill，请查看表1。

  3. 对第2步中得到的字节数组进行两次 SHA256 计算，取运算结果的前4个字节，得到校验码（Checksum）的字节数组，如下所示：

    [30,19,80,117]

  4. 将第2步中的字节数组和第3步中的校验码字节数组按照先后顺序连接在一起，得到新的字节数组，如下所示：

    [218,55,159,1,17,236,24,183,207,250,207,180,108,87,224,39,189,99,246,85,138,120,236,78,228,233,41,192,124,109,156,104,235,66,194,24,0,30,19,80,117]

  5. 对第4步中产生的字节数组进行Base58编码，得到以priv开始的字符串，即私钥（private key），如下所示：

    privbsGZFUoRv8aXZbSGd3bwzZWFn3L5QKq74RXAQYcmfXhhZ54CLr9z

    至此就完成了私钥的生成。

表1

名称 数据内容 长度
Prefix 0xDA 0x37 0x9F 3个字节
Version 0x01 1个字节
Fill 0x00 1个字节
Checksum 对第2步中得到的字节数组进行两次SHA256运算之后，取运算结果的前4个字节 4个字节

该表对生成私钥中使用到的Prefix、Version、Fill以及Checksum进行了说明。

生成公钥

生成公钥需要在生成私钥之后才能实现，需要用到 ED25519 算法。生成公钥包含以下步骤：

  1. 通过 ED25519 算法对raw private key进行处理生成32位的字节数组，即raw public key。例如私钥是privbsGZFUoRv8aXZbSGd3bwzZWFn3L5QKq74RXAQYcmfXhhZ54CLr9z，其raw public key如下所示：

    [21,118,76,208,23,224,218,117,50,113,250,38,205,82,148,81,162,27,130,83,208,1,240,212,54,18,225,158,198,50,87,10]

  2. 在raw public key 前面加上1个字节的前缀（Prefix），然后再加上1个字节的版本号（Version），得到新的字节数组，如下所示：

    [176,1,21,118,76,208,23,224,218,117,50,113,250,38,205,82,148,81,162,27,130,83,208,1,240,212,54,18,225,158,198,50,87,10]

    Note：关于Prefix、Version以及Checksum请查看表2。

  3. 对第2步中的字节数组进行两次 SHA256 计算，取运算结果的前4个字节，得到校验码（Checksum）的字节数组，如下所示：

    [116,171,22,107]

  4. 将第2步中的字节数组和3步的校验码字节数组按照先后顺序连接在一起，得到新的字节数组，如下所示：

    [176,1,21,118,76,208,23,224,218,117,50,113,250,38,205,82,148,81,162,27,130,83,208,1,240,212,54,18,225,158,198,50,87,10,116,171,22,107]

  5. 对第4步中的字节数组进行16进制编码，得到16进制字符串，即公钥（public key），如下所示：

    b00115764cd017e0da753271fa26cd529451a21b8253d001f0d43612e19ec632570a74ab166b

    至此就完成了公钥的生成。

表2

名称 数据内容 长度
Prefix 0xB0 1个字节
Version 0x01 1个字节
Checksum 对第2步中得到的字节数组进行两次SHA256运算之后，取运算结果的前4个字节 4个字节

该表对生成公钥中使用到的Prefix、Version以及Checksum进行了说明。

生成地址

在生成私钥和公钥后可以进一步通过算法生成地址。生成地址包含以下步骤：

  1. 通过 ED25519 算法对raw private key进行处理生成32位的字节数组，即 raw public key。例如私钥为 privbsGZFUoRv8aXZbSGd3bwzZWFn3L5QKq74RXAQYcmfXhhZ54CLr9z，其raw public key 如下所示：

    [21,118,76,208,23,224,218,117,50,113,250,38,205,82,148,81,162,27,130,83,208,1,240,212,54,18,225,158,198,50,87,10]

  2. 对 raw public key 进行一次 SHA256 运算，并取运算结果的后20位字节，得到字节数组，如下所示：

    [173,148,59,51,183,193,55,160,1,133,247,80,65,13,67,190,164,114,18,220]

  3. 在第2步产生的字节数组前面加上2个字节的前缀（Prefix），然后再加上1个字节的版本号（Version），得到新的字节数组，如下所示：

    [1,86,1,173,148,59,51,183,193,55,160,1,133,247,80,65,13,67,190,164,114,18,220]

    Note : 关于Prefix、Version以及Checksum请查看表3。

  4. 对第3步中的字节数组进行两次 SHA256 计算，取运算结果的前4个字节，得到校验码（Checksum）的字节数组，如下所示：

    [167,127,34,35]

  5. 将第3步中的字节数组和第4步的校验码字节数组按照先后顺序连接在一起，得到新的字节数组，如下所示：

    [1,86,1,173,148,59,51,183,193,55,160,1,133,247,80,65,13,67,190,164,114,18,220,167,127,34,35]

  6. 对第5步中产生的字节数组进行Base58编码，得到以bu开头的字符串，即地址（address），如下所示：

    buQmWJrdYJP5CPKTbkQUqscwvTGaU44dord8

    至此就完成了地址的生成。

表3

名称 数据内容 长度
Prefix 0x01 0x56 2个字节
Version 0x01 1个字节
PublicKey 取raw public key的后20个字节 20个字节
Checksum 对第3步中得到的字节数组进行两次SHA256运算之后，取运算结果的前4个字节 4个字节

该表对生成地址中使用到的Prefix、Version以及Checksum进行了说明。

交易签名

借助 ED25519 算法和私钥对待签名的交易（transaction_blob的反16进制编码得到的字节数组）进行签名，并进行16进制转换，得到签名字符串sign_data。

下面的示例展示了如何用 ED25519 和私钥对transaction_blob签名。

私钥是：

privbsGZFUoRv8aXZbSGd3bwzZWFn3L5QKq74RXAQYcmfXhhZ54CLr9z

Transaction blob是:

0A24627551566B5555424B70444B526D48595777314D553855376E676F5165686E6F31363569109F0818C0843D20E80732146275696C642073696D706C65206163636F756E743A5F08011224627551566B5555424B70444B526D48595777314D553855376E676F5165686E6F3136356922350A246275516E6936794752574D4D454376585850673854334B35615A557551456351523670691A0608011A02080128C7A3889BAB20

用 ED25519 的签名接口对待签名的交易（transaction_blob的反16进制编码得到的字节数组）进行签名，并进行16进制转换后，得到的sign_data是：

a46ee590a84abdeb8cc38ade1ae8e8a2c71bb69bdc4cd7dc0de1b74b37e2cbd1696229687f80dff4276b1a3dd3f95a9bc1d569943b337fe170317430f36d6401

交易提交方式

交易的执行有两种接口调用方式：调用接口生成transaction_blob 和自己生成transaction_blob。

由于transaction_blob很可能被截取和篡改，因此不建议调用接口生成transaction_blob。 如果需要调用接口生成transaction_blob、签名并提交交易，请查看HTTP中的序列化交易接口。

调用接口

调用接口生成transation_blob包含以下步骤：

  1. 调用 getAccount 接口获取待发起交易账户的nonce值，代码如下所示：

    HTTP GET host:port/getAccount?address=账户地址

  2. 根据需要填充json数据并完成交易数据填充，格式如下所示：

    {
    "source_address":"xxxxxxxxxxx", //交易源账号，即交易的发起方
    "nonce":2, //nonce的值
    "ceil_ledger_seq": 0, //可选
    "fee_limit":1000, //交易支付的费用
    "gas_price": 1000, //gas价格(不小于配置的最低值)
    "metadata":"0123456789abcdef", //可选，用户自定义给交易的备注，16进制格式
    "operations":[
        {
            //根据不同的操作填写
        },
        {
            //根据不同的操作填写
        }
        ......
    ]
}

    nonce值需要在第1步中获取值的基础上加1。

  3. 通过调用 getTransactionBlob 接口将第2步中生成的json数据作为参数传入，得到一个交易hash和transaction_blob，实现交易序列化，格式如下所示：

    {
"error_code": 0,
"error_desc": "",
"result": {
    "hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //交易的hash
    "transaction_blob": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //交易序列化之后的16进制表示
        }
}

  4. 对交易进行签名并填充交易数据。根据之前生成的私钥对transaction_blob签名，然后填充提交交易的json数据，格式如下所示：

    {
    "items" : [{
        "transaction_blob" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //一个交易序列化之后的16进制表示
        "signatures" : [{//第一个签名
            "sign_data" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //签名数据
            "public_key" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //公钥
        }, {//第二个签名
            "sign_data" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //签名数据
            "public_key" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //公钥
        }]
    }]
}

  5. 通过调用 submitTransaction 接口，将第4步中生成的json数据作为参数传入，得到响应结果，完成交易提交。响应结果的格式如下所示：

    {
    "results": [
        {
            "error_code": 0,
            "error_desc": "",
            "hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //交易的hash
        }
    ],
    "success_count": 1
}

自己生成

自己生成transaction_blob，签名，并提交交易，具体操作包括以下步骤：

  1. 通过调用 getAccount 接口获取待发起交易的账户的nonce值，如下所示：

    HTTP GET host:port/getAccount?address=账户地址

  2. 填充protocol buffer的交易对象Transaction，并进行序列化操作，从而得到transaction_blob。具体的交易数据结构详情请看ProtoBuf数据结构。

  3. 签名交易，并填充交易数据。根据私钥生成公钥，并用私钥对transaction_blob签名，然后填充提交交易的json数据，格式如下：

    {
    "items" : [{
        "transaction_blob" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //一个交易序列化之后的16进制表示
        "signatures" : [{//第一个签名
            "sign_data" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //签名数据
            "public_key" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //公钥
        }, {//第二个签名
            "sign_data" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", //签名数据
            "public_key" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //公钥
        }]
    }]
}

  4. 通过调用 submitTransaction 接口，将第3步生成的json数据作为参数传入，完成交易提交。响应结果格式如下：

    {
    "results": [
        {
            "error_code": 0,
            "error_desc": "",
            "hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //交易的hash
        }
    ],
    "success_count": 1
}

ProtoBuf数据结构

Protocol Buffers（ProtoBuf）是一种轻便高效的结构化数据存储格式，可以用于结构化数据串行化，或者说序列化。它很适合做数据存储或RPC数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。目前提供了C++、Java、Python 三种语言的 API。

了解更多关于ProtoBuf的信息。

接下来将介绍ProtocolBuffer的数据结构详情，并提供针对脚本生成的各种语言的protocol buffer的文件和简单测试程序。

数据结构

下面介绍了交易中可能用到的各种ProtoBuf数据结构及其用途，供用户参考使用。

Transaction

该数据结构适用于完整的交易。

    message Transaction {
        enum Limit{
            UNKNOWN = 0;
            OPERATIONS = 1000;
        };
        string source_address = 1; // 交易发起账户地址
        int64 nonce = 2; // 交易序列号
        int64 fee_limit = 3; // 交易费用，默认1000Gas，单位是MO，1 BU = 10^8 MO
        int64 gas_price = 4; // 交易打包费用，默认是1000，单位是MO，1 BU = 10^8 MO
        int64 ceil_ledger_seq = 5; // 区块高度限制
        bytes metadata = 6; // 交易备注
        repeated Operation operations = 7; // 操作列表
    }

Operation

该数据结构适用于交易中的操作。

    message Operation {
        enum Type {
            UNKNOWN = 0;
            CREATE_ACCOUNT = 1;
            ISSUE_ASSET = 2;
            PAY_ASSE = 3;
            SET_METADATA = 4;
            SET_SIGNER_WEIGHT = 5;
            SET_THRESHOLD = 6;
            PAY_COIN = 7;
            LOG = 8;
            SET_PRIVILEGE = 9;
        };
        Type type = 1; // 操作类型
        string source_address = 2; // 操作源账户地址
        bytes metadata = 3; // 操作备注
        OperationCreateAccount create_account = 4; // 创建账户操作
        OperationIssueAsset issue_asset = 5; // 发行资产操作
        OperationPayAsset pay_asset = 6; // 转移资产操作
        OperationSetMetadata set_metadata = 7; // 设置metadata
        OperationSetSignerWeight set_signer_weight = 8; // 设置签名者权限
        OperationSetThreshold set_threshold = 9; // 设置交易门限
        OperationPayCoin pay_coin = 10; // 转移coin
        OperationLog log = 11; // 记录log
        OperationSetPrivilege set_privilege = 12; // 设置权限
    }

OperationCreateAccount

该数据结构用于创建账户。

    message OperationCreateAccount{
        string dest_address = 1; // 待创建的目标账户地址
        Contract contract = 2; // 合约
        AccountPrivilege priv = 3; // 权限
        repeated KeyPair metadatas = 4; // 附加信息
        int64 init_balance = 5; // 初始化余额
        string init_input = 6; // 合约入参
    }

Contract

该数据结构用于设置合约。

    message Contract{
        enum ContractType{
        JAVASCRIPT = 0;
        }
        ContractType type = 1; // 合约类型
        string payload = 2; // 合约代码
    }

AccountPrivilege

该数据结构用于设置账户权限。

    message AccountPrivilege {
        int64 master_weight = 1; // 账户自身权重
        repeated Signer signers = 2; // 签名者权重列表
        AccountThreshold thresholds = 3; // 门限
    }

Signer

该数据结构用于设置签名者权重。

    message Signer {
        enum Limit{
            SIGNER_NONE = 0;
            SIGNER = 100;
        };
        string address = 1; // 签名者账户地址
        int64 weight = 2; // 签名者权重
    }

AccountThreshold

该数据结构用于设置账户门限。

    message AccountThreshold{
        int64 tx_threshold = 1; // 交易门限
        repeated OperationTypeThreshold type_thresholds = 2; // 指定操作的交易门限列表，未指定的操作的交易以tx_threshold为门限
    }

OperationTypeThreshold

该数据结构用于指定类型的操作门限。

    message OperationTypeThreshold{
        Operation.Type type = 1; // 操作类型
        int64 threshold = 2; // 该操作对应的门限
    }

OperationIssueAsset

该数据结构用于发行资产。


    message OperationIssueAsset{
        string code = 1; // 待发行的资产编码
        int64 amount = 2; // 待发行的资产数量
    }

OperationPayAsset

该数据结构用于转移资产。

    message OperationPayAsset {
        string dest_address = 1; // 目标账户地址
        Asset asset = 2; // 资产
        string input = 3; // 合约入参
    }

Asset

该数据结构适用于资产。

    message Asset{
        AssetKey key = 1; // 资产标识
        int64 amount = 2; // 资产数量
    }

AssetKey

该数据结构用于标识资产唯一性。

    message AssetKey{
        string issuer = 1; // 资产发行账户地址
        string code = 2; // 资产编码
        int32 type = 3; // 资产类型（默认为0，表示不限制数量）
    }

OperationSetMetadata

该数据结构用于设置Metadata。

    message OperationSetMetadata{
        string key = 1; // 关键字，惟一
        string value = 2; // 内容
        int64 version = 3; // 版本控制，可不设置
        bool delete_flag = 4; // 是否删除
    }

OperationSetSignerWeight

该数据结构用于设置签名者权重。

    message OperationSetSignerWeight{
        int64 master_weight = 1; // 自身权重
        repeated Signer signers = 2; // 签名者权重列表
    }

OperationSetThreshold

该数据结构用于设置门限。

    message OperationSetThreshold{
        int64 tx_threshold = 1; // 交易门限
        repeated OperationTypeThreshold type_thresholds = 2; // 指定操作的交易门限列表，未指定的操作的交易以tx_threshold为门限
    }

OperationPayCoin

该数据结构用于发送coin。

    message OperationPayCoin{
        string dest_address = 1; // 目标账户地址
        int64 amount = 2; // coin的数量
        string input = 3; // 合约入参
    }

OperationLog数据结构

该数据结构用于记录log信息。

    message OperationLog{
        string topic = 1; // 日志主题
        repeated string datas = 2; // 日志内容
    }

OperationSetPrivilege数据结构

该数据结构用于设置账户权限。

    message OperationSetPrivilege{
        string master_weight = 1; // 账户自身权重
        repeated Signer signers = 2; // 签名者权重列表
        string tx_threshold = 3; // 交易门限
        repeated OperationTypeThreshold type_thresholds = 4; // 指定操作的交易门限列表，未指定的操作的交易以tx_threshold为门限
    }

使用示例

本节中提供了proto脚本，以及 cpp、java、javascript、pyton、object-c 和 php 生成的proto源码的示例，详细信息请查看proto源码。

链接中的目录结构说明：

  1. cpp: C++的源码

  2. io: Java的测试程序

  3. go: Go的测试程序

  4. js: Javascript的测试程序

  5. python: Python的测试程序

  6. ios: Object-C的测试程序

  7. php: PHP的测试程序

交易提交示例

场景：账户A（buQVkUUBKpDKRmHYWw1MU8U7ngoQehno165i）创建账户B（通过Keypair中的 生成地址 来生成新账户地址）。

接口生成transaction_blob示例

通过接口生成transaction_blob包含以下步骤：

  1. 通过GET获取待发起交易账户的nonce值。

    GET http://seed1.bumotest.io:26002/getAccount?address=buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw

    得到的响应报文：

    {
    "error_code" : 0,
    "result" : {
        "address" : "buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw",
        "assets" : [
            {
                "amount" : 1000000000,
                "key" : {
                    "code" : "HNC",
                    "issuer" : "buQBjJD1BSJ7nzAbzdTenAhpFjmxRVEEtmxH"
                }
            }
        ],
        "assets_hash" : "3bf279af496877a51303e91c36d42d64ba9d414de8c038719b842e6421a9dae0",
        "balance" : 27034700,
        "metadatas" : null,
        "metadatas_hash" : "ad67d57ae19de8068dbcd47282146bd553fe9f684c57c8c114453863ee41abc3",
        "nonce" : 5,
        "priv" : {
            "master_weight" : 1,
            "thresholds" : [{
                "tx_threshold" : 1
            }
                           ]
        }
    }
}

address: 当前查询的账户地址
assets: 账户资产列表
assets_hash: 资产列表hash
balance: 账户资产余额
metadata: 交易备注，必须是16进制
metadatas_hash: 交易备注hash
nonce: 转出方交易序列号，通过查询账户信息接口返回的nonce | 1
priv: 权限
master_weight: 当前账户权重
thresholds: 门限
tx_threshold: 交易默认门限

  2. 完成交易数据填充。

    通过 Keypair 中的 生成地址 生成的新账户B的地址是buQoP2eRymAcUm3uvWgQ8RnjtrSnXBXfAzsV，填充的json数据如下：

    {
    "source_address":"buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw",
    "nonce":7,
    "ceil_ledger_seq": 0,
    "fee_limit":1000000,
    "gas_price": 1000,
    "metadata":"",
    "operations":[
        {
            "type": 1,
            "create_account": {
                "dest_address": "buQoP2eRymAcUm3uvWgQ8RnjtrSnXBXfAzsV",
                "init_balance": 10000000,
                "priv": {
                    "master_weight": 1,
                    "thresholds": {
                        "tx_threshold": 1
                    }
                }
            }
        }
    ]
}

    这里的nonce值不是6，没有连续，因此该交易会超时，不会成功。

  3. 对交易数据进行序列化处理。

    POST http://seed1.bumotest.io:26002/getTransactionBlob

    请求报文:

    {
    "source_address":"buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw",
    "nonce":7,
    "ceil_ledger_seq": 0,
    "fee_limit":1000000,
    "gas_price": 1000,
    "metadata":"",
    "operations":[
        {
            "type": 1,
            "create_account": {
                "dest_address": "buQoP2eRymAcUm3uvWgQ8RnjtrSnXBXfAzsV",
                "init_balance": 10000000,
                "priv": {
                    "master_weight": 1,
                    "thresholds": {
                        "tx_threshold": 1
                    }
                }
            }
        }
    ]
}

    响应报文:

    {
"error_code": 0,
"error_desc": "",
"result": {
"hash": "be4953bce94ecd5c5a19c7c4445d940c6a55fb56370f7f606e127776053b3b51",
"transaction_blob": "0a2462755173757248314d34726a4c6b666a7a6b7852394b584a366a537532723978424e4577100718
 c0843d20e8073a37080122330a246275516f50326552796d4163556d33757657675138526e6a7472536e5
 8425866417a73561a0608011a0208012880ade204"
}
}

  4. 通过私钥对交易（transaction_blob）签名。

    导入包:

    import io.bumo.encryption.key.PrivateKey;

    私钥是:

    privbvTuL1k8z27i9eyBrFDUvAVVCSxKeLtzjMMZEqimFwbNchnejS81

    签名后的sign_data是：

    9C86CE621A1C9368E93F332C55FDF423C087631B51E95381B80F81044714E3CE3DCF5E4634E5BE77B12ABD
3C54554E834A30643ADA80D19A4A3C924D0B3FA601

  5. 完成交易数据填充。

    {
    "items" : [{
        "transaction_blob" : "0a2462755173757248314d34726a4c6b666a7a6b7852394b584a366a537532723978424e4577100718
        c0843d20e8073a37080122330a246275516f50326552796d4163556d33757657675138526e6a7472536e5
        8425866417a73561a0608011a0208012880ade204",
        "signatures" : [{
            "sign_data" : "9C86CE621A1C9368E93F332C55FDF423C087631B51E95381B80F81044714E3CE3DCF5E4634E5BE77B12
            ABD3C54554E834A30643ADA80D19A4A3C924D0B3FA601",
            "public_key" : "b00179b4adb1d3188aa1b98d6977a837bd4afdbb4813ac65472074fe3a491979bf256ba63895"
         }]
    }]
}

  6. 通过POST提交交易。

    POST http://seed1.bumotest.io/submitTransaction

    得到如下的响应报文：

    {
    "results": [{
        "error_code": 0,
        "error_desc": "",
        "hash": "be4953bce94ecd5c5a19c7c4445d940c6a55fb56370f7f606e127776053b3b51"
    }],
    "success_count": 1 //1表示提交成功
}

自己生成transaction_blob示例

自己生成transaction_blob（以Java为例）包含以下步骤：

  1. 通过GET获取待发起交易账户的nonce值。

    GET http://seed1.bumotest.io:26002/getAccount?address=buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw

    得到的响应报文：

    {
    "error_code" : 0,
    "result" : {
        "address" : "buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw",
        "assets" : [
            {
                "amount" : 1000000000,
                "key" : {
                    "code" : "HNC",
                    "issuer" : "buQBjJD1BSJ7nzAbzdTenAhpFjmxRVEEtmxH"
                }
            }
        ],
        "assets_hash" : "3bf279af496877a51303e91c36d42d64ba9d414de8c038719b842e6421a9dae0",
        "balance" : 27034700,
        "metadatas" : null,
        "metadatas_hash" : "ad67d57ae19de8068dbcd47282146bd553fe9f684c57c8c114453863ee41abc3",
        "nonce" : 5,
        "priv" : {
            "master_weight" : 1,
            "thresholds" : [{
                "tx_threshold" : 1
            }]
        }
    }
}

address: 当前查询的账户地址
assets: 账户资产列表
assets_hash: 资产列表hash
balance: 账户资产余额
metadata: 交易备注，必须是16进制
metadatas_hash: 交易备注hash
nonce: 转出方交易序列号，通过查询账户信息接口返回的nonce | 1
priv: 权限
master_weight: 当前账户权重
thresholds: 门限
tx_threshold: 交易默认门限

  2. 填充交易（Transaction）数据结构，并生成transaction_blob。

    import io.bumo.sdk.core.extend.protobuf.Chain;
Chain.Transaction.Builder builder = Chain.Transaction.newBuilder();
builder.setSourceAddress("buQsurH1M4rjLkfjzkxR9KXJ6jSu2r9xBNEw");
builder.setNonce(7);
builder.setFeeLimit(1000 * 1000);
builder.setGasPrice(1000);
builder.setCeilLedgerSeq(0);
builder.setMetadata(ByteString.copyFromUtf8(""));
Chain.Operation.Builder operation = builder.addOperationsBuilder();
operation.setType(Chain.Operation.Type.CREATE_ACCOUNT);
Chain.OperationCreateAccount.Builder operationCreateAccount = Chain.OperationCreateAccount.newBuilder();
operationCreateAccount.setDestAddress("buQoP2eRymAcUm3uvWgQ8RnjtrSnXBXfAzsV");
operationCreateAccount.setInitBalance(10000000);
Chain.AccountPrivilege.Builder accountPrivilegeBuilder = Chain.AccountPrivilege.newBuilder();
accountPrivilegeBuilder.setMasterWeight(1);
Chain.AccountThreshold.Builder accountThresholdBuilder = Chain.AccountThreshold.newBuilder();
accountThresholdBuilder.setTxThreshold(1);
accountPrivilegeBuilder.setThresholds(accountThresholdBuilder);
operationCreateAccount.setPriv(accountPrivilegeBuilder);
operation.setCreateAccount(operationCreateAccount);
String transaction_blob = HexFormat.byteToHex(builder.build().toByteArray());

    得到的transaction_blob是：

    77100718c0843d20e8073a37080122330a246275516f50326552796d4163556d3375765767
5138526e6a7472536e58425866417a73561a0608011a0208012880ade204

    Note ： 这里的nonce值不是6，没有连续，因此该交易会超时，不会成功。

  3. 通过私钥对交易（transaction_blob）签名。 导入包：

  4.  import io.bumo.encryption.key.PrivateKey;

    私钥是：

    privbvTuL1k8z27i9eyBrFDUvAVVCSxKeLtzjMMZEqimFwbNchnejS81

    签名后的sign_data是：

    9C86CE621A1C9368E93F332C55FDF423C087631B51E95381B80F81044714E3CE3DCF5E4634E5BE77B12
ABD3C54554E834A30643ADA80D19A4A3C924D0B3FA601

  5. 完成交易数据填充。

    {
    "items" : [{
        "transaction_blob" : "0a2462755173757248314d34726a4c6b666a7a6b7852394b584a366a537532723978424e4577100718
        c0843d20e8073a37080122330a246275516f50326552796d4163556d33757657675138526e6a7472536e5
        8425866417a73561a0608011a0208012880ade204",
        "signatures" : [{
            "sign_data" : "9C86CE621A1C9368E93F332C55FDF423C087631B51E95381B80F81044714E3CE3DCF5E4634E5BE77B12
            ABD3C54554E834A30643ADA80D19A4A3C924D0B3FA601",
            "public_key" : "b00179b4adb1d3188aa1b98d6977a837bd4afdbb4813ac65472074fe3a491979bf256ba63895"
        }]
    }]
}

  6. 通过POST提交交易。

    POST http://seed1.bumotest.io/submitTransaction

    得到的响应报文：

    {
    "results": [{
        "error_code": 0,
        "error_desc": "",
        "hash": "be4953bce94ecd5c5a19c7c4445d940c6a55fb56370f7f606e127776053b3b51"
    }],
    "success_count": 1 //1表明交易提交成功。
}

标签：transaction,字节,生成,Keypair,API,blob,key,BUMO,交易
来源： https://blog.csdn.net/shangsongwww/article/details/89684136