From 3dcb934614358e2ca362292ef93fee3df1cfecb8 Mon Sep 17 00:00:00 2001
From: Ian Norden <iannordenn@gmail.com>
Date: Thu, 11 Jul 2019 12:51:11 -0500
Subject: [PATCH] work on doc.go

---
 cmd/utils/flags.go |  2 +-
 statediff/doc.go   | 13 +++++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/cmd/utils/flags.go b/cmd/utils/flags.go
index d216915ad..dbe008646 100644
--- a/cmd/utils/flags.go
+++ b/cmd/utils/flags.go
@@ -743,7 +743,7 @@ var (
 
 	StateDiffFlag = cli.BoolFlag{
 		Name:  "statediff",
-		Usage: "Enables the calculation of state diffs between each block, persists these state diffs the configured persistence mode.",
+		Usage: "Enables the processing of state diffs between each block",
 	}
 	StateDiffPathsAndProofs = cli.BoolFlag{
 		Name:  "statediff.pathsandproofs",
diff --git a/statediff/doc.go b/statediff/doc.go
index c0cbb4353..0e6d5f3e1 100644
--- a/statediff/doc.go
+++ b/statediff/doc.go
@@ -20,13 +20,23 @@ This work is adapted from work by Charles Crain at https://github.com/jpmorganch
 Package statediff provides an auxiliary service that processes state diff objects from incoming chain events,
 relaying the objects to any rpc subscriptions.
 
+The service is spun up using the below CLI flags
+--statediff: boolean flag, turns on the service
+--statediff.streamblock: boolean flag, configures the service to associate and stream out the rest of the block data with the state diffs.
+--statediff.intermediatenodes: boolean flag, tells service to include intermediate (branch and extension) nodes; default (false) processes leaf nodes only.
+--statediff.pathsandproofs: boolean flag, tells service to generate paths and proofs for the diffed storage and state trie leaf nodes.
+--statediff.watchedaddresses: string slice flag, used to limit the state diffing process to the given addresses. Usage: --statediff.watchedaddresses=addr1 --statediff.watchedaddresses=addr2 --statediff.watchedaddresses=addr3
+
+If you wish to use the websocket endpoint to subscribe to the statediff service, be sure to open up the Websocket RPC server with the `--ws` flag.
+
 Rpc subscriptions to the service can be created using the rpc.Client.Subscribe() method,
 with the "statediff" namespace, a statediff.Payload channel, and the name of the statediff api's rpc method- "stream".
 
 e.g.
 
+cli, _ := rpc.Dial("ipcPathOrWsURL")
 stateDiffPayloadChan := make(chan statediff.Payload, 20000)
-rpcSub, err := Subscribe(context.Background(), "statediff", stateDiffPayloadChan, "stream"})
+rpcSub, err := cli.Subscribe(context.Background(), "statediff", stateDiffPayloadChan, "stream"})
 for {
 	select {
 	case stateDiffPayload := <- stateDiffPayloadChan:
@@ -35,6 +45,5 @@ for {
 		log.Error(err)
 	}
 }
-
 */
 package statediff