PayoutScript-xyZ step-by-step installation instructions

ZracheSs | xyZ
4 min readJul 10, 2021

--

This script will make all the payouts for your academy!

Let’s start by enabling Windows subsystem for Linux :

Search for the term PowerShell in the search bar, and run the Windows PowerShell as administrator. Click on yes when prompt to confirm.

  1. Copy/paste the following command into the PowerShell :
    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
  2. Wait until the command runs
  3. Type ‘y’ and enter to restart your computer

Now, let’s install ubuntu on your windows :

Open the Microsoft Store and go to Ubuntu 18.04 LTS App.

Get, install and launch the app. You will be prompt to setup a username and password for your Ubuntu terminal.

Once finish, close the window!

Getting the script ready for your scholarship program :

Download the ZIP file from the GitHub repositories: https://github.com/ZracheSs-xyZ/PayoutScript-xyZ

ALWAYS MAKE SURE TO DOWNLOAD THIS SCRIPT FROM THIS URL!

Extract the ZIP file.

Go into the PayoutScript-xyZ folder, open the slp-payout-config.json file and enter your scholars information and the Ronin accounts private keys.

Go back to the PayoutScript-xyZ folder, shift-right click and select ‘Open Linux shell here’.

Enter the following commands on the terminal one by one :

  • sudo apt update
  • sudo apt install python3 python3-pip
  • pip3 install web3
  1. You can now run the script by typing this command :
    python3 PayoutScript-xyZ.py slp-payout-config.json
  2. Review all the claim requests
  3. Approve/refuse all the claim requests by typing y/n
  4. Review all the payment transactions
  5. Approve/refuse all the transactions by typing y/n
The claiming information and the transaction information for the 1% donation would appear here as well! (THIS PICTURE WILL SOON BE UPDATED WITH THE NEW VERSION)

First, the script will iterate through all the scholars in slp-payout-config.json file and check for accounts with a claimable SLP balance and will ask for approval to claim the SLP.

Secondly, the script will check for account with SLP balance in the account and will ask you for approval to start the payment process.

These two steps are independent, you can either claim the SLP without going through with the payments, or you can go directly to the payment and keep the unclaimed SLP in the account. You can also run it as many time as needed!

Donations

With your donation, I will be able to keep working on this project and add new features. Thank you!

  • There’s a built-in donation of 1% that you can easily modify by changing the value of FEE_PAYOUT_ADDRESS from 0.01 to 0.
  • Ronin Wallet Address: ronin:a04d88fbd1cf579a83741ad6cd51748a4e2e2b6a
  • Ethereum Wallet Address: 0x3C133521589daFa7213E5c98C74464a9577bEE01

Good to know

  • You can keep the slp-payout-config.json in a separate folder or even on a flash drive if you specify the correct path as an argument when you execute the script.
  • All the claims/transactions logs are saved in a separate file after each run.
  • If the script is going to pay over 100 scholars, you would need to adjust the time.sleep value from 0.250 to 0.35 in order not to trigger any rate limit.
  • If the script claim the SLP and doesn’t process the payouts, just run it again… This is because the claim request took too much time to be processed by the servers!

Help and support

If you need help or support to implement this script, you can DM me on twitter: https://twitter.com/ZracheSs
Or join the xyZ Discord Server: https://discord.com/invite/837cCXPd48

--

--