Minimal implementation of the Mimblewimble protocol.
Find a file
thaddeus 529ce44219
Override global one times. (#3737)
* Minor update for foreign api docs. Peers seems to be no longer needed as an arg in the grin_api::Foreign::new.

* This changes foreign_rpc and owner_rpc modules to public so the helper modules for the rpc clients can be accessible in external projects.

* Updated test seeds.

* Added functions that override the one time globals. This is needed for the grin-gui so it can change the global contexts when it needs to switch from testnet to mainnet.

* Refactor

* Fix panick at 'attempt to subtract with overflow' when grin-wallet sends in a start_index of 0 for new wallets.

* Fix overflow panic using saturating_sub(1).
2022-10-07 10:37:32 +01:00
.cargo windows cargo settings (#2632) 2019-02-26 16:48:45 +00:00
.ci Change connection name for CI Release (#3653) 2021-08-18 15:45:52 +02:00
.github Rename Floonet to Testnet (#3431) 2020-10-07 09:36:02 -04:00
.hooks Update copyright year to 2021 (#3592) 2021-03-10 10:14:48 -05:00
api The foreign_rpc and owner_rpc auto generated helper modules should be made public. (#3734) 2022-09-07 15:51:36 +01:00
chain Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
config bump to 5.2.0-alpha.1 on master (#3652) 2021-08-19 09:06:52 +02:00
core Override global one times. (#3737) 2022-10-07 10:37:32 +01:00
doc Spelling Improvements (#3642) 2021-05-13 14:07:14 -04:00
etc Update copyright year to 2021 (#3592) 2021-03-10 10:14:48 -05:00
keychain make fn rewind_hash pub (#3674) 2021-12-13 12:18:37 +00:00
p2p Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
pool Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
servers Override global one times. (#3737) 2022-10-07 10:37:32 +01:00
src verify-chain node client arg (#3678) 2022-01-07 13:45:48 +00:00
store Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
util Override global one times. (#3737) 2022-10-07 10:37:32 +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 Fix CI for macOS (#3726) 2022-07-01 12:16:15 +01:00
Cargo.lock Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
Cargo.toml Thiserror changeover (#3728) 2022-07-14 11:08:13 +01:00
CODE_OF_CONDUCT.md Update Code of Conduct (#3447) 2020-09-22 17:15:37 +01:00
CONTRIBUTING.md Updated contributing.md links. (#3727) 2022-07-02 13:41:22 +02: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.