跨链技术践行者

BUMO 区块链开发文档

BUMO区块链开发文档
- 基础知识
  - 了解protocol buffer3
  - protocol buffer 3和json
  - websocket和http
  - 端口配置
  - 交易执行的基本过程
  - 试一试
- HTTP接口
  - 生成公私钥对-测试用
  - 查询账号
  - 查询账号基本信息
  - 查询资产
  - 查询metadata
  - 查询交易
  - 查询缓存队列交易
  - 查询区块头
  - 提交交易
  - 序列化交易
  - 调用合约
  - 评估费用
- 定义交易
  - 交易的基本结构
  - 操作
    - 操作码
    - 创建账号
    - 发行资产
    - 转移资产
    - 设置metadata
    - 设置权限
    - 转移BU资产
    - 记录日志
- 高级功能
  - 控制权的分配
  - 版本化控制
  - 合约（推荐使用新的接口）
    - 语法说明（推荐使用新的接口）
    - 内置函数（推荐使用新的接口）
    - 内置变量（推荐使用新的接口）
    - 异常处理（推荐使用新的接口）
  - 验证者节点选举
    - 创建选举合约账户
    - 申请成为验证节点候选人
    - 对验证节点候选人申请者投票
    - 收回押金
    - 废止恶意节点
    - 取消废止恶意节点
    - 对废止恶意节点投票
    - 查询功能
  - 费用选举合约
    - 费用结构
    - 费用种类
    - 查询历史费用
    - 查询费用提案
    - 费用提案
    - 费用选举
- 错误码
- 示例

基础知识

了解protocol buffer3

BUMO区块链是用protocol buffer 3序列化数据的，protocol buffer 3是google推出的数据序列化协议，您如果不了解protocol buffer 3，请点击https://developers.google.com/protocol-buffers/docs/proto3了解更多。我们使用的所有数据格式都能在源码的src\proto目录中找到。其中chain.proto文件中定义的数据是和交易、区块、账号密切相关的。

protocol buffer 3和json

http接口中的数据都是json格式的，这些格式都是由protocolbuffer自动转化的。由于json中无法直接使用不可见字符, 凡是protocolbuffer结构定义中为bytes的，在json中都是16进制格式。

websocket和http

BUMO 区块链提供了websocket和http 两种API接口。您可以在安装目录/config/bumo.json 文件种找到"webserver"和"wsserver"两个对象,它们指定了http服务端口和websocket服务端口。

    "webserver":
    {
        "listen_addresses": "0.0.0.0:36002"
    },
    "wsserver":
    {
        "listen_address": "0.0.0.0:36003"
    }

端口配置

网络类型	网络ID（network_id）	WebServer	P2P	WebSocket
mainnet	10000	16002	16001	16003
testnet	20000	26002	26001	26003
内测版本	30000	36002	36001	36003

交易执行的基本过程

根据意愿组装交易对象Transaction
交易对象序列化(protocol buffer 3格式)为字节流 transaction_blob
用私钥skey对transaction_blob签名得到sign_data，skey的公钥为pkey
提交交易，见提交交易
查询以确定交易是否成功或接收推送（websocket API）判断交易是否成功

试一试

如果您的区块链刚刚部署完成，那么目前区块链系统中只有创世账号。您可以通过http接口查询创世账号 HTTP GET host:36002/getGenesisAccount 您会得到类似这样的返回内容

{
   "error_code" : 0,
   "result" : {
      "address" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3",
      "assets" : null,
      "balance" : 100000000000000000,
      "metadatas" : null,
      "priv" : {
         "master_weight" : 1,
         "thresholds" : {
            "tx_threshold" : 1
         }
      }
   }
}

返回结果中的address的值就是创世账号。您还可以通过查询账号接口查询任意账号

HTTP GET host:36002/getAccount?address=buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3

HTTP接口

生成公私钥对-测试用

HTTP GET /createKeyPair

功能：该接口只为方便测试使用，请勿在生产环境使用该接口（生产环境下请用SDK或者命令行生成），因为调用该接口后，如果节点服务器作恶会导致账户私钥泄露。该接口仅产生一个公私钥对，不会写入全网区块链。如需要上链，需对该新账号执行任意一次创建账号、转移资产、转移BU资产操作。

返回内容

{
   "error_code" : 0,
   "result" : {
      "address" : "buQqRgkmtckz3U4kX91F2NmZzJ9rkadjYaa2",  //账户地址
      "private_key" : "privbtnSGRQ46FF3MaqiGiDNytz2soFw4iNHKahTqszR6mRrmq7qhVYh",  //账户私钥
      "private_key_aes" : "7594a97bc5e6432704cc5f58ff60727ee9bda10a6117915d025553afec7f81527cb857b882b7c775391fe1fe3f7f3ec198ea69ada138b19cbe169a1a3fa2dec8",  //AES加密账户私钥之后的数据
      "public_key" : "b00101da11713eaad86ad8ededfc28e86b8cd619ca2d593a21d8b82da34320a7e63b09c279bc", //账户公钥
      "public_key_raw" : "01da11713eaad86ad8ededfc28e86b8cd619ca2d593a21d8b82da34320a7e63b",  //公钥排除前缀和后缀后的数据
      "sign_type" : "ed25519"  //账户加密类型
   }
}

查询账号

HTTP GET /getAccount?address=buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3&key=hello&code=xxx&issuer=xxx

功能:返回指定账号的信息及其所有资产、metadata

参数	描述
address	账号地址，必填
key	账号的 metadata 中指定的key的值，如果不填写，那么返回结果中含有所有的metadata
code, issuer,type	资产代码,资产发行商。这两个变量要么同时填写，要么同时不填写。若不填写，返回的结果中包含所有的资产。若填写，返回的结果中只显示由code和issuer,type指定的资产。目前type只能是0，可以不用填写

返回内容

{
  "error_code" : 0,
  "result" : {
    "address" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3", //该账号的地址
    "assets" : [//该账号的所有资产
      {
        "amount" : 1400,
        "key" :
        {
          "code" : "CNY",
          "issuer" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
        }
      }, {
        "amount" : 1000,
        "key" :
        {
          "code" : "USD",
          "issuer" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
        }
      }
    ],
    "assets_hash" : "9696b03e4c3169380882e0217a986717adfc5877b495068152e6aa25370ecf4a",
    "contract" : null,
    "metadatas" : [//该账号的所有metadata
      {
        "key" : "123",
        "value" : "123_value",
        "version" : 1
      }, {
        "key" : "456",
        "value" : "456_value",
        "version" : 1
      }, {
        "key" : "abcd",
        "value" : "abcd_value",
        "version" : 1
      }
    ],
    "nonce" : 1, //账号当前作为交易源执行过的交易数量。若nonce为0，该字段不显示
    "priv" : {
      "master_weight" : 1,
      "thresholds" : {
        "tx_threshold" : 1
      }
    },
    "metadatas_hash" : "82c8407cc7cd77897be3100c47ed9d43ec4097ee1c00e2c13447187e5b1ac66c"
  }
}

如果该账号不存在,则返回内容

{
   "error_code" : 4,
   "result" : null
}

查询账号基本信息

HTTP GET /getAccountBase?address=buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3

返回指定账号的基本信息

参数	描述
address	账号地址，必填

返回内容

{
  "error_code" : 0,
  "result" : {
    "address" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3", //该账号的地址
    "assets_hash" : "9696b03e4c3169380882e0217a986717adfc5877b495068152e6aa25370ecf4a",
    "balance" : 899671600,
    "contract" : null,
    "nonce" : 1, //账号当前作为交易源执行过的交易数量。若nonce为0，该字段不显示
    "priv" : {
      "master_weight" : 1,
      "thresholds" : {
        "tx_threshold" : 1
      }
    },
    "metadatas_hash" : "82c8407cc7cd77897be3100c47ed9d43ec4097ee1c00e2c13447187e5b1ac66c"
  }
}

如果该账号不存在,则返回内容

{
   "error_code" : 4,
   "result" : null
}

查询资产

HTTP GET /getAccountAssets?address=buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3

返回指定账号的资产信息

参数	描述
address	账号地址，必填
code, issuer	issuer表示资产发行账户地址，code表示资产代码。只有同时填写正确code&issuer才能正确显示指定资产否则默认显示所有资产。type指定的资产。选填
type	目前type只能是0，可以不用填写

返回内容

{
  "error_code" : 0,
    "result": [
      {
        "amount" : 1400,
        "key" :
        {
          "code" : "CNY",
          "issuer" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
        }
      }, 
      {
        "amount" : 1000,
        "key" :
        {
          "code" : "USD",
          "issuer" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
        }
      }
    ]
}

如果该账号不存在资产,则返回内容

{
   "error_code" : 0,
   "result" : null
}

查询metadata

HTTP GET /getAccountMetaData?address=buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3

返回指定账号的MetaData信息

参数	描述
address	账号地址，必填
key	指定metadata中的key值。选填

返回内容

{
  "error_code" : 0,
    "result": {
        "123": {
            "key" : "123",
            "value" : "123_value",
            "version" : 1
        },
        "456": {
            "key" : "456",
            "value" : "456_value",
            "version" : 1
        },
        "abcd": {
            "key" : "abcd",
            "value" : "abcd_value",
            "version" : 1
        }
    }
}

如果该账号不存在metadata,则返回内容

{
   "error_code" : 0,
   "result" : null
}

查询交易

GET /getTransactionHistory?ledger_seq=6

参数	描述
hash	用交易的唯一标识hash查询
ledger_seq	查询指定区块中的所有交易
上述两个参数产生的约束条件是逻辑与的关系，如果您同时指定两个参数，系统将在指定的区块中查询指定的交易

返回示例

{
    "error_code": 0,
    "result": {
        "total_count": 2,
        "transactions": [{
            "actual_fee": 313000,
            "close_time": 1524031260097214,
            "error_code": 0,
            "error_desc": "",
            "hash": "89a9d6e5d2c0e2b5c4fe58045ab2236d12e9449ef232342a48a2e2628e12014d",
            "ledger_seq": 6,
            "signatures": [{
                "public_key": "b00180c2007082d1e2519a0f2d08fd65ba607fe3b8be646192a2f18a5fa0bee8f7a810d011ed",
                "sign_data": "27866d70a58fc527b1ff1b4a693b8034b0078fc7ac7591fb05679abe5ca660db5c372922bfa8f26e76511e2c33386306ded7593874a6aec5baeeaddbd2012f06"
            }],
            "transaction": {
                "fee_limit": 10000000000,
                "gas_price": 1000,
                "nonce": 1,
                "operations": [{
                    "create_account": {
                        "dest_address": "buQBAfoMfXZVPpg9DaabMmM2EwUnfoVsTSVV",
                        "init_balance": 10000000,
                        "priv": {
                            "master_weight": 1,
                            "thresholds": {
                                "tx_threshold": 1
                            }
                        }
                    },
                    "type": 1
                },
                {
                    "create_account": {
                        "dest_address": "buQj8UyKbN3myVSerLDVXVXH47vWXfqtxKLm",
                        "init_balance": 10000000,
                        "priv": {
                            "master_weight": 1,
                            "thresholds": {
                                "tx_threshold": 1
                            }
                        }
                    },
                    "type": 1
                }],
                "source_address": "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
            },
            "tx_size": 313
        },
        {
            "actual_fee": 313000,
            "close_time": 1524031260097214,
            "error_code": 0,
            "error_desc": "",
            "hash": "7d7cfc860acfd83865d01bb655ac772113833f0769264d6392c6220024b8f93f",
            "ledger_seq": 6,
            "signatures": [{
                "public_key": "b00180c2007082d1e2519a0f2d08fd65ba607fe3b8be646192a2f18a5fa0bee8f7a810d011ed",
                "sign_data": "fb7d9d87f4c9140b6e19a199091c6871e2380ad8e8a8fcada9b42a2911057111dc796d731f3f887e600aa89cc8692300f980723298a93b91db711155670d3e0d"
            }],
            "transaction": {
                "fee_limit": 10000000000,
                "gas_price": 1000,
                "nonce": 2,
                "operations": [{
                    "create_account": {
                        "dest_address": "buQntAvayDWkAhPh6CSrTWbiEniAL2ys5m2p",
                        "init_balance": 10000000,
                        "priv": {
                            "master_weight": 1,
                            "thresholds": {
                                "tx_threshold": 1
                            }
                        }
                    },
                    "type": 1
                },
                {
                    "create_account": {
                        "dest_address": "buQX5X9y59zbmqyFgFPQPcyUPcPnvwsLatsq",
                        "init_balance": 10000000,
                        "priv": {
                            "master_weight": 1,
                            "thresholds": {
                                "tx_threshold": 1
                            }
                        }
                    },
                    "type": 1
                }],
                "source_address": "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
            },
            "tx_size": 313
        }]
    }
}

如果没有查到交易则返回

{
  "error_code": 4,
  "result":
  {
    "total_count": 0,
    "transactions": []
  }
}

查询缓存队列交易

GET /getTransactionCache?hash=ad545bfc26c440e324076fbbe1d8affbd8a2277858dc35927d425d0fe644e698&limit=100

参数	描述
hash	用交易的唯一标识hash查询
limit	查询交易队列前N个正在处理的交易
上述两个参数产生的约束条件是逻辑或的关系，如果您同时指定两个参数，系统将hash查询

返回示例

{
    "error_code": 0,
    "result": {
        "total_count": 1,
        "transactions": [
            {
                "hash": "a336c8f4b49c8b2c5a6c68543368ed3b450b6138a9f878892cf982ffb6fe234e",
                "incoming_time": 1521013029435154,
                "signatures": [
                    {
                        "public_key": "b001882b9d1b5e7019f163d001c85194cface61e294483710f5e66ef40a4d387f5fcb0166f4f",
                        "sign_data": "c5885144ffccb0b434b494271258e846c30a4551036e483822ee2b57400576e9e700e8960eb424764d033a2e73af6e6a2bfa5da390f71161732e13beee206107"
                    }
                ],
                "status": "processing",
                "transaction": {
                    "fee_limit": 100000,
                    "gas_price": 1000,
                    "nonce": 2,
                    "operations": [
                        {
                            "create_account": {
                                "dest_address": "buQWufKdVicxRAqmQs6m1Z9QuFZG2W7LMsi2",
                                "init_balance": 300000,
                                "metadatas": [
                                    {
                                        "key": "key",
                                        "value": "bubinuo"
                                    }
                                ],
                                "priv": {
                                    "master_weight": 1,
                                    "thresholds": {
                                        "tx_threshold": 2
                                    }
                                }
                            },
                            "type": 1
                        }
                    ],
                    "source_address": "buQBDf23WtBBC8GySAZHsoBMVGeENWzSRYqB"
                }
            }
        ]
    }
}

如果没有查到交易则返回

{
  "error_code": 4,
  "result":
  {
    "total_count": 0,
    "transactions": []
  }
}

查询区块头

GET /getLedger?seq=xxxx&with_validator=true&with_consvalue=true&with_fee=true&with_block_reward=true

参数	描述
seq	ledger的序号，如果不填写，返回当前ledger
with_validator	默认false，不显示验证节点列表
with_consvalue	默认false，不显示共识值
with_fee	默认false，不显示费用配置
with_block_reward	默认false，不显示区块奖励和验证节点奖励

如果查询到ledger则返回内容:

{
   "error_code" : 0,
   "result" : {
      "block_reward" : 800000000,
      "consensus_value" : {
         "close_time" : 1524031260097214,
         "ledger_seq" : 6,
         "previous_ledger_hash" : "ef329c7ed761e3065ab08f9e7672fd5f4e3ddd77b0be35598979aff8c21ada9b",
         "previous_proof" : "0ac1010a2c080110022a26080310052220432dde2fd32a2a66da77647231821c87958f56c303bd08003633952d384eb0b61290010a4c623030316435363833363735303137666662633332366538666232303738653532316566383435373234363236353339356536383934633835323434656566643262666130386635393862661240deeb9b782410f0f86d897006cac8ad152e56e4f914e5d718706de84044ef98baef25512a337865772641d57090b5c77e9e2149dbd41910e8d6cd85c3387ea708",
         "previous_proof_plain" : {
            "commits" : [
               {
                  "pbft" : {
                     "commit" : {
                        "sequence" : 5,
                        "value_digest" : "432dde2fd32a2a66da77647231821c87958f56c303bd08003633952d384eb0b6",
                        "view_number" : 3
                     },
                     "round_number" : 1,
                     "type" : 2
                  },
                  "signature" : {
                     "public_key" : "b001d5683675017ffbc326e8fb2078e521ef8457246265395e6894c85244eefd2bfa08f598bf",
                     "sign_data" : "deeb9b782410f0f86d897006cac8ad152e56e4f914e5d718706de84044ef98baef25512a337865772641d57090b5c77e9e2149dbd41910e8d6cd85c3387ea708"
                  }
               }
            ]
         },
         "txset" : {
            "txs" : [
               {
                  "signatures" : [
                     {
                        "public_key" : "b00180c2007082d1e2519a0f2d08fd65ba607fe3b8be646192a2f18a5fa0bee8f7a810d011ed",
                        "sign_data" : "27866d70a58fc527b1ff1b4a693b8034b0078fc7ac7591fb05679abe5ca660db5c372922bfa8f26e76511e2c33386306ded7593874a6aec5baeeaddbd2012f06"
                     }
                  ],
                  "transaction" : {
                     "fee_limit" : 10000000000,
                     "gas_price" : 1000,
                     "nonce" : 1,
                     "operations" : [
                        {
                           "create_account" : {
                              "dest_address" : "buQBAfoMfXZVPpg9DaabMmM2EwUnfoVsTSVV",
                              "init_balance" : 10000000,
                              "priv" : {
                                 "master_weight" : 1,
                                 "thresholds" : {
                                    "tx_threshold" : 1
                                 }
                              }
                           },
                           "type" : 1
                        },
                        {
                           "create_account" : {
                              "dest_address" : "buQj8UyKbN3myVSerLDVXVXH47vWXfqtxKLm",
                              "init_balance" : 10000000,
                              "priv" : {
                                 "master_weight" : 1,
                                 "thresholds" : {
                                    "tx_threshold" : 1
                                 }
                              }
                           },
                           "type" : 1
                        }
                     ],
                     "source_address" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
                  }
               },
               {
                  "signatures" : [
                     {
                        "public_key" : "b00180c2007082d1e2519a0f2d08fd65ba607fe3b8be646192a2f18a5fa0bee8f7a810d011ed",
                        "sign_data" : "fb7d9d87f4c9140b6e19a199091c6871e2380ad8e8a8fcada9b42a2911057111dc796d731f3f887e600aa89cc8692300f980723298a93b91db711155670d3e0d"
                     }
                  ],
                  "transaction" : {
                     "fee_limit" : 10000000000,
                     "gas_price" : 1000,
                     "nonce" : 2,
                     "operations" : [
                        {
                           "create_account" : {
                              "dest_address" : "buQntAvayDWkAhPh6CSrTWbiEniAL2ys5m2p",
                              "init_balance" : 10000000,
                              "priv" : {
                                 "master_weight" : 1,
                                 "thresholds" : {
                                    "tx_threshold" : 1
                                 }
                              }
                           },
                           "type" : 1
                        },
                        {
                           "create_account" : {
                              "dest_address" : "buQX5X9y59zbmqyFgFPQPcyUPcPnvwsLatsq",
                              "init_balance" : 10000000,
                              "priv" : {
                                 "master_weight" : 1,
                                 "thresholds" : {
                                    "tx_threshold" : 1
                                 }
                              }
                           },
                           "type" : 1
                        }
                     ],
                     "source_address" : "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
                  }
               }
            ]
         }
      },
      "fees" : {
         "base_reserve" : 10000000,
         "gas_price" : 1000
      },
      "header" : {
         "account_tree_hash" : "6aca37dfe83f213942b21d02618b989619cfd7c0e67a8a14b0f7599dd4010aad",
         "close_time" : 1524031260097214,
         "consensus_value_hash" : "14a65d69f619395135da2ff98281d5707494801f12184a4318b9a76383e651a8",
         "fees_hash" : "916daa78d264b3e2d9cff8aac84c943a834f49a62b7354d4fa228dab65515313",
         "hash" : "2cf378b326ab0026625c8d036813aef89a0b383e75055b80cb7cc25a657a9c5d",
         "previous_hash" : "ef329c7ed761e3065ab08f9e7672fd5f4e3ddd77b0be35598979aff8c21ada9b",
         "seq" : 6,
         "tx_count" : 2,
         "validators_hash" : "d857aa40ecdb123415f893159321eb223e4dbc11863daef86f35565dd1633316",
         "version" : 1000
      },
      "validators" : [
         {
            "address" : "buQhmPKU1xTyC3n7zJ8zLQXtuDJmM2zTrJey"
         }
      ],
      "validators_reward" : {
         "buQhmPKU1xTyC3n7zJ8zLQXtuDJmM2zTrJey" : 800000000
      }
   }
}

如果没有查询到ledger返回的内容:

{
   "error_code" : 4,
   "result" : null
}

提交交易

POST /submitTransaction

数据格式

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

参数	描述
transaction_blob	交易序列化之后的16进制格式。您可以参照定义交易来组装自己的交易数据
sign_data	签名数据， 16进制格式。其值为对transaction_blob进行签名(动词)得到的签名数据。注意，签名时要先将transaction_blob转成字节流再签名，不要对16进制字符串直接签名
public_key	公钥， 16进制格式。

序列化交易

如果您手中还没有protocol buffer工具，您可以使用本接口将交易序列化。

参数	描述
source_address	必填，交易的发起方账号地址
nonce	必填，交易序号，必须等于发起方账号的nonce+1。您可以通过查询账号返回的结果中得到账号的nonce
ceil_ledger_seq	区块高度限制, 如果大于0，则交易只有在该区块高度之前（包括该高度）才有效，如果为0，则不判断。
metadata	可选, 用户自定义交易的备注数据, 必须为16进制表示

关于operations中的数据格式，参照操作下面各种不同的操作的json格式

POST /getTransactionBlob

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

返回内容

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

{
  "source_address": "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3",
  "nonce": 1,
  "fee_limit": 1000000,
  "gas_price": 1000,
  "operations": [{
      "type": 1,
      "create_account": {
        "dest_address": "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf",
        "metadatas": [{
            "key": "hello",
            "value": "这是创建账号的过程中设置的一个metadata"
          }
        ],
        "priv": {
          "master_weight": 10,
          "signers": [],
          "thresholds": {
            "tx_threshold": 7
          }
        },
        "contract": {
          "payload": "function main(inputStr){\n /*这是合约入口函数*/ }"
        }
      }
    }
  ]
}

{
   "error_code" : 0,
   "error_desc" : "",
   "result" : {
      "hash" : "106345c939250c26495d461957a17cd58d9f69dc5d21c772e20e1ff337c7c2ce",
      "transaction_blob" : "0a2462755173396e70614371396d4e465a473138717538385a636d5859716436627170545533100122af0108012aaa010a24627551676d6868784c77686455766357696a7a78756d5548614e715a744a7057764e7366123a123866756e6374696f6e206d61696e28696e707574537472297b0a202f2ae8bf99e698afe59088e7baa6e585a5e58fa3e587bde695b02a2f207d1a06080a1a020807223e0a0568656c6c6f1235e8bf99e698afe5889be5bbbae8b4a6e58fb7e79a84e8bf87e7a88be4b8ade8aebee7bdaee79a84e4b880e4b8aa6d65746164617461"
   }
}

调用合约

在智能合约模块的设计中，我们提供了沙箱环境来进行调试合约，且调试过程中不会更改区块链和合约的状态。在 BUMO 链上，我们为用户提供了 callContract 接口来帮助用户来调试智能合约，智能合约可以是公链上已存的，也可以是通过参数上传本地的合约代码进行测试，使用 callContract 接口不会发送交易，也就无需支付上链手续费。

   POST /callContract

post内容如下

{
  "contract_address" : "",
  "code" : "\"use strict\";log(undefined);function query() { return 1; }",
  "input" : "{}",
  "contract_balance" : "100009000000",
  "fee_limit" : 100000000000000000,
  "gas_price": 1000,
  "opt_type" : 2,
  "source_address" : ""
}

contract_address: 调用的智能合约地址，如果从数据库查询不到则返回错误。如果填空，则默认读取 code 字段的内容
code：需要调试的合约代码，如果 contract_address 为空，则使用 code 字段，如果code字段你也为空，则返回错误。
input：给被调用的合约传参。
fee_limit : 手续费。
gas_price : Gas价格。
contract_balance : 赋予合约的初始 BU 余额。
opt_type: 0: 调用合约的读写接口 init, 1: 调用合约的读写接口 main, 2 :调用只读接口 query。
source_address：模拟调用合约的原地址。
返回值如下：

  {
   "error_code" : 0,
   "error_desc" : "",
   "result" : {
      "logs" : {
         "0-buQVkReBYUPUYHBinVDrrb9FQRpo49b9YRXq" : null
      },
      "query_rets" : [
         {
            "result" : {
               "type" : "bool",
               "value" : false
            }
         }
      ],
      "stat" : {
         "apply_time" : 6315,
         "memory_usage" : 886176,
         "stack_usage": 2564,
         "step" : 3
      },
      "txs" : null
   }
}

评估费用

   POST /testTransaction

post内容如下

{
  "items": [
    {
      "transaction_json": {
        "source_address": "buQBDf23WtBBC8GySAZHsoBMVGeENWzSRYqB",
        "metadata":"0123456789abcdef", //可选
        "nonce": 6,
        "operations": [
          {
            "type": 7,
            "pay_coin": {
              "dest_address": "buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw",
              "amount": 10000
            }
          }
        ]
      },
      "signature_number":1
    }
  ]
}

评估费用不改变账号余额基础上进行的评估，交易中涉及的原账号和目标账号都必须在系统中存在，创建账号的目标地址除外。

source_address：模拟交易的原地址。
nonce : 在原账号基础上加1。
signature_number : 签名个数，默认为1；不填写系统会设置为1；
metadata : 可选
fee_limit : 不用填写
gas_price : 不用填写
operations : 可以是任何一种操作类型。
返回值如下：

{
    "error_code": 0,
    "error_desc": "",
    "result": {
        "hash": "7f0d9de23d6d8f2964a1efe4a458e02e43e47f60f3c22bb132b676c54a44ba04",
        "logs": null,
        "query_rets": null,
        "stat": null,
        "txs": [
            {
                "actual_fee": 264,
                "gas": 264,
                "transaction_env": {
                    "transaction": {
                        "fee_limit": 99999999700110000,
                        "gas_price": 1,
                        "nonce": 1,
                        "operations": [
                            {
                                "pay_coin": {
                                    "amount": 299890000,
                                    "dest_address": "buQkBDTfe4tx2Knw9NDKyntVmsYvYtHmAiE7"
                                },
                                "type": 7
                            }
                        ],
                        "source_address": "buQBDf23WtBBC8GySAZHsoBMVGeENWzSRYqB"
                    }
                }
            }
        ]
    }
}

gas_price ：会在transaction添加gas_price，gas_price为系统的最低price
actual_fee ：评估交易的实际费用
gas ：评估交易所用gas

定义交易

交易的基本结构

json格式

{
    "source_address":"xxxxxxxxxxx",//交易源账号，即交易的发起方
    "nonce":2, //nonce值
    "fee_limit" : 1000000, //愿为交易花费的手续费
    "gas_price": 1000,//gas价格(不小于配置的最低值)
    "ceil_ledger_seq": 100, //可选，区块高度限制, 如果大于0，则交易只有在该区块高度之前（包括该高度）才有效
    "metadata":"0123456789abcdef", //可选，用户自定义给交易的备注，16进制格式
    "operations":[
    {
    //根据不同的操作填写
    },
    {
    //根据不同的操作填写
    }
    ......
    ]
}

protocol buffer 结构
```
message Transaction
{
    enum Limit{
            UNKNOWN = 0;
            OPERATIONS = 1000;
    };
    string source_address = 1;
    int64 nonce = 2;
    int64 fee_limit = 3;
    int64 gas_price =4;
    int64 ceil_ledger_seq = 5;
    bytes metadata = 6;
    repeated Operation operations = 7;
}
```
交易Transaction有7个关键字段
- source_address: 交易源账号，即交易发起方的账号。当这笔交易成功后，交易源账号的nonce字段会自动加1。账号中的nonce意义是本账号作为交易源执行过的交易数量。
- nonce:其值必须等于交易源账号的当前nonce+1，这是为了防止重放攻击而设计的。如何查询一个账号的nonce可参考查询账号。若查询账号没有显示nonce值，说明账号的当前nonce是0.
- fee_limit:本交易能接受的最大的手续费。交易首先会按照这个费用收取手续费，若交易执行成功，则会收取实际的花费，否则将收取这个字段的费用。
- gas_price:用于计算每个操作的手续费，还参与交易字节费的计算。
- ceil_ledger_seq:针对本交易的区块高度限制条件，高级功能。
- operations:操作列表。本交易的有效负载，即本交易想要做什么事情。见操作
- metadata:用户自定义字段，可以不填写，备注用。
Operation是所有操作的父类:
```
message Operation
{
    enum Type {
        UNKNOWN = 0;
        CREATE_ACCOUNT = 1;
        ISSUE_ASSET = 2;
        PAY_ASSET = 3;
        SET_METADATA = 4;
        SET_SIGNER_WEIGHT = 5;
        SET_THRESHOLD = 6;
        PAY_COIN = 7;
        LOG = 8;
    };
    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;
    OperationSetSignerWeight set_signer_weight = 8;
    OperationSetThreshold set_threshold = 9;
    OperationPayCoin pay_coin = 10;
    OperationLog log = 11;
}
```
- type: 操作类型的枚举。如其值为ISSUE_ASSET（发行资产），那么本操作中的issue_asset字段就会被使用；如果其值为PAY_ASSET，那么本操作中pay_asset字段就会被使用……详见操作码
- source_address:操作源，即本操作针对哪个账号生效。若不填写，则默认本操作源等于本操作源。
- metadata:本操作的备注，用户自定义，可以不填写

操作

操作码

代码值	枚举名	说明
1	CREATE_ACCOUNT	创建账号
2	ISSUE_ASSET	发行资产
3	PAY_ASSET	转移资产
4	SET_METADATA	设置metadata
7	PAY_COIN	支付BU COIN
9	SET_PRIVILEGE	设置权限

创建账号

参数	描述
dest_address	目标账号的地址。创建普通账号时，不能为空。创建智能合约账号，必须为空。如需创建选举和费用合约，请参考验证者节点选举和费用选举合约章节
contract	如果不填写，表示普通的账号。如果填写，表示合约账号
priv	该账号的权限信息
init_balance	初始化账户 BU 值
init_input	给合约传初始化参数

功能在区块链上创建一个新的账号
成功条件
- 各项参数合法
- 要创建的账号不存在
- 注意：如果目标为合约账户，则priv配置必须符合 {"master_weight" : 0 , "thresholds": {"tx_threshold":1}}，如果是普通账号需要配置 {"master_weight" : 1 , "thresholds": {"tx_threshold":1}}
json格式

创建普通账号

    {
      "type": 1,
      "create_account": {
        "dest_address": "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf",
        "contract": {
          "payload": ""
        },
        "init_balance": 100000,  //init_balance to this account
        "init_input" : "",  // if create contract , then init with this input
        "metadatas": [{
            "key": "111",
            "value": "hello 111!",
            "version": 0
          }, {
            "key": "222",
            "value": "hello 222!",
            "version": 0
          }
        ],
        "priv":  {
          "master_weight": 1,
          "thresholds": {
              "tx_threshold": 1
          }
        }
      }
    }

创建合约账号

    {
      "type": 1,
      "create_account": 
      {
        "dest_address": "",
        "contract": 
        {
          "payload": "
            'use strict';
            function init(bar)
            {
              return;
            }

            function main(input)
            {
              return;
            }

            function query()
            {
              return;
            }
          "
        },
        "init_balance": 100000,  //init_balance to this account
        "init_input" : "{\"method\":\"toWen\",\"params\":{\"feeType\":0}}",
        "priv":  {
          "master_weight": 0,
          "thresholds": {
              "tx_threshold": 1
          }
        }
      }
    }

合约账号自动生成，并储存在交易记录里，可以通过交易hash查询，如下：

GET /getTransactionHistory?hash=150dbbf1beaaae23bb3b7148cf65279d7de46a76d7ec8e480ef745f5708beb16

返回结果

{
    "error_code": 0,
    "result": {
        "total_count": 1,
        "transactions": 
		[
			{
            "actual_fee": 1000402000,
            "close_time": 1528725055019893,
            "error_code": 0,
            "error_desc": "[{\"contract_address\":\"buQfFcsf1NUGY1o25sp8mQuaP6W8jahwZPmX\",\"operation_index\":0}]", //创建合约结果，包括合约地址和操作索引值
            "hash": "4cbf50e03645f1075d7e5c450ced93e26e3153cf7b88ea8003b2fda39e618e64",
            "ledger_seq": 14671,
            "signatures": [{
                "public_key": "b00180c2007082d1e2519a0f2d08fd65ba607fe3b8be646192a2f18a5fa0bee8f7a810d011ed",
                "sign_data": "87fdcad0d706479e1a3f75fac2238763cd15fd93f81f1b8889fb798cefbe1752c192bbd3b5da6ebdb31ae47d8b62bb1166dcceca8d96020708f3ac5434838604"
            }],
            "transaction": {
                "fee_limit": 20004420000,
                "gas_price": 1000,
                "nonce": 30,
                "operations": [{
                    "create_account": {
                        "contract": {
                            "payload": "\n\t\t          \n\t\t        \t'use strict';\n\t\t\t\t\tfunction init(bar)\n\t\t\t\t\t{\n\t\t\t\t\t  return;\n\t\t\t\t\t}\n\t\t\t\t\t\n\t\t\t\t\tfunction main(input)\n\t\t\t\t\t{\n\t\t\t\t\t  return;\n\t\t\t\t\t}\n\t\t     function query()\n\t\t\t\t\t{\n\t\t\t\t\t  return;\n\t\t\t\t\t}\n\t\t      \n\t\t          "
                        },
                        "init_balance": 10000000,
                        "priv": {
                            "thresholds": {
                                "tx_threshold": 1
                            }
                        }
                    },
                    "type": 1
                }],
                "source_address": "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3"
            },
            "tx_size": 402
        }]
    }
}

创建合约结果描述

transactions.error_code: 0: 交易成功；非 0：交易失败

transactions.error_desc：失败时为错误描述内容；成功时，如果有创建合约账号交易，会存储一个字符串格式的Json数组。

创建合约结果 Json 数组描述

[
  {
    "contract_address": "buQm5RazrT9QYjbTPDwMkbVqjkVqa7WinbjM", //合约账号
    "operation_index": 0                                        //交易数组中的操作索引值，0 表示第一笔交易
  }
]

protocol buffer 结构
```
message OperationCreateAccount
{
    string dest_address = 1;
    Contract contract = 2;
    AccountPrivilege priv = 3;
    repeated KeyPair metadatas = 4;
    int64    init_balance = 5;
    string  init_input = 6;
}
```
- dest_address:要创建的账号的地址。创建普通账号时，非空。创建智能合约账号，空。如需创建选举和费用合约，请参考验证者节点选举和费用选举合约章节
- contract:合约。若你想要创建一个不具有合约功能的账号，可以不填写这部分。若您想创建具有合约功能的账号，请参照合约
- priv: 账号的初始权力分配。相关的数据结构定义:
```
  message AccountPrivilege
  {
      int64 master_weight = 1;
      repeated Signer signers = 2;
      AccountThreshold thresholds = 3;
  }

  message AccountThreshold
  {
      int64 tx_threshold = 1; //required, [-1,MAX(INT64)] -1: 表示不设置
      repeated OperationTypeThreshold type_thresholds = 2; //如果这个设置，则操作门限以这个为准
  }

  message OperationTypeThreshold
  {
      Operation.Type type = 1;
      int64 threshold = 2;
  }

  message Signer
  {
      enum Limit
      {
          SIGNER_NONE = 0;
          SIGNER = 100;
      };
      string address = 1;
      int64 weight = 2;
  }
  
```
  若您想设置账号受别人控制、设置分配给其他控制账号操作权重、设置操作门限等，可以通过设置权限操作
- metadatas:metadata列表。您可以为新建的账号设置一批初始的metadata。其数据类型为KeyPair,结构如下
```
message KeyPair
{
    string key = 1;
    string value = 2;
    int64 version = 3;
}
```
  这是一个版本化的键值对数据库，如果您不需要，可以不填写这部分。
- init_balance: 给创建的账户初始化的 BU 数。
- init_input: 如果被创建的账户是合约账户，则传参执行初始化合约操作。

发行资产

参数	描述
amount	发行的数量
code	资产代码

功能操作源账号发行一笔数字资产，执行成功后操作源账号的资产余额中会出现这一笔资产
成功条件
- 各项参数合法
- 资产数量没有溢出（int64）

json格式

{
  "type": 2,
  "issue_asset": {
    "amount": 1000,
    "code": "CNY"
  }
}

protocol buffer 结构
```
message OperationIssueAsset
{
    string code = 1;
    int64 amount = 2;
}
```
- code:要发行的资产代码，长度范围[1, 64]
- 发行的数量。数值范围(0,MAX(int64))
- 执行成功后，操作源的资产表中会出现这部分新发行的资产

转移资产

参数	描述
pay_asset.dest_address	目标账户
pay_asset.asset.key.issuer	资产发行方
pay_asset.asset.key.code	资产代码
pay_asset.asset.amount	要转移的数量
pay_asset.input	触发合约调用的入参，如果用户未输入，默认为空字符串

功能操作源账号将一笔资产转给目标账号
成功条件
- 各项参数合法
- 源账号该类型的资产数量足够

json格式

  {
    "type": 3,
    "pay_asset": {
      "dest_address": "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf",
      "asset": {
        "key": {
          "issuer": "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf",
          "code": "CNY",
          "type": 0 //目前只能填0 或者不填
        },
        "amount": 100
      },
      "input": "{\"bar\":\"foo\"}"
    }
  }

protocol buffer 结构

message OperationPayAsset
{
    string dest_address = 1;
    Asset asset = 2;
    string input = 3;
}

dest_address: 资产接收方账号地址
asset: 要转移的资产

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

message AssetKey
{
     string issuer = 1; //资产发行方
     string code = 2; //资产代码
     int32 type = 3;   //资产类型
}

input: 本次转移触发接收方的合约，合约的执行入参就是input

设置metadata

参数	描述
set_metadata.key	required，length:(0, 1024]
set_metadata.value	optional，length:[0, 256K]
set_metadata.version	optional，default 0, 0：不限制版本，>0 : 当前 value 的版本必须为该值， <0 : 非法

功能操作源账号修改或添加一个metadata到自己的metadata表中
成功条件
- 各项参数合法

json格式

{
  "type": 4,
  "set_metadata": {
    "key": "abc",
    "value": "hello abc!",
    "version": 0
  }
}

protocol buffer 结构
```
message OperationSetMetadata
{
    string key = 1;
    string value = 2;
    int64 version = 3;
}
```
- key: 主键，账号内唯一。长度范围[1,1024]
- value: 值。长度范围[0,256K]
- version: 版本号，可以不填写。若您想使用这个高级功能，参见版本化控制

设置权限

参数	描述
master_weight	optional，字符串类型，default ""，表示该账号的 master 权重。 "" ：不设置该值；"0": 设置 master 权重为 0；("0", "MAX(UINT32)"]：设置权重值为该值；其他：非法。
signers	optional，需要操作的 signer 列表，default 为空对象。空对象不设置，非空设置 signer 列表
address	需要操作的 signer 地址，符合地址校验规则。
weight	optional，default 0。0 ：删除该 signer; (0, MAX(UINT32)]：设置权重值为该值，其他：非法
tx_threshold	optional，字符串类型, default ""，表示该账号的最低权限。""，不设置该值；"0": 设置 tx_threshold 权重为 0；("0", "MAX(INT64)"]：设置权重值为该值；其他：非法。
type	表示某种类型的操作 (0, 100]
threshold	optional，default 0。 0 ：删除该类型操作；(0, MAX(INT64)]：设置权重值为该值；其他：非法

功能设置签名者拥有的权重，设置各个操作所需要的门限。
成功条件
- 各项参数合法

json格式

  {
      "set_privilege": 
      {
        "master_weight": "10",
        "signers": 
        [
          {
          "address": "buQqfssWJjyKfFHZYx8WcSgLVUdXPT3VNwJG",
          "weight": 8
          }
        ],
        "tx_threshold": "2",
        "type_thresholds": 
        [
          {
            "type": 1,
            "threshold": 8
          }, 
          {
            "type": 2,
            "threshold": 9
          }
        ]
      },
      "type": 9
  }

protocol buffer 结构

 message OperationSetPrivilege
 {
    string master_weight = 1;
    repeated Signer signers = 2;
    string tx_threshold = 3;
    repeated OperationTypeThreshold type_thresholds = 4;
 }

 message OperationTypeThreshold
 {
    Operation.Type type = 1;
    int64 threshold = 2;
 }

 message Signer 
 {
    enum Limit
    {
        SIGNER_NONE = 0;
        SIGNER = 100;
    };
    string address = 1;
    int64 weight = 2;
 }

转移BU资产

参数	描述
pay_coin.dest_address	目标账户
pay_coin.amount	要转移的数量
pay_coin.input	触发合约调用的入参，如果用户未输入，默认为空字符串

功能操作源账号将一笔资产转给目标账号
成功条件
- 各项参数合法
- 源账号该类型的资产数量足够

json格式

  {
    "type": 7,
    "pay_coin": {
        "dest_address": "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf",
        "amount": 100,
        "input": "{\"bar\":\"foo\"}"
      }
    }
  }

protocol buffer 结构
```
message OperationPayCoin
{
    string dest_address = 1;
    int64 amount = 2;
    string input = 3;
}
```
- dest_address: BU接收方账号地址
- amount: 要转移的BU数量
- input: 本次转移触发接收方的合约，合约的执行入参就是input

记录日志

参数	描述
log.topic	日志主题，必须为字符串类型,参数长度(0,128]
log.datas	日志内容，以数组方式存储的字符串，每个元素长度(0,1024]

功能写数据到区块链中
成功条件
- 各项参数合法

json格式

  {
    "type": 8,
    "log": {
        "topic": "hello",
        "datas":
        [
          "hello, log 1",
          "hello, log 2"
        ]
    }
  }

protocol buffer 结构

  message OperationLog{
    string topic = 1;
    repeated string datas = 2;
  }

topic: 日志主题
datas: 日志内容

高级功能

控制权的分配

您在创建一个账号时，可以指定这个账号的控制权分配。您可以通过设置priv的值设置。下面是一个简单的例子

{
    "master_weight": "70",//本地址私钥拥有的权力值 70
    "signers": [//分配出去的权力
        {
            "address": "buQc39cgJDBaFGiiAsRtYKuaiSFdbVGheWWk",
            "weight": 55    //上面这个地址拥有权力值55
        },
        {
            "address": "buQts6DfT5KavtV94JgZy75H9piwmb7KoUWg",
            "weight": 100    //上面这个地址拥有权力值100
        }
    ],
    "tx_threshold": "8",//发起交易需要权力值 8
    "type_thresholds": [
        {
            "type": 1,//创建账号需要权利值 11
            "threshold": 11
        },
        {//发行资产需要权利值 21
            "type": 2,
            "threshold": 21
        },
        {//转移资产需要权力值 31
            "type": 3,
            "threshold": 31
        },
        {//设置metadata需要权利值 41
            "type": 4,
            "threshold": 41
        },
        {//变更控制人的权力值需要权利值 51
            "type": 5,
            "threshold": 51
        },
        {//变更各种操作的阈值需要权利值 61
            "type": 6,
            "threshold": 61
        }
    ]
}

版本化控制

每一个账号的metadata都是一个版本化的小型数据库。版本化的特点是可以避免修改冲突的问题。

合约

推荐使用新的接口新的智能合约接口

合约是一段JavaScript代码,标准(ECMAScript as specified in ECMA-262)。合约的初始化函数是init, 执行的入口函数是main函数，您写的合约代码中必须有init和main函数的定义。该函数的入参是字符串input，是调用该合约的时候指定的。下面是一个简单的例子

"use strict";
function init(bar)
{
  /*init whatever you want*/
  return;
}

function main(input)
{
  let para = JSON.parse(input);
  if (para.do_foo)
  {
    let x = {
      'hello' : 'world'
    };
  }
}

function query(input)
{ 
  return input;
}

系统提供了几个全局函数, 这些函数可以获取区块链的一些信息，也可驱动账号发起所有交易，除了设置门限和权重这两种类型的操作。

注意，自定义的函数和变量不要与内置变量和全局函数重名，否则会造成不可控的数据错误。

语法说明

推荐使用新的接口新的智能合约接口

参考文档：智能合约语法说明

内置函数

推荐使用新的接口新的智能合约接口

函数读写权限

每个函数都有固定的只读或者可写权限

只读权限是指不会写数据到区块链的接口函数，比如获取余额 getBalance

可写权限是指会写数据到区块链的接口函数，比如转账 payCoin

在编写智能合约的时候，需要注意的是不同的入口函数拥有不同的调用权限

init 和 main 能调用所有的内置函数

query 只能调用只读权限的函数，否则在调试或者执行过程中会提示接口未定义
返回值介绍

所有内部函数的调用，如果失败则返回 false 或者直接抛出异常执行终止，成功则为其他对象。如果遇到参数错误，会在错误描述中提示参数位置出错，这里的位置指参数的索引号，即从 0 开始计数。例如 parameter 1 表示第 2 个参数错误。如下例子：
```
issueAsset("CNY", 10000);
/*
   错误描述：
   Contract execute error,issueAsset parameter 1 should be a string

   指第 2 个参数应该为字符串
*/
```

获取账号信息(不包含metada和资产)

getBalance(address);

address: 账号地址

例如

let balance = getBalance('buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY');
/*
  权限：只读
  返回：字符串格式数字 '9999111100000'
*/

存储合约账号的metadata信息

storageStore(metadata_key, metadata_value);
- metadata_key: metadata 的 key
- metadata_key: metadata 的 value
```
storageStore('abc', 'values');
/*
  权限：可写
  返回：成功返回true, 失败抛异常
*/
```
获取合约账号的metadata信息

storageLoad(metadata_key);
- metadata_key: metadata的key
```
let value = storageLoad('abc');
/*
  权限：只读
  返回：成功返回字符串，如 'values', 失败返回false
*/
```
即可得到本合约账号中自定数据的abc的值
删除合约账号的metadata信息

storageDel(metadata_key);
- metadata_key: metadata的key
```
storageDel('abc');
/*
  权限：可写
  返回：成功返回true, 失败抛异常
*/
```
即可删除本合约账号中自定数据的abc的值

获取某个账号的资产信息

getAccountAsset(account_address, asset_key);

account_address: 账号地址
asset_key: 资产属性

例如

let asset_key =
{
  'issuer' : 'buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY',
  'code' : 'CNY'
};
let bar = getAccountAsset('buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY', asset_key);

/*
  权限：只读
  返回：成功返回资产数字如'10000'，失败返回 false
*/

获取区块信息

getBlockHash(offset_seq);

offset_seq: 距离最后一个区块的偏移量，范围：[0,1024)

例如

let ledger = getBlockHash(4);
/*
  权限：只读
  返回：成功返回字符串，如 'c2f6892eb934d56076a49f8b01aeb3f635df3d51aaed04ca521da3494451afb3'，失败返回 false
*/

地址合法性检查

addressCheck(address);

address 地址参数，字符串

例如

let ret = addressCheck('buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf');
/*
  权限：只读
  返回：成功返回 true，失败返回 false
*/

字符串数字合法性检查

stoI64Check(strNumber);

strNumber：字符串数字参数

例如

let ret = stoI64Check('12345678912345');
/*
  权限：只读
  返回：成功返回 true，失败返回 false
*/

64位加法

int64Add(left_value, right_value);

left_value: 左值
right_value：右值

例如

let ret = int64Add('12345678912345', 1);
/*
  权限：只读
  返回：成功返回字符串 '12345678912346', 失败抛异常
*/

64位减法

int64Sub(left_value, right_value);

left_value: 左值
right_value：右值

例如

let ret = int64Sub('12345678912345', 1);
/*
  权限：只读
  返回：成功返回字符串 '123456789123464'，失败抛异常
*/

64位乘法

int64Mul(left_value, right_value);

left_value: 左值
right_value：右值

例如

let ret = int64Mul('12345678912345', 2);
/*
  权限：只读
  返回：成功返回字符串 '24691357824690'，失败抛异常
*/

64位除法

int64Div(left_value, right_value);

left_value: 左值
right_value：右值

例如

let ret = int64Div('12345678912345', 2);
/*
  权限：只读
  返回：成功返回 '6172839456172'，失败抛异常
*/

64位取模

int64Mod(left_value, right_value);

left_value: 左值
right_value：右值

例如

let ret = int64Mod('12345678912345', 2);
/*
  权限：只读
  返回：成功返回字符串 '1'，失败抛异常
*/

64位比较

int64Compare(left_value, right_value);
- 返回值 1：左值大于右值，0：等于，-1 ：小于
- left_value: 左值
- right_value：右值
例如
```
let ret = int64Compare('12345678912345', 2);
/*
  权限：只读
  返回：成功返回数字 1（左值大于右值），失败抛异常
*/
```
变换单位

toBaseUnit(value);
- 返回值: 成功会返回乘以 10^8 的字符串，失败会返回 false
- value: 被转换的数字，只能传入字符串，可以包含小数点，且小数点之后最多保留 8 位数字
例如
```
let ret = toBaseUnit('12345678912');
/*
  权限：只读
  返回：成功返回字符串 '1234567891200000000'，失败抛异常
*/
```

输出日志

log(info); info: 日志内容

例如

let ret = log('buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY');
/*
  权限：只读
  返回：成功无返回值，失败返回 false
*/

输出交易日志

tlog(topic,args...);
- tlog会产生一笔交易写在区块上
- topic: 日志主题，必须为字符串类型,参数长度(0,128]
- args...: 最多可以包含5个参数，参数类型可以是字符串、数值或者布尔类型,每个参数长度(0,1024]
例如
```
tlog('transfer',sender +' transfer 1000',true);
/*
  权限：可写
  返回：成功返回 true，失败抛异常
*/
```

发行资产

issueAsset(code, amount);

code: 资产代码
amount: 发行资产数量

例如

issueAsset("CNY", "10000");
/*
  权限：可写
  返回：成功返回 true，失败抛异常  
*/

转移资产

payAsset(address, issuer, code, amount[, input]);
- address: 转移资产的目标地址
- issuer: 资产发行方
- code: 资产代码
- amount: 转移资产的数量
- input: 可选，合约参数，如果用户未填入，默认为空字符串
例如
```
payAsset("buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY", "buQgmhhxLwhdUvcWijzxumUHaNqZtJpWvNsf", "CNY", "10000", "{}");
/*
  权限：可写
  返回：成功返回 true，失败抛异常    
*/
```
转账

payCoin(address, amount[, input]);
- address: 发送BU的目标地址
- amount: 发送BU的数量
- input: 可选，合约参数，如果用户未填入，默认为空字符串
例如
```
payCoin("buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY", "10000", "{}");
/*
  权限：可写
  返回：成功返回 true，失败抛异常  
*/
```
断言

assert(condition[, message]);
- condition: 断言变量
- message: 可选，失败时抛出异常的消息
例如
```
assert(1===1, "Not valid");
/*
  权限：只读
  返回：成功返回 true，失败抛异常  
*/
```

内置变量

推荐使用新的接口新的智能合约接口

该合约账号的地址

thisAddress

全局变量thisAddress的值等于该合约账号的地址。

例如账号x发起了一笔交易调用合约Y，本次执行过程中，thisAddress的值就是Y合约账号的地址。
```
let bar = thisAddress;
/*
bar的值是Y合约的账号地址。
*/
```
本次支付操作的 BU coin

thisPayCoinAmount
本次支付操作的Asset

thisPayAsset

为对象类型{"amount": 1000, "key" : {"issuer": "buQsZNDpqHJZ4g5hz47CqVMk5154w1bHKsHY", "code":"CNY"}}
当前区块高度

blockNumber
当前区块时间戳

blockTimestamp
调用者的地址

sender sender 的值等于本次调用该合约的账号。

例如某账号发起了一笔交易，该交易中有个操作是调用合约Y（该操作的source_address是x），那么合约Y执行过程中，sender的值就是x账号的地址。
```
let bar = sender;
/*
那么bar的值是x的账号地址。
*/
```
触发本次合约调用的操作的序号

triggerIndex

triggerIndex 的值等于触发本次合约的操作的序号。

例如某账号A发起了一笔交易tx0，tx0中第0（从0开始计数）个操作是给某个合约账户转移资产(调用合约), 那么triggerIndex的值就是0。
```
let bar = triggerIndex;
/* bar 是一个非负整数*/
```

异常处理

JavaScript异常

当合约运行中出现未捕获的JavaScript异常时，处理规定：
1. 本次合约执行失败，合约中做的所有交易都不会生效。
2. 触发本次合约的这笔交易为失败。错误代码为151。
执行交易失败合约中可以执行多个交易，只要有一个交易失败，就会抛出异常，导致整个交易失败

验证者节点选举

创建选举合约账户

验证节点选举账户创建成功后，才可以进行后续的操作, 且该账户是全局唯一的, 不能重复创建。

创建一个合约账户（参见创建账号），账户的地址必须是buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ。
将 src\ledger\validators_vote.js 文件中的源码全部拷贝作为账户中 payload 字段的值。

     "contract" :
     {
       "contract_id" : "something identify this contract",
       "payload" : "拷贝 src\ledger\validators_vote.js 中全部代码至此处"
     },

在 validators_vote.js 文件指定的合约代码中, 以下变量可根据需要修改。但一旦验证节点选举账户创建成功，则不能再修改。

  let validatorSetSize       = 100;
  let votePassRate           = 0.7;
  let effectiveVoteInterval  = 15 * 24 * 60 * 60 * 1000 * 1000;
  let minPledgeAmount        = 50000 * 100000000;
  let minSuperadditionAmount = 100 * 100000000;

validatorSetSize 指定网络内验证节点的个数；
votePassRate 设置投票通过率，只有验证节点有投票权限，投票数 >= 四舍五入( 验证节点总数 * votePassRate ) 则投票通过，例如，假设总共有 4 个验证节点，那么 4 * 0.7 = 2.8，四舍五入后为 3，那么投票数必须 >= 3 才能通过, 如果总共有 6 个验证节点，那么 6 * 0.7 = 4.2，四舍五入后为 4，投票数必须 >= 4 才能通过;
effectiveVoteInterval 设置投票有效期，单位为微秒，超过有效期，则提案和投票作废；
minPledgeAmount 设置最小押金数额，低于该额度则拒绝；
minSuperadditionAmount 设置押金最小追加数额，低于该数额将被拒绝。

申请成为验证节点候选人

任意一个拥有网络节点的账户可以通过向验证节点选举账户转移一笔 coin 作为押金，申请成为验证节点候选人。但能否成为候选节点，需经过验证节点投票决定。

申请者向验证节点选举账户转移一笔 coin 作为押金（参见‘转移BU资产’），该押金可通过 ‘收回押金’ 操作收回。
‘转移货币’操作的 input 字段填入 { "method" : "pledgeCoin"}，注意使用转义字符。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :100000,
    "input":
    "{\"method\":\"pledgeCoin\"}"
  }

验证节点将对申请者投票(请参见‘对验证节点候选人申请者投票’)，投票通过后将成为验证节点候选人。候选人能否成为真正的验证节点取决于押金数额。假设网络需要 100 个验证节点（ validatorSetSize 值为 100），那么押金数额排在前 100 位以内的申请者将成为验证节点。押金数额可以追加，且不限次数，追加方式即再次执行‘申请成为验证节点候选人’操作。申请者可通过‘查询功能’查询候选人名单和他们所交纳的押金数额。

注意：申请成为验证节点候选人的账户必须拥有节点，且节点和账户为同一地址。

对验证节点候选人申请者投票

验证节点对申请者投票通过后，则该节点成为验证节点候选人。如果投票有效期内未通过，可以收回押金。

向验证节点选举账户转移任意一笔资产或者一笔数额为 0 的 coin。
‘转移资产’或‘转移货币’操作的 input 字段填入 { "method" : "voteForApplicant", "params" : { "address" : "填入申请者地址" } }，注意使用转义字符。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :0,
    "input":
    "{ 
        \"method\":\"voteForApplicant\",
        \"params\":
        { 
          \"address\":\"buQtZrMdBQqYzfxvqKX3M8qLZD3LNAuoSKj4\"
        }
    }"
  }

注意：只有验证节点有投票权，且每个验证节点只能投票一次。如果在有效投票期内投票未通过，则申请提案和已投票数全部作废。

收回押金

验证节点、验证节点候选人和候选人申请者可通过此操作收回全部押金。

向验证节点选举账户转移任意一笔资产或者一笔数额为 0 的 coin。
‘转移资产’或‘转移货币’操作的 input 字段填入 { "method":"takebackCoin" }，注意使用转义字符。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :0,
    "input":"{\"method\":\"takebackCoin\"}"
  }

操作成功后，选举账户会将所有押金退回原账户，如果当前节点已经是验证节点，将丢失验证节点身份。选举合约将选出新的验证节点替代退出验证节点的位置。

废止恶意节点

如果某验证节点发现有另一个验证节点为恶意节点，或者不再适合作为验证节点，可以申请废止该恶意节点。发起‘废止恶意节点’提案后，需要所有验证节点投票决定是否执行废止操作。

废止者向验证节点选举账户转移任意一笔资产或者一笔数额为 0 的 coin。
‘转移资产’或‘转移货币’操作的 input 字段填入 { "method" : "abolishValidator", "params" : { "address" : "此处填入恶意验证节点地址", "proof" : "此处填入废止该验证节点的原因"} }，注意使用转义字符。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :0,
    "input":
    "{
      \"method\":\"abolishValidator\",
      \"params\":
      {
        \"address\":\"buQmvKW11Xy1GL9RUXJKrydWuNykfaQr9SKE\"，
        \"proof\":\"I_saw_it_uncomfotable.\"
      }
    }"
  }

注意：申请废止者和被废止者必须都是验证者节点。

取消废止恶意节点

如果发起废止操作的验证节点后来发现被废止节点并非恶意节点，可以取消废止操作。但如果该废止操作已经被其他验证节点投票通过，则无法取消。

废止者向验证节点选举账户转移任意一笔资产或者一笔数额为 0 的 coin。
‘转移资产’或‘转移货币’操作的 input 字段填入 { "method" : "quitAbolish", "params" : { "address" : "此处填入恶意验证节点地址" } }。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :0,
    "input":
    "{ 
      \"method\":\"quitAbolish\",
      \"params\":
      { 
        \"address\":\"buQmvKW11Xy1GL9RUXJKrydWuNykfaQr9SKE\"
      }
    }"
  }

注意：只有申请废止者才可以取消，其他节点和验证者节点无权取消。

对废止恶意节点投票

投票通过后，恶意节点将被废止。恶意节点被废止后，选举账户只将该节点 90% 的押金退回原账户，10% 的押金将被罚没，且平均分给剩余其他所有验证节点作为押金, 取模的余数奖励给股权最高的验证节点。

验证节点向选举账户转移任意一笔资产或者一笔数额为 0 的 coin。
‘转移资产’或‘转移货币’操作的 input 字段填入 { "method" : "voteForAbolish", "params" : { "address" : "此处填入被投票的恶意验证节点地址" } }，注意使用转移字符。

  "pay_coin" :
  {
    "dest_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "amount" :0,
    "input":
    "{
       \"method\":\"voteForAbolish\",
      \"params\":
      {
         \"address\":\"buQmvKW11Xy1GL9RUXJKrydWuNykfaQr9SKE\"
      }
    }"
  }

注意：只有验证节点拥有投票权。若有效期内该废止提案未投票通过，则提案作废，申请被废止的节点将继续作为验证节点参与共识。

查询功能

用户通过向查询接口（即 query 接口）提供指定参数，可以查看相关信息, 调用查询接口当前只能通过 callContract, contract_address 字段填入验证者候选节点选举账户地址。

查询当前验证节点集合

  {
    "contract_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "code" : "",
    "input" : "{\"method\": \"getValidators\"}",
    "opt_type" : 2,
    "source_address" : ""
  }

查询验证节点候选人名单和押金数额；

  {
    "contract_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "code" : "",
    "input" : "{\"method\": \"getCandidates\"}",
    "opt_type" : 2,
    "source_address" : ""
  }

查询指定的候选节点申请者提案信息

input 中的 address 字段填入申请者地址。

  {
    "contract_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "code" : "",
    "input" :
    "{
      \"method\": \"getApplicantProposal\",
      \"params\":
      {
         \"address\":\"buQmvKW11Xy1GL9RUXJKrydWuNykfaQr9SKE\"
      }
    }",
    "opt_type" : 2,
    "source_address" : ""
  }

查询指定的废止恶意节点提案的信息

input 中的 address 字段填入指定的恶意节点地址。

  {
    "contract_address" : "buQtxgoaDrVJGtoPT66YnA2S84yE8FbBqQDJ",
    "code" : "",
    "input" :
    "{
      \"method\": \"getAbolishProposal\",
      \"params\":
      {
         \"address\":\"buQmvKW11Xy1GL9RUXJKrydWuNykfaQr9SKE\"
      }
    }",
    "opt_type" : 2,
    "source_address" : ""
  }

费用选举合约

此合约为交易费用标准制定合约，每项费用标准由共识节点提出议案，所有共识节点投票选举，获胜的议案作为新的费用收取标准，在下一个区块实施，当提案提出后超过15天仍未胜出，提案作废。此合约地址：buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe

费用结构

message FeeConfig
{
  enum Type {
  	UNKNOWN = 0;
  	GAS_PRICE = 1;
  	BASE_RESERVE = 2;
  };
  int64 gas_price = 1;
  int64 base_reserve = 2;
}

费用种类

代码值	枚举名	说明
1	GAS_PRICE	Gas最低费用
2	BASE_RESERVE	预留费用

查询历史费用

GET /getLedger?seq=xxxx&with_fee=true

参数	描述
seq	ledger的序号，如果不填写，返回当前ledger
with_fee	默认false，不显示费用列表

如果查询到ledger则返回内容:

{
    "error_code": 0,
    "result": {
        "fees": {
            "base_reserve": 5,
            "gas_price": 1000
        },
        "header": {
            "account_tree_hash": "c4e74a027e7fb7a96fa2c028a24fd8296df049decf928ee173ec4106ae016b0c",
            "consensus_value_hash": "2779905317234108f76cf5d65125cc0e9a3fd58e2140226bf79e8917028c8c9c",
            "fees_hash": "d7618678ae72e7154fc4366f0a43154ee6bb786b3cefd46287e608e90e13a651",
            "hash": "0c1b9d4b5a72d42f73917114c71672f78a3d951b7f7b89663d10138ea409c308",
            "seq": 1,
            "validators_hash": "cc4b0517295210c24ab037e3e9e122fd0c71e3c87994b7f913860de0a1930c36",
            "version": 1000
        }
    }
}

查询费用提案

通过发送接口 callContract 接口查询。合约入参input参数json格式

{
    "method":"queryProposal"
}

json格式需转换成字符串形式填写到 callContract 接口结构

{
    "contract_address" : "buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe",
    "code" : "",
    "input" : "{\"method\":\"queryProposal\"}",
    "opt_type" : 2,
    "source_address" : "",
    "fee_limit":100000,
    "gas_price":1000
}

contract_address赋值为区块上的费用选举合约地址，opt_type 为 2 代表调用查询接口

如果查询到则返回内容:

{
    "error_code": 0,
    "error_desc": "",
    "result": {
        "logs": {
            "0-buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe": null
        },
        "query_rets": [
            {
                "result": {
                    "type": "string",
                    "value": "{\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1\":{\"accountId\":\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw\",\"proposalId\":\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1\",\"feeType\":1,\"price\":5,\"voteCount\":0,\"time\":1517470155872949}}"
                }
            }
        ],
        "actual_fee": 0,
        "stat": {
            "apply_time": 11342,
            "memory_usage": 1325072,
            "stack_usage": 2564,
            "step": 16
        },
        "txs": null
    }
}

result 域的value值为返回结果，反序列化为json格式即可得到所有的费用提案

查询投票

通过发送接口 callContract 接口查询，可根据提案id进行查询单项。合约入参input参数json格式

{
    "method":"queryVote",
    "params":{
      "proposalId": "buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1"
    }
}

json格式需转换成字符串形式填写到 callContract 接口结构

{
    "contract_address" : "buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe",
    "code" : "",
    "input" :"{\"method\":\"queryVote\",\"params\":{\"proposalId\":\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1\"}}",
    "opt_type" : 2,
    "source_address" : "",
    "fee_limit":100000,
    "gas_price":1000
}

contract_address赋值为区块上的费用选举合约地址，opt_type 为 2 代表调用查询接口

如果查询到则返回内容:

{
    "error_code": 0,
    "error_desc": "",
    "result": {
        "logs": {
            "0-buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe": null
        },
        "query_rets": [
            {
                "result": {
                    "type": "string",
                    "value": "{\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw\":1}"
                }
            }
        ],
        "actual_fee": 0,
        "stat": {
            "apply_time": 18020,
            "memory_usage": 1326456,
            "stack_usage": 2564,
            "step": 19
        },
        "txs": null
    }
}

result 域的value值为返回结果，反序列化为json格式即可得到所有的某项费用提案的投票

费用提案

通过发送转移资产交易或者付币交易来给合约发起费用提案。合约入参input参数json格式。一个账户只能发起一类费用提案，如果再次发起提案，会销毁上次提案及相关投票。

{
  "method":"proposalFee",
    "params":{
        "feeType": 1, //费用种类
        "price": 5    //费用int且大于等于0
    }
}

json格式需转换成字符串形式填写到paycoin接口结构

{
    "type" : "PAY_COIN",
    "pay_coin" : {
       "dest_address" :"buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe",
       "amount":0,
        "input":"{\"method\":\"proposalFee\",\"params\":{\"feeType\":1,\"price\":5}}"
    }
}

费用选举

votePassRate 设置投票通过率，只有验证节点有投票权限，投票数 >= 四舍五入( 验证节点总数 * votePassRate ) 则投票通过，例如，假设总共有 4 个验证节点，那么 4 * 0.7 = 2.8，四舍五入后为 3，那么投票数必须 >= 3 才能通过, 如果总共有 6 个验证节点，那么 6 * 0.7 = 4.2，四舍五入后为 4，投票数必须 >= 4 才能通过;

通过发送转移资产交易或者付币交易来给合约发起费用选举。合约入参input参数json格式

{
  "method":"voteFee",
  "params":{
      "proposalId": "buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1"
   }
}

json格式需转换成字符串形式填写到paycoin接口结构

{
   "type" : "PAY_COIN",
    "pay_coin" : {
        "dest_address" :"buQiQgRerQM1fUM3GkqUftpNxGzNg2AdJBpe",
        "amount":0,
        "input":"{\"method\":\"voteFee\",\"params\":{\"proposalId\":\"buQft4EdxHrtatWUXjTFD7xAbMXACnUyT8vw1\"}}"
    }
}

错误码

错误由两部分构成:

error_code : 错误码，大概的错误分类
error_desc : 错误描述，一般能从错误描述准确发现错误具体信息

错误列表如下:

error_code/错误码	枚举名	错误描述
0	ERRCODE_SUCCESS	操作成功
1	ERRCODE_INTERNAL_ERROR	服务内部错误
2	ERRCODE_INVALID_PARAMETER	参数错误
3	ERRCODE_ALREADY_EXIST	对象已存在，如重复提交交易
4	ERRCODE_NOT_EXIST	对象不存在，如查询不到账号、TX、区块等
5	ERRCODE_TX_TIMEOUT	TX 超时，指该 TX 已经被当前节点从 TX 缓存队列去掉，但并不代表这个一定不能被执行
7	ERRCODE_MATH_OVERFLOW	数学计算溢出
20	ERRCODE_EXPR_CONDITION_RESULT_FALSE	指表达式执行结果为 false，意味着该 TX 当前没有执行成功，但这并不代表在以后的区块不能成功
21	ERRCODE_EXPR_CONDITION_SYNTAX_ERROR	指表达式语法分析错误，代表该 TX 一定会失败
90	ERRCODE_INVALID_PUBKEY	公钥非法
91	ERRCODE_INVALID_PRIKEY	私钥非法
92	ERRCODE_ASSET_INVALID	无效的资产
93	ERRCODE_INVALID_SIGNATURE	签名权重不够，达不到操作的门限值
94	ERRCODE_INVALID_ADDRESS	地址非法
97	ERRCODE_MISSING_OPERATIONS	交易缺失操作
98	ERRCODE_TOO_MANY_OPERATIONS	单笔交易内超过了100个操作
99	ERRCODE_BAD_SEQUENCE	交易序号错误，nonce错误
100	ERRCODE_ACCOUNT_LOW_RESERVE	余额不足
101	ERRCODE_ACCOUNT_SOURCEDEST_EQUAL	源和目的账号相等
102	ERRCODE_ACCOUNT_DEST_EXIST	创建账号操作，目标账号已存在
103	ERRCODE_ACCOUNT_NOT_EXIST	账户不存在
104	ERRCODE_ACCOUNT_ASSET_LOW_RESERVE	支付操作，资产余额不足
105	ERRCODE_ACCOUNT_ASSET_AMOUNT_TOO_LARGE	资产数量过大，超出了int64的范围
106	ERRCODE_ACCOUNT_INIT_LOW_RESERVE	创建账号初始化资金不足
111	ERRCODE_FEE_NOT_ENOUGH	费用不足
114	ERRCODE_OUT_OF_TXCACHE	TX 缓存队列已满
120	ERRCODE_WEIGHT_NOT_VALID	权重值不在有效范围内
121	ERRCODE_THRESHOLD_NOT_VALID	门限值不在有效范围内
144	ERRCODE_INVALID_DATAVERSION	metadata的version版本号不与已有的匹配（一个版本化的数据库）
146	ERRCODE_TX_SIZE_TOO_BIG	交易数据超出上限
151	ERRCODE_CONTRACT_EXECUTE_FAIL	合约执行失败
152	ERRCODE_CONTRACT_SYNTAX_ERROR	合约语法分析失败
153	ERRCODE_CONTRACT_TOO_MANY_RECURSION	合约递归深度超出上限
154	ERRCODE_CONTRACT_TOO_MANY_TRANSACTIONS	合约产生的交易超出上限
155	ERRCODE_CONTRACT_EXECUTE_EXPIRED	合约执行超时
160	ERRCODE_TX_INSERT_QUEUE_FAIL	插入交易缓存队列失败

示例

下面我们用buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3发起一笔交易，这笔交易只有1个操作:创建一个账号。

组装交易，将交易序列化

POST getTransactionBlob

{
  "source_address": "buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3",
  "nonce": 1,
  "fee_limit":100000,
  "gas_price":1000,
  "operations": [{
      "type": 1,
      "create_account": {
        "dest_address": "buQts6DfT5KavtV94JgZy75H9piwmb7KoUWg",
        "metadatas": [{
            "key": "hello",
            "value": "这是创建账号的过程中设置的一个metadata"
          }
        ],
        "priv": {
          "thresholds": {
            "tx_threshold": 1
          }
        },
        "contract": {
          "payload": "function main(inputStr){\n /*这是合约入口函数*/ }"
        }
      }
    }
  ]
}

得到结果

{
    "error_code": 0,
    "error_desc": "",
    "result": {
        "hash": "8e97ab885685d68b8fa8c7682f77ce17a85f1b4f6c8438eda8ec955890919405",
        "transaction_blob": "0a2e61303032643833343562383964633334613537353734656234393736333566663132356133373939666537376236100122b90108012ab4010a2e61303032663836366337663431356537313934613932363131386363353565346365393939656232396231363461123a123866756e6374696f6e206d61696e28696e707574537472297b0a202f2ae8bf99e698afe59088e7baa6e585a5e58fa3e587bde695b02a2f207d1a06080a1a020807223e0a0568656c6c6f1235e8bf99e698afe5889be5bbbae8b4a6e58fb7e79a84e8bf87e7a88be4b8ade8aebee7bdaee79a84e4b880e4b8aa6d65746164617461"
    }
}

我们用对buQs9npaCq9mNFZG18qu88ZcmXYqd6bqpTU3的私钥对transaction_blob的值进行签名。得到签名数据2f6612eaefbdadbe792201bb5d1e178aff118dfa0a640edb2a8ee91933efb97c4fb7f97be75195e529609a4de9b890b743124970d6bd7072b7029cfe7683ba2d。

将签名数据和公钥和交易blob一起提交

POST /submitTransaction

{
  "items" : [{
      "transaction_blob" : "0a2e61303032643833343562383964633334613537353734656234393736333566663132356133373939666537376236100122b90108012ab4010a2e61303032663836366337663431356537313934613932363131386363353565346365393939656232396231363461123a123866756e6374696f6e206d61696e28696e707574537472297b0a202f2ae8bf99e698afe59088e7baa6e585a5e58fa3e587bde695b02a2f207d1a06080a1a020807223e0a0568656c6c6f1235e8bf99e698afe5889be5bbbae8b4a6e58fb7e79a84e8bf87e7a88be4b8ade8aebee7bdaee79a84e4b880e4b8aa6d65746164617461",
      "signatures" : [{
          "sign_data" : "2f6612eaefbdadbe792201bb5d1e178aff118dfa0a640edb2a8ee91933efb97c4fb7f97be75195e529609a4de9b890b743124970d6bd7072b7029cfe7683ba2d",
          "public_key" : "b00204e1c7dddc36d3153adcaa451b0ab525d3def48a0a10fdb492dc3a7263cfb88e80ee974ca4da0e1f322aa84ff9d11340c764ea756ad148e979c121619e9fe52e9054"
        }
      ]
    }
  ]
}

你可能感兴趣的:(区块链,bumo,BUMO专栏)

DIV+CSS+JavaScript技术制作网页（旅游主题网页设计与制作）云南大理 STU学生网页设计网页设计期末网页作业 html静态网页 html5期末大作业网页设计 web大作业
️精彩专栏推荐作者主页:【进入主页—获取更多源码】web前端期末大作业：【HTML5网页期末作业(1000套)】程序员有趣的告白方式：【HTML七夕情人节表白网页制作(110套)】文章目录二、网站介绍三、网站效果▶️1.视频演示2.图片演示四、网站代码HTML结构代码CSS样式代码五、更多源码二、网站介绍网站布局方面：计划采用目前主流的、能兼容各大主流浏览器、显示效果稳定的浮动网页布局结构。网站程
【加密社】Solidity 中的事件机制及其应用加密社闲侃区块链智能合约区块链
加密社引言在Solidity合约开发过程中，事件（Events）是一种非常重要的机制。它们不仅能够让开发者记录智能合约的重要状态变更，还能够让外部系统（如前端应用）监听这些状态的变化。本文将详细介绍Solidity中的事件机制以及如何利用不同的手段来触发、监听和获取这些事件。事件存储的地方当我们在Solidity合约中使用emit关键字触发事件时，该事件会被记录在区块链的交易收据中。具体而言，事件
在一台Ubuntu计算机上构建Hyperledger Fabric网络落叶无声9 区块链超级账本 Hyperledger fabric 区块链 ubuntu 构建 hyperledger fabric
在一台Ubuntu计算机上构建HyperledgerFabric网络Hyperledgerfabric是一个开源的区块链应用程序平台，为开发基于区块链的应用程序提供了一个起点。当我们提到HyperledgerFabric网络时，我们指的是使用HyperledgerFabric的正在运行的系统。即使只使用最少数量的组件，部署Fabric网络也不是一件容易的事。Fabric社区创建了一个名为Cello
Day1笔记-Python简介&标识符和关键字&输入输出 ~在杰难逃~ Python python 开发语言大数据数据分析数据挖掘
大家好，从今天开始呢，杰哥开展一个新的专栏，当然，数据分析部分也会不定时更新的，这个新的专栏主要是讲解一些Python的基础语法和知识，帮助0基础的小伙伴入门和学习Python，感兴趣的小伙伴可以开始认真学习啦！一、Python简介【了解】1.计算机工作原理编程语言就是用来定义计算机程序的形式语言。我们通过编程语言来编写程序代码，再通过语言处理程序执行向计算机发送指令，让计算机完成对应的工作，编程
每日算法&面试题，大厂特训二十八天——第二十天（树）肥学 ⚡算法题⚡面试题每日精进 java 算法数据结构
目录标题导读算法特训二十八天面试题点击直接资料领取导读肥友们为了更好的去帮助新同学适应算法和面试题，最近我们开始进行专项突击一步一步来。上一期我们完成了动态规划二十一天现在我们进行下一项对各类算法进行二十八天的一个小总结。还在等什么快来一起肥学进行二十八天挑战吧！！特别介绍小白练手专栏，适合刚入手的新人欢迎订阅编程小白进阶python有趣练手项目里面包括了像《机器人尬聊》《恶搞程序》这样的有趣文章
【华为OD技术面试真题 - 技术面】- python八股文真题题库（4) 算法大师华为od 面试 python
华为OD面试真题精选专栏：华为OD面试真题精选目录:2024华为OD面试手撕代码真题目录以及八股文真题目录文章目录华为OD面试真题精选**1.Python中的`with`**用途和功能自动资源管理示例：文件操作上下文管理协议示例代码工作流程解析优点2.\_\_new\_\_和**\_\_init\_\_**区别__new____init__区别总结3.**切片（Slicing）操作**基本切片语法
【华为OD技术面试真题 - 技术面】-测试八股文真题题库（1）算法大师华为od 面试 python 算法前端
华为OD面试真题精选专栏：华为OD面试真题精选目录:2024华为OD面试手撕代码真题目录以及八股文真题目录文章目录华为OD面试真题精选1.黑盒测试和白盒测试的区别2.假设我们公司现在开发一个类似于微信的软件1.0版本，现在要你测试这个功能：打开聊天窗口，输入文本，限制字数在200字以内。问你怎么提取测试点。功能测试性能测试安全性测试可用性测试跨平台兼容性测试网络环境测试3.接口测试的工具你了解哪些
【华为OD技术面试真题 - 技术面】- python八股文真题题库（1）算法大师华为od 面试 python
华为OD面试真题精选专栏：华为OD面试真题精选目录:2024华为OD面试手撕代码真题目录以及八股文真题目录文章目录华为OD面试真题精选1.数据预处理流程数据预处理的主要步骤工具和库2.介绍线性回归、逻辑回归模型线性回归（LinearRegression）模型形式：关键点：逻辑回归（LogisticRegression）模型形式：关键点：参数估计与评估：3.python浅拷贝及深拷贝浅拷贝（Shal
OPENAIGC开发者大赛企业组AI黑马奖 | AIGC数智传媒解决方案 RPA中国人工智能 AIGC 传媒
在第二届拯救者杯OPENAIGC开发者大赛中，涌现出一批技术突出、创意卓越的作品。为了让这些优秀项目被更多人看到，我们特意开设了优秀作品报道专栏，旨在展示其独特之处和开发者的精彩故事。无论您是技术专家还是爱好者，希望能带给您不一样的知识和启发。让我们一起探索AIGC的无限可能，见证科技与创意的完美融合！创未来AI应用赛-企业组AI黑马奖作品名称：AIGC数智传媒解决方案参赛团队：深圳市三象智能技术
你可能遗漏的一些C#/.NET/.NET Core知识点追逐时光者 C#.NET DotNetGuide编程指南 c#.net .netcore microsoft
前言在这个快速发展的技术世界中，时常会有一些重要的知识点、信息或细节被忽略或遗漏。《C#/.NET/.NETCore拾遗补漏》专栏我们将探讨一些可能被忽略或遗漏的重要知识点、信息或细节，以帮助大家更全面地了解这些技术栈的特性和发展方向。拾遗补漏GitHub开源地址https://github.com/YSGStudyHards/DotNetGuide/blob/main/docs/DotNet/D
【从浅识到熟知Linux】Linux发展史 Jammingpro 从浅学到熟知Linux linux 运维服务器
归属专栏：从浅学到熟知Linux个人主页：Jammingpro每日努力一点点，技术变化看得见文章前言：本篇文章记录Linux发展的历史，因在介绍Linux过程中涉及的其他操作系统及人物，本文对相关内容也有所介绍。文章目录Unix发展史Linux发展史开源Linux官网企业应用情况发行版本在学习Linux前，我们可能都会问Linux从哪里来？它是如何发展的。但在介绍Linux之前，需要先介绍一下Un
Armv8.3 体系结构扩展--原文版代码改变世界ctw ARM-TEE-Android armv8 嵌入式 arm架构安全架构芯片 Trustzone Secureboot
快速链接:.ARMv8/ARMv9架构入门到精通-[目录]付费专栏-付费课程【购买须知】:个人博客笔记导读目录(全部)TheArmv8.3architectureextensionTheArmv8.3architectureextensionisanextensiontoArmv8.2.Itaddsmandatoryandoptionalarchitecturalfeatures.Somefeat
【ARM Cortex-M 系列 2.3 -- Cortex-M7 Debug event 详细介绍】主公讲 ARM #ARM 系列 arm开发 debug event
请阅读【嵌入式开发学习必备专栏】文章目录Cortex-M7DebugeventDebugeventsCortex-M7Debugevent在ARMCortex-M7架构中，调试事件（DebugEvent）是由于调试原因而触发的事件。一个调试事件会导致以下几种情况之一发生：进入调试状态：如果启用了停滞调试（HaltingDebug），一个调试事件会使处理器在调试状态下停滞。通过将DHCSR.C_DE
Dockerfile命令详解之 FROM 清风怎不知意容器化 java 前端 javascript
许多同学不知道Dockerfile应该如何写，不清楚Dockerfile中的指令分别有什么意义，能达到什么样的目的，接下来我将在容器化专栏中详细的为大家解释每一个指令的含义以及用法。专栏订阅传送门https://blog.csdn.net/qq_38220908/category_11989778.html指令不区分大小写。但是，按照惯例，它们应该是大写的，以便更容易地将它们与参数区分开来。(引用
【Python基础】Python迭代器与生成器（两种强大工具）姑苏老陈 Python编程入门 python 开发语言 python迭代器与生成器
本文收录于《Python编程入门》专栏，从零基础开始，分享一些Python编程基础知识，欢迎关注，谢谢！文章目录一、前言二、迭代器2.1创建迭代器2.2自定义迭代器2.3处理大型文件三、生成器四、生成器表达式五、实际应用案例5.1数据库查询5.2网络数据流处理六、总结一、前言在Python中，迭代器与生成器是两种非常强大的工具，它们可以帮助我们有效地处理大量数据，特别是在需要逐个访问元素的情况下。
基于JavaWeb开发的Java+SpringMvc+vue+element实现上海汽车博物馆平台网顺技术团队成品程序项目 java vue.js 汽车课程设计 spring boot
基于JavaWeb开发的Java+SpringMvc+vue+element实现上海汽车博物馆平台作者主页网顺技术团队欢迎点赞收藏⭐留言文末获取源码联系方式查看下方微信号获取联系方式承接各种定制系统精彩系列推荐精彩专栏推荐订阅不然下次找不到哟Java毕设项目精品实战案例《1000套》感兴趣的可以先收藏起来，还有大家在毕设选题，项目以及论文编写等相关问题都可以给我留言咨询，希望帮助更多的人文章目录基
【K8s】专题十一：Kubernetes 集群证书过期处理方法行者Sun1989 Kubernetes kubernetes 云原生容器
本文内容均来自个人笔记并重新梳理，如有错误欢迎指正！如果对您有帮助，烦请点赞、关注、转发、订阅专栏！专栏订阅入口Linux专栏|Docker专栏|Kubernetes专栏往期精彩文章【Docker】（全网首发）KylinV10下MySQL容器内存占用异常的解决方法【Docker】（全网首发）KylinV10下MySQL容器内存占用异常的解决方法（续）【Docker】MySQL源码构建Docker镜
Go编程语言前景怎么样？参加培训好就业吗 QFdongdong
Go语言专门针对多处理器系统应用程序的编程进行了优化，使用Go编译的程序可以媲美C或C++代码的速度，而且更加安全、支持并行进程。不仅可以开发web,可以开发底层，目前知乎就是用golang开发。区块链首选语言就是go,以-太坊，超级账本都是基于go语言，还有go语言版本的btcd.Go的目标是希望提升现有编程语言对程序库等依赖性(dependency)的管理，这些软件元素会被应用程序反复调用。由
【华为OD技术面】 - 考到的Lettcode手撕算法代码真题目录算法大师华为od 算法
华为OD面试真题精选专栏：华为OD面试真题精选目录:2024华为OD面试手撕代码真题目录以及八股文真题目录文章目录华为OD面试真题精选目录目录题目备注1052.爱生气的书店老板2024-4LCR058.我的日程安排表I技术二面
【C#生态园】深度剖析：C#嵌入式开发工具大揭秘 friklogff C#生态园 c#开发语言
C#嵌入式开发：全面了解六大框架与库前言随着物联网和嵌入式系统的快速发展，越来越多的开发者开始关注使用C#语言进行嵌入式开发。本文将介绍几种用于C#的嵌入式开发框架和相关库，以及它们的核心功能、安装配置方法和API概览，帮助读者了解并选择适合自己项目的工具和资源。欢迎订阅专栏：C#生态园文章目录C#嵌入式开发：全面了解六大框架与库前言1.nanoFramework：一个用于C#的嵌入式开发框架1.
区块链～我的念夜未央0075460
世界上最快的速度不是光，不是电，而是我们的「念」。一念起，万水千山；一念灭，沧海桑田。念起念灭当随缘，切莫执迷。执念区块链
在日本找到好工作的3个正确姿势日本就职那些事
来日本快一年零八个月了，这段时间因为学业繁重偷懒，怕分散注意力，就很少出现在公众面前。最近已经学有所成手痒的不行，已经感觉到：再不写东西跟你分享，就会到生病的境地，所以决定为了防病于犯病之前，坚持写作，就像我坚持运动一样。前段时间有位知乎专栏读者朋友说要来日本生活，希望我给点建议，这么宏大的人生理想问题，怪小女无能，不能完美地给出标准答案（谁能给出标准答案我甘愿拜他为师）。不过说真的，只有自己踏出
【华为OD机试真题 python】输出指定字母在字符串的中的索引【2022 Q4 | 100分】无痕de泪华为OD机试真题 python 输出指定字母在字符串的中的索引字符串华为od python
前言《华为OD笔试真题python》专栏含华为OD机试真题、华为面试题、牛客网华为专栏真题。如果您正在准备华为的面试，或者华为od的机会，有任何想了解的可以私信我进行交流。我会尽可能的给一些建议，和帮您解答！PS：文中答案仅供参考，不能照抄哦■题目描述【输出指定字母在字符串的中的索引】给定一个字符串，把字符串按照大写在前小写在后排序，输出排好后的第K个字母在原来字符串的索引。相同字母输出第一个出现
时间买卖 ziworeborn
以下为《通往财富自由之路》专栏中，关于时间买卖的笔记摘要。如果把一个人比作一个公司的话，刚开始我们的商业模式只能单份出售自己的时间。在这个阶段，升级个人商业模式的核心只有一个，提高我们的单位时间售价。在这个阶段，大多数人会做出最终被证明不明智的选择，把自己的付出与自己的单位时间售价直接挂钩，于是，开始不由自主地采用两个简单粗暴的方式提高自己的单位时间售价：磨洋工、喊高价。然而，长期来看，这其实是不
以太坊DApp开发指南 Kirn
DApp架构设计DApp架构.png如上图，DApp的架构我们可以简单分为以上三种类型：轻钱包模式、重钱包模式和兼容模式。轻钱包模式轻钱包模式下我们需要有一个开放HttpRPC协议的节点与钱包通信，这个节点可以是任意链上的节点。轻钱包通常会作为一个浏览器插件存在，插件在运行时会自动注入Web3框架，DApp可以通过Web3与区块链节点通信。当DApp只是单纯的获取数据时是不需要钱包介入的，但是当D
【数字化供应链】数字化供应链架构、全景管理、全流程贯通方案数字化建设方案数字化转型数据治理主数据数据仓库供应链数字仓储智慧物流智慧仓储物流园区架构微服务数据挖掘大数据人工智能
原文《数字化供应链架构、全景管理、全流程贯通方案》PPT格式。主要从供应链管理全景、智慧供应链建设总体目标、供应链总体业务流程、供应链总体功能架构、供应链总体技术架构、供应链全流程贯通、供应链全领域管理、供应链数据数据分析、供应链决策中台等进行建设。本文仅对主要内容进行介绍。来源网络公开渠道，旨在交流学习，如有侵权联系速删，更多参考公众号：优享智库基于先进IT技术、大数据能力、物联网应用、区块链平
区块链私有链new qis_qis 区块链区块链以太坊数字货币
{“config”:{“chainld”:666,“homesteadBlock”:0,“eip150Block”:0,“eip150Hash”:“0x0000000000000000000000000000000000000000000000000000000000000000”,“eip155Block”:0,“eip158Block”:0,“byzantiumBlock”:0,“consta
区块链私有链 qis_qis 区块链区块链以太坊数字货币
{"config":{"chainld":666,"homesteadBlock":0,"eip150Block":0,"eip150Hash":"0x0000000000000000000000000000000000000000000000000000000000000000","eip155Block":0,"eip158Block":0,"byzantiumBlock":0,"consta
Day25_0.1基础学习MATLAB学习小技巧总结（25）——四维图形的可视化非常规定义M 0.1基础学习MATLAB 学习 matlab 开发语言 SIMULINK 数学建模
利用空闲时间把碎片化的MATLAB知识重新系统的学习一遍，为了在这个过程中加深印象，也为了能够有所足迹，我会把自己的学习总结发在专栏中，以便学习交流。参考书目：1、《MATLAB基础教程(第三版)(薛山)》2、《MATLABR2020a完全自学一本通》之前的章节都是基础的数据运算用法，对于功课来说更加重要的内容是建模、绘图、观察数据趋势，接下来我会结合自己的使用经验，来为大家分享绘图、建模使用的小
IBM 中国研发部裁员风暴，IT 行业何去何从？青云交 java学习教学 IBM 裁员 IT 产业人才发展产业未来自主创新全球格局职业发展裁员风暴中国研发部
亲爱的朋友们，热烈欢迎你们来到青云交的博客！能与你们在此邂逅，我满心欢喜，深感无比荣幸。在这个瞬息万变的时代，我们每个人都在苦苦追寻一处能让心灵安然栖息的港湾。而我的博客，正是这样一个温暖美好的所在。在这里，你们不仅能够收获既富有趣味又极为实用的内容知识，还可以毫无拘束地畅所欲言，尽情分享自己独特的见解。我真诚地期待着你们的到来，愿我们能在这片小小的天地里共同成长，共同进步。本博客的精华专栏：Ja
分享100个最新免费的高匿HTTP代理IP mcj8089 代理IP 代理服务器匿名代理免费代理IP 最新代理IP
推荐两个代理IP网站： 1. 全网代理IP：http://proxy.goubanjia.com/ 2. 敲代码免费IP：http://ip.qiaodm.com/ 120.198.243.130:80,中国/广东省 58.251.78.71:8088,中国/广东省 183.207.228.22:83,中国/
mysql高级特性之数据分区 annan211 java 数据结构 mongodb 分区 mysql
mysql高级特性 1 以存储引擎的角度分析，分区表和物理表没有区别。是按照一定的规则将数据分别存储的逻辑设计。器底层是由多个物理字表组成。 2 分区的原理分区表由多个相关的底层表实现，这些底层表也是由句柄对象表示，所以我们可以直接访问各个分区。存储引擎管理分区的各个底层表和管理普通表一样(所有底层表都必须使用相同的存储引擎)，分区表的索引只是
JS采用正则表达式简单获取URL地址栏参数 chiangfai js 地址栏参数获取
GetUrlParam:function GetUrlParam(param){ var reg = new RegExp("(^|&)"+ param +"=([^&]*)(&|$)"); var r = window.location.search.substr(1).match(reg); if(r!=null
怎样将数据表拷贝到powerdesigner (本地数据库表) Array_06 powerDesigner
================================================== 1、打开PowerDesigner12，在菜单中按照如下方式进行操作 file->Reverse Engineer->DataBase 点击后，弹出 New Physical Data Model 的对话框 2、在General选项卡中 Model name:模板名字，自
logbackのhelloworld 飞翔的马甲日志 logback
一、概述 1.日志是啥？当我是个逗比的时候我是这么理解的：log.debug()代替了system.out.print(); 当我项目工作时，以为是一堆得.log文件。这两天项目发布新版本，比较轻松，决定好好地研究下日志以及logback。传送门1：日志的作用与方法： http://www.infoq.com/cn/articles/why-and-how-log 上面的作
新浪微博爬虫模拟登陆随意而生新浪微博
转载自：http://hi.baidu.com/erliang20088/item/251db4b040b8ce58ba0e1235 近来由于毕设需要，重新修改了新浪微博爬虫废了不少劲，希望下边的总结能够帮助后来的同学们。现行版的模拟登陆与以前相比，最大的改动在于cookie获取时候的模拟url的请求
synchronized 香水浓 java thread
Java语言的关键字，可用来给对象和方法或者代码块加锁，当它锁定一个方法或者一个代码块的时候，同一时刻最多只有一个线程执行这段代码。当两个并发线程访问同一个对象object中的这个加锁同步代码块时，一个时间内只能有一个线程得到执行。另一个线程必须等待当前线程执行完这个代码块以后才能执行该代码块。然而，当一个线程访问object的一个加锁代码块时，另一个线程仍然
maven 简单实用教程 AdyZhang maven
1. Maven介绍 1.1. 简介 java编写的用于构建系统的自动化工具。目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时需要区分版本。 1.2. Maven资源见官方网站；The 5 minute test，官方简易入门文档；Getting Started Tutorial，官方入门文档；Build Coo
Android 通过 intent传值获得null aijuans android
我在通过intent 获得传递兑现过的时候报错，空指针,我是getMap方法进行传值，代码如下 1 2 3 4 5 6 7 8 9 public void getMap(View view){ Intent i =
apache 做代理报如下错误：The proxy server received an invalid response from an upstream baalwolf response
网站配置是apache＋tomcat,tomcat没有报错，apache报错是： The proxy server received an invalid response from an upstream server. The proxy server could not handle the request GET /. Reason: Error reading fr
Tomcat6 内存和线程配置 BigBird2012 tomcat6
1、修改启动时内存参数、并指定JVM时区（在windows server 2008 下时间少了8个小时）在Tomcat上运行j2ee项目代码时，经常会出现内存溢出的情况，解决办法是在系统参数中增加系统参数： window下，在catalina.bat最前面 set JAVA_OPTS=-XX:PermSize=64M -XX:MaxPermSize=128m -Xms5
Karam与TDD bijian1013 Karam TDD
一.TDD 测试驱动开发（Test-Driven Development,TDD）是一种敏捷（AGILE）开发方法论，它把开发流程倒转了过来，在进行代码实现之前，首先保证编写测试用例，从而用测试来驱动开发（而不是把测试作为一项验证工具来使用）。 TDD的原则很简单： a.只有当某个
[Zookeeper学习笔记之七]Zookeeper源代码分析之Zookeeper.States bit1129 zookeeper
public enum States { CONNECTING, //Zookeeper服务器不可用，客户端处于尝试链接状态 ASSOCIATING, //？？？ CONNECTED, //链接建立，可以与Zookeeper服务器正常通信 CONNECTEDREADONLY, //处于只读状态的链接状态，只读模式可以在
【Scala十四】Scala核心八：闭包 bit1129 scala
Free variable A free variable of an expression is a variable that’s used inside the expression but not defined inside the expression. For instance, in the function literal expression (x: Int) => (x
android发送json并解析返回json ronin47 android
package com.http.test; import org.apache.http.HttpResponse; import org.apache.http.HttpStatus; import org.apache.http.client.HttpClient; import org.apache.http.client.methods.HttpGet; import
一份IT实习生的总结 brotherlamp PHP php资料 php教程 php培训 php视频
今天突然发现在不知不觉中自己已经实习了 3 个月了，现在可能不算是真正意义上的实习吧，因为现在自己才大三，在这边撸代码的同时还要考虑到学校的功课跟期末考试。让我震惊的是，我完全想不到在这 3 个月里我到底学到了什么，这是一件多么悲催的事情啊。同时我对我应该 get 到什么新技能也很迷茫。所以今晚还是总结下把，让自己在接下来的实习生活有更加明确的方向。最后感谢工作室给我们几个人这个机会让我们提前出来
据说是2012年10月人人网校招的一道笔试题-给出一个重物重量为X,另外提供的小砝码重量分别为1，3，9。。。3^N。将重物放到天平左侧，问在两边如何添加砝码 bylijinnan java
public class ScalesBalance { /** * 题目： * 给出一个重物重量为X,另外提供的小砝码重量分别为1，3，9。。。3^N。（假设N无限大，但一种重量的砝码只有一个） * 将重物放到天平左侧，问在两边如何添加砝码使两边平衡 * * 分析： * 三进制 * 我们约定括号表示里面的数是三进制，例如 47=(1202
dom4j最常用最简单的方法 chiangfai dom4j
要使用dom4j读写XML文档,需要先下载dom4j包,dom4j官方网站在 http://www.dom4j.org/目前最新dom4j包下载地址:http://nchc.dl.sourceforge.net/sourceforge/dom4j/dom4j-1.6.1.zip 解开后有两个包,仅操作XML文档的话把dom4j-1.6.1.jar加入工程就可以了,如果需要使用XPath的话还需要
简单HBase笔记 chenchao051 hbase
一、Client-side write buffer 客户端缓存请求描述：可以缓存客户端的请求，以此来减少RPC的次数，但是缓存只是被存在一个ArrayList中，所以多线程访问时不安全的。可以使用getWriteBuffer()方法来取得客户端缓存中的数据。默认关闭。二、Scan的Caching 描述： next( )方法请求一行就要使用一次RPC,即使
mysqldump导出时出现when doing LOCK TABLES daizj mysql mysqdump 导数据
　　执行　mysqldump -uxxx -pxxx -hxxx -Pxxxx database tablename > tablename.sql　导出表时，会报 mysqldump: Got error: 1044: Access denied for user 'xxx'@'xxx' to database 'xxx' when doing LOCK TABLES 解决
CSS渲染原理 dcj3sjt126com Web
从事Web前端开发的人都与CSS打交道很多，有的人也许不知道css是怎么去工作的，写出来的css浏览器是怎么样去解析的呢？当这个成为我们提高css水平的一个瓶颈时，是否应该多了解一下呢？一、浏览器的发展与CSS
《阿甘正传》台词 dcj3sjt126com
Part Ⅰ: 《阿甘正传》Forrest Gump经典中英文对白 Forrest: Hello! My names Forrest. Forrest Gump. You wanna Chocolate? I could eat about a million and a half othese. My momma always said life was like a box ochocol
Java处理JSON dyy_gusi json
Json在数据传输中很好用，原因是JSON 比 XML 更小、更快，更易解析。在Java程序中，如何使用处理JSON，现在有很多工具可以处理，比较流行常用的是google的gson和alibaba的fastjson，具体使用如下： 1、读取json然后处理 class ReadJSON { public static void main(String[] args)
win7下nginx和php的配置 geeksun nginx
1. 安装包准备 nginx : 从nginx.org下载nginx-1.8.0.zip php：从php.net下载php-5.6.10-Win32-VC11-x64.zip， php是免安装文件。 RunHiddenConsole: 用于隐藏命令行窗口 2. 配置 # java用8080端口做应用服务器，nginx反向代理到这个端口即可 p
基于2.8版本redis配置文件中文解释 hongtoushizi redis
转载自： http://wangwei007.blog.51cto.com/68019/1548167 在Redis中直接启动redis-server服务时, 采用的是默认的配置文件。采用redis-server xxx.conf 这样的方式可以按照指定的配置文件来运行Redis服务。下面是Redis2.8.9的配置文
第五章常用Lua开发库3-模板渲染 jinnianshilongnian nginx lua
动态web网页开发是Web开发中一个常见的场景，比如像京东商品详情页，其页面逻辑是非常复杂的，需要使用模板技术来实现。而Lua中也有许多模板引擎，如目前我在使用的lua-resty-template，可以渲染很复杂的页面，借助LuaJIT其性能也是可以接受的。如果学习过JavaEE中的servlet和JSP的话，应该知道JSP模板最终会被翻译成Servlet来执行；而lua-r
JZSearch大数据搜索引擎颠覆者 JavaScript
系统简介：大数据的特点有四个层面：第一，数据体量巨大。从TB级别，跃升到PB级别；第二，数据类型繁多。网络日志、视频、图片、地理位置信息等等。第三，价值密度低。以视频为例，连续不间断监控过程中，可能有用的数据仅仅有一两秒。第四，处理速度快。最后这一点也是和传统的数据挖掘技术有着本质的不同。业界将其归纳为4个“V”——Volume，Variety，Value，Velocity。大数据搜索引
10招让你成为杰出的Java程序员 pda158 java 编程框架
如果你是一个热衷于技术的 Java 程序员，那么下面的 10 个要点可以让你在众多 Java 开发人员中脱颖而出。　　 1. 拥有扎实的基础和深刻理解 OO 原则　　对于 Java 程序员，深刻理解 Object Oriented Programming（面向对象编程）这一概念是必须的。没有 OOPS 的坚实基础，就领会不了像 Java 这些面向对象编程语言
tomcat之oracle连接池配置小网客 oracle
tomcat版本7.0 配置oracle连接池方式：修改tomcat的server.xml配置文件： <GlobalNamingResources> <Resource name="utermdatasource" auth="Container" type="javax.sql.DataSou
Oracle 分页算法汇总 vipbooks oracle sql 算法 .net
这是我找到的一些关于Oracle分页的算法，大家那里还有没有其他好的算法没？我们大家一起分享一下！ -- Oracle 分页算法一 select * from ( select page.*,rownum rn from (select * from help) page -- 20 = (currentPag