Minimal implementation of the Mimblewimble protocol.
Find a file
Ignotus Peverell 22c521eec8
[WIP] Abridged sync (#440)
* Util to zip and unzip directories
* First pass at sumtree request/response. Add message types, implement the exchange in the protocol, zip up the sumtree directory and stream the file over, with necessary adapter hooks.
* Implement the sumtree archive receive logicGets the sumtree archive data stream from the network and write it to a file. Unzip the file, place it at the right spot and reconstruct the sumtree data structure, rewinding where to the right spot.
* Sumtree hash structure validation
* Simplify sumtree backend buffering logic. The backend for a sumtree has to implement some in-memory buffering logic to provide a commit/rollback interface. The backend itself is an aggregate of 3 underlying storages (an append only file, a remove log and a skip list). The buffering was previously implemented both by the backend and some of the underlying storages. Now pushing back all buffering logic to the storages to keep the backend simpler.
* Add kernel append only store file to sumtrees. The chain sumtrees structure now also saves all kernels to a dedicated file. As that storage is implemented by the append only file wrapper, it's also rewind-aware.
* Full state validation. Checks that:
    - MMRs are sane (hash and sum each node)
    - Tree roots match the corresponding header
    - Kernel signatures are valid
    - Sum of all kernel excesses equals the sum of UTXO commitments
minus the supply
* Fast sync handoff to body sync. Once the fast-sync state is fully setup, get bacj in body sync
mode to get the full bodies of the last blocks we're missing.
* First fully working fast sync
* Facility in p2p conn to deal with attachments (raw binary after message).
* Re-introduced sumtree send and receive message handling using the above.
* Fixed test and finished updating all required db state after sumtree validation.
* Massaged a little bit the pipeline orphan check to still work after the new sumtrees have been setup.
* Various cleanup. Consolidated fast sync and full sync into a single function as they're very similar. Proper conditions to trigger a sumtree request and some checks on receiving it.
2018-02-09 22:32:16 +00:00
.hooks fix the bash array loop 2017-12-20 15:37:23 -05:00
api Remove unused import and uniformize crates (#686) 2018-02-05 19:46:56 +00:00
chain [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
config [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
core [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
doc rustfmt install instruction gotcha (#663) 2018-01-30 08:36:18 -05:00
grin [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
keychain Allow multiple Aggsig contexts (#685) 2018-02-06 11:42:26 +00:00
p2p [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
pool [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
pow attempt to make CUDA gcc detection a bit more robust and handle more cases 2018-02-09 11:18:14 +00:00
src/bin List connected peers (#680) 2018-02-03 00:37:35 +00:00
store [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
util [WIP] Abridged sync (#440) 2018-02-09 22:32:16 +00:00
wallet Sender pays the fee. Fix #274 (#694) 2018-02-09 05:33:24 +00:00
.gitignore Markdown fixes + gitignore addition (#334) 2017-11-20 14:33:35 +00:00
.travis.yml Adding kcov code coverage to chain and core modules (#547) 2018-01-06 20:54:46 +00:00
Cargo.toml List connected peers (#680) 2018-02-03 00:37:35 +00:00
CODE_OF_CONDUCT.md fix grammar issue (go the extra step --> go the extra mile) (#688) 2018-02-07 10:00:42 +00:00
CONTRIBUTING.md updating contribution guidelines with info on how to submit documentation changes 2017-11-07 21:45:52 +00:00
grin.toml update cuda mining defaults and trompcode 2018-02-07 21:00:58 +00:00
LICENSE Create LICENSE 2017-06-29 09:24:44 -07:00
README.md Add kcov support (#545) 2017-12-27 02:09:10 +00:00
rustfmt.toml Start of a binary file for the grin node 2017-04-24 18:55:01 -07:00

Build Status Gitter chat Codecov coverage status

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, aiming to stay as such.
  • Follows the MimbleWimble protocol, which provides great anonymity and scaling characteristics.
  • Cuckoo Cycle proof of work (at least to start with).
  • Relatively fast block time (a minute or less, possibly decreasing as networks improve).
  • Fixed block reward, both over time and in blocks (fees are not additive).
  • Transaction fees are based on the number of UTXO created/destroyed and total transaction size.
  • Smooth curve for difficulty adjustments.

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

Status

Grin is still an infant, 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 disrepect 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.

J.K. Rowling for making it despite extraordinary adversity.

License

Apache License v2.0.