diff --git a/docs/auction-state-graph.svg b/docs/auction-state-graph.svg
new file mode 100644
index 0000000..50d287f
--- /dev/null
+++ b/docs/auction-state-graph.svg
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><!-- Generated by graphviz version 2.40.1 (20161225.0304)
+ --><!-- Title: Creator Pages: 1 --><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1049pt" height="75pt" viewBox="0.00 0.00 1049.38 75.20">
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 71.2)">
+<title>Creator</title>
+<polygon fill="#ffffff" stroke="transparent" points="-4,4 -4,-71.2 1045.3757,-71.2 1045.3757,4 -4,4"/>
+<!-- Void In -->
+<g id="node1" class="node">
+<title>Void In</title>
+<polygon fill="none" stroke="#ffa500" points="108,-36 0,-36 0,0 108,0 108,-36"/>
+<text text-anchor="middle" x="54" y="-13.8" font-family="Times,serif" font-size="14.00" fill="#000000">Void In</text>
+</g>
+<!-- NotStarted -->
+<g id="node3" class="node">
+<title>NotStarted</title>
+<polygon fill="none" stroke="#000000" points="339.9516,-36 231.9516,-36 231.9516,0 339.9516,0 339.9516,-36"/>
+<text text-anchor="middle" x="285.9516" y="-13.8" font-family="Times,serif" font-size="14.00" fill="#000000">NotStarted</text>
+</g>
+<!-- Void In&#45;&gt;NotStarted -->
+<g id="edge1" class="edge">
+<title>Void In-&gt;NotStarted</title>
+<path fill="none" stroke="#000000" d="M108.0896,-18C141.9611,-18 185.7924,-18 221.4674,-18"/>
+<polygon fill="#000000" stroke="#000000" points="221.7763,-21.5001 231.7763,-18 221.7762,-14.5001 221.7763,-21.5001"/>
+<text text-anchor="middle" x="169.9758" y="-21.3" font-family="Times,serif" font-size="11.00" fill="#000000">Create (stage Open)</text>
+</g>
+<!-- Void Out -->
+<g id="node2" class="node">
+<title>Void Out</title>
+<polygon fill="none" stroke="#ffa500" points="1041.3757,-36 933.3757,-36 933.3757,0 1041.3757,0 1041.3757,-36"/>
+<text text-anchor="middle" x="987.3757" y="-13.8" font-family="Times,serif" font-size="14.00" fill="#000000">Void Out</text>
+</g>
+<!-- CurrentBid -->
+<g id="node4" class="node">
+<title>CurrentBid</title>
+<polygon fill="none" stroke="#000000" points="563.9733,-36 455.9733,-36 455.9733,0 563.9733,0 563.9733,-36"/>
+<text text-anchor="middle" x="509.9733" y="-13.8" font-family="Times,serif" font-size="14.00" fill="#000000">CurrentBid</text>
+</g>
+<!-- NotStarted&#45;&gt;CurrentBid -->
+<g id="edge2" class="edge">
+<title>NotStarted-&gt;CurrentBid</title>
+<path fill="none" stroke="#000000" d="M340.181,-18C371.9834,-18 412.3434,-18 445.7339,-18"/>
+<polygon fill="#000000" stroke="#000000" points="445.8555,-21.5001 455.8555,-18 445.8555,-14.5001 445.8555,-21.5001"/>
+<text text-anchor="middle" x="397.9625" y="-21.3" font-family="Times,serif" font-size="11.00" fill="#000000">Start (stage Open)</text>
+</g>
+<!-- CurrentBid&#45;&gt;CurrentBid -->
+<g id="edge3" class="edge">
+<title>CurrentBid-&gt;CurrentBid</title>
+<path fill="none" stroke="#000000" d="M489.7116,-36.1527C486.5944,-45.5391 493.3483,-54 509.9733,-54 520.1042,-54 526.5695,-50.8581 529.3693,-46.2796"/>
+<polygon fill="#000000" stroke="#000000" points="532.8705,-46.4145 530.235,-36.1527 525.8959,-45.8182 532.8705,-46.4145"/>
+<text text-anchor="middle" x="509.9733" y="-57.3" font-family="Times,serif" font-size="11.00" fill="#000000">MakeBid (stage Open)</text>
+</g>
+<!-- Winner -->
+<g id="node5" class="node">
+<title>Winner</title>
+<polygon fill="none" stroke="#000000" points="799.0049,-36 691.0049,-36 691.0049,0 799.0049,0 799.0049,-36"/>
+<text text-anchor="middle" x="745.0049" y="-13.8" font-family="Times,serif" font-size="14.00" fill="#000000">Winner</text>
+</g>
+<!-- CurrentBid&#45;&gt;Winner -->
+<g id="edge4" class="edge">
+<title>CurrentBid-&gt;Winner</title>
+<path fill="none" stroke="#000000" d="M564.1894,-18C598.8862,-18 644.0765,-18 680.5993,-18"/>
+<polygon fill="#000000" stroke="#000000" points="680.6549,-21.5001 690.6549,-18 680.6549,-14.5001 680.6549,-21.5001"/>
+<text text-anchor="middle" x="627.4891" y="-21.3" font-family="Times,serif" font-size="11.00" fill="#000000">Close (stage Closed)</text>
+</g>
+<!-- Winner&#45;&gt;Void Out -->
+<g id="edge5" class="edge">
+<title>Winner-&gt;Void Out</title>
+<path fill="none" stroke="#000000" d="M799.096,-18C835.7244,-18 884.294,-18 922.9278,-18"/>
+<polygon fill="#000000" stroke="#000000" points="923.0313,-21.5001 933.0313,-18 923.0313,-14.5001 923.0313,-21.5001"/>
+<text text-anchor="middle" x="866.1903" y="-21.3" font-family="Times,serif" font-size="11.00" fill="#000000">Buyout (stage Closed)</text>
+</g>
+</g>
+</svg>
\ No newline at end of file
diff --git a/docs/catalyst_milestone_reports.md b/docs/catalyst_milestone_reports.md
index ab692f3..220498b 100644
--- a/docs/catalyst_milestone_reports.md
+++ b/docs/catalyst_milestone_reports.md
@@ -14,7 +14,7 @@ Changes:
 
 ## State graph examples
 
-![](./auction-state-graph.png)
+![](./auction-state-graph.svg)
 
 
 Source code: