2019-05-09 20:54:24 +03:00
[![Build Status ](https://dev.azure.com/mimblewimble/grin/_apis/build/status/mimblewimble.grin?branchName=master )](https://dev.azure.com/mimblewimble/grin/_build/latest?definitionId=1& branchName=master)
2019-03-26 15:47:57 +03:00
[![Coverage Status ](https://img.shields.io/codecov/c/github/mimblewimble/grin/master.svg )](https://codecov.io/gh/mimblewimble/grin)
[![Chat ](https://img.shields.io/gitter/room/grin_community/Lobby.svg )](https://gitter.im/grin_community/Lobby)
[![Support ](https://img.shields.io/badge/support-on%20gitter-brightgreen.svg )](https://gitter.im/grin_community/support)
[![Documentation Wiki ](https://img.shields.io/badge/doc-wiki-blue.svg )](https://github.com/mimblewimble/docs/wiki)
[![Release Version ](https://img.shields.io/github/release/mimblewimble/grin.svg )](https://github.com/mimblewimble/grin/releases)
[![License ](https://img.shields.io/github/license/mimblewimble/grin.svg )](https://github.com/mimblewimble/grin/blob/master/LICENSE)
2016-12-16 03:46:16 +03:00
2016-10-21 03:06:12 +03:00
# Grin
2019-11-19 13:49:32 +03:00
Grin is an in-progress implementation of the Mimblewimble protocol. Many characteristics are still undefined but the following constitutes a first set of choices:
2016-10-21 03:06:12 +03:00
2019-01-28 13:58:51 +03:00
* Clean and minimal implementation, and aiming to stay as such.
2019-11-26 23:17:16 +03:00
* Follows the Mimblewimble protocol, which provides hidden amounts and scaling advantages.
2019-01-28 13:58:51 +03:00
* Cuckoo Cycle proof of work in two variants named Cuckaroo (ASIC-resistant) and Cuckatoo (ASIC-targeted).
* Relatively fast block time: one minute.
2018-03-26 01:35:06 +03:00
* Fixed block reward over time with a decreasing dilution.
2018-03-05 22:33:44 +03:00
* Transaction fees are based on the number of Outputs created/destroyed and total transaction size.
2016-10-21 03:06:12 +03:00
* Smooth curve for difficulty adjustments.
2019-11-19 13:49:32 +03:00
To learn more, read our [introduction to Mimblewimble and Grin ](doc/intro.md ).
2017-03-21 21:18:09 +03:00
2016-10-21 03:06:12 +03:00
## Status
2019-01-28 13:58:51 +03:00
Grin is live with mainnet. Still, much is left to be done and [contributions ](CONTRIBUTING.md ) are welcome (see below). Check our [mailing list archives ](https://lists.launchpad.net/mimblewimble/ ) for the latest status.
2016-10-21 03:06:12 +03:00
## Contributing
2017-09-01 03:54:15 +03:00
To get involved, read our [contributing docs ](CONTRIBUTING.md ).
2016-10-21 03:06:12 +03:00
2016-11-09 22:17:58 +03:00
Find us:
2017-03-24 03:04:00 +03:00
* Chat: [Gitter ](https://gitter.im/grin_community/Lobby ).
2019-11-19 13:49:32 +03:00
* Mailing list: join the [~Mimblewimble team ](https://launchpad.net/~mimblewimble ) and subscribe on Launchpad.
2018-10-09 21:39:34 +03:00
* Twitter for the Grin council: [@grincouncil ](https://twitter.com/grincouncil )
2016-11-09 22:17:58 +03:00
2017-05-03 23:56:03 +03:00
## Getting Started
2017-05-04 00:23:12 +03:00
To learn more about the technology, read our [introduction ](doc/intro.md ).
2017-05-03 23:56:03 +03:00
2017-05-04 00:23:12 +03:00
To build and try out Grin, see the [build docs ](doc/build.md ).
2016-10-21 03:06:12 +03:00
## Philosophy
2018-06-13 19:03:34 +03:00
Grin likes itself small and easy on the eyes. It wants to be inclusive and welcoming for all walks of life, without judgement. Grin is terribly ambitious, but not at the detriment of others, rather to further us all. It may have strong opinions to stay in line with its objectives, which doesn't mean disrespect of others' ideas.
2016-10-21 03:06:12 +03:00
We believe in pull requests, data and scientific research. We do not believe in unfounded beliefs.
## Credits
2019-11-19 13:49:32 +03:00
Tom Elvis Jedusor for the first formulation of Mimblewimble.
2016-10-22 01:02:20 +03:00
2016-10-21 03:06:12 +03:00
Andrew Poelstra for his related work and improvements.
2016-10-22 01:02:20 +03:00
John Tromp for the Cuckoo Cycle proof of work.
2016-10-21 03:06:12 +03:00
J.K. Rowling for making it despite extraordinary adversity.
## License
Apache License v2.0.