cic-docs/README.md

98 lines
9.1 KiB
Markdown
Raw Normal View History

2020-01-15 11:57:44 +01:00
## Community Inclusion Currencies (CICs) Documentation
2020-05-17 09:06:15 +02:00
Community Inclusion Currency (CIC) technology seeks to give organizations and communities the ability to issue, use and manage CICs in order to build resilient and connected economies.
2020-11-04 13:19:36 +01:00
## General Documentation
2020-05-26 16:54:29 +02:00
+ [White Paper](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/CIC-White-Paper.pdf)
2020-12-05 13:59:52 +01:00
+ [Training Materials](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/CIC_Training_Guide_Kenya.pdf)
2020-05-15 11:12:01 +02:00
+ [Frequently Asked Questions](https://docs.google.com/document/d/1qtlOEL4pqW1vOL893BaXH9OqRSAO3k0q2eWbVIkxEvU/edit?usp=sharing)
+ [Blog](https://www.grassrootseconomics.org/blog)
+ [MOOC](https://www.grassrootseconomics.org/mooc) - Very old (paper based systems)
2020-05-15 11:12:01 +02:00
+ [Village Market Simulator series](https://www.youtube.com/playlist?list=PLPUExzwZAUpbEInJy_8Wj_c_mDsw7-qXe)
2020-06-13 10:20:33 +02:00
+ [Transaction Data CSVs](https://www.grassrootseconomics.org/research): Transaction Datasets and Research
+ [Live Data Dashboard](https://dashboard.sarafu.network)
2020-07-27 10:42:13 +02:00
+ [Animated Explainer Video](https://www.youtube.com/watch?v=vJL9-FFleow)
2021-07-24 11:00:14 +02:00
+ [Jam Board](https://jamboard.google.com/d/1PcowWC7UNCOtfpaeUT2hu8_GoEU-kwzmcHYLvplUFOM/edit?usp=sharing)
+ [Preso](https://drive.google.com/file/d/1qLfNgIBkhnrxesAJd2Sn9eCxsAzctSqV/view?usp=sharing)
2020-07-27 10:42:13 +02:00
2020-05-14 11:56:02 +02:00
2021-09-13 11:04:47 +02:00
## CIC-Engine - Open source code
+ **CIC-Engine**, Top level code desctiption ([CIC Engine](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/cic-engine.md))
+ **Base components**, containing all necessary provisions for services and tooling. ([Chaintools](https://gitlab.com/chaintool))
+ **Generic services components**, libraries, daemons and services making up the custodial engine. ([cicnet](https://gitlab.com/chaintool))
+ **Deployment components**, which facilitates deployment of the custodial engine, as well as seeding data for development, demonstration and migration. ([GrassrootsEconomics](https://gitlab.com/grassrootseconomics/))
2020-05-15 11:12:01 +02:00
+ [Dashboard](https://github.com/GrassrootsEconomics/Accdash) [Dashboard API](https://github.com/GrassrootsEconomics/Accap)
2021-06-09 18:51:24 +02:00
+ [Demurrage Smart Contract](https://gitlab.com/cicnet/erc20-demurrage-token)
2020-05-14 11:56:02 +02:00
2021-09-13 11:04:47 +02:00
## CIC full system notes ##
See ([CIC Engine](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/cic-engine.md)) for our vision mission and community statement
2020-05-15 11:12:01 +02:00
* Blockchain
2021-08-13 14:02:14 +02:00
* Currently: To ensure decentralization, censor proofing and fair gas prices we work on Humanitarian Blockchains like bloxberg.org.
2021-06-18 08:45:27 +02:00
* Blockchain 1st vs database
2021-08-13 14:02:14 +02:00
* Any interface can be developed without central control
2021-04-19 07:02:47 +02:00
* A blockchain where gas prices can be kept to zero.
2021-08-13 14:02:14 +02:00
* A Proof of Authority chain where nodes can be elected democratically or Proof of Stake where the Token Issuers have Stake
2021-04-19 07:02:47 +02:00
* A blockchain that enables easy and secure bridging to other chains.
2020-05-14 11:56:02 +02:00
* Blockchain Contracts
2021-06-18 08:45:27 +02:00
* [Demurrage token](https://gitlab.com/cicnet/erc20-demurrage-token) - Network / Basic Income token - Mints tokens that include a demurrage.
2021-09-13 11:04:47 +02:00
* Bridge - in order to move between the side chains (Layer 2) we use a bridge
2020-11-03 14:45:33 +01:00
* Currently: We have no connections to Ethereum Mainnet
2021-06-18 08:45:27 +02:00
* Goal: To have options to bridge to a variety of other tokens - possibly Cosmos Protocol
2021-03-01 06:58:46 +01:00
* Liquidty Pools - Enable connection of Sarafu and CICs to each other and outside networks
2021-09-13 11:04:47 +02:00
* Currently not in use.
2021-06-18 08:45:27 +02:00
* Goal" A variety of options for connecting CICs and other tokens, such as [Static and Bonded Liquidity pools](https://www.grassrootseconomics.org/post/static-vs-bonded-liquidity-pools-for-cics)
2020-05-17 09:06:15 +02:00
* Contract Deployment (Currency Creation service)
2021-06-18 08:45:27 +02:00
* Currently: We currently deploy all contracts via Command line
2021-09-13 11:04:47 +02:00
* Goal: A web based interface for organizations and communities to create their own tokens and other contracts (DAO)
2021-04-19 07:02:47 +02:00
* CIC Token Creation system
2021-06-18 08:45:27 +02:00
* Currently: Manual contract deployment (command line) and paper based agreements with communities.
2021-04-19 07:02:47 +02:00
* Goal: Registered organizations can submit an application to be an issuer, they must have:
* an audited and legally binding backing commitment signed by local guarentors to back the total amount of a CIC .
* The CIC issuers should also choose to add thier CIC to a liquidity pool with Sarafu or other CICs for connections
2021-06-18 08:45:27 +02:00
* Longer term goal: DAOs
2020-06-13 09:57:50 +02:00
* Cloud server - is where we host all of our systems, Platform, Dashboard, future blockchain node.
2021-06-18 08:45:27 +02:00
* Currently: We are using Digital Ocean for instances and data storgage along with postgress databases - Transactions are done here first then synced with blockchain
2021-04-19 07:02:47 +02:00
* Goal: Migrating servers to Digital Ocean using Kubernetes.
* Moving toward a web-based wallet and decentralized data storage with self-soverign data (certificate based)
* Simulations
* Currently: We started with a home grown Village Market Simulator and are currently are developing and using a cadCAD based [modeling](https://gitlab.com/grassrootseconomics/cic-modeling) simulation built by BlockScience
* Goal: To build on this simulation to validate and stress test economic models and to provide predictive analysis based on data
2020-05-14 11:56:02 +02:00
* Dashboard
2020-06-13 09:57:50 +02:00
* Currently: [Our dashboard](https://dashboard.sarafu.network) uses a D3 javascript we also have an internal dashboard for CIC platform administrators.
* We are pulling data from an internal postgres database on the CIC Mgmt Platform as well as blockchain transaction data from BlockScout
2020-05-14 11:56:02 +02:00
* Goal: To have system related information available to field officers and users on Android phones and to pull data from our own blockchain node.
2020-06-13 09:57:50 +02:00
* To allow donors to give directly and measure the impact of their giving
* To visualize trade and the health of economies and communities
2021-04-19 07:02:47 +02:00
* To pull transaction and user meta data from blockchain directly (also used in marketplace)
2020-05-14 11:56:02 +02:00
* Marketplace
2021-04-19 07:02:47 +02:00
* Currently: Word of mouth but Grassroots Economics provides limited signage to users and marketing of products in the network is done by word of mouth, SMS messaging and a phone support team.
2020-06-13 09:57:50 +02:00
* Goal: A web based interface for organizations and communities to share projects, event offers and wants using CICs
2021-04-19 07:02:47 +02:00
* Self-sovergin [certificates](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/020_redeemable_certifcate.md) (NFTs) form the basis for the marketplace
* A USSD marketplace (Directory) system that can be searchable and likned to regional areas
* CIC Administration Dashboard (CICADA) - Management Platform
2020-05-14 11:56:02 +02:00
* Currently: System admins (GE staff) are able to assist users to reset pins, reverse transactions, create new users. The system is build on React and Flask in Python and uses postgres for data stroage.
2021-04-19 07:02:47 +02:00
* Goal: Migration to Angular and stabilization of the platform and synchronization to blockchain, and eventual migration to a webBased wallet system with cloud storage with minimal need.
2020-05-14 11:56:02 +02:00
* Wallet:
2020-06-13 09:47:00 +02:00
* Currently: Users connect via USSD through AfricasTalking to connect with their wallet on the CIC Mgmt Platform, private keys are held by Grassroots Economics for these phones
2020-05-14 11:56:02 +02:00
* Goal:
2021-06-18 08:45:27 +02:00
* Telegram Chat bot
2021-04-19 07:02:47 +02:00
* [WebApp](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/010_Web_Wallet.md)
2020-06-13 09:47:00 +02:00
* Fiat On-ramp / off-ramp - In order to enable users and donors to interact with CICs we need a way to move fiat on and off the blockchain
2021-06-18 08:45:27 +02:00
* Currently: any connection to national currency is handled manually (eMoney / bank transfers)
* Goal: To connect to / create API driven liquidity pools to fiat (eMoney)
2021-04-19 07:02:47 +02:00
* To make credit card another other payment on and offramps available and streamline our fiat to token processes.
* Exchange Rates will be variable based on the CIC → KSH rate (depends on the liquidity pool maths)
2020-11-03 14:45:33 +01:00
* Blockchain interaction (once bridged)
2021-04-19 07:02:47 +02:00
* Anyone who can obtain or create any CIC token can send it to a liquidity pool if avalaible for conversion and bridging.
2021-06-18 08:45:27 +02:00
* Data /ID System -
2020-05-14 11:56:02 +02:00
* Currently: Each user has a sim card and the Telecom provides KYC services - users are asked a pin number to access the account on USSD
2021-06-18 08:45:27 +02:00
* Goal: Creating a more robust ID system for users with and without sim cards. Possibly adding brightID social ID - like technologies with confidence scoring
* Non custodial data ownership on cloud where users can specify what data they want to make avalible
* Move toward a 'claims' based system where CIC are claims against redemption with endorsments and data and other claims can be created and endorsed - such as product offering, carbon offseting, SDG Impacts.
2021-04-19 07:02:47 +02:00
* Rewards and Incentives
2021-06-18 08:45:27 +02:00
* Currently: These incentive systems are manual, such as initial user air drop, referral bonuses and holding fees.
2021-04-19 07:02:47 +02:00
* Currently: We are using a CIC by the name of Sarafu that is not backed by anything. Users get a Sarafu for free and groups will be able to create their own CICs backed by local goods and services and connect to eachother.
* Goal: Any org developing a CIC can easily establish various rules and policies - these should be built into the token contracts.
2020-06-13 09:57:50 +02:00
* Training Materials:
2021-04-19 07:02:47 +02:00
* Currently: We have minimal documentation curriculum, games and materials for training communities and CIC issuers
* Goal: Better curriculum and verious multi-media materials