diff --git a/spec/02_platform_incentives.md b/spec/02_platform_incentives.md new file mode 100644 index 0000000..243e9e0 --- /dev/null +++ b/spec/02_platform_incentives.md @@ -0,0 +1,60 @@ +# Current Platform Incentives spec + + +* Authors: Will Ruddick (grassecon.org) +* Date: 2020.04.22 +* Version: 1 +* Status: Pre-draft + +## Rationale +The current system seeks to maximize circulation in order to fill market gaps and help CIC users to support eachother. + +## Before +Currently: Grassroots Economics started with a pool of 8 Million Sarafu tokens (which they value 1:1 with Kenyan Shillings ala buy backs). Of which 90% will have been distributed to users as below by the end of April 2020. +The following are all rules are platform based (not blockchain contract based). Note that these rules are for the Sarafu CIC only and not meant to be the rules for other CIC creators. +1. *airdrop-selfservice*: New users get 50 Sarafu (a CIC) (Shown as Disbursement in database) +1. *airdrop-full-profile*: New users that fill out their profiles (name, business, location, gender) get additional 400 Sarafu (a CIC) (must call office line) (Shown as Disbursement in database) +1. *refferal* Users that are the 1st to send a new user at least 20 tokens in the 1st 24 hours get 100 Sarafu - after that new user has begun to trade with another user (not the referrer) (Shown as Disbursement in database) +1. *chama bonus*: Savings Groups (aka Chamas are groups of users that save and give loans to eachother) get 10,000 Sarafu divided between their members after 2 months of trading.(Shown as Disbursement in database) +1. *chama redemption* Savings Groups can redeem 50% of their Sarafu Balance for Kenyan Shillings each month but must have spent (given loans) of at least as much as they want to cash out. (Shown as Agent_out in database) Cashing out is done using donor funds by Grassroots Economics Foundation and Sarafu is valued 1:1 with Kenyan shilligns using eMoney (Mpesa). +1. *usage bonus*: Users get a daily or weekly Sarafu bonues depending on how they trade. They are ranked by the number of other people they trade above 20 Sarafu with and awarded based on their percentage of such overall trade. (Possibly moving to k-cycle centrality).(Shown as Disbursement in database) +1. *Holding Fee*: If an account if dormant (no trades in or out) for 7 days 20 Sarafu are deducted and added back to the pool. (Shown as Reclaimation in database) +1. *Donation bonues* Anyone with Mpesa or Bonga points can send them to Grassroots Economics to receive additional Sarafu (Shown as Disbursement in database) Donors can give Grassroots Economics funds to support the Sarafu buy-back and operations + +## After +After the migration to xDAI (https://github.com/GrassrootsEconomics/CIC-Docs/blob/master/spec/xdai_migration.md) +anyone (with access to blockchain) in the world can contribute reserve in the form of xDAI. xDAI is a stable token to the US dollar and can be purchased with USD. +With a reserve in xDAI each Sarafu token will now have spot price or excahnge price to xDAI given by P = R/(S*TRR) +Where R = the amount of xDAI in reserve, S= the total supply of Sarafu, and TRR = Target Reserve Ratio = that ratio of R/S such that the echange price is 1:1. +1. Grassroots Economics will continue with all the above incentives for Sarafu and to buy the vouchers off on a regular basis 1:1 from Savings groups. +1. Any funds going into the reserve will increase the price and mint additional Sarafu following a bonding curve. +Anyone with a webApp or MetaMask can add xDAI and mint more Sarafu (+) increase the value of all Sarafu +Anyone with a webApp or MetaMask can add send Sarafu to the converter contract to destroy it and withdraw reserve (-) decreasing the value of all Sarafu. +1. As the reserve of Sarafu is depleted and the exchange price drops Grassroots Economics as well as other donors will add more reserve and mint more tokens to distribute. +1. Grassroots Economics will destroy Sarafu it collects to pull out excess reserve and convert that xDAI to Kenyan shillings to continue with Savings Group buy backs. +1. A % fee on conversion between reserve and supply in both directions is done on blockchain and added to the reserve. + + +## Implementation + +### Workflow + +### Variables + +### Interface + + +## Testing + + +## Changelog + diff --git a/spec/platform_incentives.md b/spec/platform_incentives.md deleted file mode 100644 index 0651107..0000000 --- a/spec/platform_incentives.md +++ /dev/null @@ -1,61 +0,0 @@ -# Current Platform Incentives spec - - -* Authors: Will Ruddick (grassecon.org) -* Date: 2020.04.22 -* Version: 1 -* Status: Pre-draft - -## Rationale -The current system seeks to maximize circulation in order to fill market gaps and help CIC users to support eachother. - -## Before -Currently: Grassroots Economics started with a pool of 8 Million Sarafu tokens (which they value 1:1 with Kenyan Shillings ala buy backs). Of which 90% will have been distributed to users as below by the end of April 2020. -The following are all rules are platform based: -1. New users get 50 Sarafu (a CIC) (Shown as Disbursement in database) -1. New users that fill out their profiles (name, business, location, gender) get additional 350 Sarafu (a CIC) (must call office line) (Shown as Disbursement in database) -1. Users that refer other users get 100 Sarafu - after that new user has begun to trade (Shown as Disbursement in database) -1. Savings Groups (aka Chamas are groups of users that save and give loans to eachother) get 10,000 Sarafu divided between their members after 2 months of trading.(Shown as Disbursement in database) -1. Savings Groups can redeem 50% of their Sarafu Balance for Kenyan Shillings each month but must have spent (given loans) of at least as much as they want to cash out. (Shown as Agent_out in database) Cashing out is done using donor funds by Grassroots Economics Foundation and Sarafu is valued 1:1 with Kenyan shilligns using eMoney (Mpesa). -1. Users get a daily or weekly Sarafu bonues depending on how they trade. They are ranked by the number of other people they trade above 20 Sarafu with and awarded based on their percentage of such overall trade. (Possibly moving to k-cycle centrality).(Shown as Disbursement in database) -1. Holding Fee: If an account if dormant (no trades in or out) for 7 days 20 Sarafu are deducted and added back to the pool. (Shown as Reclaimation in database) -1. Anyone with Mpesa or Bonga points can send them to Grassroots Economics to receive additional Sarafu (Shown as Disbursement in database) -1. Donors can give Grassroots Economics funds to support the Sarafu buy-back and operations - -## After -After the migration to xDAI (https://github.com/GrassrootsEconomics/CIC-Docs/blob/master/spec/xdai_migration.md) -anyone (with access to blockchain) in the world can contribute reserve in the form of xDAI. xDAI is a stable token to the US dollar and can be purchased with USD. -With a reserve in xDAI each Sarafu token will now have spot price or excahnge price to xDAI given by P = R/(S*TRR) -Where R = the amount of xDAI in reserve, S= the total supply of Sarafu, and TRR = Target Reserve Ratio = that ratio of R/S such that the echange price is 1:1. -1. Grassroots Economics will continue with all the above incentives and to buy the vouchers off on a regular basis 1:1 from Savings groups. -1. Any funds going into the reserve will increase the price and mint additional Sarafu following a bonding curve. -*. Anyone with a webApp or MetaMask can add xDAI and mint more Sarafu (+) increase the value of all Sarafu -*. Anyone with a webApp or MetaMask can add send Sarafu to the converter contract to destry it and withdraw reserve (-) decreasing the value of all Sarafu -1. As the reserve of Sarafu is depleted and the exchange price drops Grassroots Economics as well as other donors will add more reserve and mint more tokens to distribute. -1. Grassroots Economics will destroy Sarafu it collects to pull out excess reserve and convert that xDAI to Kenyan shillings to continue with Savings Group buy backs. -1. A % fee on conversion between reserve and supply in both directions is done on blockchain and added to the reserve. - - -## Implementation - -### Workflow - -### Variables - -### Interface - - -## Testing - - -## Changelog -