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

suggested to change to the term voucher rather than token

Browse Source
This commit is contained in:
Will Ruddick 2021-07-13 12:48:21 +00:00
parent 1d28f9f75f
commit d5f0d8f9f3
1 changed files with 17 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
spec/022_multi_token_env.md
View File

@ -1,4 +1,4 @@
# Multi Token Environment # Multi Token Environment (Vouchers Menu)
<!-- <!--
valid status values are: Pre-draft|Draft|Proposal|Accepted valid status values are: Pre-draft|Draft|Proposal|Accepted
@ -9,7 +9,7 @@ valid status values are: Pre-draft|Draft|Proposal|Accepted
* Status: Pre-draft * Status: Pre-draft
## Rationale ## Rationale
Enabeling users to hold and trade multiple tokens- will allows wallet holders to be connected to eachother as well as other tokens such as rewards. Enabeling users to hold and trade multiple tokens- will allows various chamas and token issuers to be connected to eachother as well as other tokens such as rewards.
## Intro ## Intro
* Today users only hold one token aka Sarafu - created by Grassroots Economics. This means that users can't interact with other tokens at all. * Today users only hold one token aka Sarafu - created by Grassroots Economics. This means that users can't interact with other tokens at all.
@ -21,10 +21,11 @@ Enabeling users to hold and trade multiple tokens- will allows wallet holders to
2. The user should be able to see these tokens and their balances (if non-zero) in a 'My Tokens' Menu item (top level) - as many as possible on USSD with the highest balalances at the top. 2. The user should be able to see these tokens and their balances (if non-zero) in a 'My Tokens' Menu item (top level) - as many as possible on USSD with the highest balalances at the top.
3. The user should be able to switch which token is their Active Token. This will be used for sending, as well as default balance checks and mini statement. 3. The user should be able to switch which token is their Active Token. This will be used for sending, as well as default balance checks and mini statement.
## USSD Menu ## USSD Menu:
Top level menu item called: Vouchers (Voucha in Kiswahili)
### 1 ### 1
Choose Active Token: Choose Voucher: (CHagua Voucha)
1. Sarafu 100 1. Sarafu 100
2. YOMA 50 2. YOMA 50
3. Afya 223 3. Afya 223
@ -32,7 +33,7 @@ Choose Active Token:
0: Back 0: Back
### 2 ### 2
Your active will be set to Afya. Your voucher will be set to Afya.
Please enter your PIN to confirm: Please enter your PIN to confirm:
@ -40,7 +41,7 @@ Please enter your PIN to confirm:
9: Main Menu 9: Main Menu
### 3 ### 3
Success! All transactions will now be in AFYA tokens. Success! All transactions will now be in AFYA.
0: Back 0: Back
9: Main Menu 9: Main Menu
@ -51,32 +52,32 @@ Balance 223 AFYA
1. Send 1. Send
2. One Time Code 2. One Time Code
3. Directory 3. Directory
4. Change Token 4. Vouchers
5. My Ledger 5. Records
6. My Profile 6. Profile
7. Help 7. Help
### CICADA Mgmt Platform - GUI ### CICADA Mgmt Platform - GUI
1. On the user info page you should be able to set their Active Token - via a drop down 1. On the user info page you should be able to set their Active Voucher - via a drop down
1. You should be able to see balances in all the tokens they have 1. You should be able to see balances in all the tokens/vouchers they have
## Active Token ## Active Token
1. Each user needs to be assigned a default / Active token - they start with Sarafu by default. 1. Each user needs to be assigned a default active token/voucher - they start with Sarafu by default.
## (optional) Accept other Tokens ## (not used) Accept other Tokens
1. If this is on and someone attempts to send another token (other than their active token) to that user the sender will recieve an error as well as the reciever similar to the Balance Limit Error https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/019_wallet_soft_limit.md 1. If this is on and someone attempts to send another token (other than their active token) to that user the sender will recieve an error as well as the reciever similar to the Balance Limit Error https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/019_wallet_soft_limit.md
## Interfaces - UX ## Interfaces - UX
### Command Line - CLI Set Active Token ### Command Line - CLI Set Active Token
1. User ID and Name or ID of the token - ensure it is a valid token 1. Inputs: User ID and Name or ID of the token - ensure it is a valid token (ability to batch this with csv)
### USSD feature phones - Set Active Token ### USSD feature phones - Set Active Token
- New user dials ussd session code where she selects My Sarafu -> Set Active Token - New user dials ussd session code where she selects -) Vouchers
- They top X tokens by balances they have in their wallet are shown with an option to select the number of the token they want to choose - Their Voucher sorterd by balances they have in their wallet are shown with an option to select the number of the token they want to choose
- Confirmation message and entry of pin number to Confirm - Confirmation message and entry of pin number to Confirm
- Future transactions send from this account will try to send that token - Future transactions send from this account will try to send that token