USDT API

交易创建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