https://github.com/namecoin/ncprop279
Bridge between Tor Prop279 (Pluggable Naming) clients and Namecoin.
https://github.com/namecoin/ncprop279
anonymity anticensorship blockchain civil-liberties decentralized dns free-speech hacktoberfest human-rights internet-freedom namecoin p2p pluggable privacy prop279 tor
Last synced: 5 months ago
JSON representation
Bridge between Tor Prop279 (Pluggable Naming) clients and Namecoin.
- Host: GitHub
- URL: https://github.com/namecoin/ncprop279
- Owner: namecoin
- License: gpl-3.0
- Created: 2019-06-23T20:17:12.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-09-03T23:33:31.000Z (almost 3 years ago)
- Last Synced: 2024-06-19T17:48:15.240Z (about 2 years ago)
- Topics: anonymity, anticensorship, blockchain, civil-liberties, decentralized, dns, free-speech, hacktoberfest, human-rights, internet-freedom, namecoin, p2p, pluggable, privacy, prop279, tor
- Language: Go
- Homepage: https://www.namecoin.org/
- Size: 94.7 KB
- Stars: 1
- Watchers: 4
- Forks: 5
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tor Prop279 Provider for Namecoin
`ncprop279` acts as a bridge between Tor Prop279 clients and Namecoin; it can be used for Namecoin naming in Tor. Unlike `dns-prop279`, it does not use the DNS wire protocol. This reduces attack surface and binary size, but prevents delegation from Namecoin to DNS via NS/DS records.
## Usage
You need [StemNS](https://github.com/namecoin/StemNS) or [TorNS](https://github.com/meejah/TorNS) in order to use `ncprop279`. You also need a Namecoin lookup client such as Namecoin Core, ConsensusJ-Namecoin, or Electrum-NMC. Your StemNS/TorNS services configuration might look like this:
```
_service_to_command = {
"bit.onion": ['/path/to/ncprop279'],
"bit": ['/path/to/ncprop279'],
}
```
ncprop279 can be configured by arguments on the command line (see `ncprop279 -help`)
or by the same arguments listed in a configuration file. An example configuration
file is provided in `ncprop279.conf` in this repository, uncomment and edit any
desired lines. Note that the `[ncprop279]` section header is required. This configuration
file will not be used automatically. To specify command line arguments directly
or give a path to the configuration file, append to the list in the map
mentioned above:
"bit.onion": ['/path/to/ncprop279', '-conf=/path/to/ncprop279.conf']
## Security Notes
* `ncprop279` hasn't been carefully checked for proxy leaks.
* Using `ncprop279` will make you stand out from other Tor users.
* Stream isolation for streams opened by applications (e.g. Tor Browser) should work fine.
* Stream isolation metadata is passed through to the Namecoin lookup client, so any network traffic produced as a result of your lookups (e.g. traffic between Electrum-NMC and ElectrumX) will be stream-isolated.
* Lookups are cached; the cache is stream-isolated.
* This whole thing is highly experimental! Please test it and give feedback, but **don't rely on it behaving correctly**.
## License
ncprop279 is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
ncprop279 is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with ncprop279. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).
ncprop279 is produced independently from the Tor® anonymity software and carries no guarantee from The Tor Project about quality, suitability or anything else.