WHC RPC业务解析
2018-07-18 本文已影响31人
路之遥_其漫漫_
WormHole RPC的处理流程
RPC 的业务整理
| name | callfunction | param | return value |
|---|---|---|---|
listblocktransactions_MP |
whc_listblocktransactions |
指定的块高度 | 列出指定块号的区块，包含的所有omni交易的哈希列表 |
whc_listpendingtransactions |
whc_listpendingtransactions |
可选的过滤地址 | 列出系统中还在交易池的所有/过滤地址相关的omni详细信息列表 |
whc_getpayload |
whc_getpayload |
交易哈希 | 返回指定交易的omni数据结果，对于非omni交易，抛异常 |
getsto_MP |
whc_getsto |
指定的空投交易哈希 | |
getcrowdsale_MP |
whc_getcrowdsale |
参1：众筹资产ID，参2：可选，是否获取参与者的详细信息 | 返回指定众筹资产的详细信息；对于非众筹的资产，直接报错 |
getgrants_MP |
whc_getgrants |
管理资产的ID | 返回管理资产的所有信息，包括增发和销毁的历史数据。 |
getproperty_MP |
whc_getproperty |
资产ID | 返回资产的所有基础信息 |
whc_createpayload_issuancefixed |
whc_createpayload_issuancefixed |
参1:生态体系；参2: Token类型；参3: 是否为派生资产; 参4: 资产的自定义类别; 参5: 资产的子类别；参6: 资产的名称；参7: 资产的官网；参8: 新资产的描述数据；参9：发行的资产总金额 | omni协议序列化后的数据 |
whc_createpayload_issuancecrowdsale |
whc_createpayload_issuancecrowdsale |
前8个参数，与上述相同；参9: 期望参与者使用的Token；参10: 期望资产与众筹资产的兑换比例；参11: 众筹的截止时间；参12: 参与者的早鸟奖励； 参13: 按参与者购买的数量，授予发行者代币的比例 | omni协议序列化后的数据 |
whc_createpayload_issuancemanaged |
whc_createpayload_issuancemanaged |
该RPC8个参数，与上述前8个参数意义相同 | omni协议序列化后的数据 |
whc_createpayload_burnbch |
whc_createpayload_burnbch |
无 | 创建基础货币的载荷数据 |
whc_createpayload_simplesend |
whc_createpayload_simplesend |
参1: 资产ID； 参2: 转账的Token数量 | 创建发送货币的omni载荷数据 |
whc_createpayload_grant |
whc_createpayload_grant |
参1:增发的资产ID；参2:增发的金额；参3:增发的原因(可选) | omni协议序列化后的数据 |
whc_createpayload_revoke |
whc_createpayload_revoke |
参1:销毁的资产ID；参2:销毁的金额；参3:销毁的原因(可选) | omni协议序列化后的数据 |
whc_createpayload_sto |
whc_createpayload_sto |
参1: 将要进行空投的资产ID；参2: 进行空投的金额；参3: 给哪种资产的持有人进行空投 | omni协议序列化后的数据 |
whc_createpayload_sendall |
whc_createpayload_sendall |
参数1:资产的生态 | omni协议序列化后的数据 |
whc_createpayload_changeissuer |
whc_createpayload_changeissuer |
参1:资产ID | omni协议序列化后的数据 |
whc_createrawtx_input |
whc_createrawtx_input |
向参1所在的交易添加一个交易输入；参1: 16进制的未签名交易(可以传空字符串); 参2:txid; 参3:输出索引 | 添加交易输入后的未签名交易的16进制数据 |
whc_createrawtx_reference |
whc_createrawtx_reference |
向参1所在的交易添加一个输出；参1: 16进制的未签名交易(可以传空字符串)；参2: 输出的目的地址；参3: 指定的输出金额(可选) | 添加交易输出后的未签名交易的16进制数据 |
whc_createrawtx_opreturn |
whc_createrawtx_opreturn |
添加一个omni C类交易输出至参1所在的交易；参1: 16进制的未签名交易(可以传空字符串)； 参2: 将要添加至输出的C类载荷数据 | 添加交易输出后的未签名交易的16进制数据 |
whc_createrawtx_change |
whc_createrawtx_change |
添加一个输出，一般用来添加一个找零输出；参1:未签名的交易；参2:该交易所使用的交易输入；参3: 添加输出的锁定脚本；参4: 参1交易期望的交易费；参5: 该找零输出期望插入的位置； | 添加交易输出后的未签名交易的16进制数据 |
whc_burnbchgetwhc |
whc_burnbchgetwhc |
参1:燃烧的BCH金额；参2:多余的赎回资金地址(可选) | 生成的获取WHC的交易哈希 |
whc_send |
whc_send |
参1:发送者地址；参2:接收者地址；参3:要发送的资产ID；参4:发送的Token数量；参5:多余的sh | 生成的转账交易哈希 |
whc_sendall |
whc_sendall |
参1:发送者地址；参2:接收者地址；参3:生态体系(强制为1) | 生成的转账交易哈希 |
whc_sendrawtx |
whc_sendrawtx |
注意:本RPC不可以用来操作燃烧BCH获取WHC。参1:发送者地址；参2:wormhole协议载荷数据；参3:接收者地址；参4:赎回BCH的地址；参5:给接收者地址的金额 | 生成的wormhole交易的ID |
whc_sendissuancecrowdsale |
whc_sendissuancecrowdsale |
与上述whc_createpayload_issuancecrowdsale参数列表相同 |
生成的创建众筹资产的交易哈希 |
whc_sendissuancefixed |
whc_sendissuancefixed |
与上述whc_createpayload_issuancefixed参数列表相同 |
生成的创建固定资产的交易哈希 |
whc_sendissuancemanaged |
whc_sendissuancemanaged |
与上述whc_createpayload_issuancefixed参数列表相同 |
生成的创建可管理资产的交易哈希 |
whc_sendchangeissuer |
whc_sendchangeissuer |
参1:原资产的发行者；参2:将拥有该资产的所有者；参3:转移的资产ID | 生成的转移资产所有者的交易哈希 |
whc_sendclosecrowdsale |
whc_sendclosecrowdsale |
参1:资产的发行者； 参2:资产ID | 生成的关闭众筹的交易哈希 |
whc_sendgrant |
whc_sendgrant |
参1:资产的发行者；参2:给指定的地址增发金额；参3:资产ID；参4:增发的金额；参5:增发原因(可选) | 生成的增发交易的哈希 |
whc_sendrevoke |
whc_sendrevoke |
参1:资产的发行者；参2:资产ID；参3:销毁的金额；参4:销毁原因(可选) | 生成的销毁资金交易哈希 |
whc_sendsto |
whc_sendsto |
参1:空投发行人的地址；参2:空投的资产ID；参3:空投的金额；参4:赎回的BCH的地址(可选)；参5:给某种资产的持有人进行空投(可选) | 生成的空投交易哈希 |
RPC的调用流程
燃烧BCH，获取基础货币RPC调用流程
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 创建输出，向指定的燃烧地址打币：
wormholed-cli whc_createrawtx_reference - 创建燃烧BCH的omni载荷数据：
wormholed-cli whc_createpayload_burnbch - 创建输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
转币
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 创建发送Token的载荷数据：
wormholed-cli whc_createpayload_simplesend - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 创建输出，将Token转入该地址：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
转移所有的资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 创建发送Token的载荷数据：
wormholed-cli whc_createpayload_sendall - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference（这步可以省略） - 创建输出，将Token转入该地址：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
创建固定数量的Token资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建固定资产的载荷数据：
wormholed-cli whc_createpayload_issuancefixed - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference
结果：此时创建新资产会在 第一个交易输入的地址上(即：在第一步引入)。 - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
创建众筹资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建众筹资产的载荷数据：
wormholed-cli whc_createpayload_issuancecrowdsale - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference
结果：此时创建新资产会在 第一个交易输入的地址上(即：在第一步引入)。 - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
关闭众筹资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建众筹资产的载荷数据：
wormholed-cli whc_createpayload_closecrowdsale - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
创建可管理资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建可管理资产的载荷数据：
wormholed-cli whc_createpayload_issuancemanaged - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference
结果：此时创建新资产会在 第一个交易输入的地址上(即：在第一步引入)。 - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
增发资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建可管理资产的载荷数据：
wormholed-cli whc_createpayload_grant - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
销毁资产
- 添加交易输入：
wormholed-cli whc_createrawtx_input - 生成创建可管理资产的载荷数据：
wormholed-cli whc_createpayload_revoke - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
进行空投
- 添加交易输入：
wormholed-cli whc_createrawtx_input(注意：第一个输入必须含有足够的空投资产) - 生成创建可管理资产的载荷数据：
wormholed-cli whc_createpayload_sto - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
更改资产发行者
- 添加交易输入：
wormholed-cli whc_createrawtx_input(注意：第一个输入必须为资产的发行地址) - 生成创建可管理资产的载荷数据：
wormholed-cli whc_createpayload_changeissuer - 创建交易输出，将创建的omni载荷数据添加进交易输出：
wormholed-cli whc_createrawtx_opreturn - 创建输出，进行找零：
wormholed-cli whc_createrawtx_reference - 创建资产接收者输出：
wormholed-cli whc_createrawtx_reference - 对创建的交易进行签名：
wormholed-cli signrawtransaction - 发送交易：
wormholed-cli sendrawtransaction
查询使用的RPC
wormholed-cli getrawtransaction "txid": 获取指定交易哈希的16进制交易数据
wormholed-cli decoderawtransaction "rawtx": 对获取到的16进制数据进行解码
wormholed-cli signrawtransaction "rawtx": 对原始交易进行签名
wormholed-cli sendrawtransaction "rawtx": 发送签名后的交易
wormholed-cli listunspent (成熟度0, 1 ...): 列出当前钱包中可以使用的所有资金
wormholed-cli whc_gettransaction "txid": 获取omni交易的解析
wormholed-cli whc_getbalance "address" propertyID: 获取指定地址指定资产的余额
wormholed-cli getproperty_MP propertyID: 列写omni系统中指定资产的基础信息
wormholed-cli listblocktransactions_MP height: 列出某个块高度含有的所有omni交易
wormholed-cli whc_listpendingtransactions: 列出当前节点的交易池中所有未确认的omni交易
wormholed-cli whc_getpayload "txid": 返回指定omni交易的载荷数据
wormholed-cli getsto_MP "txid" "*": 列出指定空投交易的所有参与者，以及金额信息
wormholed-cli getgrants_MP propertyID: 返回指定的管理资产的增发/销毁信息
最终版的测试交易
- 获取基础货币：53d2d2701bdca225ae4486e72854369a09499a0555c22ef1936c02924fe901cb
- 转账：d9dd78f140691dd946175696bd312dfcfac4c5cc5c4f5eb1143dfde0db83c25e
- 转账：2e66312a5bc2c5f984ae53f382b43ac070ff8fd3450ca6d162495b43bbbf3e90
- 空投：9bb8eb45e5b3ba4059c38409a225216f3aaae990f07d2541f1c09571862b99d2
- 创建可管理的资产：b85ffb2d38339b4432cd8dfe50861e05376665f1ffe08c4824dea934aadb20e1
- 创建众筹交易：
b0d2300119ec08d0876c96351a74d0f9048394f9ce1099fb300d854490cff14b
82951edd8f37e75aa6c398ae6e3fdcae184f56680e73e870637c0122b26029c2 - 关闭众筹交易：
