Minimal implementation of the Mimblewimble protocol.
Find a file
AntiochP d3e5acccf9
initial docs and images to describe receiving a block and simple sync. (#405)
* intial docs and images to describe receiving a block and simple sync.

* add some more description text

* svg -> png

* updated simple_sync diagram to include sync_head

* rename "block head" -> "body head"

* wip - sync_on_form diagram (kill me now)

* tidy up diagram for "sync on fork"

* consolidate the chain docs
2017-12-04 15:35:18 -05:00
.hooks add lock_height to Transaction and TxKernel (#167) 2017-10-11 18:12:01 +00:00
api port across "simple_sync" changes from testnet1 branch (#409) 2017-11-30 10:27:50 -05:00
chain sync_head port from testnet1 (#425) 2017-12-04 19:16:57 +00:00
config Fix for issue #318 (#323) 2017-11-19 01:55:26 -05:00
core [CONSENSUS] Limit number of inputs in a block #261 (#328) 2017-11-19 19:59:07 -05:00
doc initial docs and images to describe receiving a block and simple sync. (#405) 2017-12-04 15:35:18 -05:00
grin sync_head port from testnet1 (#425) 2017-12-04 19:16:57 +00:00
keychain Wallet Restore feature (#338) 2017-11-20 00:50:09 +00:00
p2p port across "simple_sync" changes from testnet1 branch (#409) 2017-11-30 10:27:50 -05:00
pool Genesis block for known chains, mine dev chains (#269) 2017-11-15 16:49:15 -05:00
pow miner timing resolution (#351) 2017-11-20 22:57:36 +00:00
src/bin rollback the change output in the wallet on tx failure (#345) 2017-11-20 14:12:52 -05:00
store Fix rm log not getting written to disk 2017-11-25 23:26:36 -05:00
util Log "nn.nnn coins spent using strategy ..." on log level Debug (#326) 2017-11-19 13:34:43 -05:00
wallet rollback the change output in the wallet on tx failure (#345) 2017-11-20 14:12:52 -05:00
.gitignore Markdown fixes + gitignore addition (#334) 2017-11-20 14:33:35 +00:00
.travis.yml keychain crate (no more secretkeys in core) (#146) 2017-10-03 00:02:31 +00:00
Cargo.toml tweaks to logging configuration (#176) 2017-10-13 16:42:04 +00:00
CODE_OF_CONDUCT.md Update moderation team email 2017-09-29 20:50:49 +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 Grammar and typo fix (#415) 2017-12-04 12:51:46 -05:00
LICENSE Create LICENSE 2017-06-29 09:24:44 -07:00
README.md Fixing repository links after move 2017-10-23 17:20:32 +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

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.