From 5e73899cb88ccdaa95408d7c60043361ee0ce0cc Mon Sep 17 00:00:00 2001 From: wowario Date: Fri, 19 Sep 2025 00:19:09 +0300 Subject: [PATCH] add wow readme --- README.md | 147 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..32e003228 --- /dev/null +++ b/README.md @@ -0,0 +1,147 @@ +# ~~Mo~~Wownero - Such privacy! Many coins! Wow! + +[](https://suchwow.xyz/meme/157) + +## 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 + +- Web: [wownero.org](https://wownero.org) +- Twitter: [@w0wn3r0](https://twitter.com/w0wn3r0) +- Reddit: [/r/wownero](https://www.reddit.com/r/wownero) +- Mail: [wownero@wownero.org](mailto:wownero@wownero.org) +- Git: [codeberg.org/wownero/wownero](https://codeberg.org/wownero/wownero) +- Matrix General Chat Room: [#wownero-gen:wowne.ro](https://matrix.to/#/#wownero-gen:wowne.ro) +- IRC: [OFTC #wownero](https://webchat.oftc.net/?channels=wownero) +- Discord: [discord.gg/ykZyAzJhDK](https://discord.com/invite/ykZyAzJhDK) +- Telegram: [t.me/wownero](https://t.me/wownero) +- Public Node Status: [monero.fail](https://monero.fail/?chain=wownero&network=mainnet) +- Wownero Memes: [suchwow.xyz](https://suchwow.xyz) +- Market Info: [coinmarketcap.com](https://coinmarketcap.com/currencies/wownero), [coingecko.com](https://www.coingecko.com/en/coins/wownero/usd) + +## Exchanges + +- [BasicSwap DEX](https://basicswapdex.com) ([Installation Guide](https://academy.particl.io/en/latest/basicswap-guides/basicswapguides_installation.html)) +- [NonLogs](https://nonlogs.com/trade/WOW-BTC) +- [AltQuick](https://altquick.com/market/Wownero) + +## Wallets + +- Wonero CLI Wallet: [codeberg.org/wownero/wownero](https://codeberg.org/wownero/wownero/releases) +- Stack Wallet iOS & Android Mobile Wallet: [stackwallet.com](https://stackwallet.com) +- Cake Wallet [cakewallet.com](https://cakewallet.com) + +## Blockchain Explorers + +- https://explore.wownero.com + +## Supporting the project + +Wownero is a 100% community-sponsored endeavor. Supporting services are also graciously provided by sponsors: + +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](https://codeberg.org/wownero/meta/issues) 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.4.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 + +Packages are available for + +* Arch Linux/Manjaro + + yay -S wownero-git + +* 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 + +* Arch Linux/Manjaro + + sudo pacman -Syu --needed base-devel cmake boost openssl zeromq libpgm unbound libsodium libunwind xz readline expat gtest python3 ccache doxygen graphviz qt5-tools hidapi libusb protobuf systemd + + git clone https://codeberg.org/wownero/wownero && cd wownero + + make + +* Debian/Ubuntu + + sudo apt update && sudo apt install build-essential cmake pkg-config libssl-dev libzmq3-dev libunbound-dev libsodium-dev libunwind8-dev liblzma-dev libreadline6-dev libexpat1-dev libpgm-dev qttools5-dev-tools libhidapi-dev libusb-1.0-0-dev libprotobuf-dev protobuf-compiler libudev-dev libboost-chrono-dev libboost-date-time-dev libboost-filesystem-dev libboost-locale-dev libboost-program-options-dev libboost-regex-dev libboost-serialization-dev libboost-system-dev libboost-thread-dev python3 ccache doxygen graphviz + + git clone https://codeberg.org/wownero/wownero && cd wownero + + make + +## Running Binaries + +The build places the binary in `/build///release/bin` sub-directory. To run in the +foreground: + + ./wownerod + +To list all available options, run `./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: + + ./wownerod --detach + +Once node is synced to network, run the CLI wallet by entering: + + ./wownero-wallet-cli + +Type `help` in CLI wallet to see standard commands (for advanced options, type `help_advanced`). + +Copyright (c) 2014-2025 The Monero Project. + +Portions Copyright (c) 2012-2013 The Cryptonote developers.