The purpose of this repository is to create a method for users of the Gridcoin crypto-currency (www.gridcoin.us) to re-distribute the GRC currency to other members who are active on specific BOINC projects, this methodology is called 'rain' or 'raining'.
This allows for example a project administrator to rain additional GRC funds onto their project if they need a short term boost in processing power, or between community members as a thankyou, or to bring resources to bear in preparation for BOINC contests, such as the BOINC Pentathlon (https://www.seti-germany.de/boinc_pentathlon/start.php?&lang=en)
*** PREREQUISITES
This Python script is for Windows only, Linux Gridcoin wallets have no Neural Network.
To operate this Python script you need to install Python 2.7.
The gridcoinresearch.conf file must contain 'exportmagnitude=true', 'rpcuser=' and 'rpcpassword=' must be set with a username and password.
The Gridcoin Qt wallet must be started with the -server argument (or add 'server=1' to gridcoinresearch.conf) to allow GridcoinResearch to accept RPC commands.
The NeuralNetwork must be synchronized.
This Python script must be copied to 'C:\Program Files (x86)\GridcoinResearch' for it to work, or, gridcoinresearchd must be set in %PATH%.
*** INSTRUCTIONS
Open the command prompt:
cd C:\Program Files (x86)\GridcoinResearch
gridcoinresearch -server
Once the GridcoinResearch wallet is fully loaded:
Option A, from the command prompt type:
gridcoinresearchd execute syncdpor2
Option B, go to the RPC console in the GUI wallet and type:
execute syncdpor2
wait for the Neural Network to finish syncing. *** Note; the NN must sync before proceeding to ensure latest Gridcoin Magnitudes are loaded ***
From the command prompt:
python rain.py
You will need to:
Enter the name of the project on which you wish to rain funds
If you prefer to distribute based on Project RAC or use Gridcoin Magnitude
Enter the total amount of GRC you wish to send to the rainees
Choose the Gridcoin Wallet Account Label from which the GRC should be taken (in GUI wallet see Receive Coins for Label list)
Enter an optional message to mark in your own wallet (for your reference)
Enter your Gridcoin Wallet Passphrase *** Note; the passphrase is not stored in the database and the entry will be invisible, the wallet will be locked, unlocked, the transaction sent, re-locked and then unlocked for staking only ***
Once all the data is loaded and the transaction completed, you will receive a set of TXIDs, one for each block of addresses, which can be queried on the block explorer. TXs are split into blocks because of a limit in Windows command line (max length 8192 characters), the program will use the least number of TXs possible.
A database file 'Rain.db' will be added to the 'C:\Users\User\AppData\Roaming\GridcoinResearch\reports' folder, in case of problems it is safe to delete this file.
Example Transaction: https://gridcoinstats.eu/tx/af1174f7806e39dd809981f128975294c820cc8009db7e193bcd2b7c1dfb990c
Tips to my GRC Address: SAuPu8zarzQykWLGwxc6JRvW3imM8YU9wc