Kosmos Wiki - User contributions [en]

Kredits

2020-01-31T01:31:09Z

Jonomist:

Kredits are a system for tracking contributions to Kosmos projects, enabling the fair and transparent use of project funds, as well as improving project management and governance.

For now, kredits are mostly a fun experiment and gaming element, but the long-term idea is that they can be rewarded with dividends, if or when the Kosmos project/org is in a financial position that allows it to reward everybody contributing to its success.

== Current status ==

After a few years of experimentation, we finally started issuing kredits in production earlier this year (2019). We also have a functioning, usable Web UI up and running, which interacts directly with Ethereum and IPFS nodes, and which you can also use to create your contributor account: https://kredits.kosmos.org

== Concept & Architecture ==

=== Smart contracts ===

Kredits are cryptographic tokens, (currently) stored on the [https://ethereum.org/ Ethereum] blockchain, issued and managed via programs called [https://en.wikipedia.org/wiki/Smart_contract smart contracts].

We use two types of tokens:

# A non-fungible [https://eips.ethereum.org/EIPS/eip-721 ERC721] token, which represents the actual contributions. These are unique, and they cannot be sent or traded with other people. They are earned by contributing to Kosmos projects, and either one of our bots or one of our contributors propose to create them for a contribution.
# A fungible [https://eips.ethereum.org/EIPS/eip-20 ERC20] token, which represents the value of contributions. These are not unique, meaning every token represents the same value. They can be sent to other addresses using any ERC20-compatible wallet.

Every contribution token/record contains the amount of ERC20 kredits that can be claimed by the contributor. "Claiming" those tokens basically means paying them out from the Kredits smart contract to your own wallet. This is optional, and the contributor can choose to do this whenever they want.

=== Data storage ===

All non-essential data (basically everything except for pure IDs and numbers/amounts) is stored on [https://ipfs.io/ IPFS]. In order to ensure that no data is lost, and all data is available to Kredits users at all times, we run a few Kosmos IPFS nodes, as well as a public IPFS gateway. See [[Kredits:IPFS]] for more information.

=== High-level overview ===

[[File:High-level-architecture.png|960px|link=https://wiki.kosmos.org/images/c/c1/High-level-architecture.svg|frameless|caption]]

== Software ==

=== Kredits Contracts ===

[https://github.com/67P/kredits-contracts/ kredits-contracts] contains the smart contracts, written in Solidity, as well as the generated contract ABI for use with the Web3 JavaScript library (e.g. in kredits-web). It can be linked from other programs via npm.

=== Kosmos Schemas ===

[https://github.com/67P/kosmos-schemas/ kosmos-schemas] contains the JSON Schema definitions and examples for all data stored in IPFS. They can be used in the kredits-contracts JS wrapper as well as in client apps.

=== Kredits Web ===

[https://github.com/67P/kredits-web/ kredits-web] is the Web UI for the public Kredits dashboard and management UI. The app is hosted on 5apps Deploy at [https://kredits.kosmos.org/ kredits.kosmos.org].

=== Hubot Kredits ===

[https://github.com/67P/hubot-kredits hubot-kredits] is a Hubot chatbot extension, which can automatically create (unconfirmed) contribution tokens, e.g. based on GitHub contributions, Mediawiki edits, etc.. We also use it to prototype back-end behavior that is potentially needed in `kredits-web`.

=== Kredits GitHub ===

[https://github.com/67P/kredits-github kredits-github] is a very simple GitHub app, which adds a check to pull requests in org repos, ensuring that they are assigned a kredits label, which is used by hubot-kredits to determine the size of the contribution.

=== Kredits IPFS Pinner ===

[https://gitea.kosmos.org/kosmos/kredits-ipfs-pinner kredits-ipfs-pinner] pins IPFS data of a Kredits organization on an IPFS node. Running this program turns any IPFS node into a live mirror for all Kredits-related documents.

== Democratic governance via Kredits ==

Kredits have the potential to be used for distributed governance of the Kosmos project and organization. The basic idea is that people can vote on decisions with a vote that carries a weight according to their contributions. In short: the people who do should be the ones who decide. With a limited set of basic rules, this makes for an interesting new and decentralized approach to open-source governance.

== Roadmap ==

See https://wiki.kosmos.org/Meeting_Notes:_Feb_25,_2019#Kredits_Roadmap_2019

== Ideas ==

* <del>Leaderboard for contributions/kredits, where people can choose to publish their name or not (based on actual blockchain data)</del> WIP, almost done: https://kredits.kosmos.org/
* Some way for new contributors to claim kredits sent to them via email link or similar (Update: current idea is to issue them without the need for an address, then be able to confirm address change via GitHub OAuth and admin action/proposal)
* <del>IRC bot for small transactions, so people can send each other kredits on Kosmos project channels</del> Turned out to not make sense.
* <del>Custom wallet, removing all unnecessary features and integrating custom features we'd like to have (like e.g. easy multisig transactions, linked/initiated from a Kosmos chatroom)</del> WIP, almost done: https://github.com/67P/kredits-web/ (tokens can be sent via normal ETH wallets)
* [[Contribution Dashboard]] for regular Kredit distribution as well as general project stats
* Expense management, similar to https://opencollective.com/learn-more
* Interoperability with other coops/projects/software
** https://docs.opencoopecosystem.net/
** https://www.valueflo.ws/

== Similar projects/ideas ==

* [https://wiki.p2pfoundation.net/Commons-Oriented_Decentralised_Programmed_Organisations cDPOs (commons-oriented decentralised programmed organisations)] as frameworks to bootstrap, develop & sustain commons projects
* [https://blog.colony.io/colony-beta-product-summary-2121a357d61d?mc_cid=b1750a36c8&mc_eid=fb43075dba#.9egmfejax Colony] -- "The Colony Beta is for teams who want to create their own “Collaboration Network”—a place to work with, incentivize, and track the contributions of a network of collaborators. It combines task management with “payments” and tracking."
* [http://aragon.one/ Aragon]
* [https://github.com/ether-camp/virtual-accelerator/ ether-camp/virtual accelerator] -- "The Virtual Accelerator is a platform that allows for the promotion, testing and funding of ideas. " HackerGold is their token.
* [http://boardroom.to/ boardroom.to] -- A blockchain based governance platform.
* [https://lunyr.com/ Lunyr] -- "Lunyr is an Ethereum-based decentralized crowdsourced encyclopedia which rewards users with app tokens for peer-reviewing and contributing information."
* [https://singulardtv.com/ Singulardtv] -- "A Blockchain Entertainment Studio, Smart Contract Rights Management Platform and Video On-Demand Portal"
* [https://daostack.io/ DAOstack] -- "DAOstack is an open source project advancing the technology and adoption of decentralized governance."

see also:

* [https://tokenmarket.net/ TokenMarket] -- "Trade and research 152 digital assets. Organize crowdsales."
* [https://medium.com/@ConsenSys/tokens-on-ethereum-e9e61dac9b4e#.hfxscd8yx Tokens on Ethereum] about Ethereum based tokens by ConsenSys
* [https://medium.com/@balajis/thoughts-on-tokens-436109aabcbe Thoughts on Tokens] by Balaji S. Srinivasan and Naval Ravikant
* [https://www.misthos.io/ Misthos] (multi-sig bitcoin wallet, "designed for project teams, investment partnerships and other ad hoc ventures to manage the divvying up of income (received as bitcoin) among their individual members", based on Blockstack, [https://www.coindesk.com/bitcoin-wallet-blockstack-decentralized/ Coindesk article])
* https://sourcecred.io
* [https://freecoin.dyne.org/ Freecoin]

== Similar code/inspirations/links ==

* [https://github.com/Lunyr/crowdsale-contracts/tree/master/contracts Lynyr contracts]
* [https://github.com/Giveth/minime minime contracts]
* [https://github.com/ConsenSys/gnosis-contracts/blob/master/contracts/solidity/Tokens/StandardToken.sol gnosis-contracts]
* [https://github.com/melonproject/melon/ melonproject contracts]
* Paper: [https://papers.ssrn.com/sol3/papers.cfm?abstract_id=3243656 "Liberal Radicalism: Formal Rules for a Society Neutral Among Communities"]

== Notes ==

* [https://sideshift.ai/ Sideshift] is similar to Shapeshift, but without KYC and such. Could be used to donate to the Kredits contract using Bitcoin via LN, as well as via normal chain txs with a variety of currencies.

Kredits

2020-01-15T04:39:44Z

Jonomist: /* Similar projects/ideas */

Kredits are a system for tracking contributions to Kosmos projects, enabling the fair and transparent use of project funds, as well as improving project management and governance.

For now, kredits are mostly a fun experiment and gaming element, but the long-term idea is that they can be rewarded with dividends, if or when the Kosmos project/org is in a financial position that allows it to reward everybody contributing to its success.

== Current status ==

After a few years of experimentation, we finally started issuing kredits in production earlier this year (2019). We also have a functioning, usable Web UI up and running, which interacts directly with Ethereum and IPFS nodes, and which you can also use to create your contributor account: https://kredits.kosmos.org

== Concept & Architecture ==

=== Smart contracts ===

Kredits are cryptographic tokens, (currently) stored on the [https://ethereum.org/ Ethereum] blockchain, issued and managed via programs called [https://en.wikipedia.org/wiki/Smart_contract smart contracts].

We use two types of tokens:

# A non-fungible [https://eips.ethereum.org/EIPS/eip-721 ERC721] token, which represents the actual contributions. These are unique, and they cannot be sent or traded with other people. They are earned by contributing to Kosmos projects, and either one of our bots or one of our contributors propose to create them for a contribution.
# A fungible [https://eips.ethereum.org/EIPS/eip-20 ERC20] token, which represents the value of contributions. These are not unique, meaning every token represents the same value. They can be sent to other addresses using any ERC20-compatible wallet.

Every contribution token/record contains the amount of ERC20 kredits that can be claimed by the contributor. "Claiming" those tokens basically means paying them out from the Kredits smart contract to your own wallet. This is optional, and the contributor can choose to do this whenever they want.

=== Data storage ===

All non-essential data (basically everything except for pure IDs and numbers/amounts) is stored on [https://ipfs.io/ IPFS]. In order to ensure that no data is lost, and all data is available to Kredits users at all times, we run a few Kosmos IPFS nodes, as well as a public IPFS gateway. See [[Kredits:IPFS]] for more information.

=== High-level overview ===

[[File:High-level-architecture.png|960px|link=https://wiki.kosmos.org/images/c/c1/High-level-architecture.svg|frameless|caption]]

== Software ==

=== Kredits Contracts ===

[https://github.com/67P/kredits-contracts/ kredits-contracts] contains the smart contracts, written in Solidity, as well as the generated contract ABI for use with the Web3 JavaScript library (e.g. in kredits-web). It can be linked from other programs via npm.

=== Kosmos Schemas ===

[https://github.com/67P/kosmos-schemas/ kosmos-schemas] contains the JSON Schema definitions and examples for all data stored in IPFS. They can be used in the kredits-contracts JS wrapper as well as in client apps.

=== Kredits Web ===

[https://github.com/67P/kredits-web/ kredits-web] is the Web UI for the public Kredits dashboard and management UI. The app is hosted on 5apps Deploy at [https://kredits.kosmos.org/ kredits.kosmos.org].

=== Hubot Kredits ===

[https://github.com/67P/hubot-kredits hubot-kredits] is a Hubot chatbot extension, which can automatically create (unconfirmed) contribution tokens, e.g. based on GitHub contributions, Mediawiki edits, etc.. We also use it to prototype back-end behavior that is potentially needed in `kredits-web`.

=== Kredits GitHub ===

[https://github.com/67P/kredits-github kredits-github] is a very simple GitHub app, which adds a check to pull requests in org repos, ensuring that they are assigned a kredits label, which is used by hubot-kredits to determine the size of the contribution.

=== Kredits IPFS Pinner ===

[https://gitea.kosmos.org/kosmos/kredits-ipfs-pinner kredits-ipfs-pinner] pins IPFS data of a Kredits organization on an IPFS node. Running this program turns any IPFS node into a live mirror for all Kredits-related documents.

== Democratic governance via Kredits ==

Kredits have the potential to be used for distributed governance of the Kosmos project and organization. The basic idea is that people can vote on decisions with a vote that carries a weight according to their contributions. In short: the people who do should be the ones who decide. With a limited set of basic rules, this makes for an interesting new and decentralized approach to open-source governance.

== Roadmap ==

See https://wiki.kosmos.org/Meeting_Notes:_Feb_25,_2019#Kredits_Roadmap_2019

== Ideas ==

* <del>Leaderboard for contributions/kredits, where people can choose to publish their name or not (based on actual blockchain data)</del> WIP, almost done: https://kredits.kosmos.org/
* Some way for new contributors to claim kredits sent to them via email link or similar (Update: current idea is to issue them without the need for an address, then be able to confirm address change via GitHub OAuth and admin action/proposal)
* <del>IRC bot for small transactions, so people can send each other kredits on Kosmos project channels</del> Turned out to not make sense.
* <del>Custom wallet, removing all unnecessary features and integrating custom features we'd like to have (like e.g. easy multisig transactions, linked/initiated from a Kosmos chatroom)</del> WIP, almost done: https://github.com/67P/kredits-web/ (tokens can be sent via normal ETH wallets)
* [[Contribution Dashboard]] for regular Kredit distribution as well as general project stats
* Expense management, similar to https://opencollective.com/learn-more
* Interoperability with other coops/projects/software
** https://docs.opencoopecosystem.net/
** https://www.valueflo.ws/

== Similar projects/ideas ==

* [https://medium.com/@ecsa_team/programmed-decentralised-commons-production-2b1fac7cf9a8 cDPOs (commons-oriented decentralised programmed organisations)] as frameworks to bootstrap, develop & sustain commons projects
* [https://blog.colony.io/colony-beta-product-summary-2121a357d61d?mc_cid=b1750a36c8&mc_eid=fb43075dba#.9egmfejax Colony] -- "The Colony Beta is for teams who want to create their own “Collaboration Network”—a place to work with, incentivize, and track the contributions of a network of collaborators. It combines task management with “payments” and tracking."
* [http://aragon.one/ Aragon]
* [https://github.com/ether-camp/virtual-accelerator/ ether-camp/virtual accelerator] -- "The Virtual Accelerator is a platform that allows for the promotion, testing and funding of ideas. " HackerGold is their token.
* [http://boardroom.to/ boardroom.to] -- A blockchain based governance platform.
* [https://lunyr.com/ Lunyr] -- "Lunyr is an Ethereum-based decentralized crowdsourced encyclopedia which rewards users with app tokens for peer-reviewing and contributing information."
* [https://singulardtv.com/ Singulardtv] -- "A Blockchain Entertainment Studio, Smart Contract Rights Management Platform and Video On-Demand Portal"
* [https://daostack.io/ DAOstack] -- "DAOstack is an open source project advancing the technology and adoption of decentralized governance."

see also:

* [https://tokenmarket.net/ TokenMarket] -- "Trade and research 152 digital assets. Organize crowdsales."
* [https://medium.com/@ConsenSys/tokens-on-ethereum-e9e61dac9b4e#.hfxscd8yx Tokens on Ethereum] about Ethereum based tokens by ConsenSys
* [https://medium.com/@balajis/thoughts-on-tokens-436109aabcbe Thoughts on Tokens] by Balaji S. Srinivasan and Naval Ravikant
* [https://www.misthos.io/ Misthos] (multi-sig bitcoin wallet, "designed for project teams, investment partnerships and other ad hoc ventures to manage the divvying up of income (received as bitcoin) among their individual members", based on Blockstack, [https://www.coindesk.com/bitcoin-wallet-blockstack-decentralized/ Coindesk article])
* https://sourcecred.io
* [https://freecoin.dyne.org/ Freecoin]

== Similar code/inspirations/links ==

* [https://github.com/Lunyr/crowdsale-contracts/tree/master/contracts Lynyr contracts]
* [https://github.com/Giveth/minime minime contracts]
* [https://github.com/ConsenSys/gnosis-contracts/blob/master/contracts/solidity/Tokens/StandardToken.sol gnosis-contracts]
* [https://github.com/melonproject/melon/ melonproject contracts]
* Paper: [https://papers.ssrn.com/sol3/papers.cfm?abstract_id=3243656 "Liberal Radicalism: Formal Rules for a Society Neutral Among Communities"]

== Notes ==

* [https://sideshift.ai/ Sideshift] is similar to Shapeshift, but without KYC and such. Could be used to donate to the Kredits contract using Bitcoin via LN, as well as via normal chain txs with a variety of currencies.

Events/DOTS 2019

2019-12-15T07:09:45Z

Jonomist:

lio17, raucao and jonomist had a phone call on Nov 6, 2019, about a potential collaboration between i4Policy and Kosmos. The idea is that Kredits could be used for the development of the open source civic tech, such as the document consultation tool, iConsult, and maybe i4Policy software could also be used for Kosmos governance in the future.

There is going to be a multi-day workshop at the DOTS event in Nakuru (Kenya) in December. Jonomist summarized the event as follows:

<blockquote>
== Overview of DOTS:==

When: 5-7 December

Where: Nakuru, at Lanet Matfam Resort.

Who: GIG and r0g jointly organize DOTS, with more partners joining in!

What: 5 tracks on Dec 5 and 6 with lots of space and time to exchange in between the sessions. Public event on Dec 7.

== Kredits/i4Policy Shared Goals for DOTS:==

* Reciprocal code review and feedback
* UX brainstorming with DOTS participants
* Draft medium-term development plan (Q2 2020 - Q4 2021) for the i4Policy consultation tool (iConsult) and Kredits
* Integration of the development plans for a joint project to pilot Kredits for distributed co-creation of iConsult
* Outlining a joint project proposal: specification of goals, shared expectations, timelines and milestones, budget items/rates, and providing an initial overview of the dividend allocations based on the integrated development plans for i4Policy and Kredits.

== Agenda: ==

In attendance: lio17, raucao, jonomist, and kaleab

Dec 4
* Team and project introductions (walkthrough of each other's visions, tech and current thinking)

Dec 5
* Reciprocal code review and feedback
* Setting the shared vision for collaboration and the agenda
* Shared brainstorming of initial medium-term development plans

Dec 6
* Review draft medium-term development plans
* Establish an integrated development plan
* Joint project planning

Dec 7
* UX workshop with other DOTS participants
* Presentation of i4Policy to public in Nakuru

</blockquote>