This is the initial smart contract implementation for the Circles universal basic income platform.
Note: This is not yet intended for deployment in a production system.
Website // Whitepaper // Chat
There are several components:
This is derived from standard ERC20 implementations, with two main differences: The balance for the "owner" (UBI receiver) is calculated based on the time elapsed since the contract was created, and there is an "hubTransfer" function that allows trusted transitive exchanges. Tokens belong to the hub that deployed them, and can only transact transitively with tokens from the same hub. Tokens have owners, which can be an external account or any kind of contract - in our deployment, they will be gnosis safes.
This is the location of system-wide variables and the trust graph. It has special permissions on all tokens that were deployed through it and have authorized it to perform transitive exchanges. Hub has an owner, which should at least be a multisig, (in our deployment this will also be a gnosis safe) but can in practice be any type of address.
Illustrated here are some of the main available calls:
- Signup method of the hub deploys a circles token
- Safe or external account makes trust connections within the hub with the trust method
- Users send transitive transactions with the hub, which has special permissions on tokens
Requires node version 12
Clone down this repo and npm install
With ganache running (npm run ganache
), in a new console window, node_modules/.bin/truffle compile
then node_modules/.bin/truffle migrate
Note: This is a work in progress and this should be done only for contribution and exploration purposes.
Requires node version 10
npm test
will re-build the contracts / tests and run all of the tests in the test directory.
Tests are executed with the help of Truffle and written in javascript using Mocha with the Chai assertion library.
When you run npm test
a new local blockchain will be started with ganache-cli (unless you already have one running). The contracts will be deployed and the javascript tests will make transactions to this chain.
Helper functions defined in test/helpers provides functionality for more complicated tests such as: reading the event log, or checking for an EVM "revert / throw", or changing the blockstamp times.
GNU Affero General Public License v3.0 AGPL-3.0