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