package orderer

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc Broadcast (stream common.Envelope, stream BroadcastResponse)

  ab.proto:76

  broadcast receives a reply of Acknowledgement for each common.Envelope in order, indicating success or type of failure

  message BroadcastResponse

  ab.proto:26

  • common.Status status = 1

    Status code, which may be used to programatically respond to success/failure

  • string info = 2

    Info string which may contain additional information about the status returned

• rpc Deliver (stream common.Envelope, stream DeliverResponse)

  ab.proto:79

  deliver first requires an Envelope of type DELIVER_SEEK_INFO with Payload data as a mashaled SeekInfo message, then a stream of block replies is received.

  message DeliverResponse

  ab.proto:67

  • oneof Type

    • common.Status status = 1

    • common.Block block = 2

• uint32 max_message_count = 1

  Simply specified as number of messages for now, in the future we may want to allow this to be specified by size in bytes

• uint32 absolute_max_bytes = 2

  The byte count of the serialized messages in a batch cannot exceed this value.

• uint32 preferred_max_bytes = 3

  The byte count of the serialized messages in a batch should not exceed this value.

• string timeout = 1

  Any duration string parseable by ParseDuration(): https://golang.org/pkg/time/#ParseDuration

ChannelRestrictions is the mssage which conveys restrictions on channel creation for an orderer

• uint64 max_count = 1

  The max count of channels to allow to be created, a value of 0 indicates no limit

• string type = 1

Carries a list of bootstrap brokers, i.e. this is not the exclusive set of brokers an ordering service

• repeated string brokers = 1

  Each broker here should be identified using the (IP|host):port notation, e.g. 127.0.0.1:7050, or localhost:7050 are valid entries

SeekInfo specifies the range of requested blocks to return If the start position is not found, an error is immediately returned Otherwise, blocks are returned until a missing block is encountered, then behavior is dictated by the SeekBehavior specified. If BLOCK_UNTIL_READY is specified, the reply will block until the requested blocks are available, if FAIL_IF_NOT_READY is specified, the reply will return an error indicating that the block is not found. To request that all blocks be returned indefinitely as they are created, behavior should be set to BLOCK_UNTIL_READY and the stop should be set to specified with a number of MAX_UINT64

• optional SeekPosition start = 1

  The position to start the deliver from

• optional SeekPosition stop = 2

  The position to stop the deliver

• SeekInfo.SeekBehavior behavior = 3

  The behavior when a missing block is encountered

Used in: SeekInfo

• BLOCK_UNTIL_READY = 0

• FAIL_IF_NOT_READY = 1

Used in: SeekPosition

(message has no fields)

Used in: SeekPosition

(message has no fields)

Used in: SeekInfo

• oneof Type

  • SeekNewest newest = 1

  • SeekOldest oldest = 2

  • SeekSpecified specified = 3

Used in: SeekPosition

• uint64 number = 1