Minimal implementation of the Mimblewimble protocol.
Find a file
Yeastplume 12480e7310 Changes to allow for testing and playing with cuckoo-miner integration (#76)
* Refactoring to allow for different miner implementations. Added conditional support for compiling and loading the cuckoo-miner plugin project.
* Small changes to experimentally integrate with cuckoo-miner and compatibility with latest version of cuckoo-miner.
* Turning off inclusion of cuckoo_miner by default
* Disabling simulate_parallel_mining test for now
2017-07-11 17:11:03 +00:00
api New Chain struct acting as facade for all chain operations 2017-07-04 09:17:11 -07:00
chain New Chain struct acting as facade for all chain operations 2017-07-04 09:17:11 -07:00
core Changes to allow for testing and playing with cuckoo-miner integration (#76) 2017-07-11 17:11:03 +00:00
doc POW Doc updates (#73) 2017-07-03 17:39:20 +02:00
grin Changes to allow for testing and playing with cuckoo-miner integration (#76) 2017-07-11 17:11:03 +00:00
p2p Use io::Read/Write interface instead of AsyncRead/AsyncWrite + Finish Tests (#74) 2017-07-05 18:42:55 +00:00
pool Protect wallet data file with a file lock 2017-06-14 21:42:58 -07:00
secp256k1zkp Revert "Delegate Block Encoding to Store (#44)" 2017-05-31 15:49:15 -07:00
src/bin New Chain struct acting as facade for all chain operations 2017-07-04 09:17:11 -07:00
store Wallet HTTP posting, fixes and additions to port address configurability. (#66) 2017-06-27 04:09:01 +02:00
util New Chain struct acting as facade for all chain operations 2017-07-04 09:17:11 -07:00
wallet Wallet HTTP posting, fixes and additions to port address configurability. (#66) 2017-06-27 04:09:01 +02:00
.gitignore ignore ItelliJ IDEA project files 2016-10-31 12:54:22 +01:00
.travis.yml Reintroducing Rust beta channel testing. 2017-02-18 19:05:18 -08:00
Cargo.toml Changes to allow for testing and playing with cuckoo-miner integration (#76) 2017-07-11 17:11:03 +00:00
LICENSE Create LICENSE 2017-06-29 09:24:44 -07:00
README.md Minor clarifications and additional getting started link 2017-05-03 14:23:12 -07:00
rustfmt.toml Start of a binary file for the grin node 2017-04-24 18:55:01 -07:00

Build Status Gitter chat

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

Find an area you can help with and do it. Open source is about collaboration and open participation. Try to make your code look like what already exists and submit a pull request. If you're looking for additional ideas, the code includes TODO comments for minor to major improvements. Grep is your friend.

Additional tests are rewarded with an immense amount of positive karma. So is documentation.

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.