package bc

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc CalculateMakerFee (CalculateMakerFeeRequest, FeeResponse)

  bc.proto:194

  message CalculateMakerFeeRequest

  bc.proto:143

  • uint64 shift_starts_at = 1

  • uint64 deposit_ends_at = 2

  • uint64 settle_ends_at = 3

  • string pays_with_chain_id = 4

  • string pays_unit = 5

  • string wants_chain_id = 6

  • string wants_unit = 7

  • string collateralized_nrg = 8

  • string nrg_unit = 9

• rpc CalculateTakerFee (CalculateTakerFeeRequest, FeeResponse)

  bc.proto:195

  message CalculateTakerFeeRequest

  bc.proto:155

  • string maker_tx_hash = 1

  • uint32 maker_tx_output_index = 2

  • string collateralized_nrg = 3

• rpc GetBalance (GetBalanceRequest, GetBalanceResponse)

  bc.proto:188

  message GetBalanceRequest

  bc.proto:38

  • string address = 1

  message GetBalanceResponse

  bc.proto:42

  • string confirmed = 1

  • string unconfirmed = 2

  • string collateralized = 3

  • string unit = 4

• rpc GetBcAddressViaVanity (VanityConvertRequest, VanityConvertResponse)

  bc.proto:200

  message VanityConvertRequest

  bc.proto:174

  • string vanity = 1

  message VanityConvertResponse

  bc.proto:178

  • string bc_address = 1

  • string error = 2

• rpc GetBlake2bl (GetBlake2blRequest, GetBlake2blResponse)

  bc.proto:199

  message GetBlake2blRequest

  bc.proto:165

  • string to_be_hashed = 1

  • uint32 times = 2

  message GetBlake2blResponse

  bc.proto:170

  • string hash = 1

• rpc GetLatestBlocks (Null, GetLatestBlocksResponse)

  bc.proto:184

  message GetLatestBlocksResponse

  bc.proto:7

  • repeated Block blocks = 1

• rpc GetMatchedOrders (GetMatchedOrdersRequest, GetMatchedOrdersResponse)

  bc.proto:198

  message GetMatchedOrdersRequest

  bc.proto:91

  • bool only_settled = 1

  message GetMatchedOrdersResponse

  bc.proto:95

  • repeated MatchedOpenOrder orders = 1

• rpc GetOpenOrders (Null, GetOpenOrdersResponse)

  bc.proto:197

  message GetOpenOrdersResponse

  bc.proto:87

  • repeated MakerOrderInfo open_orders = 1

• rpc Help (Null, HelpResponse)

  bc.proto:185

  message HelpResponse

  bc.proto:11

  • string help_text = 1

• rpc NewTx (RpcTransaction, RpcTransactionResponse)

  bc.proto:187

  message RpcTransaction

  bc.proto:19

  • string from_addr = 1

  • string to_addr = 2

  • string amount = 3

  • string tx_fee = 4

  • string private_key_hex = 5

• rpc PlaceMakerOrder (PlaceMakerOrderRequest, RpcTransactionResponse)

  bc.proto:190

  message PlaceMakerOrderRequest

  bc.proto:99

  • uint64 shift_starts_at = 1

  • uint64 deposit_ends_at = 2

  • uint64 settle_ends_at = 3

  • string pays_with_chain_id = 4

  • string wants_chain_id = 5

  • string wants_chain_address = 6

  • string wants_unit = 7

  • string pays_unit = 8

  • string bc_address = 9

  • string bc_private_key_hex = 10

  • string collateralized_nrg = 11

  • string nrg_unit = 12

  • string tx_fee = 13

• rpc PlaceTakerOrder (PlaceTakerOrderRequest, RpcTransactionResponse)

  bc.proto:191

  message PlaceTakerOrderRequest

  bc.proto:117

  • string wants_chain_address = 1

  • string sends_chain_address = 2

  • string maker_tx_hash = 3

  • uint32 maker_tx_output_index = 4

  • string bc_address = 5

  • string bc_private_key_hex = 6

  • string collateralized_nrg = 7

  • string tx_fee = 8

• rpc PlaceTakerOrders (PlaceTakerOrdersRequest, RpcTransactionResponse)

  bc.proto:192

  message PlaceTakerOrdersRequest

  bc.proto:136

  • repeated TakerOrder orders = 1

  • string bc_address = 2

  • string bc_private_key_hex = 3

  • string tx_fee = 4

• rpc Stats (Null, StatsResponse)

  bc.proto:186

  message StatsResponse

  bc.proto:15

  • int64 calls = 1

• rpc Mine (MinerRequest, MinerResponse)

  miner.proto:45

  message MinerRequest

  miner.proto:15

  Miner block input

  • string work_id = 1

  • uint64 current_timestamp = 2

  • int32 offset = 3

  • string work = 4

  • string miner_key = 5

  • string merkle_root = 6

  • string difficulty = 7

  • optional BcBlock last_previous_block = 8

  • optional BlockchainHeaders new_block_headers = 9

  message MinerResponse

  miner.proto:34

  Miner block output

  • MinerResponseResult result = 1

  • string nonce = 2

  • string difficulty = 3

  • string distance = 4

  • uint64 timestamp = 5

  • uint64 iterations = 6

  • uint64 time_diff = 7

• rpc CollectBlock (Block, Null)

  rover.proto:12

  Rovers sends block collected from the respective network

• rpc IsBeforeSettleHeight (SettleTxCheckReq, SettleTxCheckResponse)

  rover.proto:18

  Check is TX reciveved in rover is watched and before settlement height

  message SettleTxCheckReq

  rover.proto:59

  • string addr_to = 1

  • string addr_from = 2

  • string bridged_chain = 3

  message SettleTxCheckResponse

  rover.proto:65

  • bool is_before_settlement_height = 1

• rpc Join (RoverIdent, stream RoverMessage)

  rover.proto:9

  Sends a greeting

  message RoverIdent

  rover.proto:21

  • string rover_name = 1

  message RoverMessage

  rover.proto:35

  • RoverMessageType type = 1

  • oneof payload

    • RoverMessage.Resync resync = 2

    • RoverMessage.FetchBlock fetch_block = 3

• rpc ReportSyncStatus (RoverSyncStatus, Null)

  rover.proto:15

  Rover reports back sync status

  message RoverSyncStatus

  rover.proto:25

  • string rover_name = 1

  • bool status = 2

Used in: MinerRequest

• string hash = 1

• string previous_hash = 2

• uint64 version = 3

• uint64 schema_version = 4

• uint64 height = 5

• string miner = 6

• string difficulty = 7

• uint64 timestamp = 8

• string merkle_root = 9

• string chain_root = 10

• string distance = 11

• string total_distance = 12

• string nonce = 13

• uint64 nrg_grant = 14

• string target_hash = 15

• uint64 target_height = 16

• string target_miner = 17

• string target_signature = 18

• uint64 twn = 19

• repeated string tws = 20

• uint64 emblem_weight = 21

• string emblem_chain_block_hash = 22

• string emblem_chain_fingerprint_root = 23

• string emblem_chain_address = 24

• uint64 tx_count = 25

• repeated Transaction txs = 26

• uint64 tx_fee_base = 27

• uint64 tx_distance_sum_limit = 28

• uint64 blockchain_headers_count = 29

• optional BlockchainHeaders blockchain_headers = 30

• string blockchain_fingerprints_root = 31

Used as request type in: Rover.CollectBlock

Used as field type in: GetLatestBlocksResponse, RoverMessage.FetchBlock, RoverMessage.Resync

• string blockchain = 1

• string hash = 2

• string previous_hash = 3

• uint64 timestamp = 4

  with ms

• uint64 height = 5

• string merkle_root = 6

• uint64 markedtx_count = 7

• repeated MarkedTransaction marked_txs = 8

• string blockchain = 1

• string hash = 2

• uint64 timestamp = 3

• bool is_current = 4

Used in: BlockchainHeaders

• string blockchain = 1

• string hash = 2

• string previous_hash = 3

• uint64 timestamp = 4

• uint64 height = 5

• string merkle_root = 6

• uint64 blockchain_confirmations_in_parent_count = 7

• repeated MarkedTransaction marked_txs = 8

Used in: BcBlock, MinerRequest

• repeated BlockchainHeader btc = 1

• repeated BlockchainHeader eth = 2

• repeated BlockchainHeader lsk = 3

• repeated BlockchainHeader neo = 4

• repeated BlockchainHeader wav = 5

Represents value stored in key/value database User provided value is automatically (de)serialized

• string type = 1

• bytes data = 2

• int32 version = 3

• bool is_native = 4

Used as response type in: Bc.CalculateMakerFee, Bc.CalculateTakerFee

• string fee = 1

• string address = 1

• uint64 expires = 2

(message has no fields)

Used in: GetOpenOrdersResponse, MatchedOpenOrder

• uint64 shift_starts_at = 1

• uint64 deposit_ends_at = 2

• uint64 settle_ends_at = 3

• string pays_chain_id = 4

• string wants_chain_id = 5

• string wants_address = 6

• string wants_unit = 7

• string pays_unit = 8

• string double_hashed_bc_address = 9

• string collateralized_nrg = 10

• string nrg_unit = 11

• string tx_hash = 12

• uint64 tx_output_index = 13

• string block_hash = 14

• uint64 block_height = 15

• bool is_settled = 16

• uint64 block_height_has_original_maker_tx = 17

Used in: Block, BlockchainHeader

• bytes value = 1

• string hash = 2

  the unique hash representing this transaction in the bridged chain

• string id = 3

  TODO: add blockchain / dataset identification field, 'eth', 'btc', ....

• string token = 4

  chains smart contract address, not BC

• string addr_from = 5

  bridged chains address, not BC

• string addr_to = 6

  bridged chains address, not BC

• uint64 block_height = 7

  the block number in the bridged chain containing this transaction

• uint64 index = 8

  the position relative to other marked transactions

Used in: GetMatchedOrdersResponse

• optional MakerOrderInfo maker = 1

• optional TakerOrderInfo taker = 2

• MsgType type = 1

• ObjType body = 2

Used in: MinerResponse

• Canceled = 0

• Ok = 1

• Error = 2

Used in: MessageGetObjectsRequest

• GetObjectsRequest = 0

Used as request type in: Bc.GetLatestBlocks, Bc.GetOpenOrders, Bc.Help, Bc.Stats

Used as response type in: Rover.CollectBlock, Rover.ReportSyncStatus

(message has no fields)

Used in: MessageGetObjectsRequest

• BlockHeaders = 0

• BlockBodies = 1

• BlockTransactions = 2

• RoverBestHeights = 3

• RoverBlockHeaders = 4

• RoverBlockBodies = 5

• RoverTransactionHeaders = 6

• RoverMarkedHeaders = 7

Used in: TransactionInput

• bytes value = 1

• string hash = 2

• uint64 index = 3

Used in: RoverMessage

• optional Block from_block = 1

• optional Block to_block = 2

Used in: RoverMessage

• optional Block latest_block = 1

  latest know block we have in storage, can be empty

• repeated Resync.Interval intervals = 2

Used in: Resync

• uint64 from_block = 1

• uint64 to_block = 2

Used in: RoverMessage

• FetchBlock = 0

• RequestResync = 1

Used as response type in: Bc.NewTx, Bc.PlaceMakerOrder, Bc.PlaceTakerOrder, Bc.PlaceTakerOrders

• RpcTransactionResponseStatus status = 1

• string tx_hash = 2

• string error = 3

Used in: RpcTransactionResponse

• Success = 0

• Failure = 1

Used in: PlaceTakerOrdersRequest

• string wants_chain_address = 1

• string sends_chain_address = 2

• string maker_tx_hash = 3

• uint32 maker_tx_output_index = 4

• string collateralized_nrg = 5

Used in: MatchedOpenOrder

• string sends_address = 1

• string wants_address = 2

• string maker_tx_hash = 3

• uint32 maker_tx_output_index = 4

• string double_hashed_bc_address = 5

• string collateralized_nrg = 6

• string block_hash = 7

• uint64 block_height = 8

• bool is_settled = 9

• string tx_hash = 10

Used in: BcBlock

• uint64 version = 1

• string nonce = 2

  <rnd>+<minerAddess>

• string hash = 3

• string overline = 4

• uint64 nin_count = 5

• uint64 nout_count = 6

• repeated TransactionInput inputs = 7

• repeated TransactionOutput outputs = 8

• uint32 lock_time = 9

Used in: Transaction

• optional OutPoint out_point = 1

• uint32 script_length = 2

• bytes input_script = 3

Used in: Transaction

• bytes value = 1

• bytes unit = 2

• uint32 script_length = 3

• bytes output_script = 4