Minimal implementation of the Mimblewimble protocol.
Find a file
hashmap 1f5de6beb9
Verify headers and blocks only when needed (#3023)
* Verify headers and blocks only when needed

Curretnly we have some lightweigt validation implemented as part of
entity deserialization, which is safer and allows us to not parse the
entire object if some part is invalid. At the same time this logic
always applies when we read an entity, eg when reading from DB.

This PR introduces UntrustedHeader/Block which is used when we read from
the network. It does partial validation during read, then it is supposed
to be converted into regular header/block which doesn't validate itself.

Also this PR adds "lightweight" validation to block header read like we have
for block body, so we don't parse block body if the header is invalid.

Fixes #1642

* Move version validation to untrusted header

* update fuzz tests
2019-10-27 08:40:52 +01:00
.cargo windows cargo settings (#2632) 2019-02-26 16:48:45 +00:00
.ci [2.x.x] CI Improvements (#2963) 2019-07-23 16:25:25 +02:00
.github Update contributing guidelines (#2563) 2019-02-19 14:29:58 +00:00
.hooks chore: pre-commit hook - format all staged files, re-add then commit (#3078) 2019-10-07 21:00:41 +01:00
api More robust peer banning (#3086) 2019-10-04 18:00:49 -04:00
chain Verify headers and blocks only when needed (#3023) 2019-10-27 08:40:52 +01:00
config update versioning to 3.0.0 alpha (#3080) 2019-10-04 10:51:55 +01:00
core Verify headers and blocks only when needed (#3023) 2019-10-27 08:40:52 +01:00
doc mmr simplified Chinese translation (#3095) 2019-10-17 09:17:32 -04:00
etc Change 2018 to 2019 in copyright files (#3072) 2019-10-02 09:40:20 +01:00
keychain Remove usage of try! macro, use ? instead (#3097) 2019-10-21 15:01:18 -04:00
p2p Verify headers and blocks only when needed (#3023) 2019-10-27 08:40:52 +01:00
pool Update Serde annotations in pool crate (#3081) 2019-10-04 11:44:46 +01:00
servers skip hydrate if missing kernels, just request full block (#3090) 2019-10-10 16:46:00 +01:00
src Change 2018 to 2019 in copyright files (#3072) 2019-10-02 09:40:20 +01:00
store use remove_range_closed for clarity (#3088) 2019-10-07 21:01:44 +01:00
util update versioning to 3.0.0 alpha (#3080) 2019-10-04 10:51:55 +01:00
.editorconfig [1.1.0] Merge master into 1.1.0 (#2720) 2019-04-01 11:47:48 +01:00
.gitignore Optimizing the code and making it more idiomatic (#2269) 2019-01-01 15:29:16 -08:00
azure-pipelines.yml [2.x.x] CI Improvements (#2963) 2019-07-23 16:25:25 +02:00
Cargo.lock track opts when requesting blocks (not just if we requested them) (#3089) 2019-10-10 09:38:25 +01:00
Cargo.toml update versioning to 3.0.0 alpha (#3080) 2019-10-04 10:51:55 +01:00
CODE_OF_CONDUCT.md Many typo fixes (#1158) 2018-06-13 17:03:34 +01:00
CONTRIBUTING.md mimblewinble -> mimblewimble (#2803) 2019-05-03 13:48:25 +01:00
LICENSE Create LICENSE 2017-06-29 09:24:44 -07:00
README.md Add Azure-pipeline badge (#2818) 2019-05-09 10:54:24 -07:00
rustfmt.toml cannot use unstable rustfmt features outside nightly toolchain (#1338) 2018-08-10 14:54:09 +01:00
SECURITY.md Implement security-process RFC (#3009) 2019-10-08 18:26:24 +03: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 great anonymity and scaling characteristics.
  • 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.

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

License

Apache License v2.0.