From Kosmos Wiki
Jump to navigation Jump to search

Kredits are an experimental bonus system for contributors. They are cryptographic tokens, stored on the Ethereum blockchain, issued and managed via smart contracts.

Anyone can create an Ethereum wallet via e.g. and start receiving kredits for contributions of any kind. People can also send their own kredits to each other if and when they like.

For now kredits are just a fun experiment and gaming element, but the long-term idea is that they can be rewarded with dividends, in case the Kosmos project/org will be in a financial position that allows it to reward everybody contributing to its success. There's also a variety of other possible use cases, like e.g. a public offering via kredit sales. (see Crypto Equity)




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

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

kredits-web is the Web UI for the public Kredits dashboard and management UI. The app is hosted on 5apps Deploy at

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 protoype back-end behavior that is potentially needed in `kredits-web`.

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

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 decide. With a limited set of basic rules, this makes for a revolutionary new approach to decentralized open-source governance.

Rules / parameters

TODO update this section with current information


  • Leaderboard for contributions/kredits, where people can choose to publish their name or not (based on actual blockchain data) WIP, almost done:
  • 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)
  • IRC bot for small transactions, so people can send each other kredits on Kosmos project channels Turned out to not make sense.
  • Custom wallet, removing all unncesseary features and integrating custom features we'd like to have (like e.g. easy multisig transactions, linked/initiated from a Kosmos chatroom) WIP, almost done: (tokens can be sent via normal ETH wallets)
  • Contribution Dashboard for regular Kredit distribution as well as general project stats
  • Expense management, similar to
  • Interoperability with other coops/projects/software

Similar projects/ideas

  • cDPOs (commons-oriented decentralised programmed organisations) as frameworks to bootstrap, develop & sustain commons projects
  • 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."
  • Aragon
  • ether-camp/virtual asselerator -- "The Virtual Accelerator is a platform that allows for the promotion, testing and funding of ideas. " HackerGold is their token.
  • -- A blockchain based governance platform.
  • Lunyr -- "Lunyr is an Ethereum-based decentralized crowdsourced encyclopedia which rewards users with app tokens for peer-reviewing and contributing information."
  • Singulardtv -- "A Blockchain Entertainment Studio, Smart Contract Rights Management Platform and Video On-Demand Portal"

see also:

Similar code/inspirations/links


  • 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.