diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..62c8935
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.idea/
\ No newline at end of file
diff --git a/DATABASE:vulcanize_db.uml b/DATABASE:vulcanize_db.uml
new file mode 100644
index 0000000..ec1d5fc
--- /dev/null
+++ b/DATABASE:vulcanize_db.uml
@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Diagram>
+  <ID>DATABASE</ID>
+  <OriginalElement>dc912b10-14b3-4867-846a-478eff9acca5.DATABASE:vulcanize_db</OriginalElement>
+  <nodes>
+    <node x="400.90178571428567" y="938.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.receipt_cids</node>
+    <node x="466.4508928571429" y="676.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.uncle_cids</node>
+    <node x="52.5" y="0.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.nodes</node>
+    <node x="702.4508928571429" y="1015.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_accounts</node>
+    <node x="290.4508928571429" y="654.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.transaction_cids</node>
+    <node x="151.5" y="216.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids</node>
+    <node x="698.9508928571429" y="665.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_cids</node>
+    <node x="908.4508928571429" y="993.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.storage_cids</node>
+    <node x="1162.450892857143" y="0.0">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.goose_db_version</node>
+    <node x="543.3258928571429" y="44.5">dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks</node>
+  </nodes>
+  <notes />
+  <edges>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.receipt_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="51.00000000000006" y="-160.0" />
+      <point x="553.9017857142858" y="912.0" />
+      <point x="659.9508928571429" y="912.0" />
+      <point x="659.9508928571429" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.transaction_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="-39.0" y="-116.0" />
+      <point x="329.4508928571429" y="633.0" />
+      <point x="345.0" y="633.0" />
+      <point x="345.0" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.uncle_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids" relationship="REFERENCES">
+      <point x="-45.75" y="-94.0" />
+      <point x="512.2008928571429" y="633.0" />
+      <point x="541.90625" y="633.0" />
+      <point x="541.90625" y="623.0" />
+      <point x="243.0" y="623.0" />
+      <point x="0.0" y="193.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="48.25" y="-105.0" />
+      <point x="843.7008928571429" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.storage_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="52.25" y="-105.0" />
+      <point x="1065.200892857143" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids" relationship="REFERENCES">
+      <point x="-48.25" y="-105.0" />
+      <point x="747.2008928571429" y="633.0" />
+      <point x="541.90625" y="633.0" />
+      <point x="541.90625" y="623.0" />
+      <point x="243.0" y="623.0" />
+      <point x="0.0" y="193.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.uncle_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="45.75" y="-94.0" />
+      <point x="603.7008928571429" y="623.0" />
+      <point x="552.40625" y="623.0" />
+      <point x="552.40625" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.storage_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_cids" relationship="REFERENCES">
+      <point x="-52.25" y="-105.0" />
+      <point x="960.7008928571429" y="912.0" />
+      <point x="795.4508928571429" y="912.0" />
+      <point x="0.0" y="105.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.transaction_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids" relationship="REFERENCES">
+      <point x="39.0" y="-116.0" />
+      <point x="407.4508928571429" y="633.0" />
+      <point x="541.90625" y="633.0" />
+      <point x="541.90625" y="623.0" />
+      <point x="243.0" y="623.0" />
+      <point x="0.0" y="193.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.nodes" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.nodes" relationship="REFERENCES">
+      <point x="-48.25" y="83.0" />
+      <point x="100.75" y="150.1329394387001" />
+      <point x="66.47932053175776" y="150.1329394387001" />
+      <point x="66.47932053175776" y="83.0" />
+      <point x="-96.5" y="-0.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.nodes" relationship="REFERENCES">
+      <point x="-45.75" y="-193.0" />
+      <point x="48.25" y="83.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.receipt_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.transaction_cids" relationship="REFERENCES">
+      <point x="-50.99999999999994" y="-160.0" />
+      <point x="451.9017857142858" y="912.0" />
+      <point x="368.4508928571429" y="912.0" />
+      <point x="0.0" y="116.0" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.header_cids" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.public.blocks" relationship="REFERENCES">
+      <point x="45.75" y="-193.0" />
+      <point x="288.75" y="196.0" />
+      <point x="591.3258928571429" y="196.0" />
+      <point x="0.0" y="38.5" />
+    </edge>
+    <edge source="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_accounts" target="dc912b10-14b3-4867-846a-478eff9acca5.TABLE:vulcanize_db.eth.state_cids" relationship="REFERENCES">
+      <point x="0.0" y="-83.0" />
+      <point x="0.0" y="105.0" />
+    </edge>
+  </edges>
+  <settings layout="Hierarchic" zoom="0.5219737856592136" showDependencies="false" x="691.0" y="619.5" />
+  <SelectedNodes />
+  <Categories>
+    <Category>Columns</Category>
+    <Category>Key columns</Category>
+    <Category>Virtual foreign keys</Category>
+  </Categories>
+</Diagram>
+
diff --git a/README.md b/README.md
index a1abff5..755ffe4 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,5 @@
 # ipld-eth-db
 Schemas and utils for IPLD ETH Postgres database
+
+## Database UML
+![](vulcanize_db.png)
\ No newline at end of file
diff --git a/vulcanize_db.png b/vulcanize_db.png
new file mode 100644
index 0000000..d359a4e
Binary files /dev/null and b/vulcanize_db.png differ