Namecoin integration/staging tree


See for more project information.

Namecoin is a peer to peer naming system based on bitcoin. It is a secure and censorship resistant replacement for DNS.

Ownership of a name is based on ownership of a coin, which is in turn based on public key cryptography. The namecoin network reaches consensus every few minutes as to which names have been reserved or updated.

It is envisioned that the .bit domain be used for gluing namecoin domain names into the DNS. This can be done close to the user or even by the user.

See for more general information.


Stable releases: only releases a tag that starts with “nc”, that are signed and that do not end with -rc0-9 should be considered stable. All others are experimental.

IMPORTANT VALIDATION CHANGES at block 19200 and 24000!

  • Effective at block 19200, merged mining comes into effect
  • Also effective at block 19200, timetravel (2015-2016 retarget) hole is closed
  • Effective at block 24000, names registered at block 12000 onward will expire after 36000 blocks instead of the current value of 12000
  • Also effective at block 24000, the decline in network fees will speed up by a factor of 4

You must upgrade to the latest version nc0.3.24.* before block 19200 or your client will start rejecting blocks and will be unable to participate in the network.


The Bitcoin protocol is augmented with namecoin operations, to reserve, register and update names. In addition to DNS like entries, arbitrary name/value pairs are allowed and multiple namespaces will be available. This will include a personal handle namespace mapping handles to public keys and personal address data.

The protocol differences from bitcoin include:

  • Different blockchain, port, IRC bootstrap and message header
  • New transaction types: new, first-update, update
  • Validation on the new transaction types
  • RPC calls for managing names
  • Network fees to slow down the initial rush

Please read before proceeding.


Building is supported on Linux, Windows and Mac. Follow the bitcoin build instructions. Use “makefile.unix” for linux - it will generate namecoind. Usage is similar to bitcoind, plus new RPC calls for the new operations. A GUI is on the roadmap.


You can acquire namecoins in the usual bitcoin way, by mining or by reciving some from others. After you have acquired some namecoins, use:

namecoind name_new d/<name>

This will reserve a name but not make it visible yet. Make a note of the short hex number. You will need it for the next step. (Do not shut down namecoind or you will also have to supply the longer hex code below.) Wait about 12 blocks, then issue:

namecoind name_firstupdate d/<name> <rand> <value>

<rand> is the short hex number from the previous step. This step will make the name visible to all.

after the first update, you can do more updates with:

namecoind name_update d/<name> <value>

and transfer to another person:

namecoind name_update d/<name> <value> <address>

dump your list of names:

namecoind name_list

dump the global list:

namecoind name_scan


Values for names in the d/ namespace are JSON encoded. The simplest value is of this form:

{“”: “”, “map”: {“www”: “”}}

A full specification is in progress.

DNS conduits

SOCKS5/Tor name resolver: See ncproxy in the client sub-directory.

In the near future gzip encoding of the value will be possible, but ncproxy does not support this yet.


  • DNS zone conduit to allow normal DNS server to serve the .bit domain
  • Firefox/chrome/… plugins
  • GUI

Related Repositories



Legacy client. New version here: Note the release branch! - Official website: ...



Vince's tree - see namecoin/namecoin for main integration tree ...



Reimplementation of Namecoin on top of the current Bitcoin Core codebase. ...



NamecoinToBind is a php script that generates bind zones for .bit domains from the namecoin blockchain by using the name_scan rpc command. ...



Namecoin integration/staging tree ...

Top Contributors

gavinandresen vinced khalahan sipa TheBlueMatt dooglus jordanlewis mgiuca doublec codler jrmithdobbs namecoin-qt devrandom EricJ2190 CAFxX muggenhor mhanne wizeman laanwj coblee makomk amiryal kR105 witten dlo dholbert spiechu xslidian lachesis Unreal89


-   vQ.3.72 zip tar
-   vQ.3.71 zip tar
-   vQ.3.71c zip tar
-   vQ.3.71b zip tar
-   vQ.3.70b zip tar
-   v0.3.70 zip tar
-   nc0.3.51.00 zip tar
-   nc0.3.50.01 zip tar
-   nc0.3.50.00 zip tar
-   nc0.3.24.66 zip tar
-   nc0.3.24.65 zip tar
-   nc0.3.24.64 zip tar
-   nc0.3.24.63 zip tar
-   nc0.3.24.62 zip tar
-   nc0.3.24.61 zip tar
-   nc0.3.24.60 zip tar
-   nc0.3.24.55-rc5 zip tar
-   nc0.3.24.54-rc4 zip tar
-   nc0.3.24.53-rc3 zip tar
-   nc0.3.24.53-rc2 zip tar
-   nc0.3.24.51-rc1 zip tar
-   nc0.3.21.91 zip tar