GitLocker: The Coding Marketplace

Description:

pyEarnapp 0.0.16.1

EarnApp API
A Python binding to interact with Earnapp dashboard API.
Installation
pip install pyEarnapp

Usage
from pyEarnapp import EarnApp
AUTH = "YOUR_AUTH_CODE_FROM_EARNAPP_DASHBOARD"

api = EarnApp(AUTH) # Initiallise the EarnApp object

To use API with proxies
from pyEarnapp import EarnApp
AUTH = "YOUR_AUTH_CODE_FROM_EARNAPP_DASHBOARD"

api = EarnApp(AUTH)
proxy_conf = {
'http': socks5://username:password@ipaddress:port,
'https': socks5://username:password@ipaddress:port,
}
earning_info = api.get_user_data(proxies=proxy_conf)

All additional arguements are passed on to the requests.method call.

Functions

Get information about the user.
get_user_data()

Returns an object of type UserData with the following attributes.

Attribute
Description

first_name
User's first name

last_name
User's last name

name
User's full name

email
User's login email

Get information on user's earnings.
get_earning_info()

Returns an object of type EarningInfo with the following attributes.

Attribute
Description

balance
Current earned balance.

earnings_total
Amount earned till date.

multiplier
Earning multiplier.

tokens
No idea what this is.

redeem_details
Returns object of type RedeemDetails.

bonuses
Earnings from referrals.

bonuses_total
Total earnings from referrals till date.

referral_part
Referral bonus percentage.

The object RedeemDetails has the following attributes.

Attribute
Description

email
Redemption email

payment_method
Redemption method

Get all the connected device's information.
get_devices_info()

Returns an object of type DevicesInfo with the following attributes.

Attribute
Description

devices
List of nodes connected with each node of object type Device.

windows_devices
Number of Windows devices.

linux_devices
Number of Linux devices.

other_devices
Number of other type of devices.

total_bandwidth_usage
Shows bandwidth usage of all devices combined

The object Device has the following attributes.

Attribute
Description

uuid
UUID of the device.

bandwidth_usage
Unredeemed bandwidth usage.

total_bandwidth
Total bandwindth usage.

redeemed_bandwidth
Redeemed bandwidth usage.

rate
Price/GB of the device.

country
Country of the device.

device_type
Type of device. (win/node/None)

Get a list of all the transactions.
get_transaction_info()

Returns an object of type Transactions with the following attributes.

Attribute
Description

transactions
List of all transactions with each object of type Transaction.

pending_payments
Number of pending payments.

paid
Number of payments completed.

total_transactions
Total number of transactions.

The Transaction object has the following attributes.

Attribute
Description

uuid
Transaction ID.

status
Status of transaction (pending/paid).

payment_method
Mode of payment.

payment_date
Is an object of type datetime.datetime, as date of payment.

amount
Amount redeemed.

redeem_date
Is an object of type datetime.datetime, as date on which balance was redeemed.

is_paid
True if the payment is completed.

Add new node/device to your ID.
add_new_device("EARNAPP_NODE_ID")

Returns the response from the server on success. Else raise an exception.

Get a list of all referrals and their bonuses.
get_referral_info()

Returns an obejct of type Referrals with the following attributes.

Attribute
Description

referrals
List of all the referrals with each object of type Referee.

referral_earnings
Unredeemed earnings from referrals. (Same as get_earning_info().bonuses)

total_referral_earnings
Total earnings from referrals. (Same as get_earning_info().bonuses_total)

number_of_referrals
Total number of accepted referrals

The Referee object has the following attributes.

Attribute
Description

id
Referral ID.

bonuses
Unredeemed bonus from referred user.

bonuses_total
Total bonus from referred user.

email
Partially hidden referred user's email.

Delete linked device
delete_device(device_uuid = 'sdk-node-adfbafdnbasgnb')

Returns true when deleted, else False

Check if IP Address is usable on earnapp
is_ip_allowed()

Returns true if IP Address is allowed, else false.

Redeem balance to PayPal
redeem_to_paypal(paypal_email = 'someone@example.com')

Returns true on successfull redeem, else False.

Exceptions

The following exceptions are defined.

Exception
Reason

AuthenticationError
Raised on authentication failure.

DeviceAddError
When the attempt to add device is failed.

DeviceNotFoundError
When the device to be added is not found.

DeviceAlreadyAddedError
When the device ID is already linked

UnKnownDeviceAddError
When cause of failure is not known.

TooManyRequestsError
Raised when earnapp rate limit is reached.

UnKnownIPCheckError
Raised when there's an error checking if the IP address is valid.

InValidIPAddressError
Raised when the IP address is invalid.

UnKnownRedeemError
When unknown error occurs on redeption.

MinimumRedeemBalanceError
When account doesn't have minimum balance needed for redeeming.