Libbitcoin Common: Difference between revisions

From Bitcoin Wiki
Jump to navigation Jump to search
Evoskuil (talk | contribs)
m fix trie description
Evoskuil (talk | contribs)
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
The common [https://github.com/libbitcoin/libbitcoin libbitcoin] library is a dependency of all others with the exception of [[Libbitcoin_Consensus|libbitcoin-consensus]]. It was the first library created and originally contained the core functionality of all of the others.
The common [https://github.com/libbitcoin/libbitcoin-system libbitcoin-system] (formerly "libbitcoin") library is a dependency of all others with the exception of [[Libbitcoin_Consensus|libbitcoin-consensus]]. It was the first library created and originally contained the core functionality of all of the others.


==Example==
==Example==
#include <cstdint>
  #include <iostream>
  #include <iostream>
  #include <string>
  #include <string>
Line 9: Line 10:
  int main()
  int main()
  {
  {
     const auto block = bc::genesis_block();
     const auto block = bc::chain::block::genesis_mainnet();
     const auto& tx = block.transactions[0];
     const auto& tx = block.transactions().front();
     const auto& input = tx.inputs[0];
     const auto& input = tx.inputs().front();
     const auto script = bc::save_script(input.script);
     const auto script = input.script().to_data(false);
     std::string message(script.begin(), script.end());
     std::string message(script.begin() + sizeof(uint64_t), script.end());
     std::cout << message << std::endl;
     std::cout << message << std::endl;
     return 0;
     return 0;
  }
  }


  ♦   ↔☺♦EThe Times 03/Jan/2009 Chancellor on brink of second bailout for banks
  The Times 03/Jan/2009 Chancellor on brink of second bailout for banks


==Bitcoin Related Features==
==Bitcoin Related Features==
Line 28: Line 29:
* All published [https://github.com/bitcoin/bips/blob/master/bip-0039/bip-0039-wordlists.md mnemonic dictionaries]
* All published [https://github.com/bitcoin/bips/blob/master/bip-0039/bip-0039-wordlists.md mnemonic dictionaries]
* Curve math, deterministic ECDSA, verification and encryption functions
* Curve math, deterministic ECDSA, verification and encryption functions
* Address functions (P2PKH and P2SH/[https://github.com/bitcoin/bips/blob/master/bip-0016.mediawiki BIP16]),
* Address functions (P2PKH and P2SH/[https://github.com/bitcoin/bips/blob/master/bip-0016.mediawiki BIP16])
* Stealth addresses functions<ref>[https://wiki.unsystem.net/en/index.php/DarkWallet/Stealth DarkWallet Stealth Design Document]</ref> for wallets and blockchain search
* Stealth addresses functions<ref>[https://wiki.unsystem.net/en/index.php/DarkWallet/Stealth DarkWallet Stealth Design Document]</ref> for wallets and blockchain search
* Wire and text serializable type library (P2P protocol)
* Wire and text serializable type library (P2P protocol)
* Bitcoin script engine (see [[Libbitcoin_Consensus|libbitcoin-consensus]] for more information)
* Bitcoin script engine (see [[Libbitcoin_Consensus|libbitcoin-consensus]] for more information)
* Asynchronous P2P networking stack built on [https://think-async.com ASIO]
* Asynchronous P2P networking stack built on [https://think-async.com ASIO] (moved to [[Libbitcoin_Network|libbitcoin-network]] in version 3)


==General Purpose Features==
==General Purpose Features==
* [https://github.com/libbitcoin/libbitcoin-system/wiki Documentation]
* Logging utilities
* Logging utilities
* [http://en.wikipedia.org/wiki/Radix_tree Patricia Trie] template with binary alphabet
* [http://en.wikipedia.org/wiki/Radix_tree Patricia Trie] template with binary alphabet
* [http://utf8everywhere.org UTF8 Everywhere] tools and integration for Windows
* [http://utf8everywhere.org UTF8 Everywhere] tools and integration for Windows
* Command line, configuration file and help processing utilities
* Command line and configuration file utilities based on [http://www.boost.org/doc/libs/1_55_0/doc/html/program_options.html boost program options]


==Build and Quality Control==
==Build and Quality Control==
Line 44: Line 46:
* All build artifacts generated by [[Libbitcoin_Build|libbitcoin-build]]
* All build artifacts generated by [[Libbitcoin_Build|libbitcoin-build]]
* Continuous integration builds via [https://travis-ci.org/libbitcoin/libbitcoin Travis-CI]
* Continuous integration builds via [https://travis-ci.org/libbitcoin/libbitcoin Travis-CI]
* Test coverage bar of 85% by line with [https://travis-ci.org/libbitcoin/libbitcoin Coverall] reporting
* Automated test coverage reporting via [https://travis-ci.org/libbitcoin/libbitcoin Coverall]
* Visual Studio 2013 project and solution files
* Visual Studio 2013 project and solution files
* Support for 32/64 bit processors and [http://en.wikipedia.org/wiki/Endianness endianness] differences
* Support for 32/64 bit processors and [http://en.wikipedia.org/wiki/Endianness endianness] differences
* Uses C++11 advancements and restricts use of pointers and exceptions
* Uses C++11 advancements and restricts use of pointers and exceptions


==Dependencies==
==Dependencies (Version2)==
* [http://www.boost.org boost]
* [http://www.boost.org boost]
* [https://github.com/bitcoin/secp256k1 libsecp256k1]
* [https://github.com/bitcoin/secp256k1 libsecp256k1]
* [http://site.icu-project.org ICU] (optional)
* [http://site.icu-project.org ICU] (optional)
==Dependencies (Version3)==
* [http://www.boost.org boost]
* [https://github.com/bitcoin/secp256k1 libsecp256k1]
* [http://site.icu-project.org ICU] (optional)
* [http://www.libpng.org/pub/png/libpng.html libpng] (optional)
* [https://fukuchi.org/works/qrencode libqrencode] (optional)


==See Also==
==See Also==
Line 58: Line 67:


==References==
==References==
[[Category:Clients]]
[[Category:Open Source]]
[[Category:Software‏‎]]

Latest revision as of 01:38, 9 March 2021

The common libbitcoin-system (formerly "libbitcoin") library is a dependency of all others with the exception of libbitcoin-consensus. It was the first library created and originally contained the core functionality of all of the others.

Example

#include <cstdint>
#include <iostream>
#include <string>
#include <bitcoin/bitcoin.hpp>

// Extract Satoshi's words.
int main()
{
    const auto block = bc::chain::block::genesis_mainnet();
    const auto& tx = block.transactions().front();
    const auto& input = tx.inputs().front();
    const auto script = input.script().to_data(false);
    std::string message(script.begin() + sizeof(uint64_t), script.end());
    std::cout << message << std::endl;
    return 0;
}
The Times 03/Jan/2009 Chancellor on brink of second bailout for banks

Bitcoin Related Features

  • Key formats (raw, BIP32, WIF, compressed/uncompressed, minikey)
  • Encoding functions (base 2/10/16/58/64/85)
  • Hash functions (ripemd160, sha1, sha256, sha512, hmac_sha256, hmac_sha512, pkcs5_pbkdf2_hmac_sha512)
  • URL parsing (BIP21 and BIP72)
  • Mnemonic functions (BIP39)
  • All published mnemonic dictionaries
  • Curve math, deterministic ECDSA, verification and encryption functions
  • Address functions (P2PKH and P2SH/BIP16)
  • Stealth addresses functions[1] for wallets and blockchain search
  • Wire and text serializable type library (P2P protocol)
  • Bitcoin script engine (see libbitcoin-consensus for more information)
  • Asynchronous P2P networking stack built on ASIO (moved to libbitcoin-network in version 3)

General Purpose Features

Build and Quality Control

  • Autotools builds for GCC/Clang
  • All build artifacts generated by libbitcoin-build
  • Continuous integration builds via Travis-CI
  • Automated test coverage reporting via Coverall
  • Visual Studio 2013 project and solution files
  • Support for 32/64 bit processors and endianness differences
  • Uses C++11 advancements and restricts use of pointers and exceptions

Dependencies (Version2)

Dependencies (Version3)

See Also

References