diff --git a/documentation/_build/doctrees/anatomy.doctree b/documentation/_build/doctrees/anatomy.doctree
index 104446d..51bb4a3 100644
Binary files a/documentation/_build/doctrees/anatomy.doctree and b/documentation/_build/doctrees/anatomy.doctree differ
diff --git a/documentation/_build/doctrees/api.doctree b/documentation/_build/doctrees/api.doctree
index e629ad5..9ff3d2e 100644
Binary files a/documentation/_build/doctrees/api.doctree and b/documentation/_build/doctrees/api.doctree differ
diff --git a/documentation/_build/doctrees/environment.pickle b/documentation/_build/doctrees/environment.pickle
index 707ce2b..3817f71 100644
Binary files a/documentation/_build/doctrees/environment.pickle and b/documentation/_build/doctrees/environment.pickle differ
diff --git a/documentation/_build/doctrees/hooks.doctree b/documentation/_build/doctrees/hooks.doctree
index 40190bb..6fb2806 100644
Binary files a/documentation/_build/doctrees/hooks.doctree and b/documentation/_build/doctrees/hooks.doctree differ
diff --git a/documentation/_build/doctrees/index.doctree b/documentation/_build/doctrees/index.doctree
index 1c460c2..f5c617f 100644
Binary files a/documentation/_build/doctrees/index.doctree and b/documentation/_build/doctrees/index.doctree differ
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 @@
-
+
@@ -38,7 +38,6 @@