grassrootseconomics/cic-docs
5
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update 006_Self_Service_Token.md

Browse Source
This commit is contained in:
Will Ruddick 2020-05-18 11:31:55 +00:00
parent d72f3727a7
commit 05b1d526e0
1 changed files with 20 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
spec/006_Self_Service_Token.md
View File

@ -19,63 +19,50 @@ We want users to be able to create their tokens to create more ownership and dif
## Token creation process - UI ## Token creation process - UI
(I will describe this for USSD be a web interface should also be made) (I will describe this for USSD be a web interface should also be made)
1. Existing User calls Sarafu 1. Existing User calls Sarafu
*. New user dials *483*46# where she selects * New user dials *483*46# where she selects
*. My Account -> Create Token * My Account -> Create Token
Note that this ability is whitelisted- to be whitelisted the user must have: Note that this ability is whitelisted- to be whitelisted the user must have:
1. Been in the system as an active user for some time (at least 1 month) 1. Been in the system as an active user for some time (at least 1 month)
1. Have a substantial balance (his CIC converted to reserve) to reach at least 25% reserve. Minimum 100 USD in value DAI. Which will staked into the converter and leveraged into $400 of CIC tokens (the value changes as reserve is removed). 1. Have a substantial balance (his CIC converted to reserve) to reach at least 25% reserve. Minimum 100 USD in value DAI. Which will staked into the converter and leveraged into $400 of CIC tokens (the value changes as reserve is removed).
2. Default Token Options 2. Default Token Options
*. Based on the users location the system has preset defaults: *. Based on the users location the system has preset defaults:
1. 25% Target Reserve Ratio (1:1 with reserve) 1. 25% Target Reserve Ratio (1:1 with reserve)
1. Minimum initial reserve is $100 USD in value 1. Minimum initial reserve is $100 USD in value
3. Chosen Options 3. Chosen Options
1. Token Name (limited to 9 characters (auto converted to lowercase no special letters) (TOKEN_NAME) 1. Token Name (limited to 9 characters (auto converted to lowercase no special letters) (TOKEN_NAME)
2. Reserve amount (the minimum is 10,000 Kenyan Shillings in value- higher amount means a higher price of the final tokens) - Max is the user’s current balance. Note that this10,000 Kenyan Shillings can be in the form of other tokens and converted to Sarafu. 2. Reserve amount (the minimum is 10,000 Kenyan Shillings in value- higher amount means a higher price of the final tokens) - Max is the user’s current balance. Note that this10,000 Kenyan Shillings can be in the form of other tokens and converted to Sarafu.
3. How many initial members? (NUM)MEMBERS) 3. How many initial members? (NUM)MEMBERS)
4. How much will initial members receive (INITAL_NEWUSER_AMT) (maximum is MAX_CIC_CREATED/NUM_MEMBERS) 4. How much will initial members receive (INITAL_NEWUSER_AMT) (maximum is MAX_CIC_CREATED/NUM_MEMBERS)
5. Note that members must ‘join’ the token (via USSD) using the TOKEN_NAME to receive this. 5. Note that members must ‘join’ the token (via USSD) using the TOKEN_NAME to receive this.
4. Pin 4. Pin
“Enter PIN * “Enter PIN
_______________” * _______________”
* Repeat Pin
Repeat Pin * “Enter PIN again
“Enter PIN again * _______________”
_______________” *
* Pop Up:
Pop Up: * “Your TOKEN_NAME token is being created.
“Your TOKEN_NAME token is being created. * You’ll receive an SMS when your token is ready.”
You’ll receive an SMS when your token is ready.” *
* Error:
Error: * If the user doesn’t repeat the same password pop up with the text
If the user doesn’t repeat the same password pop up with the text * “Wrong PIN, please try again”
“Wrong PIN, please try again” *
* Clicking back will lead to Repeat Pin screen
Clicking back will lead to Repeat Pin screen
5. “You will receive an SMS when your TOKEN_NAME token is ready” 5. “You will receive an SMS when your TOKEN_NAME token is ready”
6. Approval 6. Approval
At this stage, the wallet creation starts confirmation SMS will be sent only when the Backend process (see below) is over. At this stage, the wallet creation starts confirmation SMS will be sent only when the Backend process (see below) is over.
If token creation succeeds: If token creation succeeds:
Send an SMS to the user with the following text Send an SMS to the user with the following text
* “You have just created the TOKEN_NAME token!
SMS:
“You have just created the TOKEN_NAME token!
Dial *483*46# Airtel or *384*96# to use TOKEN_NAME token Dial *483*46# Airtel or *384*96# to use TOKEN_NAME token
Tell your members to JOIN TOKEN_NAME via My Account” Tell your members to JOIN TOKEN_NAME via My Account”
* If account creation fails:
If account creation fails:
Send an SMS to the user with the following text: Send an SMS to the user with the following text:
“Whoops! There was a problem creating your token. To try again Dial *483*46#. If issues persist contact support: 0757628885” “Whoops! There was a problem creating your token. To try again Dial *483*46#. If issues persist contact support: 0757628885”
Token creation process - Backend ## Token creation process - Backend
Start this process between step 5 to 6, Start this process between step 5 to 6,
Save all the information created in the process on the SEMPO DB. Save all the information created in the process on the SEMPO DB.