Skip to content
Snippets Groups Projects
Select Git revision
  • cert_pk_id
  • master default
  • proxy_push_result
  • cnode_put_id
  • update-windows-build
  • proxy
  • resubscribe_on_token_change
  • actions
  • client_mode
  • llhttp
  • search_node_add
  • crypto_aes_gcm_argon2
  • ios_notifications
  • log_fmt
  • v2asio
  • fix-msvc
  • message_split
  • meson
  • build_unify
  • pingpush
  • v3.4.0
  • v3.3.1
  • v3.3.1rc1
  • v3.3.1rc2
  • v3.3.0
  • v3.2.0
  • v3.1.11
  • v3.1.10
  • v3.1.9
  • v3.1.8.2
  • v3.1.8.1
  • v3.1.8
  • v3.1.7
  • v3.1.6
  • v3.1.5
  • v3.1.4
  • v3.1.3
  • v3.1.2
  • v3.1
  • v3.0.1
40 results

opendht

  • Clone with SSH
  • Clone with HTTPS
  • Adrien Béraud's avatar
    Adrien Béraud authored
    * removed OpenSSL exception
      (OpenDHT doesn't make use of OpenSSL)
    * properly capitalize "Savoir-faire Linux"
    7e346cfc
    History

    OpenDHT

    A lightweight C++11 Distributed Hash Table implementation originally based on https://github.com/jech/dht by Juliusz Chroboczek.

    • Light and fast C++11 Kademlia DHT library.
    • Distributed shared key->value data-store
    • Clean and powerfull distributed map API with storage of arbitrary binary values.
    • Optional public key cryptography layer providing data signature and encryption (using GnuTLS).
    • IPv4 and IPv6 support.
    • Python binding.

    Documentation

    See the wiki: https://github.com/savoirfairelinux/opendht/wiki

    Examples

    C++ example

    The tools directory includes simple example programs :

    • dhtnode, a command line tool, mostly used for debuging, allowing to perform operations supported by the library (get, put etc.) with text values.
    • dhtchat, a very simple IM client working over the dht.

    Example program launching a DHT node, connecting to the network and performing some basic operations:

    #include <opendht.h>
    #include <vector>
    
    int main()
    {
        dht::DhtRunner node;
    
        // Launch a dht node on a new thread, using a
        // generated RSA key pair, and listen on port 4222.
        node.run(4222, dht::crypto::generateIdentity(), true);
    
        // Join the network through any running node,
        // here using a known bootstrap node.
        node.bootstrap("bootstrap.ring.cx", "4222");
    
        // put some data on the dht
        std::vector<uint8_t> some_data(5, 10);
        node.put("unique_key", some_data);
    
        // put some data on the dht, signed with our generated private key
        node.putSigned("unique_key_42", some_data);
    
        // get data from the dht
        node.get("other_unique_key", [](const std::vector<std::shared_ptr<dht::Value>>& values) {
            // Callback called when values are found
            for (const auto& value : values)
                std::cout << "Found value: " << *value << std::endl;
            return true; // return false to stop the search
        });
    
        // here we could wait for some operations to complete
        // instead of ending now.
    
        // wait for dht threads to end
        node.join();
        return 0;
    }

    Python 3 example

    import opendht as dht
    
    r = dht.DhtRunner()
    r.run()
    
    # Join the network through any running node,
    # here using a known bootstrap node.
    r.bootstrap("bootstrap.ring.cx", "4222")
    
    r.put(dht.InfoHash.get("unique_key"), dht.Value(b'some binary data'))
    
    # blocking call (provide a get_cb and an optional done_cb argument to make the call non-blocking)
    results = r.get(dht.InfoHash.get("unique_key"))
    for r in results:
        print(r)

    How-to build and install

    Using autotools

    # clone the repo
    git clone https://github.com/savoirfairelinux/opendht.git
    
    # build and install
    cd opendht
    ./autogen.sh && ./configure
    make
    sudo make install

    Using cmake

    # clone the repo
    git clone https://github.com/savoirfairelinux/opendht.git
    
    # build and install
    cd opendht
    mkdir build && cd build
    cmake -DOPENDHT_PYTHON=ON ..
    make -j
    sudo make install

    How-to build a simple client app

    g++ main.cpp -std=c++11 -lopendht -lgnutls

    Licence

    Copyright (C) 2014-2015 Savoir-Faire Linux Inc.

    Licenced under the GNU General Public License version 3, though the core routing library (dht.cpp) is licenced under the MIT licence.

    This project is independent from another project called OpenDHT (Sean Rhea. Ph.D. Thesis, 2005), now extinct.

    Dependencies

    • msgpack-c 1.0+, used for data serialization.
    • GnuTLS 3.1+, used for cryptographic operations.
    • Nettle 2.4+, a GnuTLS dependency for crypto.
    • Build tested with GCC 4.8+ (Linux, Android, Windows with MinGW), Clang/LLVM (Linux, OS X).