Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ronnix/oneid

OneID — NameCoin-based identity
https://github.com/ronnix/oneid

hackathon identity namecoin

Last synced: 2 months ago
JSON representation

OneID — NameCoin-based identity

Awesome Lists containing this project

README

        

OneID: Namecoin-based identity
==============================

What is Namecoin?
-----------------

`Namecoin `_ is a distributed key-value
store based on the Bitcoin technology.

Namecoin's most common use is the .bit top-level domain, that
uses the ``d/`` namespace.

But you can also use it to securely store your public profile
data (name, email address, bitcoin address, GPG public key...)
in the ``id/`` namespace.

What is OneID?
-----------------

OneID acts as a presentation layer on top of the Namecoin
identity data.

It is a simple way to display a public profile, and it makes
it easy to share it using a short URL.

How do I create a profile on OneID?
-----------------------------------

You cannot create your profile through OneID at the moment.
You have to register your profile in Namecoin directly.

Your OneID profile will be available as soon as your Namecoin
identity profile has been registered.

How do I register my profile in Namecoin?
-----------------------------------------

You need to choose a username and register it in Namecoin under
the ``id/`` namespace.

The value associated with that key should be a JSON object that
contains your profile data. The required format is described in
the `Namecoin wiki `_.

Example value:

.. code-block::

{
"name": "Ronan Amicel",
"email": "[email protected]",
"bitcoin": "1NnZFxcyFoM8MBiNckhXh3jDRrjz3n43ZU",
"namecoin": "MyRZ5YHpqGiS288smQfpXtN62W9a3ZoDEg",
"photo_url": "http://www.gravatar.com/avatar/b06b5d4777e2734feb91298062539ec8?s=256"
}

If you are running your own Namecoin node, you can use the following
command to register your username:

.. code-block::

$ namecoind name_new id/

Make a note of the short hexadecimal number in the response
(````), as you will need to use it in the next command.

It is then recommended that you wait for at least 12 blocks
before you first update the name:

.. code-block::

$ namecoind name_firstupdate id/ ''

Further updates will simply be:

.. code-block::

$ namecoind name_update id/ ''

Please note that a name expire after 36,000 blocks (~250 days),
so you'll need to update it periodically to reset the
expiration time.

You can also follow `these detailed instructions `_
that describe to how to register a Namecoin domain name.
Just make sure to replace the ``d/`` prefix (*domains*) with
``id/`` (*identity*) in the examples.

About
-----

OneID was built by `Ronan Amicel `_ during
the first `Paris Bitcoin Hackathon `_.

It was built with `Python `_,
the `Pyramid `_ web framework
and the `python-bitcoinlib `_ library.

Thanks to
---------

- Thomas Miedema for helping me shape the idea and for the
great time we had at the hackathon
- `Stéphane Bortzmeyer `_
for early feedback and testing

Related projects
----------------

- `OneName `_: Namecoin-based profiles using the ``u/`` namespace.