{"action":"created","comment":{"url":"https://api.github.com/repos/trustlines-network/relay/pulls/comments/204320705","pull_request_review_id":139377357,"id":204320705,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIwNDMyMDcwNQ==","diff_hunk":"@@ -0,0 +1,240 @@\n+# Running the trustlines system\n+\n+This document tries to explain how to run your own [trustlines\n+network](https://trustlines.network/). We will walk you through setting up a\n+relay server and all the dependent components. We assume you're using a debian\n+based linux system, though installation should also work on other kinds of\n+linux.\n+\n+If you're impatient, you may jump to the description of the [docker-compose\n+based setup](#docker-compose-based-setup).\n+\n+## Components\n+\n+This section describes, which components are involved and how to install them on\n+an ubuntu based system. The components are implemented in python 3 and we need\n+to prepare the system components in order to install those. The following\n+command should be enough to do this for an ubuntu based system.\n+\n+```\n+sudo apt install build-essential python3-dev python3-venv pkg-config \\\n+     libssl-dev automake autoconf libtool libgraphviz-dev git libpq-dev\n+```\n+\n+The installation instructions assume you create a dedicated user account and put\n+files directly into the users home directory. The paths should be adapted to\n+your needs.\n+\n+### parity/geth\n+\n+You need to run a parity or geth node, which provides the JSONRPC API to the\n+relay server and the indexer. At the moment we recommend using parity together\n+with the kovan chain.\n+\n+Please follow the [official documentation](https://wiki.parity.io/Setup) in\n+order to install parity. Paritytech provides [binary\n+releases](https://github.com/paritytech/parity-ethereum/releases). If you're\n+running ubuntu, the following command allows you to install parity:\n+\n+```\n+curl -O https://releases.parity.io/v1.11.7/x86_64-unknown-linux-gnu/parity_1.11.7_ubuntu_amd64.deb\n+sudo dpkg -i parity_1.11.7_ubuntu_amd64.deb\n+```\n+\n+The relay server needs an unlocked account. Therefore, make sure you're not\n+exposing the JSONRPC endpoint. By default parity listens on the local interface\n+for new connections, so any user with a login on the machine could also access\n+the JSONRPC endpoint.\n+\n+<!-- XXX Explain how to create an account -->\n+\n+The following command line starts parity with the kovan chain. Please adapt the\n+--author, --unlock and --password arguments\n+\n+```\n+parity --no-warp --auto-update none --no-download --chain kovan \\\n+    --author 0x987654321 --unlock 0x987654321 --password /path/to/password-file \\\n+    --jsonrpc-hosts all\n+```\n+\n+One command line option we like to highlight is the `--no-warp` option. If you\n+don't specify this option, parity will enable 'Warp Synchronization'. Warp\n+synchronization allows for a faster synchronization, but the relay server will\n+not work reliably with warp synchronization turned on. The [offical\n+documentation](https://wiki.parity.io/Getting-Synced#warp-synchronization)\n+contains a description of the behaviour that is problematic:\n+\n+> Note, at present, snapshotting does not place all of the block or receipt data\n+> into the database. This means you will not get information relating to\n+> transactions more than a few days old.\n+\n+So, please double check that warp synchronization is turned off when using\n+parity. The whole trustlines system may appear to work, but will give wrong\n+results if you run with warp mode enabled.\n+\n+### contracts\n+The [trustlines-contracts\n+repository](https://github.com/trustlines-network/contracts) contains the\n+solidity contracts to be deployed on the blockchain. The ('how to deploy the\n+contracts guide')[] <!-- XXX --> contains more information on how to deploy the\n+contracts. We assume from now on that the contracts have already been deployed\n+and that the `addresses.json` file has been copied to the users home directory.","path":"docs/RelayServer.md","position":81,"original_position":81,"commit_id":"3bebd6d47add46ac43f4406bb7ff2fca0f7e0d47","original_commit_id":"3bebd6d47add46ac43f4406bb7ff2fca0f7e0d47","user":{"login":"schmir","id":40620,"node_id":"MDQ6VXNlcjQwNjIw","avatar_url":"https://avatars3.githubusercontent.com/u/40620?v=4","gravatar_id":"","url":"https://api.github.com/users/schmir","html_url":"https://github.com/schmir","followers_url":"https://api.github.com/users/schmir/followers","following_url":"https://api.github.com/users/schmir/following{/other_user}","gists_url":"https://api.github.com/users/schmir/gists{/gist_id}","starred_url":"https://api.github.com/users/schmir/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/schmir/subscriptions","organizations_url":"https://api.github.com/users/schmir/orgs","repos_url":"https://api.github.com/users/schmir/repos","events_url":"https://api.github.com/users/schmir/events{/privacy}","received_events_url":"https://api.github.com/users/schmir/received_events","type":"User","site_admin":false},"body":"Can you please write a short description then? I haven't read the documentation for the contract deployment CLI tools yet.","created_at":"2018-07-23T08:34:24Z","updated_at":"2018-07-23T08:34:25Z","html_url":"https://github.com/trustlines-network/relay/pull/148#discussion_r204320705","pull_request_url":"https://api.github.com/repos/trustlines-network/relay/pulls/148","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/comments/204320705"},"html":{"href":"https://github.com/trustlines-network/relay/pull/148#discussion_r204320705"},"pull_request":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/148"}},"in_reply_to_id":204253310},"pull_request":{"url":"https://api.github.com/repos/trustlines-network/relay/pulls/148","id":202816969,"node_id":"MDExOlB1bGxSZXF1ZXN0MjAyODE2OTY5","html_url":"https://github.com/trustlines-network/relay/pull/148","diff_url":"https://github.com/trustlines-network/relay/pull/148.diff","patch_url":"https://github.com/trustlines-network/relay/pull/148.patch","issue_url":"https://api.github.com/repos/trustlines-network/relay/issues/148","number":148,"state":"open","locked":false,"title":"Documentation/how to run relay server","user":{"login":"schmir","id":40620,"node_id":"MDQ6VXNlcjQwNjIw","avatar_url":"https://avatars3.githubusercontent.com/u/40620?v=4","gravatar_id":"","url":"https://api.github.com/users/schmir","html_url":"https://github.com/schmir","followers_url":"https://api.github.com/users/schmir/followers","following_url":"https://api.github.com/users/schmir/following{/other_user}","gists_url":"https://api.github.com/users/schmir/gists{/gist_id}","starred_url":"https://api.github.com/users/schmir/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/schmir/subscriptions","organizations_url":"https://api.github.com/users/schmir/orgs","repos_url":"https://api.github.com/users/schmir/repos","events_url":"https://api.github.com/users/schmir/events{/privacy}","received_events_url":"https://api.github.com/users/schmir/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-07-20T11:03:18Z","updated_at":"2018-07-23T08:34:25Z","closed_at":null,"merged_at":null,"merge_commit_sha":"18711239b626fcea349bf9fd66e907b7ced54aff","assignee":null,"assignees":[],"requested_reviewers":[{"login":"seichris","id":25006584,"node_id":"MDQ6VXNlcjI1MDA2NTg0","avatar_url":"https://avatars0.githubusercontent.com/u/25006584?v=4","gravatar_id":"","url":"https://api.github.com/users/seichris","html_url":"https://github.com/seichris","followers_url":"https://api.github.com/users/seichris/followers","following_url":"https://api.github.com/users/seichris/following{/other_user}","gists_url":"https://api.github.com/users/seichris/gists{/gist_id}","starred_url":"https://api.github.com/users/seichris/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/seichris/subscriptions","organizations_url":"https://api.github.com/users/seichris/orgs","repos_url":"https://api.github.com/users/seichris/repos","events_url":"https://api.github.com/users/seichris/events{/privacy}","received_events_url":"https://api.github.com/users/seichris/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/trustlines-network/relay/pulls/148/commits","review_comments_url":"https://api.github.com/repos/trustlines-network/relay/pulls/148/comments","review_comment_url":"https://api.github.com/repos/trustlines-network/relay/pulls/comments{/number}","comments_url":"https://api.github.com/repos/trustlines-network/relay/issues/148/comments","statuses_url":"https://api.github.com/repos/trustlines-network/relay/statuses/3bebd6d47add46ac43f4406bb7ff2fca0f7e0d47","head":{"label":"trustlines-network:documentation/how-to-run-relay-server","ref":"documentation/how-to-run-relay-server","sha":"3bebd6d47add46ac43f4406bb7ff2fca0f7e0d47","user":{"login":"trustlines-network","id":23054928,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzMDU0OTI4","avatar_url":"https://avatars2.githubusercontent.com/u/23054928?v=4","gravatar_id":"","url":"https://api.github.com/users/trustlines-network","html_url":"https://github.com/trustlines-network","followers_url":"https://api.github.com/users/trustlines-network/followers","following_url":"https://api.github.com/users/trustlines-network/following{/other_user}","gists_url":"https://api.github.com/users/trustlines-network/gists{/gist_id}","starred_url":"https://api.github.com/users/trustlines-network/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/trustlines-network/subscriptions","organizations_url":"https://api.github.com/users/trustlines-network/orgs","repos_url":"https://api.github.com/users/trustlines-network/repos","events_url":"https://api.github.com/users/trustlines-network/events{/privacy}","received_events_url":"https://api.github.com/users/trustlines-network/received_events","type":"Organization","site_admin":false},"repo":{"id":94525601,"node_id":"MDEwOlJlcG9zaXRvcnk5NDUyNTYwMQ==","name":"relay","full_name":"trustlines-network/relay","owner":{"login":"trustlines-network","id":23054928,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzMDU0OTI4","avatar_url":"https://avatars2.githubusercontent.com/u/23054928?v=4","gravatar_id":"","url":"https://api.github.com/users/trustlines-network","html_url":"https://github.com/trustlines-network","followers_url":"https://api.github.com/users/trustlines-network/followers","following_url":"https://api.github.com/users/trustlines-network/following{/other_user}","gists_url":"https://api.github.com/users/trustlines-network/gists{/gist_id}","starred_url":"https://api.github.com/users/trustlines-network/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/trustlines-network/subscriptions","organizations_url":"https://api.github.com/users/trustlines-network/orgs","repos_url":"https://api.github.com/users/trustlines-network/repos","events_url":"https://api.github.com/users/trustlines-network/events{/privacy}","received_events_url":"https://api.github.com/users/trustlines-network/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/trustlines-network/relay","description":null,"fork":false,"url":"https://api.github.com/repos/trustlines-network/relay","forks_url":"https://api.github.com/repos/trustlines-network/relay/forks","keys_url":"https://api.github.com/repos/trustlines-network/relay/keys{/key_id}","collaborators_url":"https://api.github.com/repos/trustlines-network/relay/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/trustlines-network/relay/teams","hooks_url":"https://api.github.com/repos/trustlines-network/relay/hooks","issue_events_url":"https://api.github.com/repos/trustlines-network/relay/issues/events{/number}","events_url":"https://api.github.com/repos/trustlines-network/relay/events","assignees_url":"https://api.github.com/repos/trustlines-network/relay/assignees{/user}","branches_url":"https://api.github.com/repos/trustlines-network/relay/branches{/branch}","tags_url":"https://api.github.com/repos/trustlines-network/relay/tags","blobs_url":"https://api.github.com/repos/trustlines-network/relay/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/trustlines-network/relay/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/trustlines-network/relay/git/refs{/sha}","trees_url":"https://api.github.com/repos/trustlines-network/relay/git/trees{/sha}","statuses_url":"https://api.github.com/repos/trustlines-network/relay/statuses/{sha}","languages_url":"https://api.github.com/repos/trustlines-network/relay/languages","stargazers_url":"https://api.github.com/repos/trustlines-network/relay/stargazers","contributors_url":"https://api.github.com/repos/trustlines-network/relay/contributors","subscribers_url":"https://api.github.com/repos/trustlines-network/relay/subscribers","subscription_url":"https://api.github.com/repos/trustlines-network/relay/subscription","commits_url":"https://api.github.com/repos/trustlines-network/relay/commits{/sha}","git_commits_url":"https://api.github.com/repos/trustlines-network/relay/git/commits{/sha}","comments_url":"https://api.github.com/repos/trustlines-network/relay/comments{/number}","issue_comment_url":"https://api.github.com/repos/trustlines-network/relay/issues/comments{/number}","contents_url":"https://api.github.com/repos/trustlines-network/relay/contents/{+path}","compare_url":"https://api.github.com/repos/trustlines-network/relay/compare/{base}...{head}","merges_url":"https://api.github.com/repos/trustlines-network/relay/merges","archive_url":"https://api.github.com/repos/trustlines-network/relay/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/trustlines-network/relay/downloads","issues_url":"https://api.github.com/repos/trustlines-network/relay/issues{/number}","pulls_url":"https://api.github.com/repos/trustlines-network/relay/pulls{/number}","milestones_url":"https://api.github.com/repos/trustlines-network/relay/milestones{/number}","notifications_url":"https://api.github.com/repos/trustlines-network/relay/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/trustlines-network/relay/labels{/name}","releases_url":"https://api.github.com/repos/trustlines-network/relay/releases{/id}","deployments_url":"https://api.github.com/repos/trustlines-network/relay/deployments","created_at":"2017-06-16T08:58:02Z","updated_at":"2018-07-19T14:46:07Z","pushed_at":"2018-07-23T06:32:46Z","git_url":"git://github.com/trustlines-network/relay.git","ssh_url":"git@github.com:trustlines-network/relay.git","clone_url":"https://github.com/trustlines-network/relay.git","svn_url":"https://github.com/trustlines-network/relay","homepage":null,"size":484,"stargazers_count":4,"watchers_count":4,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":31,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":1,"open_issues":31,"watchers":4,"default_branch":"develop"}},"base":{"label":"trustlines-network:develop","ref":"develop","sha":"056df5685efff9eb43995492fd82c1db7e019193","user":{"login":"trustlines-network","id":23054928,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzMDU0OTI4","avatar_url":"https://avatars2.githubusercontent.com/u/23054928?v=4","gravatar_id":"","url":"https://api.github.com/users/trustlines-network","html_url":"https://github.com/trustlines-network","followers_url":"https://api.github.com/users/trustlines-network/followers","following_url":"https://api.github.com/users/trustlines-network/following{/other_user}","gists_url":"https://api.github.com/users/trustlines-network/gists{/gist_id}","starred_url":"https://api.github.com/users/trustlines-network/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/trustlines-network/subscriptions","organizations_url":"https://api.github.com/users/trustlines-network/orgs","repos_url":"https://api.github.com/users/trustlines-network/repos","events_url":"https://api.github.com/users/trustlines-network/events{/privacy}","received_events_url":"https://api.github.com/users/trustlines-network/received_events","type":"Organization","site_admin":false},"repo":{"id":94525601,"node_id":"MDEwOlJlcG9zaXRvcnk5NDUyNTYwMQ==","name":"relay","full_name":"trustlines-network/relay","owner":{"login":"trustlines-network","id":23054928,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzMDU0OTI4","avatar_url":"https://avatars2.githubusercontent.com/u/23054928?v=4","gravatar_id":"","url":"https://api.github.com/users/trustlines-network","html_url":"https://github.com/trustlines-network","followers_url":"https://api.github.com/users/trustlines-network/followers","following_url":"https://api.github.com/users/trustlines-network/following{/other_user}","gists_url":"https://api.github.com/users/trustlines-network/gists{/gist_id}","starred_url":"https://api.github.com/users/trustlines-network/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/trustlines-network/subscriptions","organizations_url":"https://api.github.com/users/trustlines-network/orgs","repos_url":"https://api.github.com/users/trustlines-network/repos","events_url":"https://api.github.com/users/trustlines-network/events{/privacy}","received_events_url":"https://api.github.com/users/trustlines-network/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/trustlines-network/relay","description":null,"fork":false,"url":"https://api.github.com/repos/trustlines-network/relay","forks_url":"https://api.github.com/repos/trustlines-network/relay/forks","keys_url":"https://api.github.com/repos/trustlines-network/relay/keys{/key_id}","collaborators_url":"https://api.github.com/repos/trustlines-network/relay/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/trustlines-network/relay/teams","hooks_url":"https://api.github.com/repos/trustlines-network/relay/hooks","issue_events_url":"https://api.github.com/repos/trustlines-network/relay/issues/events{/number}","events_url":"https://api.github.com/repos/trustlines-network/relay/events","assignees_url":"https://api.github.com/repos/trustlines-network/relay/assignees{/user}","branches_url":"https://api.github.com/repos/trustlines-network/relay/branches{/branch}","tags_url":"https://api.github.com/repos/trustlines-network/relay/tags","blobs_url":"https://api.github.com/repos/trustlines-network/relay/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/trustlines-network/relay/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/trustlines-network/relay/git/refs{/sha}","trees_url":"https://api.github.com/repos/trustlines-network/relay/git/trees{/sha}","statuses_url":"https://api.github.com/repos/trustlines-network/relay/statuses/{sha}","languages_url":"https://api.github.com/repos/trustlines-network/relay/languages","stargazers_url":"https://api.github.com/repos/trustlines-network/relay/stargazers","contributors_url":"https://api.github.com/repos/trustlines-network/relay/contributors","subscribers_url":"https://api.github.com/repos/trustlines-network/relay/subscribers","subscription_url":"https://api.github.com/repos/trustlines-network/relay/subscription","commits_url":"https://api.github.com/repos/trustlines-network/relay/commits{/sha}","git_commits_url":"https://api.github.com/repos/trustlines-network/relay/git/commits{/sha}","comments_url":"https://api.github.com/repos/trustlines-network/relay/comments{/number}","issue_comment_url":"https://api.github.com/repos/trustlines-network/relay/issues/comments{/number}","contents_url":"https://api.github.com/repos/trustlines-network/relay/contents/{+path}","compare_url":"https://api.github.com/repos/trustlines-network/relay/compare/{base}...{head}","merges_url":"https://api.github.com/repos/trustlines-network/relay/merges","archive_url":"https://api.github.com/repos/trustlines-network/relay/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/trustlines-network/relay/downloads","issues_url":"https://api.github.com/repos/trustlines-network/relay/issues{/number}","pulls_url":"https://api.github.com/repos/trustlines-network/relay/pulls{/number}","milestones_url":"https://api.github.com/repos/trustlines-network/relay/milestones{/number}","notifications_url":"https://api.github.com/repos/trustlines-network/relay/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/trustlines-network/relay/labels{/name}","releases_url":"https://api.github.com/repos/trustlines-network/relay/releases{/id}","deployments_url":"https://api.github.com/repos/trustlines-network/relay/deployments","created_at":"2017-06-16T08:58:02Z","updated_at":"2018-07-19T14:46:07Z","pushed_at":"2018-07-23T06:32:46Z","git_url":"git://github.com/trustlines-network/relay.git","ssh_url":"git@github.com:trustlines-network/relay.git","clone_url":"https://github.com/trustlines-network/relay.git","svn_url":"https://github.com/trustlines-network/relay","homepage":null,"size":484,"stargazers_count":4,"watchers_count":4,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":31,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":1,"open_issues":31,"watchers":4,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/148"},"html":{"href":"https://github.com/trustlines-network/relay/pull/148"},"issue":{"href":"https://api.github.com/repos/trustlines-network/relay/issues/148"},"comments":{"href":"https://api.github.com/repos/trustlines-network/relay/issues/148/comments"},"review_comments":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/148/comments"},"review_comment":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/trustlines-network/relay/pulls/148/commits"},"statuses":{"href":"https://api.github.com/repos/trustlines-network/relay/statuses/3bebd6d47add46ac43f4406bb7ff2fca0f7e0d47"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"schmir"}}