diff --git a/README.md b/README.md
index 50cbc35..8a08bb1 100644
--- a/README.md
+++ b/README.md
@@ -5,23 +5,20 @@
Build your own EVM tools for Ubuntu.
-
-
-| [
Bryan Black](https://github.com/reelsense/)
[📖](https://github.com/stationgroup/ansible-experiments/commits?author=reelsense) |
-| :---: |
-
-
-
+## [Progress](https://gitlab.com/shopglue/ziion-tools/-/issues/1) 👷♂️
## Initialization
```bash
- ansible-galaxy install -r roles/requirements.yml
+git clone https://gitlab.com/shopglue/ziion-tools.git
+cd ziion-tools/ansible
+ansible-galaxy install -r roles/requirements.yml
```
## Requirements
-`ansible`
+- Ansible
+- Ubuntu _20.04_ Desktop **target**
## Role Variables
@@ -69,6 +66,30 @@ Build your own EVM tools for Ubuntu.
- geth
```
+## Known Issues
+
+- Existing Halborn installation and build process is still unknown. So setting up an ubuntu host to run the playbook on isn't documented, and is up to you!
+- [sol2uml broken dependency on amd64 and completely broken on arm64](https://gitlab.com/shopglue/ziion-tools/-/issues/7)
+- [manticore missing arm64 arch](https://gitlab.com/shopglue/ziion-tools/-/issues/5)
+- [mythril missing arm64 arch](https://gitlab.com/shopglue/ziion-tools/-/issues/5)
+- [ganache missing arm64 arch pre `7.1.0`](https://gitlab.com/shopglue/ziion-tools/-/issues/6)
+- [RemixIDE investigating arm64](https://gitlab.com/shopglue/ziion-tools/-/issues/2)
+- Desktop integration of RemixIDE is absent.
+
+## [CONTRIBUTORS](https://gitlab.com/shopglue/ziion-tools/-/blob/main/CONTRIBUTING.md)
+
+Thanks to the people that crowdfunded the EVM tools role for Ziion OS.
+
+>http://63dqiumxtf36fkwfavshs5aontqo4ekkc7f54uefkuhhynufbzin6jqd.onion/apps/3jJjoNDCydWNQZdaM9AfXhMqS2vF/crowdfund
+>
+>This is an Onion address on the private web. Use TOR to access.
+
+
+| [
Bryan Black](https://github.com/reelsense/)
[📖](https://github.com/stationgroup/ansible-experiments/commits?author=reelsense) |
+| :---: |
+
+
+
## License
This project is under the MIT License.
diff --git a/ansible/plays/evm-tools.yml b/ansible/plays/evm-tools.yml
index 9989d0a..757229a 100644
--- a/ansible/plays/evm-tools.yml
+++ b/ansible/plays/evm-tools.yml
@@ -13,8 +13,11 @@
- truffle
- solc
- solc-select
+ - slither
- brownie
- manticore
- mythril
- ganache
- remix
+ - geth
+ - sol2uml #BROKEN a little on x86 and completely on ARM https://gitlab.com/shopglue/ziion-tools/-/issues/7
diff --git a/ansible/roles/eth-security-toolbox/tasks/install-via-docker.yml b/ansible/roles/eth-security-toolbox/tasks/install-via-docker.yml
new file mode 100644
index 0000000..b9dd106
--- /dev/null
+++ b/ansible/roles/eth-security-toolbox/tasks/install-via-docker.yml
@@ -0,0 +1,7 @@
+- name: Create manticore
+ community.docker.docker_container:
+ name: eth-security-toolbox
+ image: trailofbits/eth-security-toolbox
+ state: started
+ restart: true
+
diff --git a/ansible/roles/eth-security-toolbox/tasks/main.yml b/ansible/roles/eth-security-toolbox/tasks/main.yml
new file mode 100644
index 0000000..c776226
--- /dev/null
+++ b/ansible/roles/eth-security-toolbox/tasks/main.yml
@@ -0,0 +1,3 @@
+---
+- import_tasks: install-via-docker.yml
+ tags: install-via-docker
diff --git a/ansible/roles/geth/tasks/main.yml b/ansible/roles/geth/tasks/main.yml
new file mode 100644
index 0000000..0037496
--- /dev/null
+++ b/ansible/roles/geth/tasks/main.yml
@@ -0,0 +1,14 @@
+---
+- name: add apt ppa required for geth
+ apt_repository:
+ repo: 'ppa:ethereum/ethereum'
+
+- name: Install pip3
+ become_user: root
+ become: true
+ apt:
+ state: present
+ update_cache: yes
+ cache_valid_time: 604800
+ pkg:
+ - ethereum
diff --git a/ansible/roles/slither/tasks/install-via-docker.yml b/ansible/roles/slither/tasks/install-via-docker.yml
new file mode 100644
index 0000000..8c9c85b
--- /dev/null
+++ b/ansible/roles/slither/tasks/install-via-docker.yml
@@ -0,0 +1,7 @@
+- name: Create slither
+ community.docker.docker_container:
+ name: slither
+ image: trailofbits/eth-security-toolbox
+ state: started
+ restart: true
+# not going to use it with all the extra baggage
diff --git a/ansible/roles/slither/tasks/install-via-pip.yml b/ansible/roles/slither/tasks/install-via-pip.yml
new file mode 100644
index 0000000..9b40635
--- /dev/null
+++ b/ansible/roles/slither/tasks/install-via-pip.yml
@@ -0,0 +1,4 @@
+- name: Install slither python package
+ ansible.builtin.pip:
+ name: slither-analyzer==0.8.3
+ state: present
diff --git a/ansible/roles/slither/tasks/main.yml b/ansible/roles/slither/tasks/main.yml
new file mode 100644
index 0000000..ed10e0c
--- /dev/null
+++ b/ansible/roles/slither/tasks/main.yml
@@ -0,0 +1,6 @@
+---
+- import_tasks: install-via-pip.yml
+ tags: install-via-pip
+
+#- import_tasks: install-via-docker.yml
+# tags: install-via-docker
diff --git a/ansible/roles/sol2uml/tasks/install-via-npm.yml b/ansible/roles/sol2uml/tasks/install-via-npm.yml
new file mode 100644
index 0000000..15e8dc7
--- /dev/null
+++ b/ansible/roles/sol2uml/tasks/install-via-npm.yml
@@ -0,0 +1,7 @@
+- name: Install sol2uml
+ community.general.npm:
+ name: sol2uml
+ version: '1.1.29'
+ path: /usr/local/sol2uml
+ global: true
+ state: present
diff --git a/ansible/roles/sol2uml/tasks/main.yml b/ansible/roles/sol2uml/tasks/main.yml
new file mode 100644
index 0000000..7d8704f
--- /dev/null
+++ b/ansible/roles/sol2uml/tasks/main.yml
@@ -0,0 +1,7 @@
+---
+#- import_tasks: build-source.yml
+# tags: build-source
+
+- import_tasks: install-via-npm.yml
+ tags: install-via-npm
+# BROKEN viz.js package https://gitlab.com/shopglue/ziion-tools/-/issues/7