2018-12-02 14:29:51 +00:00
[![Build Status ](https://ci.wownero.com/api/badges/wownero/wownero/status.svg )](https://ci.wownero.com/wownero/wownero)
# ~~Mo~~Wownero - Such privacy! Many coins! Wow! 🐕
2014-08-30 06:58:01 +00:00
2020-05-07 02:36:54 +00:00
Copyright (c) 2014-2020 The Monero Project.
2017-10-19 13:21:52 +00:00
Portions Copyright (c) 2012-2013 The Cryptonote developers.
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
# CyberWOW
An Android pruned full node for Wownero
[< img src = "https://git.wownero.com/wownero/meta/raw/branch/master/images/fdroid_badge.png"
alt="Get it on F-Droid"
height="80">](https://f-droid.org/en/packages/org.wownero.cyberwow/)
< a href = 'https://play.google.com/store/apps/details?id=org.wownero.cyberwow' > < img alt = 'Get it on Google Play' src = 'https://git.wownero.com/wownero/meta/raw/branch/master/images/google_badge.png' height = '80' / > < / a >
# Wownerujo
An Android Wallet for Wownero
[< img src = "https://git.wownero.com/wownero/meta/raw/branch/master/images/fdroid_badge.png"
alt="Get it on F-Droid"
height="80">](https://f-droid.org/packages/com.wownero.wownerujo/)
< a href = 'https://play.google.com/store/apps/details?id=com.wownero.wownerujo' > < img alt = 'Get it on Google Play' src = 'https://git.wownero.com/wownero/meta/raw/branch/master/images/google_badge.png' height = '80' / > < / a >
## Resources
- Web: [wownero.org ](http://wownero.org )
- Twitter: [@w0wn3r0 ](https://twitter.com/w0wn3r0 )
- Reddit: [/r/wownero ](https://www.reddit.com/r/wownero )
- Mail: [wownero@protonmail.com ](mailto:wownero@protonmail.com )
- GitHub: [git.wownero.com/wownero/wownero ](https://git.wownero.com/wownero/wownero )
- IRC: [#wownero on Freenode ](https://kiwiirc.com/client/irc.freenode.net/?nick=suchchatter|?#wownero )
- Bitmessage Chan: wownero (`BM-2cSzWtrj2pzLva9GF1Jp2TYsnLjrnJpvba`)
- Wownero Funding System: [funding.wownero.com ](https://funding.wownero.com )
- Wownero Forum: [forum.wownero.com ](https://forum.wownero.com )
- Discord: [discord.gg/abgaJbN ](https://discord.gg/abgaJbN )
- Telegram: [t.me/wownero ](https://t.me/wownero )
Blockchain Explorers
- https://explore.wownero.com
- https://explorer.wowkira.com
- http://wow5eqtzqvsg5jctqzg5g7uk3u62sfqiacj5x6lo4by7bvnj6jkvubyd.onion
- https://wownero.xmrauctions.com
Free Public Nodes
- wow7dhbgiljnkspkzpjyy66auegbrye2ptfv4gucgbhireg5rrjza5ad.onion:34568
- so.wow.candy.surf:34568 (US)
- such.wow.candy.surf:34568 (CAN)
- very.wow.candy.surf:34568 (IN)
- much.wow.candy.surf:34568 (UK)
- node.suchwow.xyz:34568 (US)
Tor Peers
- wowp2p5gelm6vhl2d5tvfqills63jilgy6hkvlrqljooov5ktaxgqdad.onion
- f3moshycuklu3mb3wnlfjwn26nsgzreqtfzfuyjjk46u7jqxlhf7d5id.onion
2016-10-31 20:55:57 +00:00
2014-08-30 06:58:01 +00:00
## Introduction
2018-12-02 14:29:51 +00:00
Wownero is a privacy-centric memecoin that was fairly launched on April 1, 2018 with no pre-mine, stealth-mine or ICO. Wownero has a maximum supply of around 184 million WOW with a slow and steady emission over 50 years. It is a fork of Monero, but with its own genesis block, so there is no degradation of privacy due to ring signatures using different participants for the same tx outputs on opposing forks.
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
## Supporting the project
2019-01-14 04:40:13 +00:00
2018-12-02 14:29:51 +00:00
Wownero is a 100% community-sponsored endeavor. Supporting services are also graciously provided by sponsors:
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
[< img src = "https://git.wownero.com/wownero/meta/raw/branch/master/images/macstadium.png"
alt="MacStadium"
height="100">](https://www.macstadium.com)
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
Developers are volunteers doing this mostly for shits and giggles. If you would like to support our shenanigans and stimulant addictions, please consider donating to [WFS proposals ](https://funding.wownero.com/proposals ) or the dev slush fund.
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
Donation Addresses
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
WOW: `Wo3MWeKwtA918DU4c69hVSNgejdWFCRCuWjShRY66mJkU2Hv58eygJWDJS1MNa2Ge5M1WjUkGHuLqHkweDxwZZU42d16v94mP`
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
- view key: `e62e40bfd5ca7e3a7f199602a3c97df511780489e1c1861884b00c28abaea406`
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
XMR: `44SQVPGLufPasUcuUQSZiF5c9BFzjcP8ucDxzzFDgLf1VkCEFaidJ3u2AhSKMhPLKA3jc2iS8wQHFcaigM6fXmo6AnFRn5B`
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
- view key: `cb83681c31db0c79adf18f25b2a6d05f86db1109385b4928930e2acf49a3ed0b`
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
BTC: `bc1qcw9zglp3fxyl25zswemw7jczlqryms2lsmu464`
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
## Release staging and Contributing
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
**Anyone is welcome to contribute to Wownero's codebase!**
2015-02-03 11:05:28 +00:00
2018-12-02 14:29:51 +00:00
If you have a fix or code change, feel free to submit it as a pull request. Ahead of a scheduled software upgrade, a development branch will be created with the new release version tag. Pull requests that address bugs should be made to Master. Pull requests that require review and testing (generally, optimizations and new features) should be made to the development branch. All pull requests will be considered safe until the US dollar valuation of 1 Wownero equals $1000. After this valuation has been reached, more research will be needed to introduce experimental cryptography and/or code into the codebase.
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
Things to Do, Work in Progress, and Help Wanted tasks are tracked in the [Meta ](https://git.wownero.com/wownero/meta/issues ) repo.
2014-08-30 06:58:01 +00:00
2018-12-02 14:29:51 +00:00
Join `#wownero-dev` on IRC freenode to participate in development conversation.
2017-04-09 19:32:25 +00:00
2018-03-21 16:27:21 +00:00
## Scheduled software upgrades
2016-10-11 03:22:13 +00:00
2018-12-02 14:29:51 +00:00
Wownero uses a fixed-schedule software upgrade (hard fork) mechanism to implement new features. This means that users of Wownero (end users and service providers) should run current versions and upgrade their software on a regular schedule. The required software for these upgrades will be available prior to the scheduled date. Please check the repository prior to this date for the proper Wownero software version. Below is the historical schedule and the projected schedule for the next upgrade.
Dates are provided in the format YYYY-MM-DD.
2016-10-11 03:22:13 +00:00
2018-12-02 14:29:51 +00:00
| Software upgrade block height | Date | Release Name | Minimum Wownero version | Recommended Wownero version | Details |
2017-09-20 21:32:56 +00:00
| ------------------------------ | -----------| ----------------- | ---------------------- | -------------------------- | ---------------------------------------------------------------------------------- |
2018-12-02 14:29:51 +00:00
| 1 | 2018-04-01 | Awesome Akita | v0.1.0.0 | v0.1.0.0 | Cryptonight variant 1, ringsize >= 8, sorted inputs
| 69,69 | 2018-04-24 | Busty Brazzers | v0.2.0.0 | v0.2.0.0 | Bulletproofs, LWMA difficulty algorithm, ringsize >= 10, reduce unlock to 4
| 53,666 | 2018-10-06 | Cool Cage | v0.3.0.0 | v0.3.1.3 | Cryptonight variant 2, LWMA v2, ringsize = 22, MMS
| 63,469 | 2018-11-11 | Dank Doge | v0.4.0.0 | v0.4.0.0 | LWMA v4
| 81,769 | 2019-02-19 | Erotic EggplantEmoji | v0.5.0.0 | v0.5.0.2 | Cryptonight/wow, LWMA v1 with N=144, Updated Bulletproofs, Fee Per Byte, Auto-churn
| 114,969 | 2019-06-14 | F For Fappening | v0.6.1.0 | v0.6.1.2 | RandomWOW, new block weight algorithm, slightly more efficient RingCT format
| 160,777 | 2019-11-20 | Gaping Goatse | v0.7.0.0 | v0.7.1.0 | Only allow >= 2 outputs, change to the block median used to calculate penalty, rct sigs in coinbase forbidden, 4 unlock time as protocol rule
| - | 2020-06-28 | Hallucinogenic Hypnotoad | v0.8.0.0 | v0.8.0.2 | Dandelion++ support
| XXXX | 2020-09-XX | XXXXX | v0.9.0.0 | v0.9.0.0 | RandomWOW v2 (WOWv2), increase coinbase unlock to 8,640 (1 mo.), CLSAG
2017-09-20 21:32:56 +00:00
2018-03-07 15:39:18 +00:00
X's indicate that these details have not been determined as of commit date.
2019-11-04 02:36:04 +00:00
\* indicates estimate as of commit date
2016-10-11 03:22:13 +00:00
2018-12-02 14:29:51 +00:00
## Installing from a package
2018-05-10 01:48:19 +00:00
Packages are available for
2018-12-02 14:29:51 +00:00
* Arch Linux/Manjaro
2020-08-15 14:26:51 +00:00
2018-12-02 14:29:51 +00:00
yay -S wownero-git
2020-08-15 14:26:51 +00:00
2018-12-02 14:29:51 +00:00
* NixOS
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
nix-shell -p wownero
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
* Ubuntu 18.04/Ubuntu 16.04/Debian 9/Debian 8 (amd64)
2018-05-10 01:48:19 +00:00
2020-06-10 11:26:58 +00:00
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 8BC34ABB48E565F0
2018-12-02 14:29:51 +00:00
sudo add-apt-repository "deb http://ppa.wownero.com/ bionic main"
sudo apt-get update
sudo apt-get install wownero
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
Packaging for your favorite distribution would be a welcome contribution!
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
**DISCLAIMER: These packages are not part of this repository, and as such, do not go through the same review process to ensure their trustworthiness and security.**
2020-08-15 14:26:51 +00:00
2018-12-02 14:29:51 +00:00
## Building from Source
2020-08-15 14:26:51 +00:00
2018-05-10 01:48:19 +00:00
* Docker
2018-12-02 14:29:51 +00:00
git clone https://git.wownero.com/wownero/wownero & & cd wownero
docker build -t git-wow:master -m 4g .
docker run -it -p 34567:34567 -p 34568:34568 -w /home/wownero/build/release/bin git-wow:master bash
2019-06-22 20:42:42 +00:00
2018-12-02 14:29:51 +00:00
* Arch Linux/Manjaro
2019-06-22 20:42:42 +00:00
2018-12-02 14:29:51 +00:00
sudo pacman -Syu & & sudo pacman -S base-devel cmake boost openssl zeromq libpgm unbound libsodium git libusb systemd
git clone https://git.wownero.com/wownero/wownero & & cd wownero
make -j2
2019-06-22 20:42:42 +00:00
2018-12-02 14:29:51 +00:00
* Debian/Ubuntu
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
sudo apt update & & sudo apt install build-essential cmake pkg-config libboost-all-dev libssl-dev libzmq3-dev libunbound-dev libsodium-dev libunwind8-dev liblzma-dev libreadline6-dev libldns-dev libexpat1-dev libpgm-dev libhidapi-dev libusb-1.0-0-dev libprotobuf-dev protobuf-compiler libudev-dev git -y
git clone https://git.wownero.com/wownero/wownero & & cd wownero
make -j2
2018-07-03 16:44:03 +00:00
2018-05-10 01:48:19 +00:00
2018-12-02 14:29:51 +00:00
## Running Binaries
2016-05-28 20:41:00 +00:00
The build places the binary in `bin/` sub-directory within the build directory
2019-06-22 20:42:42 +00:00
from which cmake was invoked (repository root by default). To run in the
2016-05-28 20:41:00 +00:00
foreground:
2018-12-02 14:29:51 +00:00
./bin/wownerod
2016-05-28 20:41:00 +00:00
2018-12-02 14:29:51 +00:00
To list all available options, run `./bin/wownerod --help` . Options can be
2016-05-28 20:41:00 +00:00
specified either on the command line or in a configuration file passed by the
`--config-file` argument. To specify an option in the configuration file, add
a line with the syntax `argumentname=value` , where `argumentname` is the name
2019-06-22 20:42:42 +00:00
of the argument without the leading dashes, for example, `log-level=1` .
2016-05-28 20:41:00 +00:00
2016-08-25 03:05:30 +00:00
To run in background:
2018-12-02 14:29:51 +00:00
./bin/wownerod --log-file wownerod.log --detach
2016-08-25 03:05:30 +00:00
To run as a systemd service, copy
2018-12-02 14:29:51 +00:00
[wownerod.service ](utils/systemd/wownerod.service ) to `/etc/systemd/system/` and
[wownerod.conf ](utils/conf/wownerod.conf ) to `/etc/` . The [example
service](utils/systemd/wownerod.service) assumes that the user `wownero` exists
2016-08-25 03:05:30 +00:00
and its home is the data directory specified in the [example
2018-12-02 14:29:51 +00:00
config](utils/conf/wownerod.conf).
2020-05-31 22:18:14 +00:00
2018-12-02 14:29:51 +00:00
Once node is synced to network, run the CLI wallet by entering:
2016-11-21 23:00:20 +00:00
2018-12-02 14:29:51 +00:00
./bin/wownero-wallet-cli
2016-11-21 23:00:20 +00:00
2018-12-02 14:29:51 +00:00
Type `help` in CLI wallet to see standard commands (for advanced options, type `help_advanced` ).
2017-01-22 15:45:14 +00:00
2018-12-02 14:29:51 +00:00
## Tor Anonymity Network
2017-01-22 15:45:14 +00:00
2018-12-02 14:29:51 +00:00
* Install [Tor Browser ](https://www.torproject.org/download/ )
* Open `torrc` file in a text editor ([installation directory]/Browser/TorBrowser/Data/Tor/torrc) and add hidden service information as follows:
2017-01-22 15:45:14 +00:00
```
2018-12-02 14:29:51 +00:00
HiddenServiceDir [installation directory]/Browser/TorBrowser/Data/Tor/wow_node
HiddenServiceVersion 3
HiddenServicePort 44568 127.0.0.1:44568
2019-05-12 04:16:26 +00:00
```
2018-12-02 14:29:51 +00:00
* Save `torrc` file and restart Tor Browser (keep open)
* Change directory to the `wow_node` folder, open `hostname` file, and copy your node's ".onion" address
* Start wownerod with the following parameters:
2017-01-22 15:45:14 +00:00
2019-07-02 20:31:17 +00:00
```
2018-12-02 14:29:51 +00:00
./wownerod --tx-proxy tor,127.0.0.1:9150,10 --add-peer hdps3qwnusz64r7odvynmae6myc2uyvrsc2emap6636qeuzll72eouid.onion:44568 --anonymous-inbound YOUR_NODE_ADDRESS.onion:44568,127.0.0.1:44568,25
2019-05-12 04:16:26 +00:00
```
2018-09-29 20:12:56 +00:00
2018-12-02 14:29:51 +00:00
### Access remote Tor node from CLI wallet
2016-11-21 23:00:20 +00:00
2018-12-02 14:29:51 +00:00
```
./wownero-wallet-cli --proxy 127.0.0.1:9150 --daemon-address wow7dhbgiljnkspkzpjyy66auegbrye2ptfv4gucgbhireg5rrjza5ad.onion:34568
2019-05-12 04:16:26 +00:00
```
2016-11-21 23:00:20 +00:00
2018-12-02 14:29:51 +00:00
Use port `9050` instead of `9150` if you installed Tor as a standalone daemon. For more information, check out [ANONYMITY_NETWORKS ](https://git.wownero.com/wownero/wownero/src/branch/master/ANONYMITY_NETWORKS.md ).