From 7b824b7b8194165987d314c349aecea8bbb303b6 Mon Sep 17 00:00:00 2001
From: r-ush <aarush.bhatt@gmail.com>
Date: Mon, 27 Sep 2021 13:03:44 +0530
Subject: [PATCH 1/4] readme: rewrite

---
 docs/CONTRIBUTING.md    |   0
 docs/assets/utreexo.png | Bin 0 -> 14610 bytes
 readme.md               | 176 ++++++++++------------------------------
 3 files changed, 42 insertions(+), 134 deletions(-)
 create mode 100644 docs/CONTRIBUTING.md
 create mode 100644 docs/assets/utreexo.png

diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
new file mode 100644
index 00000000..e69de29b
diff --git a/docs/assets/utreexo.png b/docs/assets/utreexo.png
new file mode 100644
index 0000000000000000000000000000000000000000..20d9e427c8301cd08bb6d951fcc29c30f74f6360
GIT binary patch
literal 14610
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
Y(GacC1UCN*g22_wH%!Zab$<N60RFTRqyPW_

literal 0
HcmV?d00001

diff --git a/readme.md b/readme.md
index deb500ba..23663a73 100644
--- a/readme.md
+++ b/readme.md
@@ -1,139 +1,47 @@
-# Utreexo
+# UTreeXO
 
-A dynamic hash based accumulator designed for the Bitcoin UTXO set
-
-Check out the ePrint paper here: [https://eprint.iacr.org/2019/611](https://eprint.iacr.org/2019/611)
+![utreexo cover image](/docs/assets/utreexo.png)
 
-Currently under active development.  If you're interested and have questions, checkout #utreexo on irc.libera.chat.
+Utreexo is a novel hash-based dynamic accumulator, which allows the millions of unspent outputs to be represented under a kilobyte -- small enough to be written on a sheet of paper. There is no trusted setup or loss of security; instead, the burden of keeping track of funds is shifted to the owner of those funds.
 
-Logs for libera are [here](http://gnusha.org/utreexo/)
+Check out the ePrint paper here: https://eprint.iacr.org/2019/611
 
----
-## Importing Utreexo
-The raw accumulator functions are in package accumulator. This is a general accumulator and is not bitcoin specific. For Bitcoin specific accumulator, look to the csn and bridgenode packages.
+Currently, transactions specify inputs and outputs, and verifying an input requires you to know the whole state of the system. With Utreexo, the holder of funds maintains a proof that the funds exist and provides that proof at spending time to the other nodes. These proofs are compact (under 1KB) but represent the utreexo model’s main downside; they present an additional data transmission overhead that allows a much smaller state.
 
-## Walkthrough for testing out Utreexo nodes
-
-Here's how to get utreexo running to test out what it can do.  This currently is testing/research level code and should not be expected to be stable or secure.  But it also should work, and if it doesn't please report bugs!
-
-To demonstrate utreexo we went with a client-server model. We have made prebuild binaries to run utreexo on Linux, Mac and Windows available here: https://github.com/mit-dci/utreexo/releases but you can also build from source.
-
-### Client
-
-#### Build from source
-```
-$ go get github.com/mit-dci/utreexo
-$ cd ~/go/src/github.com/mit-dci/utreexo/cmd/utreexoclient
-$ go build
-```
-
-#### Run
-Running the client can take a couple of hours (There are still lots of performance optimisations to be done to speed things up).
-The client downloads blocks with inclusion proofs from the server and validates them.
-```
-$ ./utreexoclient
-[the client is able to resume from where it left off. Use ctrl+c to stop it.]
-[To resume, just do `/utreexoclient` again]
-```
-
-*There is a `host` flag to specify a different server and a `watchaddr` flag to specify the address that you want to watch. To view all options use the `help` flag*
-
-If you pause the client it will create the `pollardFile` which holds the accumulator roots. As an experiment you can copy this file to a different machine and resume the client at the height it was paused.
-
-### Server
-To try utreexo you must run the utreexo server. The instructions to run the server are given below.
-
-#### Build from source
-```
-$ go get github.com/mit-dci/utreexo
-$ cd ~/go/src/github.com/mit-dci/utreexo/cmd/utreexoserver
-$ go build
-```
-
-#### Run
-
-If you want to run a server you will need the Bitcoin blockchain. Try testnet as it's smaller. (you can get Bitcoin Core from http://github.com/bitcoin/bitcoin or https://bitcoin.org/en/download)
-
-```
-[ ...install bitcoin core ]
-$ echo "testnet=1" > ~/.bitcoin/bitcoin.conf
-$ bitcoind --daemon
-[wait for testnet to sync]
-$ du -h ~/.bitcoin/testnet3/blocks/
-	214M	~/.bitcoin/testnet3/blocks/index
-	24G	~/.bitcoin/testnet3/blocks/
-[OK looks like it's there]
-$ bitcoin-cli stop
-```
-**Note:** bitcoind has to be stopped before running the server.
-
-The server should take a few hours. It does two things. First, it goes through the blockchain, maintains the full merkle forest, and saves proofs for each block to disk. Second, it saves each TXO and height with LevelDB to make a TXO time-to-live (basically how long each TXO lasts until it is spent) for caching purposes. This is what the bridge node and archive node would do in a real node.
-
-```
-$ cd ~/.bitcoin/testnet3/blocks
-$ ./utreexoserver #path probably differs on your system
-[... takes time and builds block proofs]
-[the server is able to resume from where it left off. Use ctrl+c to stop it.]
-[To resume, just do `./cmd genproofs -net=testnet` again]
-```
-
-After the server has generated the proofs, it will start a local server to serve the blocks to clients.
-
-**Note**: your folders or filenames might be different, but this should give you the idea and work on default Linux/golang setups.  If you've tried this and it doesn't work and you'd like to help out, you can either fix the code or documentation so that it works and make a pull request, or open an issue describing what doesn't work.
-
-### Windows walkthrough
-<ol>
-<li>
-To run Utreexo, download the Bitcoin core here (includes both testnet and main chain): <a href="https://bitcoin.org/en/download ">https://bitcoin.org/en/download </a> Open the respective application; the testnet application should appear as a green bitcoin and the main bitcoin core application should appear as an orange bitcoin.
-From here, synchronize with the blockchain; this takes around 2-5 hours on the testnet and up to a day using Bitcoin core.
-</li>
-<li>
-Install Go in your pc and get it working on your compiler/IDE. The guide below will refer to installing Go on VSCode.
-</li>
-<li>
-
-Get the Utreexo Code from ```github.com/mit-dci/utreexo```
-</li>
-<li>
-
-Build and generate proofs (server) by running the following command where $USER is your username
-```
-go build bridgeserver.go
-bridgeserver -datadir=C:\Users\$USER\AppData\Roaming\Bitcoin\testnet3\blocks\
-```
- **If this fails, the command run was interupted or failed. To relaunch, delete the folders in the Utreexo\utreexoserver\utree folder: forestdata, offsetdata, pollarddata, proofdata, testnet-ttlbd**
-
-</li>
-<li>
-
- For a debugging session, in launch.json in VSCode, create a configuration as follows. The
-      ```"-datadir"```    argument should point to the folder where Bitcoin was downloaded in step 1.
-
-```
-{
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Launch",
-            "type": "go",
-            "request": "launch",
-            "mode": "auto",
-            "program": "${fileDirname}",
-            "env": {},
-            "args": ["-datadir=C:\\Users\\$USER\\AppData\\Roaming\\Bitcoin\\testnet3\\blocks\\"]
-        }
-    ]
-}
-```
-</li>
-
-<li>
-
-Finally run Utreexo client from  **command line** using the following. Make sure that the server has finished running before running this command.
-
-```
-go build csnclient.go
-C:\utreexo\csnclient -datadir=C:\Users\admin\AppData\Roaming\Bitcoin\testnet3\blocks\
-```
-</li>
-</ol>
+Utreexo pushes the costs of maintaining the network to the right place: an exchange creating millions of transactions may need to maintain millions of proofs, while a personal account with only a few unspent outputs will only need to maintain a few kilobytes of proof data. Utreexo also provides a long-term scalability solution as the accumulator size grows very slowly with the increasing size of the underlying set (the accumulator size is logarithmic with the set size)
+
+## Development Process
+
+At the moment, this repository holds the code for the accumulator and proof-of-concept implementations for the compact state node and the bridge node. The accumulator package is currently used in [mit-dci/utcd](https://github.com/mit-dci/utcd) in an alternative full node bitcoin implementation written in Go.
+
+The c++ implementation of UTreeXO is at [mit-dci/libutreexo](https://github.com/mit-dci/libutreexo) and the package is currently being used in [dergoegge/bitcoin](https://github.com/dergoegge/bitcoin) in an full node bitcoin-core implementation.
+
+## Documentation
+
+It is located in the [docs](https://github.com/mit-dci/utreexo/docs) folder.
+
+## IRC
+
+Currently under active development. If you're interested and have questions, checkout #utreexo on irc.libera.chat.
+
+Logs for libera are [here](https://gnusha.org/utreexo/)
+
+## Contributions
+
+- Feel Free to Open a PR/Issue/Discussion for any features/bug(s)/question(s).
+- Make sure you follow the contributing guidelines [here]()!
+
+## Resources
+
+### Blogs
+
+- https://dci.mit.edu/utreexo
+- [Utreexo demonstration release](https://medium.com/mit-media-lab-digital-currency-initiative/utreexo-demonstration-release-a0d87506fd70)
+- [Utreexo demo release 0.2](https://medium.com/mit-media-lab-digital-currency-initiative/utreexo-demo-release-0-2-ac40a1223a38)
+- [Utreexo — A scaling solution](https://medium.com/@kcalvinalvinn/eli5-utreexo-a-scaling-solution-9531aee3d7ba)
+
+### Videos/Podcasts
+
+- [MIT Bitcoin Expo 2019 - Utreexo: Reducing Bitcoin Nodes to 1 Kilobyte](https://www.youtube.com/watch?v=edRun-6ubCc)
+- [Tadge Dryja on Scaling Bitcoin With Utreexo](https://www.youtube.com/watch?v=2Kg1Cij3w20)
+- [#1 Tadge Dryja, Digital Currency Initiative: uTreeXO and Bootstrapping Bitcoin Upgrades](https://www.youtube.com/watch?v=-MlKZ_bFLNk)

From 2a5e46ca975883b58d222ee9d04982504ddf9130 Mon Sep 17 00:00:00 2001
From: r-ush <aarush.bhatt@gmail.com>
Date: Tue, 5 Oct 2021 10:44:06 +0530
Subject: [PATCH 2/4] fix: requested changes

- change UTreeXO to utreexo
- remove proofs under 1kb
---
 readme.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/readme.md b/readme.md
index 23663a73..3fc8dfe8 100644
--- a/readme.md
+++ b/readme.md
@@ -1,20 +1,20 @@
-# UTreeXO
+# utreexo
 
 ![utreexo cover image](/docs/assets/utreexo.png)
 
-Utreexo is a novel hash-based dynamic accumulator, which allows the millions of unspent outputs to be represented under a kilobyte -- small enough to be written on a sheet of paper. There is no trusted setup or loss of security; instead, the burden of keeping track of funds is shifted to the owner of those funds.
+utreexo is a novel hash-based dynamic accumulator, which allows the millions of unspent outputs to be represented under a kilobyte -- small enough to be written on a sheet of paper. There is no trusted setup or loss of security; instead, the burden of keeping track of funds is shifted to the owner of those funds.
 
 Check out the ePrint paper here: https://eprint.iacr.org/2019/611
 
-Currently, transactions specify inputs and outputs, and verifying an input requires you to know the whole state of the system. With Utreexo, the holder of funds maintains a proof that the funds exist and provides that proof at spending time to the other nodes. These proofs are compact (under 1KB) but represent the utreexo model’s main downside; they present an additional data transmission overhead that allows a much smaller state.
+Currently, transactions specify inputs and outputs, and verifying an input requires you to know the whole state of the system. With utreexo, the holder of funds maintains a proof that the funds exist and provides that proof at spending time to the other nodes. These proofs represent the utreexo model’s main downside; they present an additional data transmission overhead that allows a much smaller state.
 
-Utreexo pushes the costs of maintaining the network to the right place: an exchange creating millions of transactions may need to maintain millions of proofs, while a personal account with only a few unspent outputs will only need to maintain a few kilobytes of proof data. Utreexo also provides a long-term scalability solution as the accumulator size grows very slowly with the increasing size of the underlying set (the accumulator size is logarithmic with the set size)
+utreexo pushes the costs of maintaining the network to the right place: an exchange creating millions of transactions may need to maintain millions of proofs, while a personal account with only a few unspent outputs will only need to maintain a few kilobytes of proof data. utreexo also provides a long-term scalability solution as the accumulator size grows very slowly with the increasing size of the underlying set (the accumulator size is logarithmic with the set size)
 
 ## Development Process
 
 At the moment, this repository holds the code for the accumulator and proof-of-concept implementations for the compact state node and the bridge node. The accumulator package is currently used in [mit-dci/utcd](https://github.com/mit-dci/utcd) in an alternative full node bitcoin implementation written in Go.
 
-The c++ implementation of UTreeXO is at [mit-dci/libutreexo](https://github.com/mit-dci/libutreexo) and the package is currently being used in [dergoegge/bitcoin](https://github.com/dergoegge/bitcoin) in an full node bitcoin-core implementation.
+The c++ implementation of utreexo is at [mit-dci/libutreexo](https://github.com/mit-dci/libutreexo) and the package is currently being used in [dergoegge/bitcoin](https://github.com/dergoegge/bitcoin) in an full node bitcoin-core implementation.
 
 ## Documentation
 

From 7f6c6572110687219e3d3c0f4fce339f7af01589 Mon Sep 17 00:00:00 2001
From: r-ush <aarush.bhatt@gmail.com>
Date: Tue, 5 Oct 2021 12:06:36 +0530
Subject: [PATCH 3/4] add: docs readme

---
 docs/readme.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 docs/readme.md

diff --git a/docs/readme.md b/docs/readme.md
new file mode 100644
index 00000000..bfae97d5
--- /dev/null
+++ b/docs/readme.md
@@ -0,0 +1,16 @@
+# utreexo
+
+utreexo is a novel hash-based dynamic accumulator, which allows the millions of unspent outputs to be represented under a kilobyte -- small enough to be written on a sheet of paper. There is no trusted setup or loss of security; instead, the burden of keeping track of funds is shifted to the owner of those funds.
+
+Check out the ePrint paper here: https://eprint.iacr.org/2019/611
+
+Currently, transactions specify inputs and outputs, and verifying an input requires you to know the whole state of the system. With utreexo, the holder of funds maintains a proof that the funds exist and provides that proof at spending time to the other nodes. These proofs represent the utreexo model’s main downside; they present an additional data transmission overhead that allows a much smaller state.
+
+utreexo pushes the costs of maintaining the network to the right place: an exchange creating millions of transactions may need to maintain millions of proofs, while a personal account with only a few unspent outputs will only need to maintain a few kilobytes of proof data. utreexo also provides a long-term scalability solution as the accumulator size grows very slowly with the increasing size of the underlying set (the accumulator size is logarithmic with the set size)
+
+# Documentation
+
+- [Installation](https://github.com/mit-dci/utreexo/blob/master/docs/installation.md)
+- [Style Guidelines](https://github.com/mit-dci/utreexo/blob/master/docs/style.md)
+- [Contributing Guidelines](https://github.com/mit-dci/utreexo/blob/master/docs/contributing.md)
+- [Contact](https://github.com/mit-dci/utreexo/blob/master/docs/contact.md)

From c57e75ec11fc9ad68bbd673353dee6dbab61648a Mon Sep 17 00:00:00 2001
From: r-ush <aarush.bhatt@gmail.com>
Date: Tue, 5 Oct 2021 12:07:22 +0530
Subject: [PATCH 4/4] add: contact.md

---
 docs/contact.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 docs/contact.md

diff --git a/docs/contact.md b/docs/contact.md
new file mode 100644
index 00000000..6851a062
--- /dev/null
+++ b/docs/contact.md
@@ -0,0 +1,15 @@
+# Contact
+
+## IRC
+
+- [irc.libera.chat](irc://irc.libera.chat), channel `#utreexo`
+
+## Discussions
+
+- [GitHub Discussions](https://github.com/mit-dci/utreexo/discussions) can be used to ask and answer questions and share updates.
+- Weekly meetings on https://meet.jit.si/
+
+## Issue Tracker
+
+The [integrated github issue tracker](https://github.com/mit-dci/utreexo/issues)
+is used for this project.