d0s3t3ch/wownero
1
0
Fork 0
mirror of https://git.wownero.com/wownero/wownero.git synced 2024-08-15 01:03:23 +00:00
Code Issues Projects Releases Wiki Activity
much wow
11314 commits 21 branches 51 tags 204 MiB
C++ 81.9%
C 11.6%
Python 2.8%
CMake 1.9%
Makefile 0.6%
Other 1%
Find a file
wowario 589efde6b3
update README
2024-03-15 11:13:11 +03:00
.github Merge pull request #8566 2023-06-27 11:20:25 -05:00
cmake depends: bump hidapi/libusb 2023-01-25 21:52:42 +01:00
contrib Revert "http_client: reduce number of packets sent for small bodies" 2024-03-15 10:22:07 +03:00
docs docs: omit i2p port number from ANONYMITY_NETWORKS 2024-02-21 01:03:11 +01:00
external add RandomWOW 2024-03-09 15:48:35 +03:00
src ringct: fix trunc_amount field name change 2024-03-15 10:22:41 +03:00
tests unit_tests: fix strtoul unit test 2024-03-07 16:10:01 +01:00
translations Copyright: Update to 2022 2022-03-04 06:59:20 +01:00
utils Add _xxfedexx_'s PGP key 2024-03-09 16:04:57 +03:00
.gitattributes cmake: support git info in released tarballs 2014-10-23 16:42:34 -04:00
.gitignore Ignore gitian build files 2022-05-12 15:42:48 -05:00
.gitmodules Update RandomWOW to 1.2.1-wow 2024-03-09 16:09:46 +03:00
CMakeLists.txt automatic submodule update 2024-03-09 15:54:20 +03:00
CMakeLists_IOS.txt Copyright: Update to 2022 2022-03-04 06:59:20 +01:00
Dockerfile update Dockerfile 2024-03-09 15:58:09 +03:00
Doxyfile Doxygen: Hide anonymous namespaces from documentation by default 2022-04-28 19:35:49 -05:00
LICENSE Update copyright to 2022 for Hardfork files 2022-04-29 11:12:36 +02:00
Makefile trezor support off 2024-03-09 15:54:17 +03:00
README.md update README 2024-03-15 11:13:11 +03:00

README.md

MoWownero - Such privacy! Many coins! Wow!

Introduction

Wownero is a Doge-inspired, CPU-mineable, solo-mining only, privacy-respecting memecoin. It was fairly launched on April Fools' Day in 2018. It is a software fork of Monero, but with a lite version of RandomX, larger ring size, and a fixed supply of 184 million coins emitted over 50 years. Wownero has no trusted setup, premine, or dev tax. Besides betting on online snail racing, the main use case of Wownero is micro-tipping meme creators with sound magic internet money. As a 100% community-driven, free and open source software, Wownero does not depend on billionaire shills or lame ass "influencers."

Unlike Opposing Projects.

Resources

Exchanges

Wallets

Blockchain Explorers

Supporting the project

Wownero is a 100% community-sponsored endeavor. Supporting services are also graciously provided by sponsors:

MacStadium JetBrains

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 the dev slush fund.

Donation Addresses

WOW: Wo3MWeKwtA918DU4c69hVSNgejdWFCRCuWjShRY66mJkU2Hv58eygJWDJS1MNa2Ge5M1WjUkGHuLqHkweDxwZZU42d16v94mP

  • view key: e62e40bfd5ca7e3a7f199602a3c97df511780489e1c1861884b00c28abaea406

XMR: 44SQVPGLufPasUcuUQSZiF5c9BFzjcP8ucDxzzFDgLf1VkCEFaidJ3u2AhSKMhPLKA3jc2iS8wQHFcaigM6fXmo6AnFRn5B

  • view key: cb83681c31db0c79adf18f25b2a6d05f86db1109385b4928930e2acf49a3ed0b

BTC: bc1qcw9zglp3fxyl25zswemw7jczlqryms2lsmu464

Release staging and Contributing

Anyone is welcome to contribute to Wownero's codebase!

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.

Things to Do, Work in Progress, and Help Wanted tasks are tracked in the Meta repo.

Join #wownero on IRC OFTC to participate in development conversation.

Scheduled software upgrades

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.

Software upgrade block height Date Release Name Minimum Wownero version Recommended Wownero version Details
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
253,999 2020-10-09 Illiterate Illuminati v0.9.0.0 v0.9.3.3 Dynamic coinbase unlock (up to 1 mo.), Deterministic unlock times, Enforce maximum coinbase amount, show_qr_code wallet command, CLSAG
331,170 2021-07-04 Junkie Jeff v0.10.0.0 v0.10.2.0 Bulletproofs+, Miner Block Header Signing, Vote by Block, Change coinbase unlock time to 1 day, Reset difficulty and switch back to Monero's difficulty algorithm
514,000 2023-04-01 Kunty Karen v0.11.0.0 v0.11.2.0 View tags, fee changes, adjusted dynamic block weight algorithm, multisig security fixes, RPC broadcast node donation sub-address, Limit tx_extra max size to ~1kb, 12-hour difficulty adjustment window

X's indicate that these details have not been determined as of commit date.

* indicates estimate as of commit date

Installing from a package

Packages are available for

  • Arch Linux/Manjaro

      yay -S wownero-git

  • Gentoo - Russian hacking tool

      emerge --noreplace eselect-repository
  eselect repository enable monero
  emaint sync -r monero
  echo '*/*::monero ~amd64' >> /etc/portage/package.accept_keywords
  emerge net-p2p/wownero

  • NixOS

      nix-shell -p wownero

Packaging for your favorite distribution would be a welcome contribution!

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.

Building from Source

  • Docker

      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

  • Arch Linux/Manjaro

      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

  • Debian/Ubuntu

      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

Running Binaries

The build places the binary in bin/ sub-directory within the build directory from which cmake was invoked (repository root by default). To run in the foreground:

./bin/wownerod

To list all available options, run ./bin/wownerod --help. Options can be 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 of the argument without the leading dashes, for example, log-level=1.

To run in background:

./bin/wownerod --log-file wownerod.log --detach

To run as a systemd service, copy wownerod.service to /etc/systemd/system/ and wow.conf to /etc/. The example service assumes that the user wownero exists and its home is the data directory specified in the example config.

Once node is synced to network, run the CLI wallet by entering:

./bin/wownero-wallet-cli

Type help in CLI wallet to see standard commands (for advanced options, type help_advanced).

Tor Anonymity Network

Ubuntu

  • sudo apt-get update && sudo apt-get install tor -y
  • sudo nano /etc/tor/torrc

add the following:

HiddenServiceDir /var/lib/tor/wownero/
HiddenServicePort 34569 127.0.0.1:34569
HiddenServicePort 34566 127.0.0.1:34566
HiddenServiceVersion 3

save and close nano

  • sudo /etc/init.d/tor restart && sudo systemctl enable tor
  • copy wow.conf file and save it in same directory as wownerod.
  • start wownerod like this:
./wownerod --config-file=wow.conf
  • sudo cat /var/lib/tor/wownero/hostname copy your onion address and share node with others here and here

To share your node over p2p, uncomment first line of wownerod.conf and add your onion address.

More information on running Tor and i2p nodes is available here

Access remote Tor node from CLI wallet

./wownero-wallet-cli --proxy 127.0.0.1:9050 --daemon-address iy6ry6uudpzvbd72zsipepukp6nsazjdu72n52vg3isfnxqn342flzad.onion:34568

Copyright (c) 2014-2024 The Monero Project.
Portions Copyright (c) 2012-2013 The Cryptonote developers.