From 27da712fd044c2a1164e648b3cbfc2c60a345c24 Mon Sep 17 00:00:00 2001
From: philip-morlier <philipmorlier@gmail.com>
Date: Fri, 24 Sep 2021 14:01:16 -0700
Subject: [PATCH] Plugin hooks initial work

---
 documentation/_build/doctrees/anatomy.doctree | Bin 3164 -> 12492 bytes
 documentation/_build/doctrees/api.doctree     | Bin 32380 -> 51524 bytes
 .../_build/doctrees/environment.pickle        | Bin 96974 -> 134561 bytes
 documentation/_build/doctrees/hooks.doctree   | Bin 3116 -> 20423 bytes
 documentation/_build/doctrees/index.doctree   | Bin 7150 -> 7130 bytes
 .../_build/html/_sources/anatomy.rst.txt      |  38 +++++++-
 .../_build/html/_sources/api.rst.txt          |  72 +++++++++++++-
 .../_build/html/_sources/hooks.rst.txt        |  59 +++++++++++-
 .../_build/html/_sources/index.rst.txt        |   3 +-
 documentation/_build/html/anatomy.html        |  50 +++++++++-
 documentation/_build/html/api.html            |  91 +++++++++++++++++-
 documentation/_build/html/build.html          |   3 +-
 documentation/_build/html/contact.html        |   3 +-
 .../_build/html/core_restricted.html          |   7 +-
 documentation/_build/html/genindex.html       |   3 +-
 documentation/_build/html/hooks.html          |  59 +++++++++---
 documentation/_build/html/index.html          |   6 +-
 documentation/_build/html/plugeth.html        |   3 +-
 documentation/_build/html/plugin_hooks.html   |  14 +--
 documentation/_build/html/plugin_loader.html  |   7 +-
 documentation/_build/html/plugins.html        |   3 +-
 documentation/_build/html/project.html        |   3 +-
 documentation/_build/html/search.html         |   3 +-
 documentation/_build/html/searchindex.js      |   2 +-
 documentation/_build/html/system_req.html     |   3 +-
 documentation/_build/html/types.html          |   7 +-
 documentation/_build/html/utils.html          |   3 +-
 documentation/api.rst                         |  72 +++++++++++++-
 documentation/hooks.rst                       |  59 +++++++++++-
 documentation/index.rst                       |   3 +-
 30 files changed, 498 insertions(+), 78 deletions(-)

diff --git a/documentation/_build/doctrees/anatomy.doctree b/documentation/_build/doctrees/anatomy.doctree
index 104446d39eb904f35105a784bd517ac6c814ade8..51bb4a38e9528b8136ef708001e374dd8725cfc6 100644
GIT binary patch
literal 12492
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
Qg(H`lr2VLNfZqiF4<@NutN;K2

delta 178
zcmX?;ct?V@fpuyi&qmfM%#)8v)H7w|ZT6D1VPeXdvAJ7%F|$ENUWRN&ZbnvV4`*It
zZfZ$oL2B`o+9?_tc^w(Kex(^gAhv9VYDN|iCuG=8ey{jZCS#d5V{z-0pea3k1&Kw)
zsqwj~#l?x~K%KEuCU4XipIj=hJNc=;D^teb$r}X}Sp72;GJZ{dsH{5KS4%*GtvJ85
dC^>aXhEfkpPG(-}6mQ1T47rRSlb0H(0|2i$L}LH|

diff --git a/documentation/_build/doctrees/api.doctree b/documentation/_build/doctrees/api.doctree
index e629ad5a1619d2ab246d69dac70ee096cc8ebf67..9ff3d2e4ee7a859f42a2c8eaa27f3925bb49e39c 100644
GIT binary patch
literal 51524
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
F`u~12Pl^Bl

delta 1482
zcmZuxZERCj816Z}=iYWK%f?3Hy6??xErGNdWMNiaTLzLfluWV@BE)uK=296HXIVGs
z>=q|;EC%`(H`XYy$_%K{d85YY4@ofD!XViX<M$5|Bmbr`7;3=idC#R?iT-)dx$k+O
z=Y7s|&OO)T#s?1wi?MUZMiy9pi(G0n82o;%`N<8&Lcc$uDhCp(y(cG2{eJMa&Xd33
zb=NSQesO%A(>9ujCafx(%H&RES7UI&9R+(h5AGfwGwqZN2DLia1}o2OF0t~N8xuq|
zsx@k@TIKbC!%+!8_czdP3976uWIrsp>*R4>xlaQ1h=cN>sH+BC8_leZXFG8n{N)mT
zR)U&PDXcr%NTZ0|05^*sCu3RsD-ui}bx=NJ@H;sEL=Il72@O(m1v3TM@iNyI?p5tm
z_u%HhycQbhBJ}bad?zotlmmzAaI1`(+>+K8?jiJ+1c8}y`0@A_@-5uvGJkJYFzFoJ
zB;DfN@D^*5cL@M=Sc>7(!B*k{dw(UAMCwd`>sH;*T9tm(Dlfz$E?U6QCR)tklC6Oj
zGN>Q2l0qo#szr<B-JCri*J_1FW+puPYG^y%ia_BJZ4uzSX7+HqR#>rB!W+XL(wrso
zaiXUG5N$uPO8t84{S2NvIm6E@(|Qj_^gMz<e^5|bf_U^-^C{kse~mL39oZ^(hz0G7
z5i_O0U}1eF{1S7>d-b$s^eIA9O!yfdv(xt(6g_6+8Es|EM5Gj_LO1jMqFldH{3=yw
z+g@EY(q#tDGrQ?G0%Tf#xKGVI*+V{_JV?lLR&+1NFRqFH8vU|p-<=LfG%ZL7f!p2U
zB=gc4zXqUSvI2fM^F7vla<+q%WNJ*A8W@gmgJbbFtoSS*C5@R1Oax#Chx>4dJdv9}
zo3M~{MjAN?9i5Hh6uBz2618$G+s{SJ0a;l2yezDILHCTkSwToYC#(`qs(N{3`VNiC
z+{ixiTBaF^f_tBSVM2OU-T68BxIVpcey(^>OxOO@;Jgg6*$c&y|H(Hc+ld#V$#%+%
zmXdXJS=LsQt(4xAHT&DY@zao@dTz7tX?~r9P7Hry_yfarzK`HF3@Hp3F?@vK0}Nkc
z_?(CEl=(=YzwhOtP~QMPJV8#GoGW)ArBBfL1eH(FObChz0iOt~>+z+kQ0s$BGTfQF
zL3b$No^PNY1%65$pe_ZR?`&)lx;ptwsO!R4O4o%yp{{E-tLxp2uAnBvOIPm7OfeX|
z5*)s2p>736_m)BG>LGekZ#1Of<u+pb?)SEoxp=Kwt=8u}f-Kw{^zbxnS}fHGED%`q
c&{>^eT7jYu8^LwWOydgtvuHulWlOey0n}I4od5s;

diff --git a/documentation/_build/doctrees/environment.pickle b/documentation/_build/doctrees/environment.pickle
index 707ce2bcbeaadf7a15cf504fd3b6b0cd049f495e..3817f711dc057583ebf4df7f60e0730b7d0e6d29 100644
GIT binary patch
literal 134561
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
K`0E=JBmWn+pMn|y

literal 96974
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

diff --git a/documentation/_build/doctrees/hooks.doctree b/documentation/_build/doctrees/hooks.doctree
index 40190bb71c132f8af1284b7393e4e211691d0b97..6fb2806e3523b0ab4534be15c5063d29acda90d3 100644
GIT binary patch
literal 20423
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
Y(&01dq(u&5+N8W%l7gaw1>DE|UmDqI;{X5v

delta 509
zcmaKoJxc>Y5Qe$SogpCjfoKRuFG^4gqk;$$Lx_bSfjb3T(KC1YUQBj_mjf*%iU=0l
z?Fx2US&1O2{0068D?2;EP6WZd#IMR?*xA|HXXbq$E|r_Oex#qLI`8xsrNO%V8a%R}
zarf()I(4XEvGCX+)NutD6UX9Ej6-J$$MZ{p?|YOObla#^f*p?-pmf(4h_1_?iJx9=
zEd+&COtJRmRD6NZ0Rx3#%SN{Z^JP8GpA;>YLkc4pE=KvQl9)yQ>+^q8f022KT;&Db
zXjtDES;+-kZfgj7*9D7s&Wy0pC(|z5sZ!$ArIg8*WE=f*)wqm=e2zM_MC__7nBJBb
zU<lbi;4~CO{=&yuXWI{M&Tp$A&HMQURmDZ~J$n-2&v|1S1W8m;4p=Ni*AHs0-!hh*
zp=t)`4NXoWjk1hQ<aoO9s^Pk*@Z@5g-<kt_ZgEt_3V$?<Dn3H3x+OKf%WRMntH)s4
evbkgl*5T7&ujC4hFs<SdR}__S|2KYRjeP=ZUAQO!

diff --git a/documentation/_build/doctrees/index.doctree b/documentation/_build/doctrees/index.doctree
index 1c460c21317d7e6757fd245ffd7117389a680ab8..f5c617f88ba9bc69af9a31e9a24add44c113ee31 100644
GIT binary patch
delta 446
zcmaE7e#@MtfpzNnjVxbyCo}V@OxEP9W85@(1>ch3b+J=2&L?JU@Mg@|*uxo8T9RLs
znV3^NC1Z1E#+J^Et(_U$ycsgKcV_GWD%_QEsWd}1V^)S*hI)pEw|s_J#-Y-r#0>G;
zDH<7)Kn2o3yl?V+{w_w=$%X<NF+kHbGM;C=%y^ygHsgIN%$lIowA7;1yyR3|)_g*?
zMipqyEv(k0OqLYn4+mP3#m>mU0P_XAbADb)VsZ%%!?U=6YLU&?2b%v2i~03}w>X4=
zYJomA+ngwLjfpX2vxVq>W+^?OV3szBPy-RlAVL;INKF=$6wv`m`+=qWz``A+8Ir&N
w0_(`o1}o2K$&vzT5ZN3kd4Z8-2ar9vkw=M5ENd%-DKj}!+L&?k<hjy;0Hji#9smFU

delta 476
zcmca*{?44GfpzNRjVxbySy?mk^Rp*^;?-ixST|XQua0rc<k@^nf;YrY$+(!9vB{e;
zV{;E@NNGuaQD$OJ@sy0Mof+FYGq!hT?C@sD*x8w}3#f2U#+A|x)r?sgY8mPo8r}*S
zVi`wDlM*w;Yo};rNCFi|1Mz{$3k6apf8$r<;3>!{P0!4WpDZh&5d*YHBjaVp>x{P<
z?=wE8!fXsmO-n6G%}Y+jW#boQ8`Xd|-oa{PaX8R|EKWuS2AF5qo%8cb5|c}C7@Wle
zREuo30nqF}Sj|?M+%LF|Lj<TE=xOuKzCzcS7{fNJi0)^OG5`u@>4FFi5TObp<UxcC
zkSOip%uCEoEvYO>EuI1lqAZYVKd?$au&R#I3`vkU$bbxOu<nc&u+}WG&9;&k7#Vj>
a=95-u*$$MS+{hy{IaJ!1aqHwx=|BMX1*?<*

diff --git a/documentation/_build/html/_sources/anatomy.rst.txt b/documentation/_build/html/_sources/anatomy.rst.txt
index 4a94f1d..d583eaa 100644
--- a/documentation/_build/html/_sources/anatomy.rst.txt
+++ b/documentation/_build/html/_sources/anatomy.rst.txt
@@ -4,4 +4,40 @@
 Plugin Anatomy
 ==============
 
-.. todo:: fill in disections of archetypal plugins 
\ No newline at end of file
+.. todo:: fill in disections of archetypal plugins
+
+.. code-block:: go 
+
+	package main
+
+import (
+	"github.com/openrelayxyz/plugeth-utils/core"
+	"gopkg.in/urfave/cli.v1"
+)
+
+var (
+	log core.Logger
+)
+
+type myservice struct{}
+
+func (*myservice) Hello() string {
+	return "Hello world"
+}
+
+func Initialize(ctx *cli.Context, loader core.PluginLoader, logger core.Logger) {
+	log = logger
+	log.Info("Initialized hello")
+}
+
+func GetAPIs(node core.Node, backend core.Backend) []core.API {
+	defer log.Info("APIs Initialized")
+	return []core.API{
+		{
+			Namespace: "mynamespace",
+			Version:   "1.0",
+			Service:   &myservice{},
+			Public:    true,
+		},
+	}
+}``
diff --git a/documentation/_build/html/_sources/api.rst.txt b/documentation/_build/html/_sources/api.rst.txt
index ef3ee53..4f22e54 100644
--- a/documentation/_build/html/_sources/api.rst.txt
+++ b/documentation/_build/html/_sources/api.rst.txt
@@ -46,7 +46,7 @@ Tracers
 
 .. code-block:: go
 
-   ``// CaptureStart is called at the start of each transaction
+   // CaptureStart is called at the start of each transaction
    CaptureStart(env core.EVM, from core.Address, to core.Address, create bool, input []byte, gas uint64, value *big.Int) {}
    // CaptureState is called for each opcode
    CaptureState(env core.EVM, pc uint64, op core.OpCode, gas, cost uint64, scope *vm.ScopeContext, rData []byte, depth int, err error) {}
@@ -55,12 +55,78 @@ Tracers
    // CaptureEnd is called at the end of each transaction
    CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) {}
    // GetResult should return a JSON serializable result object to respond to the trace call
-   GetResult() (interface{}, error) {}``
+   GetResult() (interface{}, error) {}
 
 
 .. warning:: Modifying the values passed into tracer functions can
              alter the 
-             results of the EVM execution in unpredictable ways. Additonally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference. 
+             results of the EVM execution in unpredictable ways. Additopackage main
+
+import (
+  "github.com/openrelayxyz/plugeth-utils/core"
+  "gopkg.in/urfave/cli.v1"
+)
+
+var (
+  log core.Logger
+)
+
+type myservice struct{}
+
+func (*myservice) Hello() string {
+  return "Hello world"
+}
+
+func Initialize(ctx *cli.Context, loader core.PluginLoader, logger core.Logger) {
+  log = logger
+  log.Info("Initialized hello")
+}
+
+func GetAPIs(node core.Node, backend core.Backend) []core.API {
+  defer log.Info("APIs Initialized")
+  return []core.API{
+    {
+      Namespace: "mynamespace",
+      Version:   "1.0",
+      Service:   &myservice{},
+      Public:    true,
+    },
+  }
+}
+package main
+
+import (
+  "github.com/openrelayxyz/plugeth-utils/core"
+  "gopkg.in/urfave/cli.v1"
+)
+
+var (
+  log core.Logger
+)
+
+type myservice struct{}
+
+func (*myservice) Hello() string {
+  return "Hello world"
+}
+
+func Initialize(ctx *cli.Context, loader core.PluginLoader, logger core.Logger) {
+  log = logger
+  log.Info("Initialized hello")
+}
+
+func GetAPIs(node core.Node, backend core.Backend) []core.API {
+  defer log.Info("APIs Initialized")
+  return []core.API{
+    {
+      Namespace: "mynamespace",
+      Version:   "1.0",
+      Service:   &myservice{},
+      Public:    true,
+    },
+  }
+}
+nally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference. 
 
 LiveTracer
 ----------
diff --git a/documentation/_build/html/_sources/hooks.rst.txt b/documentation/_build/html/_sources/hooks.rst.txt
index b7940ee..bbfb876 100644
--- a/documentation/_build/html/_sources/hooks.rst.txt
+++ b/documentation/_build/html/_sources/hooks.rst.txt
@@ -4,4 +4,61 @@
 Plugin Hooks
 ============
 
-.. todo:: discussion of plugin hooks
+The key to understanding a plugin is understanding its corresponding hook. Broadly, plugin hooks can be thought of as functions which deliver a function signiture to the **plugin loader**. The signature matches that of the function(s) called by the plugin and describes the data that is being captured and how the plugin will deliver said data upon invocation. 
+
+The public plugin hook function should follow the naming convention ``Plugin$HookName``. The first argument should be a `` core.PluginLoader``, followed by any arguments required by the functions to be provided by any plugins implementing this hook.
+
+**Public and Private Hook Functions**
+
+Each hook provides both a Public and private version. The private plugin hook function should bear the same name as the public plugin hook function, but with a lower case first letter. The signature should match the public plugin hook function, except that the first argument referencing the PluginLoader should be removed. It should invoke the public plugin hook function on plugins.DefaultPluginLoader. It should always verify that the DefaultPluginLoader is non-nil, log warning and return if the DefaultPluginLoader has not been initialized.
+
+**Invocation**
+
+the private plugin hook function should be invoked, with the appropriate arguments, in a single line within the Geth codebase inorder to minimize unexpected conflicts merging upstream Geth into plugeth.
+
+Selected Hooks
+--------------
+
+
+`StateUpdate`_ 
+************
+
+`Invocation`_
+
+The state update plugin provides a snapshot of the state subsystem in the form of a a stateUpdate object. The stateUpdate object contains all information transformed by a transaction but not the transaction itself. 
+
+Invoked for each new block, StateUpdate provides the changes to the blockchain state. root corresponds to the state root of the new block. parentRoot corresponds to the state root of the parent block. destructs serves as a set of accounts that self-destructed in this block. accounts maps the hash of each account address to the SlimRLP encoding of the account data. storage maps the hash of each account to a map of that account's stored data.
+
+.. warning:: StateUpdate is only called if Geth is running with 
+             ``-snapshots=true``. This is the default behavior for Geth, but if you are explicitly running with ``--snapshot=false`` this function will not be invoked. 
+			
+
+`AppendAncient`_
+*************
+
+Invoked when the freezer moves a block from LevelDB to the ancients database. ``number`` is the number of the block. ``hash`` is the 32 byte hash of the block as a raw ``[]byte``. ``header``, ``body``, and ``receipts`` are the RLP encoded versions of their respective block elements. ``td`` is the byte encoded total difficulty of the block.
+
+`NewHead`_
+**********
+
+Invoked when a new block becomes the canonical latest block. Note that if several blocks are processed in a group (such as during a reorg) this may not be called for each block. You should track the prior latest head if you need to process intermediate blocks.
+
+`GetRPCCalls`_
+************
+
+Invoked when the RPC handler registers a method call. returns the call ``id``, method ``name``, and any ``params`` that may have been passed in.  
+
+
+
+**I am struggling all of assudden with if this is really this best course of action. Giving all of this reference, seems to beg the -utils vs plugeth conversation and I am not sure that is a smart thing to get into.**
+
+
+
+
+
+
+.. _StateUpdate: https://github.com/openrelayxyz/plugeth/blob/develop/core/state/plugin_hooks.go
+.. _Invocation: https://github.com/openrelayxyz/plugeth/blob/develop/core/state/statedb.go#L955
+.. _AppendAncient: https://github.com/openrelayxyz/plugeth/blob/develop/core/rawdb/plugin_hooks.go
+.. _GetRPCCalls: https://github.com/openrelayxyz/plugeth/blob/develop/rpc/plugin_hooks.go
+.. _NewHead: https://github.com/openrelayxyz/plugeth/blob/develop/core/plugin_hooks.go#L108
diff --git a/documentation/_build/html/_sources/index.rst.txt b/documentation/_build/html/_sources/index.rst.txt
index ab2fd8a..ac126ce 100644
--- a/documentation/_build/html/_sources/index.rst.txt
+++ b/documentation/_build/html/_sources/index.rst.txt
@@ -25,7 +25,6 @@ Table of Contents
 
     project
     types
-    hooks
     anatomy
     
 
@@ -41,7 +40,7 @@ Table of Contents
 
     system_req
     plugin_loader
-    plugin_hooks
+    hooks
     core_restricted
     api
 
diff --git a/documentation/_build/html/anatomy.html b/documentation/_build/html/anatomy.html
index 371a82a..74dbaec 100644
--- a/documentation/_build/html/anatomy.html
+++ b/documentation/_build/html/anatomy.html
@@ -16,7 +16,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="Build and Deploy" href="build.html" />
-    <link rel="prev" title="Plugin Hooks" href="hooks.html" /> 
+    <link rel="prev" title="Basic Types of Plugins" href="types.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -38,7 +38,6 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -49,7 +48,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -88,13 +87,56 @@
 <p class="admonition-title">Todo</p>
 <p>fill in disections of archetypal plugins</p>
 </div>
+<div class="highlight-go notranslate"><div class="highlight"><pre><span></span><span class="kn">package</span> <span class="nx">main</span>
+</pre></div>
+</div>
+<dl class="simple">
+<dt>import (</dt><dd><p>“github.com/openrelayxyz/plugeth-utils/core”
+“gopkg.in/urfave/cli.v1”</p>
+</dd>
+</dl>
+<p>)</p>
+<dl class="simple">
+<dt>var (</dt><dd><p>log core.Logger</p>
+</dd>
+</dl>
+<p>)</p>
+<p>type myservice struct{}</p>
+<dl class="simple">
+<dt>func (<a href="#id2"><span class="problematic" id="id3">*</span></a>myservice) Hello() string {</dt><dd><p>return “Hello world”</p>
+</dd>
+</dl>
+<p>}</p>
+<dl class="simple">
+<dt>func Initialize(ctx <a href="#id4"><span class="problematic" id="id5">*</span></a>cli.Context, loader core.PluginLoader, logger core.Logger) {</dt><dd><p>log = logger
+log.Info(“Initialized hello”)</p>
+</dd>
+</dl>
+<p>}</p>
+<dl>
+<dt>func GetAPIs(node core.Node, backend core.Backend) []core.API {</dt><dd><p>defer log.Info(“APIs Initialized”)
+return []core.API{</p>
+<blockquote>
+<div><dl class="simple">
+<dt>{</dt><dd><p>Namespace: “mynamespace”,
+Version:   “1.0”,
+Service:   &amp;myservice{},
+Public:    true,</p>
+</dd>
+</dl>
+<p>},</p>
+</div></blockquote>
+<p>}</p>
+</dd>
+</dl>
+<p>}``</p>
 </div>
 
 
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="hooks.html" class="btn btn-neutral float-left" title="Plugin Hooks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="types.html" class="btn btn-neutral float-left" title="Basic Types of Plugins" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="build.html" class="btn btn-neutral float-right" title="Build and Deploy" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/_build/html/api.html b/documentation/_build/html/api.html
index 4831ab2..2a6abf7 100644
--- a/documentation/_build/html/api.html
+++ b/documentation/_build/html/api.html
@@ -38,7 +38,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -49,7 +48,7 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">API</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="#flags">Flags</a></li>
@@ -138,7 +137,7 @@ restricted.backend</p>
 <li><p><strong>Type:</strong> map[string]TracerResult</p></li>
 <li><p><strong>Behavior:</strong> When calling debug.traceX functions (such as <code class="docutils literal notranslate"><span class="pre">debug_traceCall</span></code> and <code class="docutils literal notranslate"><span class="pre">debug_traceTransaction</span></code>) the tracer can be specified as a key to this map and the tracer used will be the TracerResult specified here. TracerResult objects must match the interface:</p></li>
 </ul>
-<div class="highlight-go notranslate"><div class="highlight"><pre><span></span><span class="s">``</span><span class="c1">// CaptureStart is called at the start of each transaction</span>
+<div class="highlight-go notranslate"><div class="highlight"><pre><span></span><span class="c1">// CaptureStart is called at the start of each transaction</span>
 <span class="nx">CaptureStart</span><span class="p">(</span><span class="nx">env</span> <span class="nx">core</span><span class="p">.</span><span class="nx">EVM</span><span class="p">,</span> <span class="nx">from</span> <span class="nx">core</span><span class="p">.</span><span class="nx">Address</span><span class="p">,</span> <span class="nx">to</span> <span class="nx">core</span><span class="p">.</span><span class="nx">Address</span><span class="p">,</span> <span class="nx">create</span> <span class="kt">bool</span><span class="p">,</span> <span class="nx">input</span> <span class="p">[]</span><span class="kt">byte</span><span class="p">,</span> <span class="nx">gas</span> <span class="kt">uint64</span><span class="p">,</span> <span class="nx">value</span> <span class="o">*</span><span class="nx">big</span><span class="p">.</span><span class="nx">Int</span><span class="p">)</span> <span class="p">{}</span>
 <span class="c1">// CaptureState is called for each opcode</span>
 <span class="nx">CaptureState</span><span class="p">(</span><span class="nx">env</span> <span class="nx">core</span><span class="p">.</span><span class="nx">EVM</span><span class="p">,</span> <span class="nx">pc</span> <span class="kt">uint64</span><span class="p">,</span> <span class="nx">op</span> <span class="nx">core</span><span class="p">.</span><span class="nx">OpCode</span><span class="p">,</span> <span class="nx">gas</span><span class="p">,</span> <span class="nx">cost</span> <span class="kt">uint64</span><span class="p">,</span> <span class="nx">scope</span> <span class="o">*</span><span class="nx">vm</span><span class="p">.</span><span class="nx">ScopeContext</span><span class="p">,</span> <span class="nx">rData</span> <span class="p">[]</span><span class="kt">byte</span><span class="p">,</span> <span class="nx">depth</span> <span class="kt">int</span><span class="p">,</span> <span class="nx">err</span> <span class="kt">error</span><span class="p">)</span> <span class="p">{}</span>
@@ -147,15 +146,97 @@ restricted.backend</p>
 <span class="c1">// CaptureEnd is called at the end of each transaction</span>
 <span class="nx">CaptureEnd</span><span class="p">(</span><span class="nx">output</span> <span class="p">[]</span><span class="kt">byte</span><span class="p">,</span> <span class="nx">gasUsed</span> <span class="kt">uint64</span><span class="p">,</span> <span class="nx">t</span> <span class="nx">time</span><span class="p">.</span><span class="nx">Duration</span><span class="p">,</span> <span class="nx">err</span> <span class="kt">error</span><span class="p">)</span> <span class="p">{}</span>
 <span class="c1">// GetResult should return a JSON serializable result object to respond to the trace call</span>
-<span class="nx">GetResult</span><span class="p">()</span> <span class="p">(</span><span class="kd">interface</span><span class="p">{},</span> <span class="kt">error</span><span class="p">)</span> <span class="p">{}</span><span class="s">``</span>
+<span class="nx">GetResult</span><span class="p">()</span> <span class="p">(</span><span class="kd">interface</span><span class="p">{},</span> <span class="kt">error</span><span class="p">)</span> <span class="p">{}</span>
 </pre></div>
 </div>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>Modifying the values passed into tracer functions can
 alter the
-results of the EVM execution in unpredictable ways. Additonally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference.</p>
+results of the EVM execution in unpredictable ways. Additopackage main</p>
 </div>
+<dl class="simple">
+<dt>import (</dt><dd><p>“github.com/openrelayxyz/plugeth-utils/core”
+“gopkg.in/urfave/cli.v1”</p>
+</dd>
+</dl>
+<p>)</p>
+<dl class="simple">
+<dt>var (</dt><dd><p>log core.Logger</p>
+</dd>
+</dl>
+<p>)</p>
+<p>type myservice struct{}</p>
+<dl class="simple">
+<dt>func (<a href="#id5"><span class="problematic" id="id6">*</span></a>myservice) Hello() string {</dt><dd><p>return “Hello world”</p>
+</dd>
+</dl>
+<p>}</p>
+<dl class="simple">
+<dt>func Initialize(ctx <a href="#id7"><span class="problematic" id="id8">*</span></a>cli.Context, loader core.PluginLoader, logger core.Logger) {</dt><dd><p>log = logger
+log.Info(“Initialized hello”)</p>
+</dd>
+</dl>
+<p>}</p>
+<dl>
+<dt>func GetAPIs(node core.Node, backend core.Backend) []core.API {</dt><dd><p>defer log.Info(“APIs Initialized”)
+return []core.API{</p>
+<blockquote>
+<div><dl class="simple">
+<dt>{</dt><dd><p>Namespace: “mynamespace”,
+Version:   “1.0”,
+Service:   &amp;myservice{},
+Public:    true,</p>
+</dd>
+</dl>
+<p>},</p>
+</div></blockquote>
+<p>}</p>
+</dd>
+</dl>
+<p>}
+package main</p>
+<dl class="simple">
+<dt>import (</dt><dd><p>“github.com/openrelayxyz/plugeth-utils/core”
+“gopkg.in/urfave/cli.v1”</p>
+</dd>
+</dl>
+<p>)</p>
+<dl class="simple">
+<dt>var (</dt><dd><p>log core.Logger</p>
+</dd>
+</dl>
+<p>)</p>
+<p>type myservice struct{}</p>
+<dl class="simple">
+<dt>func (<a href="#id9"><span class="problematic" id="id10">*</span></a>myservice) Hello() string {</dt><dd><p>return “Hello world”</p>
+</dd>
+</dl>
+<p>}</p>
+<dl class="simple">
+<dt>func Initialize(ctx <a href="#id11"><span class="problematic" id="id12">*</span></a>cli.Context, loader core.PluginLoader, logger core.Logger) {</dt><dd><p>log = logger
+log.Info(“Initialized hello”)</p>
+</dd>
+</dl>
+<p>}</p>
+<dl>
+<dt>func GetAPIs(node core.Node, backend core.Backend) []core.API {</dt><dd><p>defer log.Info(“APIs Initialized”)
+return []core.API{</p>
+<blockquote>
+<div><dl class="simple">
+<dt>{</dt><dd><p>Namespace: “mynamespace”,
+Version:   “1.0”,
+Service:   &amp;myservice{},
+Public:    true,</p>
+</dd>
+</dl>
+<p>},</p>
+</div></blockquote>
+<p>}</p>
+</dd>
+</dl>
+<p>}
+nally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference.</p>
 </div>
 <div class="section" id="livetracer">
 <h2>LiveTracer<a class="headerlink" href="#livetracer" title="Permalink to this headline">¶</a></h2>
diff --git a/documentation/_build/html/build.html b/documentation/_build/html/build.html
index a905eb8..35b8e8c 100644
--- a/documentation/_build/html/build.html
+++ b/documentation/_build/html/build.html
@@ -38,7 +38,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -53,7 +52,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/contact.html b/documentation/_build/html/contact.html
index a2410a7..6f3d51c 100644
--- a/documentation/_build/html/contact.html
+++ b/documentation/_build/html/contact.html
@@ -37,7 +37,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -48,7 +47,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/core_restricted.html b/documentation/_build/html/core_restricted.html
index b044711..668d13c 100644
--- a/documentation/_build/html/core_restricted.html
+++ b/documentation/_build/html/core_restricted.html
@@ -16,7 +16,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="API" href="api.html" />
-    <link rel="prev" title="Plugin Hooks" href="plugin_hooks.html" /> 
+    <link rel="prev" title="Plugin Hooks" href="hooks.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -38,7 +38,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -49,7 +48,7 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -94,7 +93,7 @@
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="plugin_hooks.html" class="btn btn-neutral float-left" title="Plugin Hooks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hooks.html" class="btn btn-neutral float-left" title="Plugin Hooks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="api.html" class="btn btn-neutral float-right" title="API" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/documentation/_build/html/genindex.html b/documentation/_build/html/genindex.html
index 004d2b8..e7e4c3e 100644
--- a/documentation/_build/html/genindex.html
+++ b/documentation/_build/html/genindex.html
@@ -36,7 +36,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -47,7 +46,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/hooks.html b/documentation/_build/html/hooks.html
index 0e6d762..5e3e24c 100644
--- a/documentation/_build/html/hooks.html
+++ b/documentation/_build/html/hooks.html
@@ -15,8 +15,8 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Plugin Anatomy" href="anatomy.html" />
-    <link rel="prev" title="Basic Types of Plugins" href="types.html" /> 
+    <link rel="next" title="Core vs Restricted packages in Plugeth-utils" href="core_restricted.html" />
+    <link rel="prev" title="Plugin Loader" href="plugin_loader.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -35,10 +35,9 @@
 </div>
         </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
               <p class="caption"><span class="caption-text">Overview</span></p>
-<ul class="current">
+<ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -46,10 +45,19 @@
 <li class="toctree-l1"><a class="reference internal" href="build.html">Build and Deploy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Reference</span></p>
-<ul>
+<ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Plugin Hooks</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="#selected-hooks">Selected Hooks</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#stateupdate">StateUpdate</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#appendancient">AppendAncient</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#newhead">NewHead</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#getrpccalls">GetRPCCalls</a></li>
+</ul>
+</li>
+</ul>
+</li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -84,9 +92,38 @@
              
   <div class="section" id="plugin-hooks">
 <span id="hooks"></span><h1>Plugin Hooks<a class="headerlink" href="#plugin-hooks" title="Permalink to this headline">¶</a></h1>
-<div class="admonition-todo admonition" id="id1">
-<p class="admonition-title">Todo</p>
-<p>discussion of plugin hooks</p>
+<p>The key to understanding a plugin is understanding its corresponding hook. Broadly, plugin hooks can be thought of as functions which deliver a function signiture to the <strong>plugin loader</strong>. The signature matches that of the function(s) called by the plugin and describes the data that is being captured and how the plugin will deliver said data upon invocation.</p>
+<p>The public plugin hook function should follow the naming convention <code class="docutils literal notranslate"><span class="pre">Plugin$HookName</span></code>. The first argument should be a `` core.PluginLoader``, followed by any arguments required by the functions to be provided by any plugins implementing this hook.</p>
+<p><strong>Public and Private Hook Functions</strong></p>
+<p>Each hook provides both a Public and private version. The private plugin hook function should bear the same name as the public plugin hook function, but with a lower case first letter. The signature should match the public plugin hook function, except that the first argument referencing the PluginLoader should be removed. It should invoke the public plugin hook function on plugins.DefaultPluginLoader. It should always verify that the DefaultPluginLoader is non-nil, log warning and return if the DefaultPluginLoader has not been initialized.</p>
+<p><strong>Invocation</strong></p>
+<p>the private plugin hook function should be invoked, with the appropriate arguments, in a single line within the Geth codebase inorder to minimize unexpected conflicts merging upstream Geth into plugeth.</p>
+<div class="section" id="selected-hooks">
+<h2>Selected Hooks<a class="headerlink" href="#selected-hooks" title="Permalink to this headline">¶</a></h2>
+<div class="section" id="stateupdate">
+<h3><a class="reference external" href="https://github.com/openrelayxyz/plugeth/blob/develop/core/state/plugin_hooks.go">StateUpdate</a><a class="headerlink" href="#stateupdate" title="Permalink to this headline">¶</a></h3>
+<p><a class="reference external" href="https://github.com/openrelayxyz/plugeth/blob/develop/core/state/statedb.go#L955">Invocation</a></p>
+<p>The state update plugin provides a snapshot of the state subsystem in the form of a a stateUpdate object. The stateUpdate object contains all information transformed by a transaction but not the transaction itself.</p>
+<p>Invoked for each new block, StateUpdate provides the changes to the blockchain state. root corresponds to the state root of the new block. parentRoot corresponds to the state root of the parent block. destructs serves as a set of accounts that self-destructed in this block. accounts maps the hash of each account address to the SlimRLP encoding of the account data. storage maps the hash of each account to a map of that account’s stored data.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>StateUpdate is only called if Geth is running with
+<code class="docutils literal notranslate"><span class="pre">-snapshots=true</span></code>. This is the default behavior for Geth, but if you are explicitly running with <code class="docutils literal notranslate"><span class="pre">--snapshot=false</span></code> this function will not be invoked.</p>
+</div>
+</div>
+<div class="section" id="appendancient">
+<h3><a class="reference external" href="https://github.com/openrelayxyz/plugeth/blob/develop/core/rawdb/plugin_hooks.go">AppendAncient</a><a class="headerlink" href="#appendancient" title="Permalink to this headline">¶</a></h3>
+<p>Invoked when the freezer moves a block from LevelDB to the ancients database. <code class="docutils literal notranslate"><span class="pre">number</span></code> is the number of the block. <code class="docutils literal notranslate"><span class="pre">hash</span></code> is the 32 byte hash of the block as a raw <code class="docutils literal notranslate"><span class="pre">[]byte</span></code>. <code class="docutils literal notranslate"><span class="pre">header</span></code>, <code class="docutils literal notranslate"><span class="pre">body</span></code>, and <code class="docutils literal notranslate"><span class="pre">receipts</span></code> are the RLP encoded versions of their respective block elements. <code class="docutils literal notranslate"><span class="pre">td</span></code> is the byte encoded total difficulty of the block.</p>
+</div>
+<div class="section" id="newhead">
+<h3><a class="reference external" href="https://github.com/openrelayxyz/plugeth/blob/develop/core/plugin_hooks.go#L108">NewHead</a><a class="headerlink" href="#newhead" title="Permalink to this headline">¶</a></h3>
+<p>Invoked when a new block becomes the canonical latest block. Note that if several blocks are processed in a group (such as during a reorg) this may not be called for each block. You should track the prior latest head if you need to process intermediate blocks.</p>
+</div>
+<div class="section" id="getrpccalls">
+<h3><a class="reference external" href="https://github.com/openrelayxyz/plugeth/blob/develop/rpc/plugin_hooks.go">GetRPCCalls</a><a class="headerlink" href="#getrpccalls" title="Permalink to this headline">¶</a></h3>
+<p>Invoked when the RPC handler registers a method call. returns the call <code class="docutils literal notranslate"><span class="pre">id</span></code>, method <code class="docutils literal notranslate"><span class="pre">name</span></code>, and any <code class="docutils literal notranslate"><span class="pre">params</span></code> that may have been passed in.</p>
+<p><strong>I am struggling all of assudden with if this is really this best course of action. Giving all of this reference, seems to beg the -utils vs plugeth conversation and I am not sure that is a smart thing to get into.</strong></p>
+</div>
 </div>
 </div>
 
@@ -94,8 +131,8 @@
            </div>
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="types.html" class="btn btn-neutral float-left" title="Basic Types of Plugins" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="anatomy.html" class="btn btn-neutral float-right" title="Plugin Anatomy" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="plugin_loader.html" class="btn btn-neutral float-left" title="Plugin Loader" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="core_restricted.html" class="btn btn-neutral float-right" title="Core vs Restricted packages in Plugeth-utils" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/_build/html/index.html b/documentation/_build/html/index.html
index f4c8609..45c4278 100644
--- a/documentation/_build/html/index.html
+++ b/documentation/_build/html/index.html
@@ -37,7 +37,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -48,7 +47,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -98,7 +97,6 @@ perspective, PluGeth should be as stable as upstream Geth less whatever isstabil
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 </div>
@@ -113,7 +111,7 @@ perspective, PluGeth should be as stable as upstream Geth less whatever isstabil
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/plugeth.html b/documentation/_build/html/plugeth.html
index 2752e01..bf25298 100644
--- a/documentation/_build/html/plugeth.html
+++ b/documentation/_build/html/plugeth.html
@@ -36,7 +36,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -47,7 +46,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/plugin_hooks.html b/documentation/_build/html/plugin_hooks.html
index dbfb293..f7f3e83 100644
--- a/documentation/_build/html/plugin_hooks.html
+++ b/documentation/_build/html/plugin_hooks.html
@@ -14,9 +14,7 @@
         <script src="_static/doctools.js"></script>
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Core vs Restricted packages in Plugeth-utils" href="core_restricted.html" />
-    <link rel="prev" title="Plugin Loader" href="plugin_loader.html" /> 
+    <link rel="search" title="Search" href="search.html" /> 
 </head>
 
 <body class="wy-body-for-nav"> 
@@ -38,7 +36,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -46,10 +43,10 @@
 <li class="toctree-l1"><a class="reference internal" href="build.html">Build and Deploy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Reference</span></p>
-<ul class="current">
+<ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -93,10 +90,7 @@
 
            </div>
           </div>
-          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="plugin_loader.html" class="btn btn-neutral float-left" title="Plugin Loader" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="core_restricted.html" class="btn btn-neutral float-right" title="Core vs Restricted packages in Plugeth-utils" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
-    </div>
+          <footer>
 
   <hr/>
 
diff --git a/documentation/_build/html/plugin_loader.html b/documentation/_build/html/plugin_loader.html
index 9e35e0e..7c514dc 100644
--- a/documentation/_build/html/plugin_loader.html
+++ b/documentation/_build/html/plugin_loader.html
@@ -15,7 +15,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Plugin Hooks" href="plugin_hooks.html" />
+    <link rel="next" title="Plugin Hooks" href="hooks.html" />
     <link rel="prev" title="System Requirements" href="system_req.html" /> 
 </head>
 
@@ -38,7 +38,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -49,7 +48,7 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -95,7 +94,7 @@
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="system_req.html" class="btn btn-neutral float-left" title="System Requirements" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="plugin_hooks.html" class="btn btn-neutral float-right" title="Plugin Hooks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="hooks.html" class="btn btn-neutral float-right" title="Plugin Hooks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/_build/html/plugins.html b/documentation/_build/html/plugins.html
index 63f01a4..bee41b8 100644
--- a/documentation/_build/html/plugins.html
+++ b/documentation/_build/html/plugins.html
@@ -36,7 +36,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -47,7 +46,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/project.html b/documentation/_build/html/project.html
index e9a6838..2ecf92b 100644
--- a/documentation/_build/html/project.html
+++ b/documentation/_build/html/project.html
@@ -47,7 +47,6 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -58,7 +57,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/search.html b/documentation/_build/html/search.html
index 9bcc5bb..165c99f 100644
--- a/documentation/_build/html/search.html
+++ b/documentation/_build/html/search.html
@@ -39,7 +39,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -50,7 +49,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/searchindex.js b/documentation/_build/html/searchindex.js
index f81bb50..c689145 100644
--- a/documentation/_build/html/searchindex.js
+++ b/documentation/_build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["anatomy","api","build","contact","core_restricted","hooks","index","plugeth","plugin_hooks","plugin_loader","plugins","project","system_req","types","utils"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.intersphinx":1,"sphinx.ext.todo":2,sphinx:56},filenames:["anatomy.rst","api.rst","build.rst","contact.rst","core_restricted.rst","hooks.rst","index.rst","plugeth.rst","plugin_hooks.rst","plugin_loader.rst","plugins.rst","project.rst","system_req.rst","types.rst","utils.rst"],objects:{},objnames:{},objtypes:{},terms:{"127":2,"350":[2,12],"8545":2,"break":6,"byte":1,"export":1,"final":1,"function":[1,4,9,11,13],"int":1,"long":11,"new":[1,2,6,11,13],"public":1,"return":[1,13],"true":1,"while":[1,11],And:1,But:[6,11],For:[1,11],The:[1,3,11],These:1,abl:1,abov:[1,13],access:[1,2],acress:1,added:[6,12],addit:6,addition:2,additon:1,address:1,against:1,ago:11,aim:11,all:[2,11],allow:[1,6],also:[11,13],alter:[1,11],analysi:11,anatomi:6,ani:[1,3],anxiou:3,apart:11,api:[2,6,13],append:[2,13],applic:[2,11],arbitrari:1,archetyp:0,architectur:[6,11],archtyp:13,arg:[1,13],argument:[1,13],arrai:1,avail:[2,13],avoid:[1,11],awar:6,backend:[1,13],basic:6,been:[2,11],begin:2,behav:11,behavior:[1,2,11,13],best:3,big:[1,11],binari:1,block:1,bool:1,box:11,breakdown:9,brief:1,build:[1,6],buildmod:2,built:[2,11],bulk:1,call:[1,2],can:[1,11,13],cannot:13,capabl:[1,6],captur:1,captureend:1,capturefault:1,capturest:1,capturestart:1,care:1,certain:1,challeng:11,chang:[2,11],channel:13,check:1,choos:[2,11],cli:1,client:[1,6,11],clone:2,cmd:2,come:11,command:[1,2,13],compact:2,compil:2,complet:2,concur:13,congradul:2,connect:[2,12,13],consensu:11,contact:6,contain:11,contant:13,content:2,context:[1,13],control:13,copi:[1,10,14],core:[1,6],correspond:1,cost:1,could:[1,11,13],cpu:[2,12],creat:[1,6,11],createsubscript:1,ctx:1,curl:2,custom:[11,13],data:[1,2,13],databas:1,debug:1,debug_tracecal:1,debug_tracetransact:1,decod:1,depend:[2,12],deploi:6,depth:1,design:6,detail:11,develop:[6,11],differ:[1,6,11],direct:11,directori:2,disabl:1,discord:3,discuss:[5,7],disect:0,disk:[2,12],doe:[1,11],don:1,download:2,dozen:2,drawback:11,drift:11,drop:3,due:1,durat:1,dure:1,each:[1,11],earli:6,easili:11,either:1,elabor:11,enabl:11,encod:1,end:1,enough:11,env:1,err:1,error:[1,13],especi:11,ethereum:[2,6,11,12],everyon:2,evm:[1,11],exactli:11,execut:1,exist:11,explain:1,explin:4,extend:[6,11],extract:11,fail:1,fairli:1,familiar:2,featur:11,file:2,fill:[0,11],first:[1,2],flag:[2,13],flagset:1,folder:2,follow:1,forese:12,fork:[2,6,11],framework:1,freebsd:12,friend:2,from:[1,2,3,6,11],func:1,funtion:2,furtur:6,futur:12,gas:1,gasus:1,gener:[1,11,13],get:[2,6],getapi:13,geth:[1,2,6,11,13],getresult:1,give:1,given:11,goal:11,golang:[1,11,12],guid:8,hand:11,has:[2,11],have:[1,2,3,6,11,12],hear:3,hello:[1,2,3],helloworld:1,help:[2,3],here:[1,11],histor:13,home:2,hook:[6,11],how:4,howev:2,http:[2,13],hybrid:13,idea:3,implement:[1,6,11,12],includ:2,info:2,inform:[11,13],initi:[2,13],input:1,insid:2,instal:11,intend:1,interest:11,interfac:1,invok:1,ipc:1,isstabl:6,its:[11,13],itself:1,json:[1,2,13],jsonrpc:[2,13],just:2,kei:1,largest:11,least:[2,12],less:6,like:[1,6,11],limit:13,line:[1,13],link:3,linux:12,list:2,livetrac:13,load:1,loader:[1,6,11,13],local:2,locat:[2,11],log:[1,2],logger:13,look:1,lot:13,maco:12,made:13,mai:[1,3],main:2,mainnet:[2,11,12],maintain:11,make:[6,11],mani:11,manipul:1,map:1,marshal:1,match:1,matter:11,mean:11,merg:11,method:[1,2],might:[1,6],miss:11,modifi:[1,11],modul:1,moment:2,more:[11,13],move:[2,11],must:[1,13],mymamespac:2,mynamespac:1,mynamespace_hello:2,mynamespace_helloworld:1,myservic:1,name:[1,13],namespac:1,namespace_subscrib:13,nativ:1,navig:2,need:[1,2,4,11,13],network:[2,11,12],next:2,nil:1,node:[1,2,13],non:1,note:1,notifi:1,now:6,number:[1,6,11],numer:11,object:1,obscur:11,occur:1,offici:6,onc:2,onli:[11,12],opcod:1,oper:[1,6,13],opportun:1,optim:11,option:1,order:[2,13],other:11,our:3,out:11,output:1,overview:6,own:[2,11,13],p2p:1,packag:[2,6,11],page:13,param:[2,13],pars:1,pass:[1,13],perspect:6,plan:6,plugeth:[1,2,3,12],plugethplugin:2,plugethutil:2,plugin:[1,6,12],pluginload:1,point:[1,2],popular:11,practic:2,premad:11,primari:2,primarili:11,problem:3,process:[1,2,11],produc:2,project:[2,6],properli:11,protocol:11,prove:11,provid:[1,2,11,13],quit:11,ram:[2,12],rather:[1,6,11],rdata:1,reach:3,read:2,readi:2,reason:11,reciev:13,redifin:13,refer:[1,6],regist:1,releas:6,reli:[12,13],repo:10,repositori:[2,7],repres:1,requir:[1,2,6,13],requirr:13,resid:11,respond:[1,2],respons:1,restirct:4,restrict:[1,6],result:[1,2,11],retian:1,reus:1,right:[6,11],rpc:[1,2],rpcsub:1,rule:11,run:[1,2,6,13],sai:3,scope:1,scopecontext:1,secur:11,see:[2,11],sens:11,sent:1,separ:1,seper:2,serializ:1,serv:[1,11],server:3,servic:[1,13],settl:6,should:[1,2,6,12],signatur:1,similar:1,simpl:1,singl:[1,11],singular:13,small:11,some:[1,6,11],someth:1,soon:1,space:2,specif:1,specifi:1,ssd:[2,12],stabl:[6,13],stack:1,stand:13,standard:[2,11],start:[1,2,13],still:6,stop:11,store:11,straight:1,string:1,struct:1,subscrib:1,subscript:1,subscriptionnam:13,support:[1,11,12],sure:1,system:[1,6,13],take:[1,2,13],team:[3,11],tend:11,testnet:11,than:[1,6,11],thankfulli:2,thei:[1,13],thi:[1,2,11,13],those:11,though:[2,11],three:2,through:[2,3],time:[1,2],todai:6,todo:[3,10,13,14],total:13,touch:6,trace:1,tracerresult:1,tracex:1,transact:1,tutori:[2,6],two:[1,2],type:[1,2,6],uint64:1,unexpect:1,unlik:12,unpredict:1,updat:[6,11],upon:13,upstream:[6,11],use:[1,2],used:[1,11],useful:[1,2],user:11,using:[1,6],util:6,valid:1,valu:1,vari:12,variabl:1,varieti:11,veri:1,verif:13,version:1,wai:[1,3,6,11,13],want:3,websocket:[1,13],well:[2,11],what:4,whatev:6,when:[1,11],wherea:13,which:[2,11,12,13],whichev:2,why:4,wide:[1,11],window:12,wish:1,within:1,without:[1,11],work:[3,13],world:[1,2],would:11,wrapper:11,write:8,written:11,yet:6,you:[1,2,3,6,12],your:[1,2,3,13],your_command:1},titles:["Plugin Anatomy","API","Build and Deploy","Get in touch with us","Core vs Restricted packages in Plugeth-utils","Plugin Hooks","PluGeth","PluGeth","Plugin Hooks","Plugin Loader","PluGeth Plugins","Project Design","System Requirements","Basic Types of Plugins","PluGeth Utils"],titleterms:{anatomi:0,api:1,basic:13,build:2,content:6,core:4,depend:11,deploi:2,design:11,environ:2,flag:1,get:3,getapi:1,hook:[5,8],initi:1,initializenod:1,livetrac:1,loader:9,method:13,packag:4,plugeth:[4,6,7,10,11,14],plugin:[0,2,5,8,9,10,11,13],project:11,repositori:11,requir:12,restrict:4,rpc:13,scheme:11,set:2,subcommand:[1,13],subscript:13,system:12,tabl:6,three:11,todo:[0,1,4,5,8,9,11],touch:3,tracer:[1,13],type:13,util:[4,11,14]}})
\ No newline at end of file
+Search.setIndex({docnames:["anatomy","api","build","contact","core_restricted","hooks","index","plugeth","plugin_hooks","plugin_loader","plugins","project","system_req","types","utils"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.intersphinx":1,"sphinx.ext.todo":2,sphinx:56},filenames:["anatomy.rst","api.rst","build.rst","contact.rst","core_restricted.rst","hooks.rst","index.rst","plugeth.rst","plugin_hooks.rst","plugin_loader.rst","plugins.rst","project.rst","system_req.rst","types.rst","utils.rst"],objects:{},objnames:{},objtypes:{},terms:{"127":2,"350":[2,12],"8545":2,"break":6,"byte":[1,5],"case":5,"default":5,"export":1,"final":1,"function":[1,4,5,9,11,13],"import":[0,1],"int":1,"long":11,"new":[1,2,5,6,11,13],"public":[0,1,5],"return":[0,1,5,13],"true":[0,1,5],"var":[0,1],"while":[1,11],And:1,But:[6,11],For:[1,11],The:[1,3,5,11],These:1,abl:1,abov:[1,13],access:[1,2],account:5,acress:1,action:5,added:[6,12],addit:6,addition:2,additopackag:1,address:[1,5],against:1,ago:11,aim:11,all:[2,5,11],allow:[1,6],also:[11,13],alter:[1,11],alwai:5,analysi:11,anatomi:6,ancient:5,ani:[1,3,5],anxiou:3,apart:11,api:[0,2,6,13],append:[2,13],applic:[2,11],appropri:5,arbitrari:1,archetyp:0,architectur:[6,11],archtyp:13,arg:[1,13],argument:[1,5,13],arrai:1,assudden:5,avail:[2,13],avoid:[1,11],awar:6,backend:[0,1,13],basic:6,bear:5,becom:5,been:[2,5,11],beg:5,begin:2,behav:11,behavior:[1,2,5,11,13],being:5,best:[3,5],big:[1,11],binari:1,block:[1,5],blockchain:5,bodi:5,bool:1,both:5,box:11,breakdown:9,brief:1,broadli:5,build:[1,6],buildmod:2,built:[2,11],bulk:1,call:[1,2,5],can:[1,5,11,13],cannot:13,canon:5,capabl:[1,6],captur:[1,5],captureend:1,capturefault:1,capturest:1,capturestart:1,care:1,certain:1,challeng:11,chang:[2,5,11],channel:13,check:1,choos:[2,11],cli:[0,1],client:[1,6,11],clone:2,cmd:2,codebas:5,com:[0,1],come:11,command:[1,2,13],compact:2,compil:2,complet:2,concur:13,conflict:5,congradul:2,connect:[2,12,13],consensu:11,contact:6,contain:[5,11],contant:13,content:2,context:[0,1,13],control:13,convent:5,convers:5,copi:[1,10,14],core:[0,1,5,6],correspond:[1,5],cost:1,could:[1,11,13],cours:5,cpu:[2,12],creat:[1,6,11],createsubscript:1,ctx:[0,1],curl:2,custom:[11,13],data:[1,2,5,13],databas:[1,5],debug:1,debug_tracecal:1,debug_tracetransact:1,decod:1,defaultpluginload:5,defer:[0,1],deliv:5,depend:[2,12],deploi:6,depth:1,describ:5,design:6,destruct:5,detail:11,develop:[6,11],differ:[1,6,11],difficulti:5,direct:11,directori:2,disabl:1,discord:3,discuss:7,disect:0,disk:[2,12],doe:[1,11],don:1,download:2,dozen:2,drawback:11,drift:11,drop:3,due:1,durat:1,dure:[1,5],each:[1,5,11],earli:6,easili:11,either:1,elabor:11,element:5,enabl:11,encod:[1,5],end:1,enough:11,env:1,err:1,error:[1,13],especi:11,ethereum:[2,6,11,12],everyon:2,evm:[1,11],exactli:11,except:5,execut:1,exist:11,explain:1,explicitli:5,explin:4,extend:[6,11],extract:11,fail:1,fairli:1,fals:5,familiar:2,featur:11,file:2,fill:[0,11],first:[1,2,5],flag:[2,13],flagset:1,folder:2,follow:[1,5],forese:12,fork:[2,6,11],form:5,framework:1,freebsd:12,freezer:5,friend:2,from:[1,2,3,5,6,11],func:[0,1],funtion:2,furtur:6,futur:12,gas:1,gasus:1,gener:[1,11,13],get:[2,5,6],getapi:[0,13],geth:[1,2,5,6,11,13],getresult:1,github:[0,1],give:[1,5],given:11,goal:11,golang:[1,11,12],gopkg:[0,1],group:5,guid:8,hand:11,handler:5,has:[2,5,11],hash:5,have:[1,2,3,5,6,11,12],head:5,header:5,hear:3,hello:[0,1,2,3],helloworld:1,help:[2,3],here:[1,11],histor:13,home:2,hook:[6,11],hooknam:5,how:[4,5],howev:2,http:[2,13],hybrid:13,idea:3,implement:[1,5,6,11,12],includ:2,info:[0,1,2],inform:[5,11,13],initi:[0,2,5,13],inord:5,input:1,insid:2,instal:11,intend:1,interest:11,interfac:1,intermedi:5,invoc:5,invok:[1,5],ipc:1,isstabl:6,its:[5,11,13],itself:[1,5],json:[1,2,13],jsonrpc:[2,13],just:2,kei:[1,5],largest:11,latest:5,least:[2,12],less:6,letter:5,leveldb:5,like:[1,6,11],limit:13,line:[1,5,13],link:3,linux:12,list:2,livetrac:13,load:1,loader:[0,1,5,6,11,13],local:2,locat:[2,11],log:[0,1,2,5],logger:[0,1,13],look:1,lot:13,lower:5,maco:12,made:13,mai:[1,3,5],main:[0,1,2],mainnet:[2,11,12],maintain:11,make:[6,11],mani:11,manipul:1,map:[1,5],marshal:1,match:[1,5],matter:11,mean:11,merg:[5,11],method:[1,2,5],might:[1,6],minim:5,miss:11,modifi:[1,11],modul:1,moment:2,more:[11,13],move:[2,5,11],must:[1,13],mymamespac:2,mynamespac:[0,1],mynamespace_hello:2,mynamespace_helloworld:1,myservic:[0,1],nalli:1,name:[1,5,13],namespac:[0,1],namespace_subscrib:13,nativ:1,navig:2,need:[1,2,4,5,11,13],network:[2,11,12],next:2,nil:[1,5],node:[0,1,2,13],non:[1,5],note:[1,5],notifi:1,now:6,number:[1,5,6,11],numer:11,object:[1,5],obscur:11,occur:1,offici:6,onc:2,onli:[5,11,12],opcod:1,openrelayxyz:[0,1],oper:[1,6,13],opportun:1,optim:11,option:1,order:[2,13],other:11,our:3,out:11,output:1,overview:6,own:[2,11,13],p2p:1,packag:[0,1,2,6,11],page:13,param:[2,5,13],parent:5,parentroot:5,pars:1,pass:[1,5,13],perspect:6,plan:6,plugeth:[0,1,2,3,5,12],plugethplugin:2,plugethutil:2,plugin:[1,6,12],pluginload:[0,1,5],point:[1,2],popular:11,practic:2,premad:11,primari:2,primarili:11,prior:5,privat:5,problem:3,process:[1,2,5,11],produc:2,project:[2,6],properli:11,protocol:11,prove:11,provid:[1,2,5,11,13],quit:11,ram:[2,12],rather:[1,6,11],raw:5,rdata:1,reach:3,read:2,readi:2,realli:5,reason:11,receipt:5,reciev:13,redifin:13,refer:[1,5,6],referenc:5,regist:[1,5],releas:6,reli:[12,13],remov:5,reorg:5,repo:10,repositori:[2,7],repres:1,requir:[1,2,5,6,13],requirr:13,resid:11,respect:5,respond:[1,2],respons:1,restirct:4,restrict:[1,6],result:[1,2,11],retian:1,reus:1,right:[6,11],rlp:5,root:5,rpc:[1,2,5],rpcsub:1,rule:11,run:[1,2,5,6,13],sai:3,said:5,same:5,scope:1,scopecontext:1,secur:11,see:[2,11],seem:5,self:5,sens:11,sent:1,separ:1,seper:2,serializ:1,serv:[1,5,11],server:3,servic:[0,1,13],set:5,settl:6,sever:5,should:[1,2,5,6,12],signatur:[1,5],signitur:5,similar:1,simpl:1,singl:[1,5,11],singular:13,slimrlp:5,small:11,smart:5,snapshot:5,some:[1,6,11],someth:1,soon:1,space:2,specif:1,specifi:1,ssd:[2,12],stabl:[6,13],stack:1,stand:13,standard:[2,11],start:[1,2,13],state:5,still:6,stop:11,storag:5,store:[5,11],straight:1,string:[0,1],struct:[0,1],struggl:5,subscrib:1,subscript:1,subscriptionnam:13,subsystem:5,support:[1,11,12],sure:[1,5],system:[1,6,13],take:[1,2,13],team:[3,11],tend:11,testnet:11,than:[1,6,11],thankfulli:2,thei:[1,13],thi:[1,2,5,11,13],thing:5,those:11,though:[2,11],thought:5,three:2,through:[2,3],time:[1,2],todai:6,todo:[3,10,13,14],total:[5,13],touch:6,trace:1,tracerresult:1,tracex:1,track:5,transact:[1,5],transform:5,tutori:[2,6],two:[1,2],type:[0,1,2,6],uint64:1,understand:5,unexpect:[1,5],unlik:12,unpredict:1,updat:[5,6,11],upon:[5,13],upstream:[5,6,11],urfav:[0,1],use:[1,2],used:[1,11],useful:[1,2],user:11,using:[1,6],util:[0,1,5,6],valid:1,valu:1,vari:12,variabl:1,varieti:11,veri:1,verif:13,verifi:5,version:[0,1,5],wai:[1,3,6,11,13],want:3,warn:5,websocket:[1,13],well:[2,11],what:4,whatev:6,when:[1,5,11],wherea:13,which:[2,5,11,12,13],whichev:2,why:4,wide:[1,11],window:12,wish:1,within:[1,5],without:[1,11],work:[3,13],world:[0,1,2],would:11,wrapper:11,write:8,written:11,yet:6,you:[1,2,3,5,6,12],your:[1,2,3,13],your_command:1},titles:["Plugin Anatomy","API","Build and Deploy","Get in touch with us","Core vs Restricted packages in Plugeth-utils","Plugin Hooks","PluGeth","PluGeth","Plugin Hooks","Plugin Loader","PluGeth Plugins","Project Design","System Requirements","Basic Types of Plugins","PluGeth Utils"],titleterms:{anatomi:0,api:1,appendanci:5,basic:13,build:2,content:6,core:4,depend:11,deploi:2,design:11,environ:2,flag:1,get:3,getapi:1,getrpccal:5,hook:[5,8],initi:1,initializenod:1,livetrac:1,loader:9,method:13,newhead:5,packag:4,plugeth:[4,6,7,10,11,14],plugin:[0,2,5,8,9,10,11,13],project:11,repositori:11,requir:12,restrict:4,rpc:13,scheme:11,select:5,set:2,stateupd:5,subcommand:[1,13],subscript:13,system:12,tabl:6,three:11,todo:[0,1,4,8,9,11],touch:3,tracer:[1,13],type:13,util:[4,11,14]}})
\ No newline at end of file
diff --git a/documentation/_build/html/system_req.html b/documentation/_build/html/system_req.html
index 6d1f377..e18ab93 100644
--- a/documentation/_build/html/system_req.html
+++ b/documentation/_build/html/system_req.html
@@ -38,7 +38,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -49,7 +48,7 @@
 <ul class="current">
 <li class="toctree-l1 current"><a class="current reference internal" href="#">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/_build/html/types.html b/documentation/_build/html/types.html
index ea39434..0da3ebc 100644
--- a/documentation/_build/html/types.html
+++ b/documentation/_build/html/types.html
@@ -15,7 +15,7 @@
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Plugin Hooks" href="hooks.html" />
+    <link rel="next" title="Plugin Anatomy" href="anatomy.html" />
     <link rel="prev" title="Project Design" href="project.html" /> 
 </head>
 
@@ -44,7 +44,6 @@
 <li class="toctree-l2"><a class="reference internal" href="#subscriptions">Subscriptions</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -55,7 +54,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
@@ -123,7 +122,7 @@
           </div>
           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="project.html" class="btn btn-neutral float-left" title="Project Design" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="hooks.html" class="btn btn-neutral float-right" title="Plugin Hooks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="anatomy.html" class="btn btn-neutral float-right" title="Plugin Anatomy" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/documentation/_build/html/utils.html b/documentation/_build/html/utils.html
index d547ac5..3e167ba 100644
--- a/documentation/_build/html/utils.html
+++ b/documentation/_build/html/utils.html
@@ -36,7 +36,6 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="project.html">Project Design</a></li>
 <li class="toctree-l1"><a class="reference internal" href="types.html">Basic Types of Plugins</a></li>
-<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="anatomy.html">Plugin Anatomy</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Tutorials</span></p>
@@ -47,7 +46,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="system_req.html">System Requirements</a></li>
 <li class="toctree-l1"><a class="reference internal" href="plugin_loader.html">Plugin Loader</a></li>
-<li class="toctree-l1"><a class="reference internal" href="plugin_hooks.html">Plugin Hooks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hooks.html">Plugin Hooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="core_restricted.html">Core vs Restricted packages in Plugeth-utils</a></li>
 <li class="toctree-l1"><a class="reference internal" href="api.html">API</a></li>
 </ul>
diff --git a/documentation/api.rst b/documentation/api.rst
index ef3ee53..4f22e54 100644
--- a/documentation/api.rst
+++ b/documentation/api.rst
@@ -46,7 +46,7 @@ Tracers
 
 .. code-block:: go
 
-   ``// CaptureStart is called at the start of each transaction
+   // CaptureStart is called at the start of each transaction
    CaptureStart(env core.EVM, from core.Address, to core.Address, create bool, input []byte, gas uint64, value *big.Int) {}
    // CaptureState is called for each opcode
    CaptureState(env core.EVM, pc uint64, op core.OpCode, gas, cost uint64, scope *vm.ScopeContext, rData []byte, depth int, err error) {}
@@ -55,12 +55,78 @@ Tracers
    // CaptureEnd is called at the end of each transaction
    CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) {}
    // GetResult should return a JSON serializable result object to respond to the trace call
-   GetResult() (interface{}, error) {}``
+   GetResult() (interface{}, error) {}
 
 
 .. warning:: Modifying the values passed into tracer functions can
              alter the 
-             results of the EVM execution in unpredictable ways. Additonally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference. 
+             results of the EVM execution in unpredictable ways. Additopackage main
+
+import (
+  "github.com/openrelayxyz/plugeth-utils/core"
+  "gopkg.in/urfave/cli.v1"
+)
+
+var (
+  log core.Logger
+)
+
+type myservice struct{}
+
+func (*myservice) Hello() string {
+  return "Hello world"
+}
+
+func Initialize(ctx *cli.Context, loader core.PluginLoader, logger core.Logger) {
+  log = logger
+  log.Info("Initialized hello")
+}
+
+func GetAPIs(node core.Node, backend core.Backend) []core.API {
+  defer log.Info("APIs Initialized")
+  return []core.API{
+    {
+      Namespace: "mynamespace",
+      Version:   "1.0",
+      Service:   &myservice{},
+      Public:    true,
+    },
+  }
+}
+package main
+
+import (
+  "github.com/openrelayxyz/plugeth-utils/core"
+  "gopkg.in/urfave/cli.v1"
+)
+
+var (
+  log core.Logger
+)
+
+type myservice struct{}
+
+func (*myservice) Hello() string {
+  return "Hello world"
+}
+
+func Initialize(ctx *cli.Context, loader core.PluginLoader, logger core.Logger) {
+  log = logger
+  log.Info("Initialized hello")
+}
+
+func GetAPIs(node core.Node, backend core.Backend) []core.API {
+  defer log.Info("APIs Initialized")
+  return []core.API{
+    {
+      Namespace: "mynamespace",
+      Version:   "1.0",
+      Service:   &myservice{},
+      Public:    true,
+    },
+  }
+}
+nally, some objects may be reused acress calls, so data you wish to capture should be copied rather than retianed by reference. 
 
 LiveTracer
 ----------
diff --git a/documentation/hooks.rst b/documentation/hooks.rst
index b7940ee..bbfb876 100644
--- a/documentation/hooks.rst
+++ b/documentation/hooks.rst
@@ -4,4 +4,61 @@
 Plugin Hooks
 ============
 
-.. todo:: discussion of plugin hooks
+The key to understanding a plugin is understanding its corresponding hook. Broadly, plugin hooks can be thought of as functions which deliver a function signiture to the **plugin loader**. The signature matches that of the function(s) called by the plugin and describes the data that is being captured and how the plugin will deliver said data upon invocation. 
+
+The public plugin hook function should follow the naming convention ``Plugin$HookName``. The first argument should be a `` core.PluginLoader``, followed by any arguments required by the functions to be provided by any plugins implementing this hook.
+
+**Public and Private Hook Functions**
+
+Each hook provides both a Public and private version. The private plugin hook function should bear the same name as the public plugin hook function, but with a lower case first letter. The signature should match the public plugin hook function, except that the first argument referencing the PluginLoader should be removed. It should invoke the public plugin hook function on plugins.DefaultPluginLoader. It should always verify that the DefaultPluginLoader is non-nil, log warning and return if the DefaultPluginLoader has not been initialized.
+
+**Invocation**
+
+the private plugin hook function should be invoked, with the appropriate arguments, in a single line within the Geth codebase inorder to minimize unexpected conflicts merging upstream Geth into plugeth.
+
+Selected Hooks
+--------------
+
+
+`StateUpdate`_ 
+************
+
+`Invocation`_
+
+The state update plugin provides a snapshot of the state subsystem in the form of a a stateUpdate object. The stateUpdate object contains all information transformed by a transaction but not the transaction itself. 
+
+Invoked for each new block, StateUpdate provides the changes to the blockchain state. root corresponds to the state root of the new block. parentRoot corresponds to the state root of the parent block. destructs serves as a set of accounts that self-destructed in this block. accounts maps the hash of each account address to the SlimRLP encoding of the account data. storage maps the hash of each account to a map of that account's stored data.
+
+.. warning:: StateUpdate is only called if Geth is running with 
+             ``-snapshots=true``. This is the default behavior for Geth, but if you are explicitly running with ``--snapshot=false`` this function will not be invoked. 
+			
+
+`AppendAncient`_
+*************
+
+Invoked when the freezer moves a block from LevelDB to the ancients database. ``number`` is the number of the block. ``hash`` is the 32 byte hash of the block as a raw ``[]byte``. ``header``, ``body``, and ``receipts`` are the RLP encoded versions of their respective block elements. ``td`` is the byte encoded total difficulty of the block.
+
+`NewHead`_
+**********
+
+Invoked when a new block becomes the canonical latest block. Note that if several blocks are processed in a group (such as during a reorg) this may not be called for each block. You should track the prior latest head if you need to process intermediate blocks.
+
+`GetRPCCalls`_
+************
+
+Invoked when the RPC handler registers a method call. returns the call ``id``, method ``name``, and any ``params`` that may have been passed in.  
+
+
+
+**I am struggling all of assudden with if this is really this best course of action. Giving all of this reference, seems to beg the -utils vs plugeth conversation and I am not sure that is a smart thing to get into.**
+
+
+
+
+
+
+.. _StateUpdate: https://github.com/openrelayxyz/plugeth/blob/develop/core/state/plugin_hooks.go
+.. _Invocation: https://github.com/openrelayxyz/plugeth/blob/develop/core/state/statedb.go#L955
+.. _AppendAncient: https://github.com/openrelayxyz/plugeth/blob/develop/core/rawdb/plugin_hooks.go
+.. _GetRPCCalls: https://github.com/openrelayxyz/plugeth/blob/develop/rpc/plugin_hooks.go
+.. _NewHead: https://github.com/openrelayxyz/plugeth/blob/develop/core/plugin_hooks.go#L108
diff --git a/documentation/index.rst b/documentation/index.rst
index ab2fd8a..ac126ce 100644
--- a/documentation/index.rst
+++ b/documentation/index.rst
@@ -25,7 +25,6 @@ Table of Contents
 
     project
     types
-    hooks
     anatomy
     
 
@@ -41,7 +40,7 @@ Table of Contents
 
     system_req
     plugin_loader
-    plugin_hooks
+    hooks
     core_restricted
     api