mjethani / blockstore

Key-value store for name registration and data storage on the Bitcoin blockchain

Blockstore: A Key-Value Store on Bitcoin

Blockstore is a generic key-value store on Bitcoin. You can use it register globally unique names, associate data with those names, and transfer them between Bitcoin addresses.

Then, you or anyone can perform lookups on those names and securely obtain the data associated with them.

Blockstore uses the Bitcoin blockchain for storing name operations and data hashes, and the Kademlia distributed hash table for storing the full data files.

Installation

pip install blockstore

Getting Started

First, start blockstored and index the blockchain:

$ blockstored start

Then, perform name lookups:

$ blockstore-cli lookup swiftonsecurity
{
    "data": "{\"name\":{\"formatted\": \"Taylor Swift\"}}"
}

Next, learn how to register names of your own, as well as transfer them and associate data with them:

Full usage docs

Design

Design decisions

Protocol details

Definitions

FAQ

Contributions

The best way to contribute is to:

1. decide what changes you'd like to make (you can find inspiration in the tab of issues)
2. fork the repo
3. make your changes
4. submit a pull request

Code contributors

Full contributor list

License

Released under the MIT License

Copyright 2015, openname.org