交易创建Transaction creation
用于创建事务的RPC可用于创建和广播Omni Protocol事务。
结果返回广播事务的哈希值。
omni_send
创建并广播简单的发送事务
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 接受者的地址 |
propertyid | String | 是 | 要发送的令牌的标识 |
amount | String | 是 | 发送金额 |
redeemaddress | String | 否 | 一个可以用来处理交易的地址(默认的发送者) |
referenceamount | String | 否 | 发送给接收方的比特币数量(默认为最小) |
示例:
$ omnicore-cli "omni_send" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 1 "100.0"
结果:
"hash" // 十六进制编码的事务哈希
omni_senddexsell
在传统的分布式OMNI/BTC交换机上放置、更新或取消销售报价。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
propertyidforsale | Uint | 是 | 要列出待售标记的标识符(OMNI必须为1或TOMNI为2) |
amountforsale | String | 是 | 出售的令牌数量 |
amountdesired | String | 是 | 所需比特币的数量 |
paymentwindow | String | 是 | 买方在成功接受订单后必须支付的时间限制 |
minacceptfee | String | 是 | 买主必须支付的最低采矿费 |
action | String | 是 | 采取行动(新报价1,更新2,取消3) |
示例:
$ omnicore-cli "omni_senddexsell" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 1 "1.5" "0.75" 25 "0.0005" 1
结果:
"hash" // 十六进制编码的事务哈希
omni_senddexaccept
创建并广播指定令牌和金额的接受要约。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 卖方的地址 |
propertyid | String | 是 | 要购买的令牌的标识 |
amount | String | 是 | 接受金额 |
override | String | 是 | 覆盖最低接受费和付款窗口检查(谨慎使用!) |
示例:
$ omnicore-cli "omni_senddexaccept"
"35URq1NN3xL6GeRKUP6vzaQVcxoJiiJKd8" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 1 "15.0"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendissuancecrowdsale
创建新的令牌作为众筹。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前任令牌的标识符(0表示新的众筹) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 新令牌的描述(可以是“”) |
propertyiddesired | Uint | 是 | 有资格参加众筹的令牌的标识符 |
tokensperunit | String | 是 | 每个单位在众筹中投入的代币数量 |
deadline | Uint | 是 | 作为Unix时间戳的众筹截止日期 |
earlybonus | Uint | 是 | 参与者每周百分比的早期奖励 |
issuerpercentage | Uint | 是 | 将授予发行人的一定比例的代币 |
示例:
$ omnicore-cli "omni_sendissuancecrowdsale""3JYd75REX3HXn1vAU83YuGfmiPXW7BpYXo" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" "" 2 "100" 1483228800 30 2
结果:
"hash" // 十六进制编码的事务哈希
omni_sendissuancefixed
创建具有固定供应的新令牌。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前驱令牌的标识符(0表示新的众筹) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 新令牌的描述(可以是“”) |
amount | String | 是 | 要创建的令牌数量 |
示例:
$ omnicore-cli "omni_sendissuancefixed" "3Ck2kEGLJtZw9ENj2tameMCtS3HB7uRar3" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" "" "1000000"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendissuancemanaged
创建具有可管理供应的新令牌。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前驱令牌的标识符(0表示新的众筹) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 新令牌的描述(可以是“”) |
示例:
$ omnicore-cli "omni_sendissuancemanaged""3HsJvhr9qzgRe3ss97b1QHs38rmaLExLcH" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" ""
结果:
"hash" // 十六进制编码的事务哈希
omni_sendsto
创建并广播发送给所有者的事务。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
previousid | Uint | 是 | 要分发的令牌的标识符 |
amount | String | 是 | 分配金额 |
redeemaddress | String | 否 | 可以花费交易粉尘的地址(默认情况下为发件人) |
distributionproperty | Uint | 否 | 要分配给的财产持有人的标识符 |
示例:
$ omnicore-cli "omni_sendsto""32Z3tJccZuqQZ4PhJR2hxHC3tjgjA8cbqz" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 3 "5000"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendgrant
颁发或授予新的托管令牌单位。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 令牌的接收者(默认情况下,发件人可以是“”) |
propertyid | Uint | 是 | 要授予的令牌的标识符 |
amount | String | 是 | 要创建的令牌数量 |
memo | String | 否 | 附加到此事务的文本注释(默认情况下没有) |
示例:
$ omnicore-cli "omni_sendgrant" "3HsJvhr9qzgRe3ss97b1QHs38rmaLExLcH" "" 51 "7000"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendrevoke
撤销托管令牌的单位。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
propertyid | Uint | 是 | 要撤销的令牌的标识符 |
amount | String | 是 | 要撤销的令牌数量 |
memo | String | 否 | 附加到此事务的文本注释(默认情况下没有) |
示例:
$ omnicore-cli "omni_sendrevoke" "3HsJvhr9qzgRe3ss97b1QHs38rmaLExLcH" "" 51 "100"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendclosecrowdsale
手动关闭一个众筹
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 关闭众筹的地址 |
propertyid | Uint | 是 | 要关闭的众筹的标识符 |
示例:
$ omnicore-cli "omni_sendclosecrowdsale" "3JYd75REX3HXn1vAU83YuGfmiPXW7BpYXo" 70
结果:
"hash" // 十六进制编码的事务哈希
omni_sendtrade
在分布式令牌交换上放置交易要约。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 与之交易的地址 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
amountforsale | String | 是 | 要列出待售的代币数量 |
propertiddesired | Uint | 是 | 交换所需的令牌标识符 |
amountdesired | String | 否 | 交换所需的令牌数量 |
示例:
$ omnicore-cli "omni_sendtrade" "3BydPiSLPP3DR5cf726hDQ89fpqWLxPKLR" 31 "250.0" 1 "10.0"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendcanceltradesbyprice
以指定价格取消分布式令牌交换的优惠。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 与之交易的地址 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
amountforsale | String | 是 | 要列出待售的代币数量 |
propertiddesired | Uint | 是 | 交换所需的令牌标识符 |
amountdesired | String | 否 | 交换所需的令牌数量 |
示例:
$ omnicore-cli "omni_sendcanceltradesbyprice" "3BydPiSLPP3DR5cf726hDQ89fpqWLxPKLR" 31 "100.0" 1 "5.0"
结果:
"hash" // 十六进制编码的事务哈希
omni_sendcanceltradesbypair
取消使用给定货币对的分布式令牌交换的所有优惠。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 与之交易的地址 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
propertiddesired | Uint | 是 | 交换所需的令牌标识符 |
示例:
$ omnicore-cli "omni_sendcanceltradesbypair" "3BydPiSLPP3DR5cf726hDQ89fpqWLxPKLR" 1 31
结果:
"hash" // 十六进制编码的事务哈希
omni_sendcancelalltrades
取消分布式令牌交换上的所有优惠。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 与之交易的地址 |
ecosystem | Uint | 是 | 取消要约的生态系统(主要生态系统为1,测试生态系统为2) |
示例:
$ omnicore-cli "omni_sendcancelalltrades" "3BydPiSLPP3DR5cf726hDQ89fpqWLxPKLR" 1
结果:
"hash" // 十六进制编码的事务哈希
omni_sendchangeissuer
在给定令牌的记录上更改发行者。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 与令牌关联的地址 |
toaddress | String | 是 | 将管理控制权转移到的地址 |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_sendchangeissuer" "1ARjWDkZ7kT9fwjPrjcQyvbXDkEySzKHwu" "3HTHRxu3aSDV4deakjC7VmsiUp7c6dfbvs" 3
结果:
"hash" // 十六进制编码的事务哈希
omni_sendall
将给定生态系统中的所有可用令牌转移给收件人。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 接受者的地址 |
ecosystem | Uint | 是 | 要发送的令牌生态系统(主要生态系统为1,测试生态系统为2) |
redeemaddress | String | 否 | 可以花费交易粉尘的地址(默认情况下为发件人) |
referenceamount | String | 否 | 发送到接收方的比特币金额(默认为最小) |
示例:
$ omnicore-cli "omni_sendall" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 2
结果:
"hash" // 十六进制编码的事务哈希
omni_sendenablefreezing
为集中管理的财产启用地址冻结。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址(必须是托管财产的发行人) |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_sendenablefreezing" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" 2
结果:
"hash" // 十六进制编码的事务哈希
omni_senddisablefreezing
禁用集中管理的属性的地址冻结。
重要说明:禁用冻结属性将UNFREEZE该属性的所有冻结地址!
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址(必须是托管财产的发行人) |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_senddisablefreezing" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" 2
结果:
"hash" // 十六进制编码的事务哈希
omni_sendfreeze
冻结集中管理令牌的地址。
注意:只有颁发者可以冻结令牌,并且仅当令牌属于启用了冻结选项的托管类型时才会冻结。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址(必须是已启用冻结的托管属性的颁发者) |
toaddress | String | 是 | 要冻结的地址 |
propertyid | Uint | 是 | 要冻结的令牌的标识符 |
amount | String | 是 | 冻结金额(注意:目前未使用的冻结地址不能交易财产) |
示例:
$ omnicore-cli "omni_sendfreeze" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" "3HTHRxu3aSDV4deakjC7VmsiUp7c6dfbvs" 2 1000
结果:
"hash" // 十六进制编码的事务哈希
omni_sendunfreeze
取消冻结集中管理令牌的地址。
注意:只有发卡行可以解冻令牌
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址(必须是已启用冻结的托管属性的颁发者) |
toaddress | String | 是 | 解冻的地址 |
propertyid | Uint | 是 | 要解冻的令牌的标识符 |
amount | String | 是 | 解冻量(注意:目前尚未使用) |
示例:
$ omnicore-cli "omni_sendunfreeze" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" "3HTHRxu3aSDV4deakjC7VmsiUp7c6dfbvs" 2 1000
结果:
"hash" // 十六进制编码的事务哈希
omni_sendrawtx
广播原始Omni Layer事务。
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
rawtransaction | String | 是 | 十六进制编码的原始事务 |
referenceaddress | String | 是 | 引用地址(默认情况下没有) |
redeemaddress | String | 否 | 可以花费交易粉尘的地址(默认情况下为发件人) |
referenceamount | String | 否 | 发送到接收方的比特币金额(默认为最小) |
示例:
$ omnicore-cli "omni_sendrawtx" "1MCHESTptvd2LnNp7wmr2sGTpRomteAkq8" "000000000000000100000000017d7840" "1EqTta1Rt8ixAA32DuC29oukbsSWU62qAV"
结果:
"hash" // 十六进制编码的事务哈希
omni_funded_send
创建并发送资助的简单发送交易。
来自发件人的所有比特币都被消费,如果缺少比特币,则从指定的费用来源获取。更改将发送到费用来源!
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 接收者的地址 |
propertyid | Uint | 是 | 要发送的令牌的标识符 |
amount | String | 是 | 发送金额 |
feeaddress | String | 否 | 如果需要,用于支付费用的地址 |
示例:
$ omnicore-cli "omni_funded_send" "1DFa5bT6KMEr6ta29QJouainsjaNBsJQhH" "15cWrfuvMxyxGst2FisrQcvcpF48x6sXoH" 1 "100.0" "15Jhzz4omEXEyFKbdcccJwuVPea5LqsKM1"
结果:
"hash" // 十六进制编码的事务哈希
omni_funded_sendall
创建并发送将给定生态系统中的所有可用令牌传输给收件人的事务。
来自发件人的所有比特币都被消费,如果缺少比特币,则从指定的费用来源获取。更改将发送到费用来源!
参数:
名称 | 类型 | 必填 | 描述 |
fromaddress | String | 是 | 要发送的地址 |
toaddress | String | 是 | 接收者的地址 |
ecosystem | Uint | 是 | 要发送的令牌生态系统(主要生态系统为1,测试生态系统为2) |
feeaddress | String | 否 | 如果需要,用于支付费用的地址 |
示例:
$ omnicore-cli "omni_funded_sendall" "1DFa5bT6KMEr6ta29QJouainsjaNBsJQhH" "15cWrfuvMxyxGst2FisrQcvcpF48x6sXoH" 1 "15Jhzz4omEXEyFKbdcccJwuVPea5LqsKM1"
结果:
"hash" // 十六进制编码的事务哈希
数据检索Data retrieval
用于数据检索的RPC可用于获取有关Omni生态系统状态的信息。
omni_getinfo
返回客户端和协议的各种状态信息。
参数:
没有参数
示例:
$ omnicore-cli "omni_getinfo"
结果:
Result:
{
"omnicoreversion_int" : xxxxxxx, //(编号)客户端版本为整数
"omnicoreversion" : "x.x.x.x-xxx", //(字符串)客户端版本
"mastercoreversion" : "x.x.x.x-xxx", //(字符串)客户端版本(已弃用)
"bitcoincoreversion" : "x.x.x", //比特币核心版
"commitinfo" : "xxxxxxx", //构建提交标识符
"block" : nnnnnn, //(number)最后处理的块的索引
"blocktime" : nnnnnnnnnn, //(number)最后处理的块的时间戳
"blocktransactions" : nnnn, //(number)在最后处理的块中找到的Omni事务
"totaltransactions" : nnnnnnnn, //(编号)全部处理的Omni交易
"alerts" : [ //(JSON对象数组)活动协议警报(如果有)
{
"alerttype" : n //(数字)警报类型为整数
"alerttype" : "xxx" //(字符串)警报类型(可以是”alertexpiringbyblock”,”alertexpiringbyblocktime”,”alertexpiringbyclientversion”或”error”)
"alertexpiry" : "nnnnnnnnnn" //(字符串)到期标准(可以指块高,时间戳或客户端版本)
"alertmessage" : "xxx" //(字符串)有关警报的信息
},
...
]
}
omni_getbalance
返回给定地址和属性的令牌余额。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 是 | 地址 |
propertyid | Uint | 是 | 属性标识符 |
示例:
$ omnicore-cli "omni_getbalance", "1EXoDusjGwvnjZUyKkxZ4UHEf77z6A5S4P" 1
结果:
{
"balance" : "n.nnnnnnnn", //(字符串)地址的可用余额
"reserved" : "n.nnnnnnnn", //(字符串)出售要约和接受保留的金额
"frozen" : "n.nnnnnnnn" //(字符串)发行人冻结的金额(仅适用于托管属性)
}
omni_getallbalancesforid
返回给定货币或属性标识符的令牌余额列表。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 属性标识符 |
示例:
$ omnicore-cli "omni_getallbalancesforid" 1
结果:
[ //(JSON对象数组)
{
"address" : "address", //(字符串)地址
"balance" : "n.nnnnnnnn", //(字符串)地址的可用余额
"reserved" : "n.nnnnnnnn", //(字符串)出售要约和接受保留的金额
"frozen" : "n.nnnnnnnn" //(字符串)发行人冻结的金额(仅适用于托管属性)
},
...
]
omni_getallbalancesforaddress
返回给定地址的所有令牌余额的列表。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 是 | 地址 |
示例:
$ omnicore-cli "omni_getallbalancesforaddress" "1EXoDusjGwvnjZUyKkxZ4UHEf77z6A5S4P"
结果:
[ //(JSON对象数组)
{
"propertyid" : n, //(数字)属性标识符
"name" : "name", //(字符串)属性的名称
"balance" : "n.nnnnnnnn", //(字符串)地址的可用余额
"reserved" : "n.nnnnnnnn", //(字符串)出售要约和接受保留的金额
"frozen" : "n.nnnnnnnn" //(字符串)发行人冻结的金额(仅适用于托管属性)
},
...
]
omni_getwalletbalances
返回整个钱包的总令牌余额列表。
参数:
名称 | 类型 | 必填 | 描述 |
includewatchonly | Boolean | 否 | 包括监视地址的余额(默认值:false) |
示例:
$ omnicore-cli "omni_getwalletbalances"
结果:
[ //(JSON对象数组)
{
"propertyid" : n, //(数字)属性标识符
"name" : "name", //(字符串)令牌的名称
"balance" : "n.nnnnnnnn", //(字符串)令牌的总可用余额
"reserved" : "n.nnnnnnnn" //(字符串)出售要约和接受保留的总金额
"frozen" : "n.nnnnnnnn" //(字符串)发行人冻结的总金额(仅适用于托管属性)
},
...
]
omni_getwalletaddressbalances
返回每个钱包地址的所有令牌余额列表。
参数:
名称 | 类型 | 必填 | 描述 |
includewatchonly | Boolean | 否 | 包括监视地址的余额(默认值:false) |
示例:
$ omnicore-cli "omni_getwalletaddressbalances"
结果:
[ //(JSON对象数组)
{
"address" : "address", //(字符串)链接到以下余额的地址
"balances" :
[
{
"propertyid" : n, //(数字)属性标识符
"name" : "name", //(字符串)令牌的名称
"balance" : "n.nnnnnnnn", //(字符串)令牌的可用余额
"reserved" : "n.nnnnnnnn" //(字符串)出售要约和接受保留的金额
"frozen" : "n.nnnnnnnn" //(字符串)发行人冻结的金额(仅适用于托管属性)
},
...
]
},
...
]
omni_gettransaction
获取有关Omni事务的详细信息。
参数:
名称 | 类型 | 必填 | 描述 |
txid | String | 是 | 要查找的事务的哈希值 |
示例:
$ omnicore-cli "omni_gettransaction" "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
结果:
{
"txid" : "hash", //(字符串)事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)发件人的比特币地址
"referenceaddress" : "address", //(字符串)用作参考的比特币地址(如果有的话)
"ismine" : true|false, //(boolean)事务是否涉及钱包中的地址
"confirmations" : nnnnnnnnnn, //(编号)交易确认的数量
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费用
"blocktime" : nnnnnnnnnn, //(数字)包含事务的块的时间戳
"valid" : true|false, //(布尔值)事务是否有效
"positioninblock" : n, //(数字)块内交易的头寸(指数)
"version" : n, //(编号)交易版本
"type_int" : n, //(编号)交易类型为数字
"type" : "type", //(字符串)事务类型为字符串
[...] //(混合)其他事务类型特定属性
}
omni_listtransactions
列出钱包事务,可选地按地址和块边界过滤。
参数:
名称 | 类型 | 必填 | 描述 |
txid | String | 否 | 地址过滤器(默认值:“*”) |
count | Uint | 否 | 最多显示n个交易(默认值:10) |
skip | Uint | 否 | 跳过前n个事务(默认值:0) |
startblock | Uint | 否 | 第一个块开始搜索(默认值:0) |
endblock | Uint | 否 | 要包含在搜索中的最后一个块(默认值:999999999) |
示例:
$ omnicore-cli "omni_listtransactions"
结果:
[ //(JSON对象数组)
{
"txid" : "hash", //(字符串)事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)发件人的比特币地址
"referenceaddress" : "address", //(字符串)用作参考的比特币地址(如果有的话)
"ismine" : true|false, //(boolean)事务是否涉及钱包中的地址
"confirmations" : nnnnnnnnnn, //(编号)交易确认的数量
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费用
"blocktime" : nnnnnnnnnn, //(数字)包含事务的块的时间戳
"valid" : true|false, //(布尔值)事务是否有效
"positioninblock" : n, //(数字)块内交易的头寸(指数)
"version" : n, //(编号)交易版本
"type_int" : n, //(编号)交易类型为数字
"type" : "type", //(字符串)事务类型为字符串
[...] //(混合)其他交易类型特定属性
},
...
]
omni_listblocktransactions
列出块中的所有Omni事务。
参数:
名称 | 类型 | 必填 | 描述 |
index | Uint | 否 | 块高度或块索引 |
示例:
$ omnicore-cli "omni_listblocktransactions" 279007
结果:
[ //(字符串数组)
"hash", //(字符串)事务的哈希
...
]
omni_listpendingtransactions
返回内存池中未决的Omni事务列表。
注意:挂起事务的有效性是不确定的,并且内存池的状态可能随时发生变化。建议在确认后检查交易,待处理的交易应视为无效。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 否 | 按地址过滤结果(默认值:“”表示无过滤器) |
示例:
$ omnicore-cli "omni_listpendingtransactions"
结果:
[ //(JSON对象数组)
{
"txid" : "hash", //(字符串)事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)发件人的比特币地址
"referenceaddress" : "address", //(字符串)用作参考的比特币地址(如果有的话)
"ismine" : true|false, //(boolean)事务是否涉及钱包中的地址
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费用
"version" : n, //(编号)交易版本
"type_int" : n, //(编号)交易类型为数字
"type" : "type", //(字符串)事务类型为字符串
[...] //(混合)其他事务类型特定属性
},
...
]
omni_getactivedexsells
返回分布式交换机上当前有效的商品。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 否 | 地址过滤器(默认:包括任何) |
示例:
$ omnicore-cli "omni_getactivedexsells"
结果:
[ //(JSON对象数组)
{
"txid" : "hash", //(字符串)此优惠的交易哈希
"propertyid" : n, //(数字)待售代币的标识符
"seller" : "address", //(字符串)卖家的比特币地址
"amountavailable" : "n.nnnnnnnn", //(字符串)仍然列出待售且当前可用的令牌数量
"bitcoindesired" : "n.nnnnnnnn", //(字符串)交换所需的比特币数量
"unitprice" : "n.nnnnnnnn" , //(字符串)单价(BTC /令牌)
"timelimit" : nn, //(数字)买方在成功接受后必须支付的时间限制
"minimumfee" : "n.nnnnnnnn", //(字符串)买方为接受此优惠而必须支付的最低采矿费
"amountaccepted" : "n.nnnnnnnn", //(字符串)当前为待处理“接受”订单保留的令牌数
"accepts": [ //(JSON对象数组)挂起的“接受”订单列表
{
"buyer" : "address", //(字符串)买方的比特币地址
"block" : nnnnnn, //(number)包含“accept”顺序的块的索引
"blocksleft" : nn, //(数字)剩余的块数
"amount" : "n.nnnnnnnn" //(字符串)接受和保留的令牌数量
"amounttopay" : "n.nnnnnnnn" //(字符串)比特币的金额需要最终确定交易
},
...
]
},
...
]
omni_listproperties
列出所有令牌或智能属性。
参数:
没有.
示例:
$ omnicore-cli "omni_listproperties"
结果:
[ //(JSON对象数组)
{
"propertyid" : n, //(数字)令牌的标识符
"name" : "name", //(字符串)标记的名称
"category" : "category", //(字符串)用于标记的类别
"subcategory" : "subcategory", //(字符串)用于标记的子类别
"data" : "information", //(字符串)附加信息或描述
"url" : "uri", //(字符串)一个URI,例如指向一个网站
"divisible" : true|false //(boolean)令牌是否可以整除
},
...
]
omni_getproperty
返回有关要查找的标记或智能属性的详细信息。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 令牌或财产的标识符 |
示例:
$ omnicore-cli "omni_getproperty" 3
结果:
{
"propertyid" : n, //(数字)标识符
"name" : "name", //(字符串)标记的名称
"category" : "category", //(字符串)用于标记的类别
"subcategory" : "subcategory", //(字符串)用于标记的子类别
"data" : "information", //(字符串)附加信息或描述
"url" : "uri", //(字符串)一个URI,例如指向一个网站
"divisible" : true|false, //(boolean)令牌是否可以整除
"issuer" : "address", //(字符串)记录中发行人的比特币地址
"creationtxid" : "hash", //(字符串)十六进制编码的创建事务哈希
"fixedissuance" : true|false, //(布尔值)令牌供应是否已修复
"managedissuance" : true|false, //(布尔值)令牌供应是否由发行者管理
"freezingenabled" : true|false, //(boolean)是否为属性启用了冻结(仅限托管属性)
"totaltokens" : "n.nnnnnnnn" //(字符串)存在的令牌总数
}
omni_getactivecrowdsales
列出当前活跃的众包。
参数:
没有.
示例:
$ omnicore-cli "omni_getactivecrowdsales"
结果:
[ //(JSON对象数组)
{
"propertyid" : n, //(数字)众筹的标识符
"name" : "name", //(字符串)通过crowdsale发布的令牌的名称
"issuer" : "address", //(字符串)记录中发行人的比特币地址
"propertyiddesired" : n, //(数字)有资格参与crowdsale的令牌的标识符
"tokensperunit" : "n.nnnnnnnn", //(字符串)每个单位在众筹中投入的代币数量
"earlybonus" : n, //(数字)参与者每周百分比的早期奖励
"percenttoissuer" : n, //(数字)将授予发行人的令牌的百分比
"starttime" : nnnnnnnnnn, //(编号)作为Unix时间戳的crowdsale的开始时间
"deadline" : nnnnnnnnnn //(编号)作为Unix时间戳的众筹截止日期
},
...
]
omni_getcrowdsale
返回有关众筹的信息。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 众筹的标识符 |
verbose | Boolean | 否 | list crowdsale参与者(默认值:false) |
示例:
$ omnicore-cli "omni_getcrowdsale" 3 true
结果:
{
"propertyid" : n, //(数字)众筹的标识符
"name" : "name", //(字符串)通过crowdsale发布的令牌的名称
"active" : true|false, //(boolean)crowdsale是否仍处于活动状态
"issuer" : "address", //(字符串)记录中发行人的比特币地址
"propertyiddesired" : n, //(数字)有资格参与crowdsale的令牌的标识符
"tokensperunit" : "n.nnnnnnnn", //(字符串)每个单位在众筹中投入的代币数量
"earlybonus" : n, //(数字)参与者每周百分比的早期奖励
"percenttoissuer" : n, //(数字)将授予发行人的令牌的百分比
"starttime" : nnnnnnnnnn, //(编号)作为Unix时间戳的crowdsale的开始时间
"deadline" : nnnnnnnnnn, //(编号)作为Unix时间戳的众筹截止日期
"amountraised" : "n.nnnnnnnn", //(字符串)参与者投入的代币数量
"tokensissued" : "n.nnnnnnnn", //(字符串)通过crowdsale发布的令牌总数
"issuerbonustokens" : "n.nnnnnnnn", //(字符串)授予发行人的代币金额作为奖金
"addedissuertokens" : "n.nnnnnnnn", //(字符串)尚未发出的发行人奖金代币金额
"closedearly" : true|false, //(boolean)crowdsale是否提前结束(如果不活动)
"maxtokens" : true|false, //(布尔值)由于达到最大值的限制,众筹是否提前结束。可发行的令牌(如果不活跃)
"endedtime" : nnnnnnnnnn, //(数字)众筹结束的时间(如果提前关闭)
"closetx" : "hash", //(字符串)关闭crowdsale的事务的十六进制编码哈希值(如果手动关闭)
"participanttransactions": [ //(JSON对象数组)一个crowdsale参与列表(如果verbose = true)
{
"txid" : "hash", //(字符串)参与事务的十六进制编码哈希
"amountsent" : "n.nnnnnnnn", //(字符串)参与者投入的代币数量
"participanttokens" : "n.nnnnnnnn", //(字符串)授予参与者的令牌
"issuertokens" : "n.nnnnnnnn" //(字符串)作为奖金授予发行人的代币
},
...
]
}
omni_getgrants
返回有关托管令牌的已授权和已撤销单元的信息。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要查找的托管标记的标识符 |
示例:
$ omnicore-cli "omni_getgrants" 31
结果:
{
"propertyid" : n, //(数字)托管令牌的标识符
"name" : "name", //(字符串)标记的名称
"issuer" : "address", //(字符串)记录中发行人的比特币地址
"creationtxid" : "hash", //(字符串)十六进制编码的创建事务哈希
"totaltokens" : "n.nnnnnnnn", //(字符串)存在的令牌总数
"issuances": [ //(JSON对象数组)已授予和已撤销令牌的列表
{
"txid" : "hash", //(字符串)授予令牌的事务的哈希
"grant" : "n.nnnnnnnn" //(字符串)此事务授予的令牌数
},
{
"txid" : "hash", //(字符串)撤销令牌的事务的哈希值
"grant" : "n.nnnnnnnn" //(字符串)此事务撤销的令牌数
},
...
]
}
omni_getsto
获取发送给所有者交易的信息和收件人。
参数:
名称 | 类型 | 必填 | 描述 |
txid | String | 是 | 要查找的事务的哈希值 |
recipientfilter | String | 否 | 收件人的过滤器(默认为钱包,所有人为“*”) |
示例:
$ omnicore-cli "omni_getsto" "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d" "*"
结果:
{
"txid" : "hash", //(字符串)事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)发件人的比特币地址
"ismine" : true|false, //(boolean)事务是否在钱包中包含一个地址
"confirmations" : nnnnnnnnnn, //(编号)交易确认的数量
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费
"blocktime" : nnnnnnnnnn, //(数字)包含事务的块的时间戳
"valid" : true|false, //(boolean)事务是否有效
"positioninblock" : n, //(数字)块内事务的位置(索引)
"version" : n, //(数字)事务版本
"type_int" : n, //(编号)事务类型为数字
"type" : "type", //(字符串)事务类型为字符串
"propertyid" : n, //(数字)发送的令牌的标识符
"divisible" : true|false, //(boolean)发送的令牌是否可被整除
"amount" : "n.nnnnnnnn", //(字符串)发送给所有者的令牌数量
"totalstofee" : "n.nnnnnnnn", //(字符串)发件人支付的费用,由OMNI或TOMNI提名
"recipients": [ //(JSON对象数组)收件人列表
{
"address" : "address", //(字符串)收件人的比特币地址
"amount" : "n.nnnnnnnn" //(字符串)发送给此收件人的令牌数
},
...
]
}
omni_gettrade
获取有关分布式令牌交换的订单的详细信息和交易匹配。
参数:
名称 | 类型 | 必填 | 描述 |
txid | String | 是 | 要查找的顺序的哈希值 |
示例:
$ omnicore-cli "omni_gettrade" "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
结果:
{
"txid" : "hash", //(字符串)订单事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)交易者的比特币地址
"ismine" : true|false, //(boolean)订单是否在钱包中包含地址
"confirmations" : nnnnnnnnnn, //(编号)交易确认的数量
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费
"blocktime" : nnnnnnnnnn, //(数字)包含事务的块的时间戳
"valid" : true|false, //(boolean)事务是否有效
"positioninblock" : n, //(数字)块内事务的位置(索引)
"version" : n, //(数字)事务版本
"type_int" : n, //(编号)事务类型为数字
"type" : "type", //(字符串)事务类型为字符串
"propertyidforsale" : n, //(数字)要出售的令牌的标识符
"propertyidforsaleisdivisible" : true|false, //(boolean)待售代币是否可分割
"amountforsale" : "n.nnnnnnnn", //(字符串)最初提供的令牌数量
"propertyiddesired" : n, //(数字)交换所需的令牌的标识符
"propertyiddesiredisdivisible" : true|false, //(boolean)所需的标记是否可被整除
"amountdesired" : "n.nnnnnnnn", //(字符串)最初需要的令牌数量
"unitprice" : "n.nnnnnnnnnnn..." //(字符串)单价(显示在所需的属性中)
"status" : "status" //(字符串)订单的状态(“打开”,“取消”,“填充”,......)
"canceltxid" : "hash", //(字符串)取消订单的交易的哈希值(如果已取消)
"matches": [ //(JSON对象数组)匹配订单和已执行交易的列表
{
"txid" : "hash", //(字符串)与之匹配的事务的哈希值
"block" : nnnnnn, //(数字)包含此事务的块的索引
"address" : "address", //(字符串)另一个交易者的比特币地址
"amountsold" : "n.nnnnnnnn", //(字符串)此交易中出售的代币数量
"amountreceived" : "n.nnnnnnnn" //(字符串)交换的代币数量
},
...
]
}
omni_getorderbook
列出分布式令牌交换上的活动商品。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 按propertyid过滤订单以进行销售 |
propertyid | Uint | 否 | 按期望的属性过滤订单 |
示例:
$ omnicore-cli "omni_getorderbook" 2
结果:
[ //(JSON对象数组)
{
"address" : "address", //(字符串)交易者的比特币地址
"txid" : "hash", //(字符串)订单事务的十六进制编码哈希
"ecosystem" : "main"|"test", //(字符串)订单生成的生态系统(如果“取消生态系统”)
"propertyidforsale" : n, //(数字)要出售的令牌的标识符
"propertyidforsaleisdivisible" : true|false, //(boolean)待售代币是否可分割
"amountforsale" : "n.nnnnnnnn", //(字符串)最初提供的令牌数量
"amountremaining" : "n.nnnnnnnn", //(字符串)仍在出售的令牌数量
"propertyiddesired" : n, //(数字)交换所需的令牌的标识符
"propertyiddesiredisdivisible" : true|false, //(boolean)所需的标记是否可被整除
"amountdesired" : "n.nnnnnnnn", //(字符串)最初需要的令牌数量
"amounttofill" : "n.nnnnnnnn", //(字符串)完全填写要约所需的令牌数量
"action" : n, //(数字)交易的行为:(1)“交易”,(2)“取消价格”,(3)“取消对”,(4)“取消 - 生态系统”
"block" : nnnnnn, //(数字)包含事务的块的索引
"blocktime" : nnnnnnnnnn //(number)包含事务的块的时间戳
},
...
]
omni_gettradehistoryforpair
检索指定市场的分布式令牌交换的交易历史。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 交易对的第一面 |
propertyid | Uint | 是 | 交易对的第二面 |
count | Uint | 否 | 要检索的交易数量(默认值:10) |
示例:
$ omnicore-cli "omni_gettradehistoryforpair" 1 12 500
结果:
[ //(JSON对象数组)
{
"block" : nnnnnn, //(数字)包含交易匹配的块的索引
"unitprice" : "n.nnnnnnnnnnn..." , //(字符串)用于执行此交易的单价(已收/已售)
"inverseprice" : "n.nnnnnnnnnnn...", //(字符串)反向单价(已售出/已收到)
"sellertxid" : "hash", //(字符串)卖方交易的哈希值
"address" : "address", //(字符串)卖家的比特币地址
"amountsold" : "n.nnnnnnnn", //(字符串)此交易中出售的代币数量
"amountreceived" : "n.nnnnnnnn", //(字符串)交换的代币数量
"matchingtxid" : "hash", //(字符串)与之匹配的事务的哈希值
"matchingaddress" : "address" //(字符串)此交易的另一方的比特币地址
},
...
]
omni_gettradehistoryforaddress
检索分布式交换机上所提供地址的订单历史记录。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 是 | 用于检索历史记录的地址 |
count | Uint | 否 | 要检索的订单数量(默认值:10) |
propertyid | Uint | 否 | 按propertyid transacted过滤(默认值:无过滤器) |
示例:
$ omnicore-cli "omni_gettradehistoryforaddress" "1MCHESTptvd2LnNp7wmr2sGTpRomteAkq8"
结果:
[ //(JSON对象数组)
{
"txid" : "hash", //(字符串)订单事务的十六进制编码哈希
"sendingaddress" : "address", //(字符串)交易者的比特币地址
"ismine" : true|false, //(boolean)订单是否在钱包中包含地址
"confirmations" : nnnnnnnnnn, //(编号)交易确认的数量
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费
"blocktime" : nnnnnnnnnn, //(数字)包含事务的块的时间戳
"valid" : true|false, //(boolean)事务是否有效
"positioninblock" : n, //(数字)块内事务的位置(索引)
"version" : n, //(数字)事务版本
"type_int" : n, //(编号)事务类型为数字
"type" : "type", //(字符串)事务类型为字符串
"propertyidforsale" : n, //(数字)要出售的令牌的标识符
"propertyidforsaleisdivisible" : true|false, //(boolean)待售代币是否可分割
"amountforsale" : "n.nnnnnnnn", //(字符串)最初提供的令牌数量
"propertyiddesired" : n, //(数字)交换所需的令牌的标识符
"propertyiddesiredisdivisible" : true|false, //(boolean)所需的标记是否可被整除
"amountdesired" : "n.nnnnnnnn", //(字符串)最初需要的令牌数量
"unitprice" : "n.nnnnnnnnnnn..." //(字符串)单价(显示在所需的属性中)
"status" : "status" //(字符串)订单的状态(“打开”,“取消”,“填充”,......)
"canceltxid" : "hash", //(字符串)取消订单的交易的哈希值(如果已取消)
"matches": [ //(JSON对象数组)匹配订单和已执行交易的列表
{
"txid" : "hash", //(字符串)与之匹配的事务的哈希值
"block" : nnnnnn, //(数字)包含此事务的块的索引
"address" : "address", //(字符串)另一个交易者的比特币地址
"amountsold" : "n.nnnnnnnn", //(字符串)此交易中出售的代币数量
"amountreceived" : "n.nnnnnnnn" //(字符串)交换的代币数量
},
...
]
},
...
]
omni_getactivations
返回待处理和已完成的功能激活。
参数:
没有
示例:
$ omnicore-cli "omni_getactivations"
结果:
{
"pendingactivations": [ //(JSON对象数组)待处理的功能激活列表
{
"featureid" : n, //(数字)功能的ID
"featurename" : "xxxxxxxx", //(字符串)功能的名称
"activationblock" : n, //(数字)将激活该功能的块
"minimumversion" : n //(数字)支持此功能所需的最小客户端版本
},
...
]
"completedactivations": [ //(JSON对象数组)已完成的功能激活列表
{
"featureid" : n, //(数字)功能的ID
"featurename" : "xxxxxxxx", //(字符串)功能的名称
"activationblock" : n, //(数字)将激活该功能的块
"minimumversion" : n //(数字)支持此功能所需的最小客户端版本
},
...
]
}
omni_getpayload
获取Omni事务的有效负载。
参数:
名称 | 类型 | 必填 | 描述 |
txid | String | 是 | 检索有效负载的事务的哈希值 |
示例:
$ omnicore-cli "omni_getactivations" "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
结果:
{
"payload" : "payloadmessage", //(字符串)解码的Omni有效载荷消息
"payloadsize" : n //(数字)有效载荷的大小
}
omni_getseedblocks
返回包含Omni事务的块列表,以便在种子块过滤中使用。
警告:Exodus crowdsale未存储在LevelDB中,因此在块255365之后,目前仅可安全地用于生成种子块。
参数:
名称 | 类型 | 必填 | 描述 |
startblock | Uint | 是 | 寻找Omni交易的第一个区块(包括) |
endblock | Uint | 是 | 查找Omni事务的最后一个块(包括) |
示例:
$ omnicore-cli "omni_getseedblocks" 290000 300000
结果:
[ //(数字数组)种子块列表
nnnnnnn, // 种子块的块高度
...
]
omni_getcurrentconsensushash
返回覆盖当前块状态的共识哈希。
参数:
没有.
示例:
$ omnicore-cli "omni_getcurrentconsensushash"
结果:
{
"block" : nnnnnn, //(数字)此共识哈希适用的块的索引
"blockhash" : "hash", //(字符串)相应块的哈希值
"consensushash" : "hash" //(字符串)块的共识哈希值
}
原始交易Raw transactions
原始事务/有效负载的RPC可用于解码或创建原始Omni事务。
原始交易需要使用“signrawtransaction”进行签名,然后使用“sendrawtransaction”进行广播。
omni_decodetransaction
解码Omni事务。
如果交易的输入不在链中,则必须提供它们,因为交易输入用于识别交易的发送者。
可以提供块高度,其用于确定解析规则。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要解码的原始事务 |
prevtxs | String | 否 | 一个JSON事务输入数组(默认值:无) |
height | Uint | 否 | 解析块高度(默认值:0表示链高) |
prevtxs的格式如下:
[
{
"txid" : "hash", //(字符串,必需)事务哈希
"vout" : n, //(数字,必需)输出数字
"scriptPubKey" : "hex", //(字符串,必需)输出脚本
"value" : n.nnnnnnnn //(number,required)输出值
}
,...
]
示例:
$ omnicore-cli "omni_decodetransaction" "010000000163af14ce6d477e1c793507e32a5b7696288fa89705c0d02a3f66beb3c
5b8afee0100000000ffffffff02ac020000000000004751210261ea979f6a06f9dafe00fb1263ea0aca959875a7073556a088cdfadcd494b3752102a3fd0a8a067e06941e066f78d930bfc47746f097fcd3f7ab27db8ddf37168b6b52ae22020000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288ac00000000"
"[{"txid":"eeafb8c5b3be663f2ad0c00597a88f2896765b2ae30735791c7e476dce14af63","vout":1,
"scriptPubKey":"76a9149084c0bd89289bc025d0264f7f23148fb683d56c88ac","value":0.0001123}]"
结果:
{
"txid" : "hash", //(字符串)事务的十六进制编码哈希
"fee" : "n.nnnnnnnn", //(字符串)比特币的交易费
"sendingaddress" : "address", //(字符串)发件人的比特币地址
"referenceaddress" : "address", //(字符串)用作参考的比特币地址(如果有的话)
"ismine" : true|false, //(boolean)事务是否在钱包中包含一个地址
"version" : n, //(数字)事务版本
"type_int" : n, //(编号)事务类型为数字
"type" : "type", //(字符串)事务类型为字符串
[...] //(混合)其他特定于交易类型的属性
}
omni_createrawtx_opreturn
向事务添加具有C类(op-return)编码的有效负载。
如果未提供原始事务,则会创建新事务。
如果数据编码失败,则不修改事务。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要扩展的原始事务(可以为null) |
payload | String | 是 | 要添加的十六进制编码的有效负载 |
示例:
$ omnicore-cli "omni_createrawtx_opreturn" "01000000000000000000" "00000000000000020000000006dac2c0"
结果:
"rawtx" //(字符串)十六进制编码的修改后的原始事务
omni_createrawtx_multisig
向事务添加具有B类(bare-multisig)编码的有效负载。
如果未提供原始事务,则会创建新事务。
如果数据编码失败,则不修改事务。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要扩展的原始事务(可以为null) |
payload | String | 是 | 要添加的十六进制编码的有效负载 |
seed | String | 是 | 混淆的种子 |
payload | String | 是 | 粉尘赎回的公钥或地址 |
示例:
$ omnicore-cli "omni_createrawtx_multisig" "0100000001a7a9402ecd77f3c9f745793c9ec805bfa2e14b89877581c734c774864247e6f50400000000ffffffff01aa0a0000000000001976a9146d18edfe073d53f84dd491dae1379f8fb0dfe5d488ac00000000""00000000000000020000000000989680"
"1LifmeXYHeUe2qdKWBGVwfbUCMMrwYtoMm" "0252ce4bdd3ce38b4ebbc5a6e1343608230da508ff12d23d85b58c964204c4cef3"
结果:
"rawtx" //(字符串)十六进制编码的修改后的原始事务
omni_createrawtx_input
向事务添加事务输入。
如果未提供原始事务,则会创建新事务。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要扩展的原始事务(可以为null) |
txid | String | 是 | 输入事务的哈希值 |
n | String | 是 | 用作输入的事务输出的索引 |
示例:
$ omnicore-cli "omni_createrawtx_input" "01000000000000000000" "b006729017df05eda586df9ad3f8ccfee5be340aadf88155b784d1fc0e8342ee" 0
结果:
"rawtx" //(字符串)十六进制编码的修改后的原始事务
omni_createrawtx_reference
向事务添加引用输出。
如果未提供原始事务,则会创建新事务。
输出值至少设置为灰尘阈值。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要扩展的原始事务(可以为null) |
destination | String | 是 | 参考地址或目的地 |
amount | Uint | 否 | 可选参考金额(默认为最小) |
示例:
$ omnicore-cli "omni_createrawtx_reference" "0100000001a7a9402ecd77f3c9f745793c9ec805bfa2e14b89877581c734c774864247e6f50400000000ffffffff03aa0a0000000000001976a9146d18edfe073d53f84dd491dae1379f8fb0dfe5d488ac5c0d0000000000004751210252ce4bdd3ce38b4ebbc5a6e1343608230da508ff12d23d85b58c964204c4cef3210294cc195fc096f87d0f813a337ae7e5f961b1c8a18f1f8604a909b3a5121f065b52aeaa0a0000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288ac00000000" "1CE8bBr1dYZRMnpmyYsFEoexa1YoPz2mfB" 0.005
结果:
"rawtx" //(字符串)十六进制编码的修改后的原始事务
omni_createrawtx_change
向事务添加更改输出。
提供的输入不会添加到事务中,而只用于确定更改。假设输入先前已添加,例如通过“createrawtransaction”。
可选地,可以提供一个位置,其中应该插入更改输出,从0开始。如果输出的数量小于位置,则将更改输出添加到结尾。应在参考输出之前插入更改输出,并且默认情况下,更改输出将添加到第一个位置。
如果更改量将被视为灰尘,则不会添加更改输出。
参数:
名称 | 类型 | 必填 | 描述 |
rawtx | String | 是 | 要扩展的原始事务 |
prevtxs | String | 是 | 一个JSON事务输入数组 |
destination | String | 是 | 改变的目的地 |
fee | Uint | 是 | 期望的交易费用 |
position | Uint | 否 | 更改输出的位置(默认:第一个位置) |
prevtxs的格式如下:
[
{
"txid" : "hash", //(字符串,必需)事务哈希
"vout" : n, //(数字,必需)输出数字
"scriptPubKey" : "hex", //(字符串,必需)输出脚本
"value" : n.nnnnnnnn //(number,required)输出值
}
,...
]
示例:
$ omnicore-cli "omni_createrawtx_change" "0100000001b15ee60431ef57ec682790dec5a3c0d83a0c360633ea8308fbf6d5fc10a779670400000000ffffffff025c0d00000000000047512102f3e471222bb57a7d416c82bf81c627bfcd2bdc47f36e763ae69935bba4601ece21021580b888ff56feb27f17f08802ebed26258c23697d6a462d43fc13b565fda2dd52aeaa0a0000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288ac00000000" "[{"txid":"6779a710fcd5f6fb0883ea3306360c3ad8c0a3c5de902768ec57ef3104e65eb1","vout":4,"scriptPubKey":"76a9147b25205fd98d462880a3e5b0541235831ae959e588ac","value":0.00068257}]" "1CE8bBr1dYZRMnpmyYsFEoexa1YoPz2mfB" 0.000035 1
结果:
"rawtx" //(字符串)十六进制编码的修改后的原始事务
omni_createpayload_simplesend
为简单的发送事务创建有效负载。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要发送的令牌的标识符 |
amount | String | 是 | 发送金额 |
示例:
$ omnicore-cli“omni_createpayload_simplesend”1“100.0”
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_sendall
为发送所有事务创建有效负载。
参数:
名称 | 类型 | 必填 | 描述 |
ecosystem | Uint | 是 | 要发送的令牌生态系统(主要生态系统为1,测试生态系统为2) |
示例:
$ omnicore-cli "omni_createpayload_sendall" 2
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_dexsell
创建有效负载以在传统的分布式OMNI / BTC交换机上放置,更新或取消销售要约。
参数:
名称 | 类型 | 必填 | 描述 |
propertyidforsale | Uint | 是 | 要列出待售标记的标识符(OMNI必须为1,TOMNI必须为2) |
amountforsale | String | 是 | 要列出待售的代币数量 |
amountdesired | String | 是 | 所需的比特币数量 |
paymentwindow | Uint | 是 | 在成功接受订单后,买方必须支付的时间限制 |
minacceptfee | String | 是 | 买方为接受报价而必须支付的最低采矿费 |
action | Uint | 是 | 采取的行动(1为新的报价,2为更新“,3为取消) |
示例:
$ omnicore-cli "omni_createpayload_dexsell" 1 "1.5" "0.75" 25 "0.0005" 1
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_dexaccept
为指定的令牌和金额创建接受要约的有效负载。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要购买的令牌的标识符 |
amount | String | 是 | 接受金额 |
示例:
$ omnicore-cli "omni_createpayload_dexaccept" 1 "15.0"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_sto
为发送给所有者事务创建有效负载。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要分发的令牌的标识符 |
amount | String | 是 | 分配金额 |
distributionproperty | Uint | 否 | 要分配给的财产持有人的标识符 |
示例:
$ omnicore-cli "omni_createpayload_sto" 3 "5000"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_issuancefixed
为具有固定供应的新令牌发行创建有效负载。
参数:
名称 | 类型 | 必填 | 描述 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前驱标记的标识符(对新标记使用0) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
amount | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
示例:
$ omnicore-cli "omni_createpayload_issuancefixed" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" "" "1000000"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_issuancecrowdsale
使用crowdsale为新令牌发行创建有效负载。
参数:
名称 | 类型 | 必填 | 描述 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前驱标记的标识符(对新标记使用0) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 新令牌的描述(可以是“”) |
propertyiddesired | Uint | 是 | 有资格参加众筹的令牌的标识符 |
tokensperunit | String | 是 | 每个单位在众筹中投入的代币数量 |
deadline | Uint | 是 | 作为Unix时间戳的众筹截止日期 |
earlybonus | Uint | 是 | 参与者每周百分比的早期奖励 |
issuerpercentage | Uint | 是 | 将授予发行人的一定比例的代币 |
示例:
$ omnicore-cli "omni_createpayload_issuancecrowdsale" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" "" 2 "100" 1483228800 30 2
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_issuancemanaged
为具有可管理供应的新令牌发行创建有效负载。
参数:
名称 | 类型 | 必填 | 描述 |
ecosystem | Uint | 是 | 用于创建令牌的生态系统(1表示主要生态系统,2表示测试生态系统) |
type | Uint | 是 | 要创建的标记的类型:(1表示不可分割的标记,2表示可分割的标记) |
previousid | Uint | 是 | 前驱标记的标识符(对新标记使用0) |
category | String | 是 | 新标记的类别(可以是“”) |
subcategory | String | 是 | 新标记的子类别(可以是“”) |
name | String | 是 | 要创建的新令牌的名称 |
url | String | 是 | 有关新令牌的更多信息的URL(可以是“”) |
data | String | 是 | 新令牌的描述(可以是“”) |
示例:
$ omnicore-cli "omni_createpayload_issuancefixed" 2 1 0 "Companies" "Bitcoin Mining" "Quantum Miner" "" "" "1000000"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_closecrowdsale
创建有效负载以手动关闭众筹。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要关闭的众筹的标识符 |
示例:
$ omnicore-cli "omni_createpayload_closecrowdsale" 70
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_grant
创建有效负载以发布或授予托管令牌的新单元。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要授予的令牌的标识符 |
amount | String | 是 | 要创建的令牌数量 |
memo | String | 否 | 附加到此事务的文本注释(默认情况下没有) |
示例:
$ omnicore-cli "omni_createpayload_grant" 51 "7000"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_revoke
创建有效负载以撤消托管令牌的单位。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要撤销的令牌的标识符 |
amount | String | 是 | 要撤销的令牌数量 |
memo | String | 否 | 附加到此事务的文本注释(默认情况下没有) |
示例:
$ omnicore-cli "omni_createpayload_revoke" 51 "100"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_changeissuer
创建有效负载以在给定令牌的记录上更改发行者。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_createpayload_changeissuer" 3
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_trade
创建有效负载以在分布式令牌交换上放置交易要约。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
amountforsale | String | 是 | 要列出待售的代币数量 |
propertyiddesired | Uint | 是 | 交换所需的令牌标识符 |
amountdesired | String | 是 | 交换所需的令牌数量 |
示例:
$ omnicore-cli "omni_createpayload_trade" 31 "250.0" 1 "10.0"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_canceltradesbyprice
创建有效负载以取消具有指定价格的分布式令牌交换的要约。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
amountforsale | String | 是 | 要列出待售的代币数量 |
propertyiddesired | Uint | 是 | 交换所需的令牌标识符 |
amountdesired | String | 是 | 交换所需的令牌数量 |
示例:
$ omnicore-cli "omni_createpayload_canceltradesbyprice" 31 "100.0" 1 "5.0"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_canceltradesbypair
创建有效负载以取消与给定货币对分布式令牌交换的所有要约。
参数:
名称 | 类型 | 必填 | 描述 |
propertyidforsale | Uint | 是 | 要列出待售的令牌的标识符 |
propertyiddesired | Uint | 是 | 交换所需的令牌标识符 |
示例:
$ omnicore-cli "omni_createpayload_canceltradesbypair" 1 31
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_cancelalltrades
创建有效负载以取消与给定货币对分布式令牌交换的所有要约。
参数:
名称 | 类型 | 必填 | 描述 |
ecosystem | Uint | 是 | 创建有效负载以取消与给定货币对分布式令牌交换的所有要约。取消要约的生态系统(主要生态系统为1,测试生态系统为2)... |
示例:
$ omnicore-cli "omni_createpayload_cancelalltrades" 1
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_enablefreezing
创建有效负载以启用集中管理的属性的地址冻结。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_createpayload_enablefreezing" 3
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_disablefreezing
创建有效负载以禁用集中管理的属性的地址冻结。
重要说明:禁用冻结属性将UNFREEZE该属性的所有冻结地址!
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 令牌的标识符 |
示例:
$ omnicore-cli "omni_createpayload_disablefreezing" 3
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_freeze
创建有效负载以冻结集中管理令牌的地址。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
toaddress | String | 是 | 冻结令牌的地址 |
propertyid | Uint | 是 | 要冻结令牌的属性(必须是托管类型并启用了冻结选项) |
amount | String | 是 | 要冻结的令牌数量(注意:这是未使用的 - 一旦冻结,地址就不能发送任何交易) |
示例:
$ omnicore-cli "omni_createpayload_freeze" "3HTHRxu3aSDV4deakjC7VmsiUp7c6dfbvs" 31 "100"
结果:
"payload" //(字符串)十六进制编码的有效负载
omni_createpayload_unfreeze
创建有效负载以解冻集中管理令牌的地址。
注意:如果服务器未同步,则金额被视为可分,即使令牌可能具有不可分割的单位!
参数:
名称 | 类型 | 必填 | 描述 |
toaddress | String | 是 | 解冻令牌的地址 |
propertyid | Uint | 是 | 解冻令牌的属性(必须是托管类型并启用了冻结选项) |
amount | String | 是 | 要解冻的令牌数量(注意:这是未使用的) |
示例:
$ omnicore-cli "omni_createpayload_unfreeze" "3HTHRxu3aSDV4deakjC7VmsiUp7c6dfbvs" 31 "100"
结果:
"payload" //(字符串)十六进制编码的有效负载
收费制度Fee system
费用系统的RPC可用于获取有关费用系统和费用分配的数据。
omni_getfeecache
获得当前缓存的费用(待分配)。
如果提供了属性ID,则将过滤结果以仅显示此属性ID。如果未提供属性ID,则结果将包含当前已暂停分配的费用的所有属性。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 否 | 要过滤结果的属性的标识符 |
示例:
$ omnicore-cli "omni_getfeecache" 31
结果:
[ //(JSON对象数组)
{
"propertyid" : nnnnnnn, //(数字)属性id
"cachedfees" : "n.nnnnnnnn", //(字符串)此属性的缓存费用金额
},
...
]
omni_getfeetrigger
获得缓存费用的分配金额。
如果提供了属性ID,则将过滤结果以仅显示此属性ID。如果未提供属性ID,则结果将包含所有属性。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 否 | 要过滤结果的属性的标识符 |
示例:
$ omnicore-cli "omni_getfeetrigger" 31
结果:
[ //(JSON对象数组)
{
"propertyid" : nnnnnnn, //(数字)属性id
"feetrigger" : "n.nnnnnnnn", //(字符串)触发分发所需的费用金额
},
...
]
omni_getfeeshare
获得当前发布分配时地址将收到的当前百分比份额。
如果提供了地址,则结果将被过滤以仅显示此地址。如果未提供地址,则结果将被过滤以仅显示钱包地址。如果提供了通配符(“*”),则结果将包含将接收共享的所有地址。
如果提供生态系统,结果将反映该生态系统的费用份额(主要或测试)。如果没有提供生态系统,结果将反映主要生态系统。
参数:
名称 | 类型 | 必填 | 描述 |
address | String | 否 | 过滤结果的地址 |
ecosystem | Uint | 否 | 获取当前百分比费用份额的生态系统(1 =主要,2 =测试) |
示例:
$ omnicore-cli "omni_getfeeshare" "1CE8bBr1dYZRMnpmyYsFEoexa1YoPz2mfB" 1
结果:
[ //(JSON对象数组)
{
"address" : "address" //(字符串)将收取一定费用的地址
"feeshare" : "n.nnnn%", //(字符串)此地址将根据当前状态收取的费用百分比
},
...
]
omni_getfeedistribution
获取过去分配费用的数据。
必须提供分发ID以标识分发以获取数据。
参数:
名称 | 类型 | 必填 | 描述 |
distributionid | String | 是 | 获取数据的分发标识符 |
示例:
$ omnicore-cli "omni_getfeedistribution" 1
结果:
{
"distributionid" : n, //(编号)分发ID
"propertyid" : n, //(数字)分布式令牌的属性id
"block" : n, //(编号)分发发生的块
"amount" : "n.nnnnnnnn", //(字符串)分配的金额
"recipients": [ //(JSON对象数组)收件人列表
{
"address" : "address", //(字符串)收件人的地址
"amount" : "n.nnnnnnnn" //(字符串)收件人收到的费用金额
},
...
]
}
omni_getfeedistributions
获取过去财产费用分配的数据。
必须提供属性ID才能检索过去的分配。
参数:
名称 | 类型 | 必填 | 描述 |
propertyid | Uint | 是 | 要检索过去分发的属性的标识符 |
示例:
$ omnicore-cli "omni_getfeedistributions" 31
结果:
[ //(JSON对象数组)
{
"distributionid" : n, //(编号)分发ID
"propertyid" : n, //(数字)分布式令牌的属性id
"block" : n, //(编号)分发发生的块
"amount" : "n.nnnnnnnn", //(字符串)分配的金额
"recipients": [ //(JSON对象数组)收件人列表
{
"address" : "address", //(字符串)收件人的地址
"amount" : "n.nnnnnnnn" //(字符串)收件人收到的费用金额
},
...
]
},
...
]
配置Configuration
配置的RPC可用于更改Omni Core设置。
omni_setautocommit
设置全局标志,该标志确定是自动提交和广播事务。
参数:
名称 | 类型 | 必填 | 描述 |
flag | Boolean | 是 | 国旗 |
示例:
$ omnicore-cli "omni_setautocommit" false
结果:
true|false //(布尔值)更新的标志状态
不推荐使用的API调用
为确保向后兼容性,对至少一个主要版本保留折旧的RPC。
Omni Core 0.0.10中将替换以下调用,并转发使用旧命令的查询。
send_MP by omni_send
sendtoowners_MP by omni_sendsto
sendrawtx_MP by omni_sendrawtx
getinfo_MP by omni_getinfo
getbalance_MP by omni_getbalance
getallbalancesforid_MP by omni_getallbalancesforid
getallbalancesforaddress_MP by omni_getallbalancesforaddress
gettransaction_MP by omni_gettransaction
listtransactions_MP by omni_listtransactions
listblocktransactions_MP by omni_listblocktransactions
getactivedexsells_MP by omni_getactivedexsells
listproperties_MP by omni_listproperties
getproperty_MP by omni_getproperty
getactivecrowdsales_MP by omni_getactivecrowdsales
getcrowdsale_MP by omni_getcrowdsale
getgrants_MP by omni_getgrants
getsto_MP by omni_getsto or omni_gettransaction