package protocol

Get desktop application:
View/edit binary Protocol Buffers messages

Account

• bytes account_name = 1

  account nick name

• AccountType type = 2

• bytes address = 3

  the create address

• int64 balance = 4

  the trx balance

• repeated Vote votes = 5

  the votes

• map<string, int64> asset = 6

  the other asset owned by this account

• map<string, int64> assetV2 = 56

  the other asset owned by this account，key is assetId

• repeated Account.Frozen frozen = 7

  the frozen balance for bandwidth

• int64 net_usage = 8

  bandwidth, get from frozen

• int64 acquired_delegated_frozen_balance_for_bandwidth = 41

  Frozen balance provided by other accounts to this account

• int64 delegated_frozen_balance_for_bandwidth = 42

  Freeze and provide balances to other accounts

• int64 create_time = 9

  this account create time

• int64 latest_opration_time = 10

  this last operation time, including transfer, voting and so on. //FIXME fix grammar

• int64 allowance = 11

  witness block producing allowance

• int64 latest_withdraw_time = 12

  last withdraw time

• bytes code = 13

  not used so far

• bool is_witness = 14

• bool is_committee = 15

• repeated Account.Frozen frozen_supply = 16

  frozen asset(for asset issuer)

• bytes asset_issued_name = 17

  asset_issued_name

• bytes asset_issued_ID = 57

• map<string, int64> latest_asset_operation_time = 18

• map<string, int64> latest_asset_operation_timeV2 = 58

• int64 free_net_usage = 19

• map<string, int64> free_asset_net_usage = 20

• map<string, int64> free_asset_net_usageV2 = 59

• int64 latest_consume_time = 21

• int64 latest_consume_free_time = 22

• bytes account_id = 23

  the identity of this account, case insensitive

• optional Account.AccountResource account_resource = 26

• bytes codeHash = 30

• optional Permission owner_permission = 31

• optional Permission witness_permission = 32

• repeated Permission active_permission = 33

Used in: Account

• int64 energy_usage = 1

  energy resource, get from frozen

• optional Frozen frozen_balance_for_energy = 2

  the frozen balance for energy

• int64 latest_consume_time_for_energy = 3

• int64 acquired_delegated_frozen_balance_for_energy = 4

  Frozen balance provided by other accounts to this account

• int64 delegated_frozen_balance_for_energy = 5

  Frozen balances provided to other accounts

• int64 storage_limit = 6

  storage resource, get from market

• int64 storage_usage = 7

• int64 latest_exchange_storage_time = 8

frozen balance

Used in: Account, AccountResource

• int64 frozen_balance = 1

  the frozen trx balance

• int64 expire_time = 2

  the expire time

• bytes owner_address = 1

• bytes account_address = 2

• AccountType type = 3

AccountId, (name, address) use name, (null, address) use address, (name, null) use name,

Used in: authority

• bytes name = 1

• bytes address = 2

• bytes owner_address = 1

• optional Permission owner = 2

  Empty is invalidate

• optional Permission witness = 3

  Can be empty

• repeated Permission actives = 4

  Empty is invalidate

Used in: Account, AccountCreateContract

• Normal = 0

• AssetIssue = 1

• Contract = 2

Update account name. Account name is not unique now.

• bytes account_name = 1

• bytes owner_address = 2

• string id = 41

• bytes owner_address = 1

• bytes name = 2

• bytes abbr = 3

• int64 total_supply = 4

• repeated AssetIssueContract.FrozenSupply frozen_supply = 5

• int32 trx_num = 6

• int32 precision = 7

• int32 num = 8

• int64 start_time = 9

• int64 end_time = 10

• int64 order = 11

  useless

• int32 vote_score = 16

• bytes description = 20

• bytes url = 21

• int64 free_asset_net_limit = 22

• int64 public_free_asset_net_limit = 23

• int64 public_free_asset_net_usage = 24

• int64 public_latest_free_net_time = 25

Used in: AssetIssueContract

• int64 frozen_amount = 1

• int64 frozen_days = 2

• bool flag = 1

• int32 priority = 2

block

Used in: Items

• repeated Transaction transactions = 1

• optional BlockHeader block_header = 2

Used in: Block, Items

• optional BlockHeader.raw raw_data = 1

• bytes witness_signature = 2

Used in: BlockHeader

• int64 timestamp = 1

• bytes txTrieRoot = 2

• bytes parentHash = 3

• int64 number = 7

  bytes nonce = 5; bytes difficulty = 6;

• int64 witness_id = 8

• bytes witness_address = 9

• int32 version = 10

• bytes accountStateRoot = 11

Inventory

• repeated BlockInventory.BlockId ids = 1

• BlockInventory.Type type = 2

Used in: BlockInventory

• bytes hash = 1

• int64 number = 2

Used in: BlockInventory

• SYNC = 0

• ADVTISE = 1

• FETCH = 2

• bytes owner_address = 1

• int64 bytes = 2

  storage bytes for buy

• bytes owner_address = 1

• int64 quant = 2

  trx quantity for buy storage (sun)

• repeated ChainInventory.BlockId ids = 1

• int64 remain_num = 2

Used in: ChainInventory

• bytes hash = 1

• int64 number = 2

• repeated ChainParameters.ChainParameter chainParameter = 1

Used in: ChainParameters

• string key = 1

• int64 value = 2

• bytes owner_address = 1

• bytes contract_address = 2

• bytes owner_address = 1

• optional SmartContract new_contract = 2

• int64 call_token_value = 3

• int64 token_id = 4

• bytes from = 1

• bytes to = 2

• int64 frozen_balance_for_bandwidth = 3

• int64 frozen_balance_for_energy = 4

• int64 expire_time_for_bandwidth = 5

• int64 expire_time_for_energy = 6

• bytes account = 1

• repeated bytes fromAccounts = 2

• repeated bytes toAccounts = 3

• ReasonCode reason = 1

DynamicProperties

• int64 last_solidity_block_num = 1

Used in: FindNeighbours, HelloMessage, Neighbours, PingMessage, PongMessage

• bytes address = 1

• int32 port = 2

• bytes nodeId = 3

Exchange

• int64 exchange_id = 1

• bytes creator_address = 2

• int64 create_time = 3

• bytes first_token_id = 6

• int64 first_token_balance = 7

• bytes second_token_id = 8

• int64 second_token_balance = 9

• bytes owner_address = 1

• bytes first_token_id = 2

• int64 first_token_balance = 3

• bytes second_token_id = 4

• int64 second_token_balance = 5

• bytes owner_address = 1

• int64 exchange_id = 2

• bytes token_id = 3

• int64 quant = 4

• bytes owner_address = 1

• int64 exchange_id = 2

• bytes token_id = 3

• int64 quant = 4

• int64 expected = 5

• bytes owner_address = 1

• int64 exchange_id = 2

• bytes token_id = 3

• int64 quant = 4

• optional Endpoint from = 1

• bytes targetId = 2

• int64 timestamp = 3

• bytes owner_address = 1

• int64 frozen_balance = 2

• int64 frozen_duration = 3

• ResourceCode resource = 10

• bytes receiver_address = 15

• optional Endpoint from = 1

• int32 version = 2

• int64 timestamp = 3

• optional HelloMessage.BlockId genesisBlockId = 4

• optional HelloMessage.BlockId solidBlockId = 5

• optional HelloMessage.BlockId headBlockId = 6

Used in: HelloMessage

• bytes hash = 1

• int64 number = 2

Used in: TransactionInfo

• bytes hash = 1

  internalTransaction identity, the root InternalTransaction hash should equals to root transaction id.

• bytes caller_address = 2

  the one send trx (TBD: or token) via function

• bytes transferTo_address = 3

  the one recieve trx (TBD: or token) via function

• repeated InternalTransaction.CallValueInfo callValueInfo = 4

• bytes note = 5

• bool rejected = 6

Used in: InternalTransaction

• int64 callValue = 1

  trx (TBD: or token) value

• string tokenId = 2

  TBD: tokenName, trx should be empty

• Inventory.InventoryType type = 1

• repeated bytes ids = 2

Used in: Inventory

• TRX = 0

• BLOCK = 1

• Items.ItemType type = 1

• repeated Block blocks = 2

• repeated BlockHeader block_headers = 3

• repeated Transaction transactions = 4

Used in: Items

• ERR = 0

• TRX = 1

• BLOCK = 2

• BLOCKHEADER = 3

Used in: Permission

• bytes address = 1

• int64 weight = 2

• optional Endpoint from = 1

• repeated Endpoint neighbours = 2

• int64 timestamp = 3

• int64 beginSyncNum = 1

• string block = 2

• string solidityBlock = 3

• int32 currentConnectCount = 4

  connect information

• int32 activeConnectCount = 5

• int32 passiveConnectCount = 6

• int64 totalFlow = 7

• repeated NodeInfo.PeerInfo peerInfoList = 8

• optional NodeInfo.ConfigNodeInfo configNodeInfo = 9

• optional NodeInfo.MachineInfo machineInfo = 10

• map<string, string> cheatWitnessInfoMap = 11

Used in: NodeInfo

• string codeVersion = 1

• string p2pVersion = 2

• int32 listenPort = 3

• bool discoverEnable = 4

• int32 activeNodeSize = 5

• int32 passiveNodeSize = 6

• int32 sendNodeSize = 7

• int32 maxConnectCount = 8

• int32 sameIpMaxConnectCount = 9

• int32 backupListenPort = 10

• int32 backupMemberSize = 11

• int32 backupPriority = 12

• int32 dbVersion = 13

• int32 minParticipationRate = 14

• bool supportConstant = 15

• double minTimeRatio = 16

• double maxTimeRatio = 17

• int64 allowCreationOfContracts = 18

• int64 allowAdaptiveEnergy = 19

Used in: NodeInfo

• int32 threadCount = 1

• int32 deadLockThreadCount = 2

• int32 cpuCount = 3

• int64 totalMemory = 4

• int64 freeMemory = 5

• double cpuRate = 6

• string javaVersion = 7

• string osName = 8

• int64 jvmTotalMemoery = 9

• int64 jvmFreeMemory = 10

• double processCpuRate = 11

• repeated MachineInfo.MemoryDescInfo memoryDescInfoList = 12

• repeated MachineInfo.DeadLockThreadInfo deadLockThreadInfoList = 13

Used in: MachineInfo

• string name = 1

• string lockName = 2

• string lockOwner = 3

• string state = 4

• int64 blockTime = 5

• int64 waitTime = 6

• string stackTrace = 7

Used in: MachineInfo

• string name = 1

• int64 initSize = 2

• int64 useSize = 3

• int64 maxSize = 4

• double useRate = 5

Used in: NodeInfo

• string lastSyncBlock = 1

• int64 remainNum = 2

• int64 lastBlockUpdateTime = 3

• bool syncFlag = 4

• int64 headBlockTimeWeBothHave = 5

• bool needSyncFromPeer = 6

• bool needSyncFromUs = 7

• string host = 8

• int32 port = 9

• string nodeId = 10

• int64 connectTime = 11

• double avgLatency = 12

• int32 syncToFetchSize = 13

• int64 syncToFetchSizePeekNum = 14

• int32 syncBlockRequestedSize = 15

• int64 unFetchSynNum = 16

• int32 blockInPorcSize = 17

• string headBlockWeBothHave = 18

• bool isActive = 19

• int32 score = 20

• int32 nodeCount = 21

• int64 inFlow = 22

• int32 disconnectTimes = 23

• string localDisconnectReason = 24

• string remoteDisconnectReason = 25

• bytes owner_address = 1

• bytes to_address = 2

• bytes asset_name = 3

  this field is token name before the proposal ALLOW_SAME_TOKEN_NAME is active, otherwise it is token id and token is should be in string format.

• int64 amount = 4

  the amount of drops

Used in: Account, AccountPermissionUpdateContract

• Permission.PermissionType type = 1

• int32 id = 2

  Owner id=0, Witness id=1, Active id start by 2

• string permission_name = 3

• int64 threshold = 4

• int32 parent_id = 5

• bytes operations = 6

  1 bit 1 contract

• repeated Key keys = 7

Used in: Permission

• Owner = 0

• Witness = 1

• Active = 2

• optional Endpoint from = 1

• optional Endpoint to = 2

• int32 version = 3

• int64 timestamp = 4

• optional Endpoint from = 1

• int32 echo = 2

• int64 timestamp = 3

Proposal

• int64 proposal_id = 1

• bytes proposer_address = 2

• map<int64, int64> parameters = 3

• int64 expiration_time = 4

• int64 create_time = 5

• repeated bytes approvals = 6

• Proposal.State state = 7

Used in: Proposal

• PENDING = 0

• DISAPPROVED = 1

• APPROVED = 2

• CANCELED = 3

• bytes owner_address = 1

• int64 proposal_id = 2

• bool is_add_approval = 3

  add or remove approval

• bytes owner_address = 1

• map<int64, int64> parameters = 2

• bytes owner_address = 1

• int64 proposal_id = 2

Used in: DisconnectMessage

• REQUESTED = 0

• BAD_PROTOCOL = 2

• TOO_MANY_PEERS = 4

• DUPLICATE_PEER = 5

• INCOMPATIBLE_PROTOCOL = 6

• NULL_IDENTITY = 7

• PEER_QUITING = 8

• UNEXPECTED_IDENTITY = 9

• LOCAL_IDENTITY = 10

• PING_TIMEOUT = 11

• USER_REASON = 16

• RESET = 17

• SYNC_FAIL = 18

• FETCH_FAIL = 19

• BAD_TX = 20

• BAD_BLOCK = 21

• FORKED = 22

• UNLINKABLE = 23

• INCOMPATIBLE_VERSION = 24

• INCOMPATIBLE_CHAIN = 25

• TIME_OUT = 32

• CONNECT_FAIL = 33

• TOO_MANY_PEERS_WITH_SAME_IP = 34

• UNKNOWN = 255

Used in: FreezeBalanceContract, UnfreezeBalanceContract

• BANDWIDTH = 0

• ENERGY = 1

Used in: TransactionInfo

• int64 energy_usage = 1

• int64 energy_fee = 2

• int64 origin_energy_usage = 3

• int64 energy_usage_total = 4

• int64 net_usage = 5

• int64 net_fee = 6

• Transaction.Result.contractResult result = 7

• bytes owner_address = 1

• int64 storage_bytes = 2

Set account id if the account has no id. Account id is unique and case insensitive.

• bytes account_id = 1

• bytes owner_address = 2

Used in: CreateSmartContract

• bytes origin_address = 1

• bytes contract_address = 2

• optional SmartContract.ABI abi = 3

• bytes bytecode = 4

• int64 call_value = 5

• int64 consume_user_resource_percent = 6

• string name = 7

• int64 origin_energy_limit = 8

• bytes code_hash = 9

• bytes trx_hash = 10

Used in: SmartContract

• repeated ABI.Entry entrys = 1

Used in: ABI

• bool anonymous = 1

• bool constant = 2

• string name = 3

• repeated Entry.Param inputs = 4

• repeated Entry.Param outputs = 5

• Entry.EntryType type = 6

• bool payable = 7

• Entry.StateMutabilityType stateMutability = 8

Used in: Entry

• UnknownEntryType = 0

• Constructor = 1

• Function = 2

• Event = 3

• Fallback = 4

Used in: Entry

• bool indexed = 1

• string name = 2

• string type = 3

  SolidityType type = 3;

Used in: Entry

• UnknownMutabilityType = 0

• Pure = 1

• View = 2

• Nonpayable = 3

• Payable = 4

• optional TXInput.raw raw_data = 1

• bytes signature = 4

Used in: TXInput

• bytes txID = 1

• int64 vout = 2

• bytes pubKey = 3

Used in: TXOutputs

• int64 value = 1

• bytes pubKeyHash = 2

• repeated TXOutput outputs = 1

Used in: Block, Items, TransactionSign, Transactions

• optional Transaction.raw raw_data = 1

• repeated bytes signature = 2

  only support size = 1, repeated list here for muti-sig extension

• repeated Transaction.Result ret = 5

Used in: raw

• Contract.ContractType type = 1

• optional google.protobuf.Any parameter = 2

• bytes provider = 3

• bytes ContractName = 4

• int32 Permission_id = 5

Used in: Contract

• AccountCreateContract = 0

• TransferContract = 1

• TransferAssetContract = 2

• VoteAssetContract = 3

• VoteWitnessContract = 4

• WitnessCreateContract = 5

• AssetIssueContract = 6

• WitnessUpdateContract = 8

• ParticipateAssetIssueContract = 9

• AccountUpdateContract = 10

• FreezeBalanceContract = 11

• UnfreezeBalanceContract = 12

• WithdrawBalanceContract = 13

• UnfreezeAssetContract = 14

• UpdateAssetContract = 15

• ProposalCreateContract = 16

• ProposalApproveContract = 17

• ProposalDeleteContract = 18

• SetAccountIdContract = 19

• CustomContract = 20

• CreateSmartContract = 30

  BuyStorageContract = 21; BuyStorageBytesContract = 22; SellStorageContract = 23;

• TriggerSmartContract = 31

• GetContract = 32

• UpdateSettingContract = 33

• ExchangeCreateContract = 41

• ExchangeInjectContract = 42

• ExchangeWithdrawContract = 43

• ExchangeTransactionContract = 44

• UpdateEnergyLimitContract = 45

• AccountPermissionUpdateContract = 46

• ClearABIContract = 48

Used in: Transaction

• int64 fee = 1

• Result.code ret = 2

• Result.contractResult contractRet = 3

• string assetIssueID = 14

• int64 withdraw_amount = 15

• int64 unfreeze_amount = 16

• int64 exchange_received_amount = 18

• int64 exchange_inject_another_amount = 19

• int64 exchange_withdraw_another_amount = 20

• int64 exchange_id = 21

Used in: Result

• SUCESS = 0

• FAILED = 1

Used in: ResourceReceipt, Result

• DEFAULT = 0

• SUCCESS = 1

• REVERT = 2

• BAD_JUMP_DESTINATION = 3

• OUT_OF_MEMORY = 4

• PRECOMPILED_CONTRACT = 5

• STACK_TOO_SMALL = 6

• STACK_TOO_LARGE = 7

• ILLEGAL_OPERATION = 8

• STACK_OVERFLOW = 9

• OUT_OF_ENERGY = 10

• OUT_OF_TIME = 11

• JVM_STACK_OVER_FLOW = 12

• UNKNOWN = 13

• TRANSFER_FAILED = 14

Used in: Transaction

• bytes ref_block_bytes = 1

• int64 ref_block_num = 3

• bytes ref_block_hash = 4

• int64 expiration = 8

• repeated authority auths = 9

• bytes data = 10

  data not used

• repeated Contract contract = 11

  only support size = 1, repeated list here for extension

• bytes scripts = 12

  scripts not used

• int64 timestamp = 14

• int64 fee_limit = 18

Used in: TransactionRet

• bytes id = 1

• int64 fee = 2

• int64 blockNumber = 3

• int64 blockTimeStamp = 4

• repeated bytes contractResult = 5

• bytes contract_address = 6

• optional ResourceReceipt receipt = 7

• repeated TransactionInfo.Log log = 8

• TransactionInfo.code result = 9

• bytes resMessage = 10

• string assetIssueID = 14

• int64 withdraw_amount = 15

• int64 unfreeze_amount = 16

• repeated InternalTransaction internal_transactions = 17

• int64 exchange_received_amount = 18

• int64 exchange_inject_another_amount = 19

• int64 exchange_withdraw_another_amount = 20

• int64 exchange_id = 21

Used in: TransactionInfo

• bytes address = 1

• repeated bytes topics = 2

• bytes data = 3

Used in: TransactionInfo

• SUCESS = 0

• FAILED = 1

• int64 blockNumber = 1

• int64 blockTimeStamp = 2

• repeated TransactionInfo transactioninfo = 3

• optional Transaction transaction = 1

• bytes privateKey = 2

• repeated Transaction transactions = 1

• bytes asset_name = 1

  this field is token name before the proposal ALLOW_SAME_TOKEN_NAME is active, otherwise it is token id and token is should be in string format.

• bytes owner_address = 2

• bytes to_address = 3

• int64 amount = 4

• bytes owner_address = 1

• bytes to_address = 2

• int64 amount = 3

• bytes owner_address = 1

• bytes contract_address = 2

• int64 call_value = 3

• bytes data = 4

• int64 call_token_value = 5

• int64 token_id = 6

• bytes owner_address = 1

• bytes owner_address = 1

• ResourceCode resource = 10

• bytes receiver_address = 15

• bytes owner_address = 1

• bytes description = 2

• bytes url = 3

• int64 new_limit = 4

• int64 new_public_limit = 5

• bytes owner_address = 1

• bytes contract_address = 2

• int64 origin_energy_limit = 3

• bytes owner_address = 1

• bytes contract_address = 2

• int64 consume_user_resource_percent = 3

vote message

Used in: Account, Votes

• bytes vote_address = 1

  the super rep address

• int64 vote_count = 2

  the vote num to this super rep.

• bytes owner_address = 1

• repeated bytes vote_address = 2

• bool support = 3

• int32 count = 5

• bytes owner_address = 1

• repeated VoteWitnessContract.Vote votes = 2

• bool support = 3

Used in: VoteWitnessContract

• bytes vote_address = 1

• int64 vote_count = 2

Vote Change

• bytes address = 1

• repeated Vote old_votes = 2

• repeated Vote new_votes = 3

• bytes owner_address = 1

Witness

• bytes address = 1

• int64 voteCount = 2

• bytes pubKey = 3

• string url = 4

• int64 totalProduced = 5

• int64 totalMissed = 6

• int64 latestBlockNum = 7

• int64 latestSlotNum = 8

• bool isJobs = 9

• bytes owner_address = 1

• bytes url = 2

• bytes owner_address = 1

• bytes update_url = 12

Used in: Transaction.raw

• optional AccountId account = 1

• bytes permission_name = 2