diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..af6dfd4 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +public +resources \ No newline at end of file diff --git a/.hugo_build.lock b/.hugo_build.lock new file mode 100644 index 0000000..e69de29 diff --git a/archetypes/default.md b/archetypes/default.md new file mode 100644 index 0000000..25b6752 --- /dev/null +++ b/archetypes/default.md @@ -0,0 +1,5 @@ ++++ +date = '{{ .Date }}' +draft = true +title = '{{ replace .File.ContentBaseName "-" " " | title }}' ++++ diff --git a/content/_index.md b/content/_index.md new file mode 100644 index 0000000..bfaa640 --- /dev/null +++ b/content/_index.md @@ -0,0 +1,53 @@ +--- +title: Introduction +type: docs +--- + +# WowneroDocs +This is a documentation page for the cryptocurrency project, [Wownero](https://wownero.org/); the only project that means nothing, is generally useless, and doesn't try to pretend any differently. + +It's freeing in a way to embrace these facts as the rest of the cryptocurrency realm is rife with marketing, buzzwords, scams, and bullshit to have new entrants drink the kool-aid so proponents can gamble against each other to make a buck. + +Wownero is a fun project to learn and hack on code, bet on snail races (literally), make stupid memes, chat with our group of ragtag stoners, and generally have fun with interesting cryptocurrency tech based on [Monero](https://getmonero.org/) (the only legit project around). Real G’s idle in [IRC](https://webchat.oftc.net/?channels=wownero) (and move in silence like lasagna). + +If you’re coming to “invest”, you’re going to have a bad time. + +{{< rawhtml >}} + +{{< /rawhtml >}} + +## Official sites +- [wownero.org](https://wownero.org/) - the official Wownero website +- [codeberg.org/wownero](https://codeberg.org/wownero/wownero) - WOW source code is here + +## Community sites +- [#wownero at oftc.net](https://webchat.oftc.net/?channels=wownero) - Wownero IRC chat +- [Wownero Matrix room](https://matrix.to/#/#wownero:matrix.org) - Bridged with IRC +- [suchwow.xyz](https://suchwow.xyz/) - Post memes, get tips +- [reddit](https://www.reddit.com/r/Wownero/) - a wownero forum which spies on you +- [wownero discord](https://discord.gg/ykZyAzJhDK) - Not bridged with IRC! Also Discord is pure spyware. +- [Telegram](https://t.me/wownero) - Same as above, you should use IRC or Matrix instead +- [Slime.cash](https://slime.cash) - A cool Wownero introduction site + +## Exchanges +- [BasicSwapDEX](https://basicswapdex.com/) - decentralized atomic swap exchange +- [TradeOgre](https://tradeogre.com/exchange/BTC-WOW) - the OG exchange +- [AltQuick](https://altquick.com/market/Wownero) - low volume +- [MajesticBank](https://majesticbank.sc/) - swap wownero for XMR, BTC, or LTC +- [Trocador](https://trocador.app/) - multi-coin swap aggregator with emphasys on privacy + +## Wallets +- [WowLet](https://wowlet.app) - GUI wallet for Linux, Windows and MacOS +- [Wownero CLI](https://git.wownero.com/wownero/wownero/releases) - official command-line wallet +- [Stack Wallet](https://stackwallet.com/) - Android and iOS mobile wallet +- [Cake Wallet](https://cakewallet.com/) - An alternative to Stack Wallet + +## Tutorials +- [How to solo mine](/docs/tutorials/mining) +- [How to run a node](/docs/tutorials/node) +- [How to use atomic swaps](/docs/tutorials/atomic-swaps) + +![The Wownero team is always high-ly focused on solving problems](/highlyfocused.jpeg) \ No newline at end of file diff --git a/content/docs/contributing.md b/content/docs/contributing.md new file mode 100644 index 0000000..e78f2b5 --- /dev/null +++ b/content/docs/contributing.md @@ -0,0 +1,20 @@ +--- +title: "Contributing" +--- + +# Contributing +People can contribute in many ways! + +- Vandalize buildings with sick Wownero graffiti +- Hang out in the [community sites](https://wownerodocs.org/#community-sites) and chat with the gang. +- Make memes and post them to [SuchWow](https://suchwow.xyz/) +- Tip memers on SuchWow +- Hack on the [Wownero codebase](https://git.wownero.com/wownero/wownero) if you’re a C++ gawd +- Make new services, sites, tools, or fun stuff +- Test new releases when they’re available +- Offer p2p trades +- Get some VR lap dances + +Above all else, remember to take it sleazy. + +![Wownero wall graffiti art](/wall.jpeg) \ No newline at end of file diff --git a/content/docs/technical-specs.md b/content/docs/technical-specs.md new file mode 100644 index 0000000..7de027d --- /dev/null +++ b/content/docs/technical-specs.md @@ -0,0 +1,33 @@ +--- +title: "Techical specs" +--- + +# Wownero Technical Specs + +## Live +Wownero blockchain is live since April 1st 2018. + +## Distribution +Wownero had no premine, ICO, instamine, or presale of any kind. + +## Block reward +184 million coins mined over ~50 years, with a smooth emission curve. No tail emission. + +## Proof of Work +Wownero is, and has always been, ASIC-resistant and CPU-mining only. +- Cryptonight v1 since height 1 (2018-04-01) +- Cryptonight v2 since height 53666 (2018-10-06) +- Cryptonight WOW since height 81769 (2019-02-19) +- RandomWOW since height 114969 (2019-06-14) + +## Block time +5 minutes. + +## Privacy +Wownero uses ring rignatures, stealth addresses and RingCT. +- Bulletproofs for better scaling +- Ring size of 22 + +## Solo mining +Wownero is solo-mining only since Junkie Jeff Hardfork (4th july 2021). +See [mining](/docs/mining) for solo mining instructions. \ No newline at end of file diff --git a/content/docs/tutorials/_index.md b/content/docs/tutorials/_index.md new file mode 100644 index 0000000..e4be708 --- /dev/null +++ b/content/docs/tutorials/_index.md @@ -0,0 +1,8 @@ +--- +title: Tutorials +type: docs +--- + +- [How to solo mine](/docs/tutorials/mining) +- [How to run a node](/docs/tutorials/node) +- [How to use atomic swaps](/docs/tutorials/atomic-swaps) diff --git a/content/docs/tutorials/atomic-swaps.md b/content/docs/tutorials/atomic-swaps.md new file mode 100644 index 0000000..d03435d --- /dev/null +++ b/content/docs/tutorials/atomic-swaps.md @@ -0,0 +1,53 @@ +--- +title: How to trade Wownero using Atomic Swaps +type: docs +--- + +# How to trade Wownero using Atomic Swaps + +You can perform atomic swaps between Wownero and a few other chains using a software called BasicSwap. It runs on your computer and connects to other participants where you can place and accept bids. Funds go directly into your wallets without any middle-man, completely decentralized. + +| coin name | ticker | +| ------------ | -------- | +| Bitcoin | BTC | +| Bitcoin Cash | BCH | +| Monero | XMR | +| Wownero | WOW | +| Decred | DCR | +| Firo | FIRO | +| Litecoin | LTC | +| PIVX | PIVX | +| Dash | DASH | +| Particl | PART | + + +## Installation + +The official documentation can be found here: https://academy.particl.io/en/latest/basicswap-guides/basicswapguides_installation.html + +A community member named ofrnxmr runs a scripted installation which is the best way to use it. Follow the instructions here: https://github.com/nahuhh/basicswap-bash/releases + +## Usage + +Run basicswapdex and open your browser to [http://127.0.0.1:12700/offers](http://127.0.0.1:12700/offers) - you should see any active offers for the coins you have enabled. + +![BasicSwap UI](/basicswap_dash.png) + +Go to the Wallets paged and make sure they’re all synced up - you might have to wait a bit. + +Copy the address or subaddress of the wallet and send funds. When the transfer is confirmed on that network you will be able to participate in atomic swaps. + +You can perform atomic swaps with Wownero and any SegWit capable chains, which will always be your intermediary; there are no direct atomic swaps from Wownero to Monero for example. + +| Swap Route Examples | +| ----------------------------- | +| Wownero -> Particl -> Monero | +| Monero -> Particl -> Wownero | +| Wownero -> Litecoin -> Monero | +| Monero -> Litecoin -> Wownero | + +Look for offers that suit your criteria (the coin you have, the coin you want, and a market rate you are comfortable with) or place your own offer. + +Set your bid, wait for it to get filled, then wait for the swap to happen. The swap itself is a combination of cryptographic shenanigans with signatures and lock times - I don’t know all of the intracacies but I do know it is trustless and completely peer to peer. + +This guide was originally written with ❤️ by [lza](https://lzahq.tech). \ No newline at end of file diff --git a/content/docs/tutorials/mining.md b/content/docs/tutorials/mining.md new file mode 100644 index 0000000..e1d16bd --- /dev/null +++ b/content/docs/tutorials/mining.md @@ -0,0 +1,49 @@ +--- +title: How to solo mine Wownero +--- + +# How to solo mine Wownero +Wownero is solo-mining only since Junkie Jeff Hardfork (4th july 2021). + +## With SuchMiner +To solo mine you can use SuchMiner, a high-performance Wownero miner. +With SuchMiner, running a node isn't required, but it's strongly recommended (less latency = more profit!). + +1. [Download SuchMiner](https://github.com/duggavo/SuchMiner/releases) and unzip the downloaded folder. +If you wish you can also verify the hash and signature, or build by yourself. +2. For security reasons it is strongly recommeneded to create a new wallet for mining. +You can use [Wowlet](https://wowlet.app/) or [Wownero Wallet CLI](https://git.wownero.com/wownero/releases). +3. Run SuchMiner and enter your wallet address and private spend key when prompted. +In WowLet you can see them with *wallet*>*keys*. + +## Mining Directly With Wownerod + +This guide was copied and extended from JR Swab's blog post - read the source [here](https://jrswab.com/blog/how-to-mine-wownero) and consider [supporting him](https://jrswab.com/support) with a small tip. + +1. Download the latest version of Wownero to your mining computer here: Wownero releases. +2. Extract the download +3. Open a terminal in the extracted directory (you should see wownerod, wownero-wallet-cli, etc from the ls command) +4. Create a new wallet for mining by running ./wownero-wallet-cli --generate-new-wallet mining +5. Note the wallet’s mnemonic seed and store it safely +6. Enter spendkey while in the wallet CLI interface and note the secret spend key (aka `{SECRET-SPENDKEY}`) +7. Enter address while in the wallet CLI interface and note the primary address (aka `{YOUR-ADDRESS}`) +8. Run `./wownerod --start-mining {YOUR-ADDRESS} --spend-secret-key {SECRET-SPENDKEY}` + +When the blockchain finishes synchronizing, mining will begin. + +## With XMRig +Once again copied from [JR Swab’s blog post](https://jrswab.com/blog/how-to-mine-wownero). + +Perform the above steps but change number 8; wownerod must be running in your terminal without mining options (just run ./wownerod): + +1. Download the latest [XMRig release](https://github.com/xmrig/xmrig/releases) +2. Extract the download +3. Open a new terminal in the extracted directory (you should see xmrig from the ls command) +4. Run `./xmrig --url 127.0.0.1:34568 --user {YOUR-ADDRESS} --algo rx/wow --spend-secret-key {SECRET-SPENDKEY} --daemon`; run with sudo for additional performance + +## Wen block? +SuchMiner prints the expected block time every few minutes. +If you are not using SuchMiner, then [CryptUnit](https://www.cryptunit.com/coin/WOW) is a great solo mining calculator. +Please keep in mind that solo mining is a lottery - it might take you more or less time to find a block, depending on your luck. + +![Wownero mason](/mason.png) \ No newline at end of file diff --git a/content/docs/tutorials/node.md b/content/docs/tutorials/node.md new file mode 100644 index 0000000..dd2ede4 --- /dev/null +++ b/content/docs/tutorials/node.md @@ -0,0 +1,22 @@ +--- +title: "Running a node" +--- + +# How to run a Wownero node +Running a Wownero node is very simple. + +## Requirements +You need ~10 GB of free disk space to run a Wownero node. +SSD is not necessary but syncing will be much faster compared to hard disk. + +### Step 1 +Download and extract the latest wownero CLI from [https://git.wownero.com/wownero/wownero/releases](WowGit) + +### Step 2 +Double-click or run wownerod. +If you are on Linux, you might have to allow execution of the daemon: +`chmod +x ./wownerod` + +Wait for sync, and that's it! You're now running a Wownero node. + +![Wownero VS Monero](/wowario_monerio_crop.jpeg) \ No newline at end of file diff --git a/hugo.toml b/hugo.toml new file mode 100644 index 0000000..bf4d039 --- /dev/null +++ b/hugo.toml @@ -0,0 +1,7 @@ +baseURL = 'https://wownerodocs.org/' +languageCode = 'en-us' +title = 'WowneroDocs' +theme = 'hugo-book' + +[params] + BookTheme = 'auto' diff --git a/layouts/shortcodes/image.html b/layouts/shortcodes/image.html new file mode 100644 index 0000000..6e0a32f --- /dev/null +++ b/layouts/shortcodes/image.html @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/layouts/shortcodes/rawhtml.html b/layouts/shortcodes/rawhtml.html new file mode 100644 index 0000000..ed3fb8a --- /dev/null +++ b/layouts/shortcodes/rawhtml.html @@ -0,0 +1 @@ +{{.Inner}} \ No newline at end of file diff --git a/layouts/shortcodes/video.html b/layouts/shortcodes/video.html new file mode 100644 index 0000000..e69de29 diff --git a/static/aheadofthepack.mp4 b/static/aheadofthepack.mp4 new file mode 100644 index 0000000..c57400f Binary files /dev/null and b/static/aheadofthepack.mp4 differ diff --git a/static/basicswap_dash.png b/static/basicswap_dash.png new file mode 100644 index 0000000..4530d23 Binary files /dev/null and b/static/basicswap_dash.png differ diff --git a/static/favicon.ico b/static/favicon.ico new file mode 100644 index 0000000..b73af22 Binary files /dev/null and b/static/favicon.ico differ diff --git a/static/highlyfocused.jpeg b/static/highlyfocused.jpeg new file mode 100644 index 0000000..2c713e4 Binary files /dev/null and b/static/highlyfocused.jpeg differ diff --git a/static/highlyfocused.png b/static/highlyfocused.png new file mode 100644 index 0000000..378b72c Binary files /dev/null and b/static/highlyfocused.png differ diff --git a/static/mason.png b/static/mason.png new file mode 100644 index 0000000..e252ff2 Binary files /dev/null and b/static/mason.png differ diff --git a/static/wall.jpeg b/static/wall.jpeg new file mode 100644 index 0000000..c174e2b Binary files /dev/null and b/static/wall.jpeg differ diff --git a/static/wowario_monerio_crop.jpeg b/static/wowario_monerio_crop.jpeg new file mode 100644 index 0000000..0d9ab7b Binary files /dev/null and b/static/wowario_monerio_crop.jpeg differ