Libbitcoin Protocol

From Bitcoin Wiki
Revision as of 22:02, 27 May 2016 by Evoskuil (talk | contribs) (Updates for version3 incorporation of libbitcoin-protocl.)
Jump to: navigation, search

The libbitcoin-protocol library is new in version3 and replaces the zeromq/czmq++, zeromq/czmq and libsodium dependencies. The library provides a high level abstraction for ØMQ networking primitives used in the libbitcoin client-server interface.

In version4 (experimental) the library also defines a privacy-centric blockchain query language based on a simple and formally-defined messaging interface for the purpose of communicating with a full chain or SPV blockchain server. The design is independent of network topology and supports in-process as well as wide area messaging.


The version3 library is integrated with the Libbitcoin Build system[1], with regular build and test execution[2].

A version4 interface definition based on Protocol Buffers has been published along with C++, Java and Python marshalling libraries.

Privacy First

The focus of the version4 protocol is not the wire encoding, but the messaging semantics[3]. The central tenet of the library is that the level of privacy in making queries must be controllable by the caller over public networks. As such all queries are prefix filtered on a bit-wise basis with the depth of the filter controlled by the caller.

Protocol Objectives

  • The server should not be required to maintain any session state.
  • The client should not be required to provide any identifying information.
  • The protocol should allow client privacy, leaving trade-offs between privacy and performance to the caller.
  • The protocol should be extensible while allowing backward and forward compatibility without version negotiation.
  • The protocol should be defined in a formal interface definition language (IDL).
  • The IDL should provide tooling for generation of client-server stubs in C/C++.
  • The IDL tooling should implement marshalling in C/C++.


See Also