Minimal implementation of the Mimblewimble protocol.
Find a file
jaspervdm 8faba4ef83
PMMR segment creation and validation (#3453)
* Chunk generation and validation

* Rename chunk -> segment

* Missed a few

* Generate and validate merkle proof

* Fix bugs in generation and validation

* Add test for unprunable MMR of various sizes

* Add missing docs

* Remove unused functions

* Remove segment error variant on chain error type

* Simplify calculation by using a Vec instead of HashMap

* Use vectors in segment definition

* Compare subtree root during tests

* Add test of segments for a prunable mmr

* Remove assertion

* Only send intermediary hashes for prunable MMRs

* Get hash from file directly

* Require both leaves if one of them is not pruned

* More pruning tests

* Add segment (de)serialization

* Require sorted vectors in segment deser

* Store pos and data separately in segment

* Rename log_size -> height

* Fix bitmap index in root calculation

* Add validation function for output (bitmap) MMRs

* Remove left over debug statements

* Fix test

* Edge case: final segment with uneven number of leaves

* Use last_pos instead of segment_last_pos

* Simplify pruning in test

* Add leaf and hash iterators

* Support fully pruned segments

* Drop backend before deleting dir in pruned_segment test

* Simplify output of first_unpruned_parent
2020-11-17 19:38:44 +01:00
.cargo windows cargo settings (#2632) 2019-02-26 16:48:45 +00:00
.ci CI: no directories in checksum file (#3460) 2020-10-02 13:14:02 -04:00
.github Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
.hooks chore: pre-commit hook - format all staged files, re-add then commit (#3078) 2019-10-07 21:00:41 +01:00
api Disable merkle proofs for v2 get_block (#3487) 2020-11-09 14:56:01 -05:00
chain Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
config Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
core PMMR segment creation and validation (#3453) 2020-11-17 19:38:44 +01:00
doc Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
etc Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
keychain Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
p2p Flexible peer filtering (#3458) 2020-10-27 12:36:00 +00:00
pool bump working version on master to 4.2.0-alpha.1 (#3443) 2020-09-15 17:26:44 +01:00
servers on_block_accepted logging and webhooks all the time (#3486) 2020-11-09 12:11:27 -05:00
src Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
store PMMR segment creation and validation (#3453) 2020-11-17 19:38:44 +01:00
util bump working version on master to 4.2.0-alpha.1 (#3443) 2020-09-15 17:26:44 +01:00
.editorconfig [1.1.0] Merge master into 1.1.0 (#2720) 2019-04-01 11:47:48 +01:00
.gitignore ignore .vscode (#3333) 2020-05-24 23:34:33 +02:00
azure-pipelines.yml Use latest hosted agent for CI (#3278) 2020-04-14 09:25:10 -04:00
Cargo.lock Refactor p2p reader (#3433) 2020-09-28 14:43:37 +01:00
Cargo.toml bump working version on master to 4.2.0-alpha.1 (#3443) 2020-09-15 17:26:44 +01:00
CODE_OF_CONDUCT.md Update Code of Conduct (#3447) 2020-09-22 17:15:37 +01:00
CONTRIBUTING.md Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
LICENSE Create LICENSE 2017-06-29 09:24:44 -07:00
README.md credit where credit is due (#3356) 2020-06-16 18:41:09 +01:00
rustfmt.toml Update hyper/tokio/futures dependencies (#3214) 2020-02-18 23:45:27 +01:00
SECURITY.md fix: correct typo in SECURITY.md (#3462) 2020-10-08 09:46:48 -04:00

Build Status Coverage Status Chat Support Documentation Wiki Release Version License

Grin

Grin is an in-progress implementation of the Mimblewimble protocol. Many characteristics are still undefined but the following constitutes a first set of choices:

  • Clean and minimal implementation, and aiming to stay as such.
  • Follows the Mimblewimble protocol, which provides hidden amounts and scaling advantages.
  • Cuckoo Cycle proof of work in two variants named Cuckaroo (ASIC-resistant) and Cuckatoo (ASIC-targeted).
  • Relatively fast block time: one minute.
  • Fixed block reward over time with a decreasing dilution.
  • Transaction fees are based on the number of Outputs created/destroyed and total transaction size.
  • Smooth curve for difficulty adjustments.

To learn more, read our introduction to Mimblewimble and Grin.

Status

Grin is live with mainnet. Still, much is left to be done and contributions are welcome (see below). Check our mailing list archives for the latest status.

Contributing

To get involved, read our contributing docs.

Find us:

Getting Started

To learn more about the technology, read our introduction.

To build and try out Grin, see the build docs.

Philosophy

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.

We believe in pull requests, data and scientific research. We do not believe in unfounded beliefs.

Credits

Tom Elvis Jedusor for the first formulation of Mimblewimble.

Andrew Poelstra for his related work and improvements.

John Tromp for the Cuckoo Cycle proof of work.

License

Apache License v2.0.