diff --git a/README.md b/README.md index b8e1347e..74619c96 100644 --- a/README.md +++ b/README.md @@ -1,401 +1,23 @@ -# LiteDoge full-node copy-paste installation guide +# LiteDoge Official Repository -Copy-paste unix commands to run a full litedoge node and start staking. +LiteDoge is a PoS-based cryptocurrency. -## Why litedoge? +Official Website: https://ldoge.tech -Best way to learn about cryptocurrencies is to learn by doing! +Latest Wallets: https://github.com/vashshawn/LDOGE/releases -Litedoge is easy to learn, based on bitcoin and available in exchanges. +Wiki and Installation guides: https://github.com/vashshawn/LDOGE/wiki -This guide walks you trough installing the wallet and begin playing around with purchasing, staking and moving small amounts of cryptocurrency around. +# Development process -## Server and operating system +Developers work in their own trees, then submit pull requests when they think their feature or bug fix is ready. -Litedoge runs on any unix or BSD server. Even Raspberry PI. In this guide I'll focus on Ubuntu 16.04 running on a cloud server. +The patch will be accepted if there is broad consensus that it is a good thing. Developers should expect to rework and resubmit patches if they don't match the project's coding conventions (see coding.txt) or are controversial. -Here are few host providers who offer cheap virtual private servers (vps) for international customers: +The master branch is regularly built and tested, but is not guaranteed to be completely stable. Tags are regularly created to indicate new stable release versions of LiteDoge. -- https://www.hetzner.com/virtual-server -- https://contabo.com/?show=vps -- https://aws.amazon.com/ec2/ +Feature branches are created when there are major new features being worked on by several people. -## Update server and install dependencies +From time to time a pull request will become outdated. If this occurs, and the pull is no longer automatically mergeable; a comment on the pull will be used to issue a warning of closure. The pull will be closed 15 days after the warning if action is not taken by the author. Pull requests closed in this manner will have their corresponding issue labeled 'stagnant'. -Log in as root to your server: - -``` -ssh root@server-ip-address -``` - -or - -``` -sudo su - -``` - -Update the OS: - -``` -apt update -qqy --fix-missing \ - && apt-get upgrade -y \ - && apt-get clean -y \ - && apt-get autoremove -y --purge -``` - -Install dependencies: - -``` -apt install build-essential -y \ - && apt install libssl-dev -y \ - && apt install libdb++-dev -y \ - && apt install libboost-all-dev -y \ - && apt install libminiupnpc-dev -y \ - && apt install git -y -``` - -## Create user - -You don't want start litedoge node with the root user. Create user `litedoge` without log-in rights. - -``` -sudo useradd -s /usr/sbin/nologin -m litedoge -``` - -## Download and build litedoge - -Clone the updated litedoge repository: - -``` -cd /home/litedoge && git clone https://github.com/vashshawn/LDOGE litedoge - -sudo chown -R litedoge:litedoge litedoge -``` - -Build it with command: - -``` -cd /home/litedoge/litedoge/src && sudo -u litedoge make -f makefile.unix -``` - -### Build issues - -Commands above cloned the original LDOGE repository. If you have problems building it, clone this repository using command `cd /home/litedoge && git clone https://github.com/suchapp/litedoge` and try building it again. - -## Linking - -Move litedoged to path: - -``` -cp /home/litedoge/litedoge/src/litedoged /bin/litedoged -``` - -## Configure litedoged - -Create the config directory: - -``` -sudo -u litedoge mkdir /home/litedoge/.litedoge -``` - -Create the config file `litedoge.conf` - -Note: you need to add strong `rpcpassword` before copy-pasting this: - -``` -cat << "EOF" | sudo tee /home/litedoge/.litedoge/litedoge.conf - -addnode=23.152.0.212 -addnode=167.160.36.7 -addnode=198.245.50.213 -addnode=85.24.143.58 -addnode=176.9.140.80 -addnode=85.169.119.40 -addnode=50.142.213.254 -addnode=192.52.167.158 -addnode=45.50.58.160 -addnode=24.76.220.10 -addnode=174.102.232.161 -addnode=82.44.44.253 -addnode=68.36.216.167 -addnode=76.18.225.234 -addnode=98.193.5.149 -addnode=173.68.191.206 -addnode=24.44.96.51 -addnode=86.205.155.158 -# addnode=192.169.7.131 -# addnode=167.160.36.13 -# addnode=74.118.157.122 -# addnode=167.160.36.9 -# addnode=185.69.55.165 -# addnode=72.241.235.204 - -# If you get too many errors in initial sync, try limiting maxconnections to 3 -#maxconnections=3 - -# Release your LDOGEs by setting staking=0 or reservebalance to needed amount -#reservebalance=99999999999 -staking=1 -stake=1 - -daemon=1 -server=1 -rpcuser=litedogerpc -rpcpassword= -rpcallowip=127.0.0.1 -rpcport=9332 - -txindex=1 - -EOF -``` - -## Optional: Bootstrap blockchain - -You can download the blockchain to make initial sync faster. You'll find it from bitcointalk's litedoge threads or discord chat. - -Copy file `bootstrap.dat` to litedoge datadir `/home/litedoge/.litedoge` before starting the server. - -If `bootstrap.zip` is not available, just skip this step. Initial sync will take few days. - -## Configure firewall - -Install `ufw` and allow ssh access before enabling it - -``` -apt install ufw -ufw allow 22 -ufw allow 9332 -ufw allow 6667 -ufw allow 17014 -ufw allow 17015 -ufw enable -``` - -## Create systemd service to start litedoge automatically - -We want our node to start automatically after a reboot or crash. Create a systemd service for it. - -``` -cat << "EOF" | sudo tee /lib/systemd/system/litedoge.service -[Unit] -Description=Litedoge daemon -After=network.target - -[Service] -ExecStart=/bin/litedoged -datadir=/home/litedoge/.litedoge -WorkingDirectory=/home/litedoge/.litedoge -Type=forking -User=litedoge -Restart=on-failure -PrivateTmp=true -PrivateDevices=yes -ProtectSystem=full -SyslogIdentifier=LDOGE -RestartSec=30 - -[Install] -WantedBy=multi-user.target -Alias=litedoge.service - -EOF -``` - -Enable the service: - -``` -systemctl daemon-reload && sudo systemctl enable litedoge.service -``` - -Every time you change something in `/lib/systemd/system/litedoge.service`, you need to run `systemctl daemon-reload`. - -## Start the service - -``` -service litedoge start -``` - -Since we have created an alias for the service, we will be able to work with it in the future as follows: - -``` -service litedoge start|stop|restart|status -``` - -## Create `ldoge` run script for daemon - -``` -cat << "EOF" | sudo tee /bin/ldoge - -/bin/litedoged -datadir=/home/litedoge/.litedoge "$@" - -EOF -``` - -Chmod - -``` -chmod a+x /bin/ldoge -``` - -## Follow litedoged logs - -``` -tail -f /home/litedoge/.litedoge/debug.log -``` - -## Backup wallet.dat - -First encrypt your wallet: - -``` -ldoge encryptwallet your-strong-password-here - -service litedoge restart -``` - -Then copy `/home/litedoge/.litedoge/wallet.dat` and store it somewhere safe. - -## Wait for sync to complete - -While waiting for sync to complete, read more about LiteDoge at: - -Official website: http://www.ldoge.tech/ (http://mirror.ldoge.info) - -Reddit: https://reddit.com/r/litedoge - -Discord: https://discord.gg/BX9XVMS - -Bitcointalk thread 1: https://bitcointalk.org/index.php?topic=1077390.0 - -Bitcointalk thread 2: https://bitcointalk.org/index.php?topic=1308769.0 - -Original repository and development guide: https://github.com/vashshawn/LDOGE - -and - -``` -ldoge help -``` - -## Receive LDOGE - -When blockchain is fully synced, use ´getnewaddress´ to get a new LDOGE address: - -``` -ldoge getnewaddress -``` - -command returns address-hash like [`dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS`](http://ranking.ldoge.info/address/dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS). Send your LDOGEs to your address. - -Wait few seconds and check your balance: - -``` -ldoge getbalance -``` - -Note: this will return your spendable balance. When you are staking, `getbalance` will be lower than your actual wallet balance. - -## Start staking - -You can earn LiteDoge by validating block transactions. - -Keep your coins for at least 8 hours in your wallet and they will be eligible for staking. - -The time needed to get stake reward depends on the number of coins you hold in your wallet. - -Unlock wallet for staking for 99999999 seconds which is ~3,1709791667 years - -``` -ldoge walletpassphrase your-strong-password-here 99999999 true -``` - -Fourth parameter `true` means `[stakingonly]` - -Note: When litedoged is restarted, you'll need to unlock your wallet manually to resume staking. - -## Check staking status - -Check node info for balances: - -``` -ldoge getinfo - -{ - ... - "balance" : 3000000.00000000, // Spendable balance - ... - "stake" : 8000000.00000000, // Locked for staking - ... - "unlocked_until" : 1612455147, // Wallet unlocked for staking - ... -} -``` - -Check staking status: - -``` -ldoge getstakinginfo - -{ - "enabled" : true, // Staking is on - "staking" : true, // You have had coins for at least 8 hours in your wallet and they are eligible for staking. - ... -} -``` - -Check last transactions for paid rewards: - -``` -ldoge listtransactions - -[ - ... - { - ... // Paid to address - "address" : "dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS", - "category" : "immature", // updates to "generate" after 510 confirmations - "amount" : 500.00000000, // Stake amount - ... - "generated" : true, // Paid for staking - ... - } -] -``` - -You can also check your staking status on LDOGE explorer at http://ldoge.miningalts.com/ - -With 3,000,000 LDOGE you should be getting rewards about twice a day. - -## Send LDOGE - -Unlock wallet for 60 secs and move your LDOGEs back to other wallet (replace hash with your address): - -``` -ldoge walletpassphrase your-strong-password-here 60 - -ldoge sendtoaddress dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS amount-ldoge-to-send -``` - -Unlock your wallet again for staking - -``` -ldoge walletpassphrase your-strong-password-here 99999999 true -``` - -## Clear history - -It might be a good idea to clear history after using wallet passphrase from command line - -``` -cat /dev/null > ~/.bash_history && history -c && exit -``` - -## Thanks - -If you found this guide useful, please consider sending some LDOGE to [`dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS`](http://ranking.ldoge.info/address/dJ68iVea94kWWgR4DFStwMnUzZUs4uVDhS). - -Send message to https://www.reddit.com/u/suchapp if you have ideas how to improve this guide! - -Thanks for staking litedoge! - -Disclaimer: _It is your own responsibility to backup and keep your wallet safe. The writer will not be responsible if your LDOGEs are lost, deleted, or stolen_. +Issues with no commits will be given a similar warning, and closed after 15 days from their last activity. Issues closed in this manner will be labeled 'stale'.