Namecoin

This project is funded by NLnet through these subgrants:

Options

services.namecoind.enable

Whether to enable namecoind, Namecoin client.

Type:
boolean
Default:
false
services.namecoind.extraNodes

List of additional peer IP addresses to connect to.

Type:
list of string
Default:
[ ]
services.namecoind.generate

Whether to generate (mine) Namecoins.

Type:
boolean
Default:
false
services.namecoind.rpc.address

IP address the RPC server will bind to.

Type:
string
Default:
"0.0.0.0"
services.namecoind.rpc.allowFrom

List of IP address ranges allowed to use the RPC API. Wiledcards (*) can be user to specify a range.

Type:
list of string
Default:
[ "127.0.0.1" ]
services.namecoind.rpc.certificate

Certificate file for securing RPC connections.

Type:
null or absolute path
Default:
null
services.namecoind.rpc.key

Key file for securing RPC connections.

Type:
null or absolute path
Default:
null
services.namecoind.rpc.password

Password for RPC connections.

Type:
null or string
Default:
null
services.namecoind.rpc.port

Port the RPC server will bind to.

Type:
16 bit unsigned integer; between 0 and 65535 (both inclusive)
Default:
8332
services.namecoind.rpc.user

User name for RPC connections.

Type:
null or string
Default:
null
services.namecoind.trustedNodes

List of the only peer IP addresses to connect to. If specified no other connection will be made.

Type:
list of string
Default:
[ ]
services.namecoind.wallet

Wallet file. The ownership of the file has to be namecoin:namecoin, and the permissions must be 0640.

Type:
absolute path
Default:
"/var/lib/namecoind/wallet.dat"
services.ncdns.address

The IP address the ncdns resolver will bind to. Leave this unchanged if you do not wish to directly expose the resolver.

Type:
string
Default:
"[::1]"
services.ncdns.dnssec.enable

Whether to enable DNSSEC support in ncdns. This will generate KSK and ZSK keypairs (unless provided via the options {option}services.ncdns.dnssec.publicKey, {option}services.ncdns.dnssec.privateKey etc.) and add a trust anchor to recursive resolvers .

Type:
boolean
Default:
false
services.ncdns.dnssec.keys.private

Path to the file containing the KSK private key.

Type:
absolute path
Default:
"/var/lib/ncdns/bit.private"
services.ncdns.dnssec.keys.public

Path to the file containing the KSK public key. The key can be generated using the dnssec-keygen command, provided by the package bind as follows:

$ dnssec-keygen -a RSASHA256 -3 -b 2048 -f KSK bit
Type:
absolute path
Default:
"/var/lib/ncdns/bit.key"
services.ncdns.dnssec.keys.zonePrivate

Path to the file containing the ZSK private key.

Type:
absolute path
Default:
"/var/lib/ncdns/bit-zone.private"
services.ncdns.dnssec.keys.zonePublic

Path to the file containing the ZSK public key. The key can be generated using the dnssec-keygen command, provided by the package bind as follows:

$ dnssec-keygen -a RSASHA256 -3 -b 2048 bit
Type:
absolute path
Default:
"/var/lib/ncdns/bit-zone.key"
services.ncdns.enable

Whether to enable ncdns, a Go daemon to bridge Namecoin to DNS. To resolve .bit domains set services.namecoind.enable = true; and an RPC username/password .

Type:
boolean
Default:
false
services.ncdns.identity.address

The IP address the hostname specified in {option}services.ncdns.identity.hostname should resolve to. If you are only using ncdns locally you can ignore this.

Type:
string
Default:
"127.127.127.127"
services.ncdns.identity.hostmaster

An email address for the SOA record at the bit zone. If you are only using ncdns locally you can ignore this.

Type:
string
Default:
""
services.ncdns.identity.hostname

The hostname of this ncdns instance, which defaults to the machine hostname. If specified, ncdns lists the hostname as an NS record at the zone apex:

bit. IN NS ns1.example.com.

If unset ncdns will generate an internal pseudo-hostname under the zone, which will resolve to the value of {option}services.ncdns.identity.address. If you are only using ncdns locally you can ignore this.

Type:
string
Default:
config.networking.hostName
services.ncdns.port

The port the ncdns resolver will bind to.

Type:
16 bit unsigned integer; between 0 and 65535 (both inclusive)
Default:
5333
services.ncdns.settings

ncdns settings. Use this option to configure ncds settings not exposed in a NixOS option or to bypass one. See the example ncdns.conf file at https://github.com/namecoin/ncdns/blob/master/_doc/ncdns.conf.example for the available options.

Type:
TOML value
Default:
{ }

Examples

  • It is also possible to permanently enable experimental Namecoin resolution with Tor Browser. 
    { pkgs, ... }:
{
  environment.systemPackages = with pkgs; [ tor-browser ];
  environment.variables.TOR_ENABLE_NAMECOIN = 1;
}
  • To enable experimental Namecoin resolution with Tor Browser, run: ```shell-session TOR_ENABLE_NAMECOIN=1 tor-browser ``` 
    { pkgs, ... }:
{
  environment.systemPackages = with pkgs; [ tor-browser ];
}