GoodDocs
Search
K

UBIScheme

Holds all the G$s that were transferred via bridge from the FundManager.
The pool of G$s is divided equally by the amount of current active users, and distributed every day. Each active user can then "claim" his quota. If a user fails to claim his quota it becomes part of the next day's pool of G$ to be distributed as basic income.

Events

WithdrawFromDao

Emits when a withdraw has been succeded.
Parameter name
Annotation
prevBalance
The balance before the withdraw.
newBalance
The balance after the withdraw.
event WithdrawFromDao(uint256 prevBalance, uint256 newBalance);

ActivatedUser

Emits when a user is activated.
Parameter name
Annotation
account
The user that was activated.
event ActivatedUser(address indexed account);

InactiveUserFished

Emits when a fish call has been succeded.
Parameter name
Annotation
caller
The user that doing "fishing".
fished_account
The user that has beed "fished".
claimAmount
The amount of tokens caller got for "fishing".
event InactiveUserFished(
address indexed caller,
address indexed fished_account,
uint256 claimAmount
);

TotalFished

Emits when finishing a "multi fish" execution. Indicates the number of users from the given array who actually been fished. It might not be finished going over all the array if there no gas left.
Parameter name
Annotation
total
The amount of total user that were "fished".
event TotalFished(uint256 total);

UBICalculated

Emits when daily UBI is calculated.
Parameter name
Annotation
day
The timestamp when this event was emitted.
dailyUbi
The amount of UBI per daily cycle.
blockNumber
The block number when this event was emitted.
event UBICalculated(uint256 day, uint256 dailyUbi, uint256 blockNumber);

UBICycleCalculated

Emits whenever a new multi day cycle starts.
Parameter name
Annotation
day
The amount of days from the start when the event was emitted.
pool
The balance of the UBI scheme in G$.
cycleLength
The duration that used to calculate a frequency of daily cycle pool distribution.
dailyUBIPool
The amount of the pool.
event UBICycleCalculated(
uint256 day,
uint256 pool,
uint256 cycleLength,
uint256 dailyUBIPool
);

UBIClaimed

Emits when someone claims the UBI.
Parameter name
Annotation
claimer
The claimer of the UBI user.
amount
The amount of the UBI the user gathered after claim reward call.
event UBIClaimed(address indexed claimer, uint256 amount);

CycleLengthSet

Emits when the Avatar sets the cycle length.
Parameter name
Annotation
newCycleLength
The duration of the collect UBI cycle..
event CycleLengthSet(uint256 newCycleLength);

CycleLengthSet

Emits when the Avatar sets the cycle length.
Parameter name
Annotation
newCycleLength
The duration of the collect UBI cycle..
event CycleLengthSet(uint256 newCycleLength);

DaySet

Emits when the Avatar sets the day.
Parameter name
Annotation
newDay
New days amount from the start of the UBI work.
event DaySet(uint256 newDay);

DaySet

Emits when the Avatar sets up he is not eligible for G$.
Parameter name
Annotation
ShouldWithdrawFromDAO
Accounts whether to also withdraw G$ from Avatar for UBI.
event ShouldWithdrawFromDAOSet(bool ShouldWithdrawFromDAO);

checkEntitlement

Checks the amount which the _member address is eligible to claim for, regardless if they have been whitelisted or not. In case the user is active, then the current day must be equal to the actual day, i.e. claim or fish has already been executed today.
Parameter name
Annotation
_member
Potential claimers address.
Returns: the amount of G$ tokens the address can claim.
function checkEntitlement(address _member) public view returns (uint256);

claim

Function for claiming UBI. Requires contract to be active and claimer to be whitelisted. Calls distributionFormula, calculates the amount the caller can claim, and transfers the amount to the caller.
Returns: a boolean indicating if UBI was claimed.
function claim() public returns (bool);

fish

In order to update users from active to inactive, we give out incentive to people to update the status of inactive users, this action is called "Fishing". Anyone can send a tx to the contract to mark inactive users. The "fisherman" receives a reward equal to the daily UBI (i.e. instead of the “fished” user). User that “last claimed” > 14 can be "fished" and made inactive (reduces active users count by one). Requires contract to be active.
Parameter name
Annotation
_account
The account to "fish".
Returns: a bool indicating if UBI was fished.
function fish(address _account) public returns (bool);

fishMulti

Executes fish with multiple addresses.
Parameter name
Annotation
_accounts
The accounts to "fish".
Returns: a bool indicating if all the UBIs were fished.
function fishMulti(address[] memory _accounts) public returns (uint256);