/ README.md
README.md
  1  <a display="inline" href="./assets/authentication.png?raw=true">
  2  <img src="./assets/authentication.png" width="20%" alt="Screenshot of the authentication screen" title="Screenshot of the authentication screen">
  3  </a>
  4  <a display="inline" href="./assets/menu.png?raw=true">
  5  <img src="./assets/menu.png" width="20%" alt="Screenshot of the menu screen" title="Screenshot of the menu screen">
  6  </a>
  7  <a display="inline" href="./assets/wallet.png?raw=true">
  8  <img src="./assets/wallet.png" width="20%" alt="Screenshot of the wallet screen" title="Screenshot of the wallet screen">
  9  </a>
 10  <a display="inline" href="./assets/payment.png?raw=true">
 11  <img src="./assets/payment.png" width="20%" alt="Screenshot of the payment screen" title="Screenshot of the payment screen">
 12  </a>
 13  
 14  # GUBI: General Use Basic Income
 15  
 16  **"To own nothing and fear nothing. To use freely and live fully."**
 17  
 18  ---
 19  
 20  ## The Premise
 21  
 22  GUBI is a prototype for a post-scarcity economic framework built on **trust, presence, and freedom**, not compliance, debt, or work-for-survival conditioning.
 23  
 24  In a world where digital identity is weaponized and autonomy is eroded, GUBI offers a parallel track: a basic income system untethered from labor metrics, surveillance scoring, or centralized ownership models.
 25  
 26  This is not charity. This is not conditional welfare. This is the **re-activation of dignity** as the basis for participation.
 27  
 28  ---
 29  
 30  ## Core Principles
 31  
 32  - **Presence over Productivity**
 33    - You earn by existing within the system, not by "performing value" in externally defined ways.
 34  
 35  - **Trust before Control**
 36    - GUBI assumes good faith by default. Reputation is emergent, not imposed.
 37  
 38  - **Use over Ownership**
 39    - Property hoarding is unnecessary. Tools, goods, and services circulate based on need and proximity, not accumulation.
 40  
 41  - **Spontaneity over Prevention**
 42    - We design for self-healing through motivation and emergence, not brittle rulesets or anticipatory policing.
 43  
 44  - **Scaling by Resonance**
 45    - GUBI does not seek mass adoption through marketing or mandates. It grows when it is found and chosen.
 46  
 47  ---
 48  
 49  ## How It Works
 50  
 51  **1. Proof-of-Presence:**
 52  - Users connect to the system through voluntary attestation mechanisms.
 53  - Currency is emitted periodically simply by being "alive" in the network.
 54  
 55  **2. Dynamic Emission Control:**
 56  - GUBI supply flexes organically based on human presence — not through centralized levers or policy edicts.
 57  - Inflation and scarcity reflect social balance, not market manipulation.
 58  
 59  **3. Peer-to-Peer Commons:**
 60  - Goods and services are offered freely or for GUBI within autonomous micro-networks.
 61  - Reciprocity emerges socially, not contractually.
 62  
 63  ---
 64  
 65  ## Why Now
 66  
 67  The so-called "Fourth Industrial Revolution" seeks to shackle human agency to digital ledgers, carbon credits, programmable money, social compliance wallets. Under the banner of "convenience," sovereignty is being atomized into permissions granted by unseen hands.
 68  
 69  GUBI exists to preemptively seed an alternative. **A way out, already waiting.**
 70  
 71  We are small. We are agile. We are human.
 72  
 73  They need coordination. We need only connection.
 74  
 75  ---
 76  
 77  ## Goals
 78  
 79  - **Short-Term:**
 80    - Build and deploy a minimal viable GUBI infrastructure outside traditional ID verification systems.
 81    - Foster initial micro-economies based on real use and trust.
 82  
 83  - **Medium-Term:**
 84    - Create bridges to physical goods and services without ownership locks.
 85    - Enable self-repair, federation, and forkability by design.
 86  
 87  - **Long-Term:**
 88    - Cultivate parallel societies that operate on dignity-first economics.
 89    - Serve as living proof that autonomy was, and is always possible.
 90  
 91  ---
 92  
 93  ## Next Steps
 94  
 95  1. Complete initial GUBI emission and attestation protocols.
 96  2. Launch limited pilot communities.
 97  3. Document failures and iterate openly.
 98  4. Spread only through resonance and invitation, not advertising.
 99  
100  ---
101  
102  > *Expect anything. Fear nothing. Build anyway.*
103  
104  ---
105  
106  (Work in progress. We grow through action.)
107  
108  ## Important
109  
110  + Cyber-gubi is fully GDPR compliant - the collected biometrics data is hashed via locality-sensitive hashing and stored in a public p2p database. The hash is irreversable to original data.
111  + To receive your basic income you need to login in the span of the last 3 days of each month, see "How to use" for more details
112  
113  ## What is it
114  
115  + A guaranteed unconditional basic income global digital currency
116  + Natural supply cap - the amount of tokens is limited to the amount of living people receiving them + inflation indexed
117  + Natural burn rate - when a beneficiary dies the tokens belonging to that person are out of circulation
118  + Inflation indexer - real-time analysis of price fluctuations and adjustment of income
119  
120  ## What it is not
121  
122  + Not a crypto currency - not based on blockchain
123  + No transfer - tokens can only be used for purchases of products and services
124  + No inheritance - tokens can not be inherited
125  + No exchange - tokens are not listed on exchanges and can not be traded or speculated with
126  
127  ## How to use
128  
129  + Authenticate with your face ID
130  + You get redirected to your wallet
131  + You can see your payment ID and do payments
132  + To pay someone you need their payment ID
133  + Each month you will automatically get your basic income debited
134  + Important: you can only receive your basic income in the span of the last 3 days of each month
135  + This is in order to make sure there are online peers to run the inflation indexer
136  
137  ## Installation
138  
139  The app runs on the public IPFS network. In order to use it follow the steps below:
140  
141  1. Install Linux
142  2. Install IPFS Companion http://docs.ipfs.io/install/ipfs-companion/
143  3. Install golang 1.20 or later version - https://go.dev/doc/install
144  4.  Clone https://github.com/stateless-minds/kubo to your local machine
145  `git clone https://github.com/stateless-minds/kubo.git`
146  5. Build IPFS
147  `make build`
148  6. Init IPFS
149  `./cmd/ipfs/ipfs init`
150  7.  Follow the instructions here to open your config file: https://github.com/ipfs/kubo/blob/master/docs/config.md. Usually it's `~/.ipfs/config` on Linux. Add the following snippet to the `HTTPHeaders`:
151  ```{
152    "API": {
153      "HTTPHeaders": {
154        "Access-Control-Allow-Origin": ["webui://-", "http://k51qzi5uqu5djbxska9ryliqt6rik7gfy44wb46xub92gbhnsy3c0n5g66phsq.ipns.localhost:8080", "http://127.0.0.1:5001", "https://webui.ipfs.io"],
155        "Access-Control-Allow-Credentials": ["true"],
156        "Access-Control-Allow-Methods": ["PUT", "POST"]
157      }
158    },
159   ```
160  8. Run the daemon:
161  + `.cmd/ipfs/ipfs daemon --enable-pubsub-experiment`
162  
163  9.  Navigate to <a href="https://ipfs.io/ipns/k51qzi5uqu5djbxska9ryliqt6rik7gfy44wb46xub92gbhnsy3c0n5g66phsq">Cyber Gubi</a>
164  10.  Pin it to your local node so that you cohost it every time your IPFS daemon is running
165  ```
166  10.1. Open your IPFS dashboard
167  
168  http://127.0.0.1:5001/webui
169  
170  10.1 In your CLI with a running daemon run:
171  
172  ./cmd/ipfs/ipfs ipns name resolve k51qzi5uqu5djbxska9ryliqt6rik7gfy44wb46xub92gbhnsy3c0n5g66phsq
173  
174  Expected result for example:
175  /ipfs/QmRtJemJxaPS1MoCcHJGgQT8Wv7e4L7PTMjxaJU3ZaBDHC
176  
177  10.2. In the search bar of the web UI search for QmHash by pasting: QmRtJemJxaPS1MoCcHJGgQT8Wv7e4L7PTMjxaJU3ZaBDHC
178  10.3 Click on More
179  10.4 Click Set Pinning
180  10.5 Mark local node and hit Apply
181  ```
182  
183  
184  ## Path to mainstream adoption
185  
186  + Map it to your local currency - as a starting point consider cyber-gubi pegged to your local currency with a 1:1 ratio - this is purely for initial pricing reference since it can not be exchanged for other currencies.
187  + Spread the word - when you go shopping mention this new currency, how much of it you already have and whether the retailer would accept it. If they express interest tell them to visit cyber-gubi to register in the company waiting list.
188  + Once a big enough commercial network registers and wants to use it due to the amount of potential customers having it this creates a push towards nation states to accept it as a form of currency to collect taxes in. They might ask to convert it to local cucrency but cyber-gubi is non-exchangeable so they have to accept it if they want to make money out of it.
189  + Wages paid in cyber-gubi are adjusted based on arbitrage between product prices and profit - for example you can sell apples at a rate of 5 to 1 compared to your local currency but pay salaries at a rate of 4 to 1 thus making profit.
190  + A free-market economy kicks in and starts regulating internal pricing independently of other currencies - at this point the initial mapping to local currency is no longer needed. The currency starts to live its own life creating own pricing system.
191  + The value of cyber-gubi is defined independently by each retailer setting price on own products
192  + Subscription based all-in-one businesses emerge as a business model - businesses registered on cyber-gubi appear as list of merchants to all receivers of basic income where you can subscribe for a monthly fee and use what you want
193  + All-in-one depots emerge where you pay a monthly fee and use and return instead of own
194  + Economy changes from ownership model to usage model
195  + Businesses simplify their business models, get predictable profits and reduce costs
196  + People no longer need storage
197  + Circular economy generates less waste
198  + Governments have accounts where they can view all transactions and collect tax
199  
200  ## Simplified
201  + Businesses register on the platform in a waitlist
202  + When there are enough merchants it goes live
203  + A critical mass of businesses means the governments should accept the basic income currency as a valid tax payment method
204  + Users get a list of merchants to choose from
205  + Users subscribe for a monthly fee and get access to stores
206  + Businesses plan accordingly the budget for stocking
207  + Businesses save on - pricing, marketing, cashiers, advertising, accounting
208  + Governments collect more tax and invest in better services and infrastructure
209  
210  ## FAQ
211  
212  + Why not list it on exchanges and pay taxes in the accepted local currency?
213      + It will immediately be speculated with and inflated/deflated.
214  + Can I create multiple wallets?
215      + No, your account is linked to your face which will get recognized on any new device.
216  + What happens with inflation?
217      + There is an inflation indexer which tracks price fluctuations in real-time and adjusts the basic income accordingly
218  + Why is there no mobile version?
219      + App stores are centralized and can take down the app anytime. You can use a mini laptop with Linux instead.
220  + How does closing an account influence the economy?
221      + Closing an account means all money of the person are destroyed. This will cause deflation as the money supply gets lower.
222  
223  ## TODO
224  
225  - [x] Add Presentation Attack Detection model to prevent malicious attempts to abuse facial recognition
226  - [x] Introduce registration for businesses via waiting list
227  - [x] Introduce governments to collect tax - they can view all transactions and collect for their own country. Governments have no control over the system and can only collect if they have an account
228  - [ ] Update kubo to latest version
229  - [ ] Port go-ipfs-api orbit-db integration to kubo/rpc
230  
231  ## Acknowledgments
232  
233  1. <a href="https://go-app.dev/">go-app</a>
234  2. <a href="https://ipfs.io/">IPFS</a>
235  3. <a href="https://berty.tech/">Berty</a>
236  4. All the rest of the authors who worked on the dependencies used! Thanks a lot!
237  
238  ## Contributing
239  
240  <a href="https://github.com/stateless-minds/cyber-gubi/issues">Open an issue</a>
241  
242  ## License
243  
244  Stateless Minds (c) 2025 and contributors
245  
246  MIT License
247  
248  ## Credits
249  
250  + Modified [Wallet Layout](https://codepen.io/surendharnagarajan/pen/eoKOLL)
251  
252  Copyright (c) 2025 by Surendhar Nagarajan (https://codepen.io/surendharnagarajan/pen/eoKOLL)
253  
254  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
255  
256  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
257  
258  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
259  
260  + Copyright (c) 2025 by Sanket Bodake 🇮🇳 (https://codepen.io/sanketbodke/pen/qBXBOgb)
261  
262  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
263  
264  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
265  
266  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
267  
268  Copyright (c) 2025 by Vitalii (https://codepen.io/nevadskiy/pen/YYGbao)
269  
270  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
271  
272  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
273  
274  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
275