{"id":19175431,"url":"https://github.com/clecap/iuk-blockchain","last_synced_at":"2026-02-26T20:47:51.824Z","repository":{"id":81103959,"uuid":"149741803","full_name":"clecap/iuk-blockchain","owner":"clecap","description":"PoA Blockchain prototype with example scenario (validation of documents)","archived":false,"fork":false,"pushed_at":"2018-07-09T07:58:44.000Z","size":1342,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-04T01:54:28.563Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://wwwiuk.informatik.uni-rostock.de/","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clecap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-21T09:30:13.000Z","updated_at":"2020-05-03T11:53:09.000Z","dependencies_parsed_at":"2023-03-21T12:21:33.351Z","dependency_job_id":null,"html_url":"https://github.com/clecap/iuk-blockchain","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clecap%2Fiuk-blockchain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clecap%2Fiuk-blockchain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clecap%2Fiuk-blockchain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clecap%2Fiuk-blockchain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clecap","download_url":"https://codeload.github.com/clecap/iuk-blockchain/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240254181,"owners_count":19772386,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T10:23:14.295Z","updated_at":"2026-02-26T20:47:46.797Z","avatar_url":"https://github.com/clecap.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Setup of testing environment\n\n## 1. Install Docker and Docker Compose\n\n### Arch Linux\nInstall Docker and Docker Compose from the offical Arch repositories:\n\n```sh\nsudo pacman -S docker docker-compose\n```\n\n### Other Linux distributions\nFollow the instructions from the [offical Docker documentation](https://docs.docker.com/install/) and [offical Docker Compose documentation](https://docs.docker.com/compose/install/) to get the latest Docker version.\n\n## 2. Manage Docker as a non-root user\n\nTo manage Docker containers as a non-root user you must be member of the `docker` group on your system. First create the group using the following command:\n\n```sh\nsudo groupadd docker\n```\n\nTo add yourself to that group, run:\n\n```sh\nsudo useradd -aG docker $USER\n```\n\nThe change will apply the next time you login to your shell.\n\n## 3. Setup Docker containers\nAfter that is done, you have to setup the Docker containers on your system. For that, we use a Docker deploy script provided by [paritytech](https://github.com/paritytech/parity-deploy). Navigate to the `parity-deploy` directory and run the deploy script.\n\n```sh\ncd parity-deploy\n./deploy.sh\n```\n\nThe deploy script creates three nodes with three accounts, each of them a validator of the PoA chain using the [Authority Round](https://wiki.parity.io/Aura) consensus algorithm. The private and public keys can be found in the `deployment` directory.\n\nWhen deployment is done, you can start the Docker containers using following command (it might be necessary to start the Docker service before, e.g. using `systemctl start docker.service`):\n\n```sh\ndocker-compose up -d\n```\n\nTo test your setup, go to [localhost:3001](http://localhost:3001) for a status monitor and [localhost:3002](http://localhost:3002) for the contract web interface. To stop the Docker containers run:\n\n```sh\ndocker-compose stop\n```\n\nTo clean up the testing environment and remove all content you deployed before, simply run the clean script located in the same directory.\n\n```sh\n./clean.sh\n```\n\n## 4. Deployment of the smart contract\n\nTo deploy the smart contract into the blockchain, you need to have Web3 for Python 3 installed. This can be achieved by using the Python package manager pip3:\n\n```sh\npip3 install web3\n```\n\nNext, navigate to the `contracts` directory and create a small helper Docker container which is used to compile the contract. This has to be done only once and can be created with the following command:\n\n```sh\nmake solc\n```\n\nThe output (ABI + binary) of the compilation process will be saved in the `build` directory. To compile the contract, run:\n\n```sh\nmake\n```\n\nOf course the contract still needs to be deployed. The deploy script achieves that with the following command:\n\n```sh\ncd contracts\n ./deploy.py --docker --write --contract=Documents.sol --path=build\n```\n\nAfter successful deployment the Ethereum address of the smart contract is returned. You can get some tokens in your MetaMask wallet by using the send script. It uses one of the validators addresses to send tokens.\n```sh\n./send.sh \u003cyour-wallet-address\u003e \u003camount\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclecap%2Fiuk-blockchain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclecap%2Fiuk-blockchain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclecap%2Fiuk-blockchain/lists"}