diff --git a/doc/order-state.drawio b/doc/order-state.drawio
deleted file mode 100644
index 1702a66..0000000
--- a/doc/order-state.drawio
+++ /dev/null
@@ -1,48 +0,0 @@
-<mxfile host="Electron" modified="2023-11-23T20:12:34.263Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/22.0.2 Chrome/114.0.5735.289 Electron/25.8.4 Safari/537.36" etag="sl0d1yKhzwqwWJ6eMTjx" version="22.0.2" type="device">
-  <diagram id="C5RBs43oDa-KdzZeNtuy" name="Page-1">
-    <mxGraphModel dx="1421" dy="816" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
-      <root>
-        <mxCell id="WIyWlLk6GJQsqaUBKTNV-0" />
-        <mxCell id="WIyWlLk6GJQsqaUBKTNV-1" parent="WIyWlLk6GJQsqaUBKTNV-0" />
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="PvtzbSBCiLpv-i50fqkV-0" target="PvtzbSBCiLpv-i50fqkV-2">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-17" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="PvtzbSBCiLpv-i50fqkV-0" target="PvtzbSBCiLpv-i50fqkV-8">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-0" value="Wait" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="260" y="360" width="80" height="80" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-1" value="Storage Usage Order State Map" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="215" y="50" width="150" height="30" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-2" value="Cancelled" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="470" y="360" width="80" height="80" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-13" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="PvtzbSBCiLpv-i50fqkV-8" target="PvtzbSBCiLpv-i50fqkV-12">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-15" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="PvtzbSBCiLpv-i50fqkV-8" target="PvtzbSBCiLpv-i50fqkV-14">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-18" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="PvtzbSBCiLpv-i50fqkV-8" target="PvtzbSBCiLpv-i50fqkV-2">
-          <mxGeometry relative="1" as="geometry">
-            <Array as="points">
-              <mxPoint x="600" y="545" />
-              <mxPoint x="600" y="400" />
-            </Array>
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-8" value="Active" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="260" y="505" width="80" height="80" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-12" value="End" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="260" y="680" width="80" height="80" as="geometry" />
-        </mxCell>
-        <mxCell id="PvtzbSBCiLpv-i50fqkV-14" value="Challenge&lt;br&gt;Success" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
-          <mxGeometry x="70" y="505" width="80" height="80" as="geometry" />
-        </mxCell>
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>
diff --git a/doc/order-state.md b/doc/order-state.md
new file mode 100644
index 0000000..c0f8380
--- /dev/null
+++ b/doc/order-state.md
@@ -0,0 +1,13 @@
+```mermaid
+stateDiagram-v2
+    [*] --> Wait
+    Wait --> Active
+    Active --> End
+    Wait --> Cancelled
+    Active --> ChallengeSuccess
+    Cancelled --> [*]
+    End --> [*]
+    ChallengeSuccess --> [*]
+
+```
+