package pb

Get desktop application:
View/edit binary Protocol Buffers messages

Xchain is the main interfaces

• rpc DeployNativeCode (DeployNativeCodeRequest, DeployNativeCodeResponse)

  xchain.proto:183

  Native code deploy interface

  message DeployNativeCodeRequest

  xchain.proto:609

  • optional Header header = 1

  • string bcname = 2

    chain name

  • optional NativeCodeDesc desc = 3

    native code desc

  • bytes code = 4

    code is the bytes of binary code

  • string address = 5

    the address of deployer

  • bytes pubkey = 6

    the public key of deployer

  • bytes sign = 7

    the sign of desc

  message DeployNativeCodeResponse

  xchain.proto:625

  • optional Header header = 1

• rpc DposCandidates (DposCandidatesRequest, DposCandidatesResponse)

  xchain.proto:191

  DposCandidates get all candidates of the tdpos consensus

  message DposCandidatesRequest

  xchain.proto:649

  候选人列表接口

  • optional Header header = 1

  • string bcname = 2

  message DposCandidatesResponse

  xchain.proto:655

  候选人列表返回

  • optional Header header = 1

  • repeated string candidatesInfo = 2

• rpc DposCheckResults (DposCheckResultsRequest, DposCheckResultsResponse)

  xchain.proto:201

  DposCheckResults get check results of a specific term

  message DposCheckResultsRequest

  xchain.proto:732

  查询检票结果记录请求

  • optional Header header = 1

  • string bcname = 2

  • int64 term = 3

  message DposCheckResultsResponse

  xchain.proto:739

  查询检票结果记录返回

  • optional Header header = 1

  • int64 term = 2

  • repeated string checkResult = 3

• rpc DposNominateRecords (DposNominateRecordsRequest, DposNominateRecordsResponse)

  xchain.proto:193

  DposNominateRecords get all records nominated by an user

  message DposNominateRecordsRequest

  xchain.proto:661

  提名者提名记录请求

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  message DposNominateRecordsResponse

  xchain.proto:674

  提名者提名记录返回

  • optional Header header = 1

  • repeated DposNominateInfo nominateRecords = 2

• rpc DposNomineeRecords (DposNomineeRecordsRequest, DposNomineeRecordsResponse)

  xchain.proto:195

  DposNomineeRecords get nominated record of a candidate

  message DposNomineeRecordsRequest

  xchain.proto:680

  候选人被提名记录请求

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  message DposNomineeRecordsResponse

  xchain.proto:687

  候选人被提名记录返回

  • optional Header header = 1

  • string txid = 2

• rpc DposStatus (DposStatusRequest, DposStatusResponse)

  xchain.proto:204

  DposStatus get dpos status

  message DposStatusRequest

  xchain.proto:746

  query dpos consensus current status request

  • optional Header header = 1

  • string bcname = 2

  message DposStatusResponse

  xchain.proto:752

  query dpos consensus current status reply

  • optional Header header = 1

  • optional DposStatus status = 2

• rpc DposVoteRecords (DposVoteRecordsRequest, DposVoteRecordsResponse)

  xchain.proto:197

  DposVoteRecords get all vote records voted by an user

  message DposVoteRecordsRequest

  xchain.proto:693

  选民投票记录请求

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  message DposVoteRecordsResponse

  xchain.proto:706

  选民投票记录返回

  • optional Header header = 1

  • repeated voteRecord voteTxidRecords = 2

    选民投票txid记录

• rpc DposVotedRecords (DposVotedRecordsRequest, DposVotedRecordsResponse)

  xchain.proto:199

  DposVotedRecords get all vote records of a candidate

  message DposVotedRecordsRequest

  xchain.proto:713

  候选人被投票记录请求

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  message DposVotedRecordsResponse

  xchain.proto:725

  候选人被投票记录返回

  • optional Header header = 1

  • repeated votedRecord votedTxidRecords = 2

    候选人被投票的txid记录

• rpc GetAccountByAK (AK2AccountRequest, AK2AccountResponse)

  xchain.proto:207

  GetAccountByAK get account sets contain a specific address

  message AK2AccountRequest

  xchain.proto:893

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  message AK2AccountResponse

  xchain.proto:899

  • optional Header header = 1

  • string bcname = 2

  • repeated string account = 3

• rpc GetAccountContracts (GetAccountContractsRequest, GetAccountContractsResponse)

  xchain.proto:77

  message GetAccountContractsRequest

  xchain.proto:906

  Query account contracts request

  • optional Header header = 1

  • string bcname = 2

  • string account = 3

  message GetAccountContractsResponse

  xchain.proto:913

  Query account contracts response

  • optional Header header = 1

  • repeated ContractStatus contracts_status = 2

• rpc GetBalance (AddressStatus, AddressStatus)

  xchain.proto:95

  GetBalance get balance of an address, Address is required for this

• rpc GetBalanceDetail (AddressBalanceStatus, AddressBalanceStatus)

  xchain.proto:106

  GetFrozenBalance get two kinds of balance 1. Still be frozen of an address 2. Available now of an address Address is required for this

  message AddressBalanceStatus

  xchain.proto:334

  • optional Header header = 1

  • string address = 2

  • repeated TokenFrozenDetails tfds = 3

• rpc GetBlock (BlockID, Block)

  xchain.proto:123

  GetBlock get block by blockid and return if the block in trunk or in branch

  message BlockID

  xchain.proto:289

  • optional Header header = 4

  • string bcname = 1

  • bytes blockid = 2

  • bool need_content = 3

    if need content

    是否需要内容

• rpc GetBlockByHeight (BlockHeight, Block)

  xchain.proto:132

  GetBlockByHeight get block by height and return if the block in trunk or in branch

  message BlockHeight

  xchain.proto:297

  • optional Header header = 3

  • string bcname = 1

  • int64 height = 2

• rpc GetBlockChainStatus (BCStatus, BCStatus)

  xchain.proto:139

• rpc GetBlockChains (CommonIn, BlockChains)

  xchain.proto:147

  Get blockchains query blockchains

  message BlockChains

  xchain.proto:520

  • optional Header header = 1

  • repeated string blockchains = 2

• rpc GetFrozenBalance (AddressStatus, AddressStatus)

  xchain.proto:115

  GetFrozenBalance get balance that still be frozen of an address, Address is required for this

• rpc GetNetURL (CommonIn, RawUrl)

  xchain.proto:163

  GetNetURL return net url

  message RawUrl

  xchain.proto:547

  RawUrl return the node's connect url

  • optional Header header = 1

  • string rawUrl = 2

• rpc GetSystemStatus (CommonIn, SystemsStatusReply)

  xchain.proto:155

  GetSystemStatus query system status

  message SystemsStatusReply

  xchain.proto:541

  • optional Header header = 1

  • optional SystemsStatus systems_status = 2

• rpc NativeCodeStatus (NativeCodeStatusRequest, NativeCodeStatusResponse)

  xchain.proto:185

  Native code status

  message NativeCodeStatusRequest

  xchain.proto:635

  • optional Header header = 1

  • string bcname = 2

  message NativeCodeStatusResponse

  xchain.proto:640

  • optional Header header = 1

  • repeated NativeCodeStatus status = 2

• rpc PostTx (TxStatus, CommonReply)

  xchain.proto:63

  PostTx post Transaction to a node

  message CommonReply

  xchain.proto:303

  • optional Header header = 1

• rpc PreExec (InvokeRPCRequest, InvokeRPCResponse)

  xchain.proto:215

  预执行合约

  message InvokeRPCResponse

  xchain.proto:773

  • optional Header header = 1

  • string bcname = 2

  • optional InvokeResponse response = 3

• rpc PreExecWithSelectUTXO (PreExecWithSelectUTXORequest, PreExecWithSelectUTXOResponse)

  xchain.proto:175

  PreExecWithSelectUTXO preExec & selectUtxo

  message PreExecWithSelectUTXORequest

  xchain.proto:927

  PreExecWithSelectUTXORequest preExec + selectUtxo for request

  • optional Header header = 1

  • string bcname = 2

  • string address = 3

  • int64 totalAmount = 4

  • optional SignatureInfo signInfo = 6

  • bool needLock = 7

  • optional InvokeRPCRequest request = 5

  message PreExecWithSelectUTXOResponse

  xchain.proto:938

  PreExecWithSelectUTXOResponse preExec + selectUtxo for response

  • optional Header header = 1

  • string bcname = 2

  • optional InvokeResponse response = 3

  • optional UtxoOutput utxoOutput = 4

    for preExec & selectUTXO

• rpc QueryACL (AclStatus, AclStatus)

  xchain.proto:70

  message AclStatus

  xchain.proto:857

  查询Acl

  • optional Header header = 1

  • string bcname = 2

  • string accountName = 3

  • string contractName = 4

  • string methodName = 5

  • bool confirmed = 6

  • optional Acl acl = 7

• rpc QueryTx (TxStatus, TxStatus)

  xchain.proto:86

  QueryTx query Transaction by TxStatus, Bcname and Txid are required for this

• rpc SelectUTXO (UtxoInput, UtxoOutput)

  xchain.proto:167

  新的Select utxos接口, 不需要签名，可以支持选择账户的utxo

  message UtxoInput

  xchain.proto:561

  UtxoInput query info to query utxos

  • optional Header header = 1

  • string bcname = 2

    which bcname to select

  • string address = 3

    address to select

  • string publickey = 4

    publickey of the address

  • string totalNeed = 5

    totalNeed refer the total need utxos to select

  • bytes userSign = 7

    userSign of input

  • bool needLock = 8

    need lock

• rpc EndorserCall (EndorserRequest, EndorserResponse)

  xendorser.proto:27

  message EndorserRequest

  xendorser.proto:11

  请求参数

  • optional Header header = 1

  • string RequestName = 2

    请求名(类型)

  • string BcName = 3

    请求链名

  • optional Transaction Fee = 4

    带签名的交易费Tx

  • bytes RequestData = 5

    Json打包的数据

  message EndorserResponse

  xendorser.proto:18

  • optional Header header = 1

  • string ResponseName = 2

  • string EndorserAddress = 3

    背书服务地址

  • optional SignatureInfo EndorserSign = 4

    背书服务签名

  • bytes ResponseData = 5

Acl实际使用的结构

Used in: AclStatus

• optional PermissionModel pm = 1

  采用的权限模型

• map<string, double> aksWeight = 2

  公钥or账户名 -> 权重

• optional AkSets akSets = 3

Used as request type in: Xchain.GetBalance, Xchain.GetFrozenBalance

Used as response type in: Xchain.GetBalance, Xchain.GetFrozenBalance

• optional Header header = 1

• string address = 2

• repeated TokenDetail bcs = 3

AK集的表示方法

Used in: AkSets

• repeated string aks = 1

  一堆公钥

Used in: Acl

• map<string, AkSet> sets = 1

  公钥or账户名集

• string expression = 2

  表达式，一期不支持表达式，默认集合内是and，集合间是or

Used in: Speeds

• map<string, double> BcSpeed = 1

BlockChain status

Used as request type in: Xchain.GetBlockChainStatus

Used as response type in: Xchain.GetBlockChainStatus

Used as field type in: SystemsStatus

• optional Header header = 1

• string bcname = 2

  block name

• optional LedgerMeta meta = 3

  ledger metadata

• optional InternalBlock block = 4

  The information of the longest block

• optional UtxoMeta utxoMeta = 5

  Utox information

• repeated string branchBlockid = 6

  Branch info

• optional Header header = 1

• bool is_trunk_tip = 2

• optional Header header = 1

• repeated TxStatus Txs = 2

Used as response type in: Xchain.GetBlock, Xchain.GetBlockByHeight

• optional Header header = 1

• string bcname = 2

• bytes blockid = 3

• Block.EBlockStatus status = 4

• optional InternalBlock block = 5

Used in: Block

• ERROR = 0

• TRUNK = 1

• BRANCH = 2

• NOEXIST = 3

ChainedBftPhaseMessage is the proposal message of the protocal. In Hotstuff, there are two kinds of messages, "NEW_VIEW_MESSAGE" and "QC_Message". A stable leader can skip this "NEW_VIEW_MESSAGE".

• QCState Type = 1

  Message Type: NEW_VIEW_MESSAGE or QC_MESSAGE

• int64 ViewNumber = 2

  ViewNumber the current view number

• optional QuorumCert ProposalQC = 3

  The new proposal send to other replicas while the

• optional QuorumCert JustifyQC = 4

  JustifyQC is the QC of the leader gathered, send to next leader, while the message type is "NEW_VIEW_MESSAGE"

• bytes MsgDigest = 5

  MsgDigest is the digest of the msgg

• optional SignInfo Signature = 6

  Signature for this msg

ChainedBftVoteMessage is the vote message of the protocal.

• bytes ProposalId = 1

  The id of this message votes for.

• optional SignInfo Signature = 2

  Replica will sign the QCMessage if the QuorumCert if valid.

Used as request type in: Xchain.GetBlockChains, Xchain.GetNetURL, Xchain.GetSystemStatus

• optional Header header = 1

ContractResponse is the response returnd by contract

Used in: InvokeResponse

• int32 status = 1

• string message = 2

• bytes body = 3

Status of a contract

Used in: GetAccountContractsResponse

• string contract_name = 1

• string txid = 2

• bytes desc = 3

• bool is_banned = 4

候选人信息

Used in: DposNominateRecordsResponse

• string candidate = 1

• string txid = 2

Used in: DposStatusResponse

• int64 term = 1

• int64 block_num = 2

• string proposer = 3

• int64 proposer_num = 4

• repeated string checkResult = 5

Used in: UtxoMeta

• int64 cpu_rate = 1

• int64 mem_rate = 2

• int64 disk_rate = 3

• int64 xfee_rate = 4

Used in: Transaction

• bytes hd_public_key = 1

  HDPublickey

• bytes original_hash = 2

  original_hash

Used in: AK2AccountRequest, AK2AccountResponse, AclStatus, AddressBalanceStatus, AddressStatus, BCStatus, BCTipStatus, BatchTxs, Block, BlockChains, BlockHeight, BlockID, CommonIn, CommonReply, DeployNativeCodeRequest, DeployNativeCodeResponse, DposCandidatesRequest, DposCandidatesResponse, DposCheckResultsRequest, DposCheckResultsResponse, DposNominateRecordsRequest, DposNominateRecordsResponse, DposNomineeRecordsRequest, DposNomineeRecordsResponse, DposStatusRequest, DposStatusResponse, DposVoteRecordsRequest, DposVoteRecordsResponse, DposVotedRecordsRequest, DposVotedRecordsResponse, EndorserRequest, EndorserResponse, GetAccountContractsRequest, GetAccountContractsResponse, InvokeRPCRequest, InvokeRPCResponse, NativeCodeStatusRequest, NativeCodeStatusResponse, PreExecWithSelectUTXORequest, PreExecWithSelectUTXOResponse, RawUrl, SystemsStatus, SystemsStatusReply, TxData, TxStatus, UtxoInput, UtxoOutput

• string logid = 1

  如果logid没填写，生成一个

• string from_node = 2

  call rpc client address，客户端可以为空，节点一定要写自己的address

• XChainErrorEnum error = 3

Identity authentication request

Used in: IdentityAuths

• bytes sign = 1

• bytes pubkey = 2

• string addr = 3

• string peerID = 4

• string timestamp = 5

Identity authentication requests

• repeated IdentityAuth auth = 1

The internal block struct

Used in: BCStatus, Block

• int32 version = 1

  block version

• int32 nonce = 2

  Random number used to avoid replay attacks

• bytes blockid = 3

  blockid generate the hash sign of the block used by sha256

• bytes pre_hash = 4

  pre_hash is the parent blockid of the block

• bytes proposer = 5

  The miner id

• bytes sign = 6

  The sign which miner signed: blockid + nonce + timestamp

• bytes pubkey = 7

  The pk of the miner

• bytes merkle_root = 8

  The Merkle Tree root

• int64 height = 9

  The height of the blockchain

• int64 timestamp = 10

  Timestamp of the block

• repeated Transaction transactions = 11

  Transactions of the block, only txid stored on kv, the detail information stored in another table

• int32 tx_count = 12

  The transaction count of the block

• repeated bytes merkle_tree = 13

  所有交易hash的merkle tree

• int64 curTerm = 16

• int64 curBlockNum = 17

• map<string, string> failed_txs = 18

  txid -> failed reason

• int32 targetBits = 19

• optional QuorumCert Justify = 20

  Justify used in chained-bft

• bool in_trunk = 14

  下面的属性会动态变化 If the block is on the trunk

• bytes next_hash = 15

  Next next block which on trunk

Used as request type in: Xchain.PreExec

Used as field type in: PreExecWithSelectUTXORequest

• optional Header header = 1

• string bcname = 2

• repeated InvokeRequest requests = 3

• string initiator = 4

• repeated string auth_require = 5

预执行的请求结构

Used in: InvokeRPCRequest, InvokeResponse, Transaction, UtxoMeta

• string module_name = 1

• string contract_name = 2

• string method_name = 3

• map<string, bytes> args = 4

• repeated ResourceLimit resource_limits = 5

• string amount = 6

  amount is the amount transfer to the contract attention: In one transaction, transfer to only one contract is allowed

预执行的返回结构

Used in: InvokeRPCResponse, PreExecWithSelectUTXOResponse

• repeated TxInputExt inputs = 1

• repeated TxOutputExt outputs = 2

• repeated bytes response = 3

• int64 gas_used = 4

• repeated InvokeRequest requests = 5

• repeated ContractResponse responses = 6

• repeated TxInput utxoInputs = 7

• repeated TxOutput utxoOutputs = 8

Ledger metadata

Used in: BCStatus

• bytes root_blockid = 1

  root block id

• bytes tip_blockid = 2

  tip block id

• int64 trunk_height = 3

  the height of the trunk

Used in: Transaction

• string effective_txid = 1

  txid交易被effective_txid的交易提出可修改区块链的请求

• bool marked = 2

  本交易是否已被修改标记

• int64 effective_height = 3

  txid交易被修改生效的高度

• string public_key = 4

  监管的public key

• string sign = 5

  监管地址对修改的交易id的签名

Used in: DeployNativeCodeRequest, NativeCodeStatus

• string name = 1

  native code name

• string version = 2

  code version

• bytes digest = 3

  digest of binary

• string prevVersion = 4

  the previous verion

• int32 xuperApiVersion = 5

  xuper api version

Used in: NativeCodeStatusResponse

• optional NativeCodeDesc desc = 1

• int32 status = 2

• bool healthy = 3

Used in: Acl

• PermissionRule rule = 1

• double acceptValue = 2

  取决于用哪种rule, 可以表示签名率，签名数或权重阈值

-------- Account and Permission Section --------

Used in: PermissionModel

• NULL = 0

  无权限控制

• SIGN_THRESHOLD = 1

  签名阈值策略

• SIGN_AKSET = 2

  AKSet签名策略

• SIGN_RATE = 3

  签名率策略

• SIGN_SUM = 4

  签名个数策略

• CA_SERVER = 5

  CA服务器鉴权

• COMMUNITY_VOTE = 6

  社区治理

QCSignInfos is the signs of the leader gathered from replicas of a specifically certType. A slice of signs is used at present. TODO @qizheng09: It will be change to Threshold-Signatures after Crypto lib support Threshold-Signatures.

Used in: QuorumCert

• repeated SignInfo QCSignInfos = 1

  QCSignInfos

QCState is the phase of hotstuff

Used in: ChainedBftPhaseMessage, QuorumCert

• NEW_VIEW = 0

• PREPARE = 1

• PRE_COMMIT = 2

• COMMIT = 3

• DECIDE = 4

QuorumCert is a data type that combines a collection of signatures from replicas.

Used in: ChainedBftPhaseMessage, InternalBlock

• bytes ProposalId = 1

  The id of Proposal this QC certified.

• bytes ProposalMsg = 2

  The msg of Proposal this QC certified.

• QCState Type = 3

  The current type of this QC certified. the type contains `NEW_VIEW`, `PREPARE`

• int64 ViewNumber = 4

  The view number of this QC certified.

• optional QCSignInfos SignInfos = 5

  SignInfos is the signs of the leader gathered from replicas of a specifically certType.

Used in: InvokeRequest

• ResourceType type = 1

• int64 limit = 2

Used in: ResourceLimit

• CPU = 0

• MEMORY = 1

• DISK = 2

• XFEE = 3

  the fee used in kernel contract

SignInfo is the signature information of the

Used in: ChainedBftPhaseMessage, ChainedBftVoteMessage, QCSignInfos

• string Address = 1

• string PublicKey = 2

• bytes Sign = 3

签名详情

Used in: EndorserResponse, PreExecWithSelectUTXORequest, Transaction

• string PublicKey = 1

• bytes Sign = 2

Used in: SystemsStatus

• map<string, double> SumSpeeds = 1

• map<string, BCSpeeds> BcSpeeds = 2

Used in: SystemsStatusReply

• optional Header header = 1

• repeated BCStatus bcs_status = 2

• optional Speeds speeds = 3

• repeated string peerUrls = 4

Used in: AddressStatus

• string bcname = 1

• string balance = 2

• XChainErrorEnum error = 3

Used in: TokenFrozenDetails

• string balance = 1

• bool isFrozen = 2

Used in: AddressBalanceStatus

• string bcname = 1

• repeated TokenFrozenDetail tfd = 2

• XChainErrorEnum error = 3

Transaction is the information of the transaction

Used in: EndorserRequest, InternalBlock, TxStatus

• bytes txid = 1

  txid is the id of this transaction

• bytes blockid = 2

  the blockid the transaction belong to

• repeated TxInput tx_inputs = 3

  Transaction input list

• repeated TxOutput tx_outputs = 4

  Transaction output list

• bytes desc = 6

  Transaction description or system contract

• bool coinbase = 7

  Mining rewards

• string nonce = 8

  Random number used to avoid replay attacks

• int64 timestamp = 9

  Timestamp to launch the transaction

• int32 version = 10

  tx format version; tx格式版本号

• bool autogen = 11

  auto generated tx

• repeated TxInputExt tx_inputs_ext = 23

• repeated TxOutputExt tx_outputs_ext = 24

• repeated InvokeRequest contract_requests = 25

• string initiator = 26

  权限系统新增字段 交易发起者, 可以是一个Address或者一个Account

• repeated string auth_require = 27

  交易发起需要被收集签名的AddressURL集合信息，包括用于utxo转账和用于合约调用

• repeated SignatureInfo initiator_signs = 28

  交易发起者对交易元数据签名，签名的内容包括auth_require字段

• repeated SignatureInfo auth_require_signs = 29

  收集到的签名

• int64 received_timestamp = 30

  节点收到tx的时间戳，不参与签名

• optional XuperSignature xuper_sign = 31

  统一签名(支持多重签名/环签名等，与initiator_signs/auth_require_signs不同时使用)

• optional ModifyBlock modify_block = 32

  可修改区块链标记

• optional HDInfo HD_info = 33

  HD加解密相关信息

TransactionStatus is the status of transaction

Used in: TxStatus

• UNDEFINE = 0

  Undefined status

• NOEXIST = 1

  Transaction not exist

• CONFIRM = 2

  Transaction have been confirmed

• FURCATION = 3

  Transaction is on the furcation

• UNCONFIRM = 4

  Transaction have not been confirmed

• optional Header header = 13

• bytes txid = 1

  Transaction id

• string bcname = 2

  Block name

• string from_addr = 3

  Account which start the transaction

• string from_pubkey = 4

  The pk of the account which start the transaction

• string from_scrkey = 5

  The sk of the account which start the transaction

• bytes user_sign = 14

  if user don't want to provide scrkey, he should sign the txdata into user_sign

• repeated TxDataAccount account = 6

  The account list accept tx

• string nonce = 8

  Random number used to avoid replay attacks

• int64 timestamp = 9

  Timestamp to launch the Tx

• bytes desc = 12

• int32 version = 15

  tx version

Used in: TxData

• string address = 1

  地址

• string amount = 2

  金额

• int64 frozen_height = 3

  冻结高度

Transaction input

Used in: InvokeResponse, Transaction

• bytes ref_txid = 1

  The transaction id referenced to

• int32 ref_offset = 2

  The output offset of the transaction referenced to

• bytes from_addr = 5

  The address of the launcher

• bytes amount = 6

  The amount of the transaction

• int64 frozen_height = 7

  Frozen height

扩展输入

Used in: InvokeResponse, Transaction

• string bucket = 1

• bytes key = 2

• bytes ref_txid = 3

• int32 ref_offset = 4

Transaction output

Used in: InvokeResponse, Transaction

• bytes amount = 1

  The amount of the transaction

• bytes to_addr = 2

  The address of the launcher

• int64 frozen_height = 4

  Fronzen height

扩展输出

Used in: InvokeResponse, Transaction

• string bucket = 1

• bytes key = 2

• bytes value = 3

Used as request type in: Xchain.PostTx, Xchain.QueryTx

Used as response type in: Xchain.QueryTx

Used as field type in: BatchTxs

• optional Header header = 1

• string bcname = 2

• bytes txid = 3

• TransactionStatus status = 4

  当前状态

• int64 distance = 5

  离主干末端的距离（如果在主干上)

• optional Transaction tx = 7

Used in: UtxoOutput

• bytes amount = 1

• bytes toAddr = 2

• bytes toPubkey = 3

• bytes refTxid = 4

• int32 refOffset = 5

Utxo metadata

Used in: BCStatus

• bytes latest_blockid = 1

  utxo vm目前执行到的blockid

• repeated string lock_key_list = 2

• string utxo_total = 3

  当前utxo vm上的总资产

• int64 avgDelay = 4

  平均上链延时

• int64 unconfirmTxAmount = 5

  待确认交易量

• int64 max_block_size = 6

  max block size

• repeated InvokeRequest reserved_contracts = 7

  preset contracts

• optional InvokeRequest forbidden_contract = 8

  reset forbidden contract configuration

• int64 new_account_resource_amount = 9

  the resource amount of creating an account

• int64 irreversibleBlockHeight = 10

  当前不可逆区块高度，与utxo对齐

• int64 irreversibleSlideWindow = 11

  当前不可逆区块高度调整窗口

• optional GasPrice gasPrice = 12

UtxoOutput query results

Used as response type in: Xchain.SelectUTXO

Used as field type in: PreExecWithSelectUTXOResponse

• optional Header header = 1

• repeated Utxo utxoList = 2

  outSign return the output bytes outSign = 2; utxo list

• string totalSelected = 3

  total selected amount

• string runtime = 1

• string compiler = 2

• bytes digest = 3

• string vm_compiler = 4

• string contract_type = 5

Used in: Header, TokenDetail, TokenFrozenDetails

• SUCCESS = 0

• UNKNOW_ERROR = 1

• CONNECT_REFUSE = 2

• NOT_ENOUGH_UTXO_ERROR = 3

• UTXOVM_ALREADY_UNCONFIRM_ERROR = 4

• UTXOVM_NOT_FOUND_ERROR = 5

• INPUT_OUTPUT_NOT_EQUAL_ERROR = 6

• TX_NOT_FOUND_ERROR = 7

• TX_SIGN_ERROR = 8

• BLOCKCHAIN_NOTEXIST = 9

• VALIDATE_ERROR = 10

• CANNOT_SYNC_BLOCK_ERROR = 11

• CONFIRM_BLOCK_ERROR = 12

• UTXOVM_PLAY_ERROR = 13

• WALK_ERROR = 14

• NOT_READY_ERROR = 15

• BLOCK_EXIST_ERROR = 16

• ROOT_BLOCK_EXIST_ERROR = 17

• TX_DUPLICATE_ERROR = 19

• SERVICE_REFUSED_ERROR = 20

• TXDATA_SIGN_ERROR = 21

• TX_SLE_ERROR = 25

• TX_FEE_NOT_ENOUGH_ERROR = 26

• UTXO_SIGN_ERROR = 28

• DPOS_QUERY_ERROR = 31

• RWSET_INVALID_ERROR = 33

• RWACL_INVALID_ERROR = 34

• GAS_NOT_ENOUGH_ERROR = 35

• TX_VERSION_INVALID_ERROR = 36

• COMPLIANCE_CHECK_NOT_APPROVED = 37

• ACCOUNT_CONTRACT_STATUS_ERROR = 38

• TX_VERIFICATION_ERROR = 40

Unified Xuper Signature

Used in: Transaction

• repeated bytes public_keys = 1

• bytes signature = 2

选民投票记录

Used in: DposVoteRecordsResponse

• string candidate = 1

• string txid = 2

候选人被投票记录

Used in: DposVotedRecordsResponse

• string voter = 1

• string txid = 2