{"action":"created","comment":{"url":"https://api.github.com/repos/hexpm/specifications/pulls/comments/57800843","id":57800843,"diff_hunk":"@@ -22,3 +22,128 @@ The package tarball contains the following files:\n         checksum = sha256(contents)\n         final_result = hex_encode(checksum)\n \n+\n+## Deterministic Archives\n+\n+The idea of \"deterministic\" or \"reproducible\" archives is to empower anyone to\n+verify that no flaws have been introduced during the publishing or download\n+phase by reproducing byte-for-byte identical Hex packages from a given source\n+tree.\n+\n+Archives (both package tarball and contents.tar.gz) should be compressed in a\n+deterministic way. That means, given a package directory, two independent\n+packagers can verify that the source directory was the same by comparing\n+checksums of the archives.\n+\n+### Motivation\n+\n+With reproducible archives, users can declare exact checksums of their\n+dependencies, and be sure on what they are depending on. This allows:\n+\n+1. If package dependencies are declared with a checksum besides name and\n+   version, mirrors of hex.pm no longer need to be trusted not to modify the\n+   packages. Even more, any distribution channel does not need to be trusted.\n+2. If the original tarball is lost ([precedent in npm in early 2016][1]), it\n+   can be byte-for-byte reconstructed from the source tree, with assurance it\n+   is exactly the same as before.","path":"package_tarball.md","position":27,"original_position":27,"commit_id":"ea75dd0a5d94d060ab2d1063e51bc56b0c10c9fd","original_commit_id":"ea75dd0a5d94d060ab2d1063e51bc56b0c10c9fd","user":{"login":"talentdeficit","id":4431,"avatar_url":"https://avatars.githubusercontent.com/u/4431?v=3","gravatar_id":"","url":"https://api.github.com/users/talentdeficit","html_url":"https://github.com/talentdeficit","followers_url":"https://api.github.com/users/talentdeficit/followers","following_url":"https://api.github.com/users/talentdeficit/following{/other_user}","gists_url":"https://api.github.com/users/talentdeficit/gists{/gist_id}","starred_url":"https://api.github.com/users/talentdeficit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/talentdeficit/subscriptions","organizations_url":"https://api.github.com/users/talentdeficit/orgs","repos_url":"https://api.github.com/users/talentdeficit/repos","events_url":"https://api.github.com/users/talentdeficit/events{/privacy}","received_events_url":"https://api.github.com/users/talentdeficit/received_events","type":"User","site_admin":false},"body":"this just allows packagers to verify their new package is identical to their old one, it doesn't actually provide any sort of tooling to verify which versions of input artifacts should be used, right?","created_at":"2016-03-29T21:07:41Z","updated_at":"2016-03-29T21:07:41Z","html_url":"https://github.com/hexpm/specifications/pull/4#discussion_r57800843","pull_request_url":"https://api.github.com/repos/hexpm/specifications/pulls/4","_links":{"self":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/comments/57800843"},"html":{"href":"https://github.com/hexpm/specifications/pull/4#discussion_r57800843"},"pull_request":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/4"}}},"pull_request":{"url":"https://api.github.com/repos/hexpm/specifications/pulls/4","id":64426664,"html_url":"https://github.com/hexpm/specifications/pull/4","diff_url":"https://github.com/hexpm/specifications/pull/4.diff","patch_url":"https://github.com/hexpm/specifications/pull/4.patch","issue_url":"https://api.github.com/repos/hexpm/specifications/issues/4","number":4,"state":"open","locked":false,"title":"reproducible archives spec","user":{"login":"Motiejus","id":107720,"avatar_url":"https://avatars.githubusercontent.com/u/107720?v=3","gravatar_id":"","url":"https://api.github.com/users/Motiejus","html_url":"https://github.com/Motiejus","followers_url":"https://api.github.com/users/Motiejus/followers","following_url":"https://api.github.com/users/Motiejus/following{/other_user}","gists_url":"https://api.github.com/users/Motiejus/gists{/gist_id}","starred_url":"https://api.github.com/users/Motiejus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Motiejus/subscriptions","organizations_url":"https://api.github.com/users/Motiejus/orgs","repos_url":"https://api.github.com/users/Motiejus/repos","events_url":"https://api.github.com/users/Motiejus/events{/privacy}","received_events_url":"https://api.github.com/users/Motiejus/received_events","type":"User","site_admin":false},"body":"Proposal for reproducible archives. Initially discussed here: https://github.com/erlang/rebar3/issues/1136","created_at":"2016-03-29T07:58:46Z","updated_at":"2016-03-29T21:07:41Z","closed_at":null,"merged_at":null,"merge_commit_sha":"21ba955ecfe13f6f3e138e0e7158cae8a06a8a5a","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/hexpm/specifications/pulls/4/commits","review_comments_url":"https://api.github.com/repos/hexpm/specifications/pulls/4/comments","review_comment_url":"https://api.github.com/repos/hexpm/specifications/pulls/comments{/number}","comments_url":"https://api.github.com/repos/hexpm/specifications/issues/4/comments","statuses_url":"https://api.github.com/repos/hexpm/specifications/statuses/ea75dd0a5d94d060ab2d1063e51bc56b0c10c9fd","head":{"label":"Motiejus:reproducible_archives","ref":"reproducible_archives","sha":"ea75dd0a5d94d060ab2d1063e51bc56b0c10c9fd","user":{"login":"Motiejus","id":107720,"avatar_url":"https://avatars.githubusercontent.com/u/107720?v=3","gravatar_id":"","url":"https://api.github.com/users/Motiejus","html_url":"https://github.com/Motiejus","followers_url":"https://api.github.com/users/Motiejus/followers","following_url":"https://api.github.com/users/Motiejus/following{/other_user}","gists_url":"https://api.github.com/users/Motiejus/gists{/gist_id}","starred_url":"https://api.github.com/users/Motiejus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Motiejus/subscriptions","organizations_url":"https://api.github.com/users/Motiejus/orgs","repos_url":"https://api.github.com/users/Motiejus/repos","events_url":"https://api.github.com/users/Motiejus/events{/privacy}","received_events_url":"https://api.github.com/users/Motiejus/received_events","type":"User","site_admin":false},"repo":{"id":54956882,"name":"specifications","full_name":"Motiejus/specifications","owner":{"login":"Motiejus","id":107720,"avatar_url":"https://avatars.githubusercontent.com/u/107720?v=3","gravatar_id":"","url":"https://api.github.com/users/Motiejus","html_url":"https://github.com/Motiejus","followers_url":"https://api.github.com/users/Motiejus/followers","following_url":"https://api.github.com/users/Motiejus/following{/other_user}","gists_url":"https://api.github.com/users/Motiejus/gists{/gist_id}","starred_url":"https://api.github.com/users/Motiejus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Motiejus/subscriptions","organizations_url":"https://api.github.com/users/Motiejus/orgs","repos_url":"https://api.github.com/users/Motiejus/repos","events_url":"https://api.github.com/users/Motiejus/events{/privacy}","received_events_url":"https://api.github.com/users/Motiejus/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/Motiejus/specifications","description":"Specifications for using and implementing Hex protocols","fork":true,"url":"https://api.github.com/repos/Motiejus/specifications","forks_url":"https://api.github.com/repos/Motiejus/specifications/forks","keys_url":"https://api.github.com/repos/Motiejus/specifications/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Motiejus/specifications/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Motiejus/specifications/teams","hooks_url":"https://api.github.com/repos/Motiejus/specifications/hooks","issue_events_url":"https://api.github.com/repos/Motiejus/specifications/issues/events{/number}","events_url":"https://api.github.com/repos/Motiejus/specifications/events","assignees_url":"https://api.github.com/repos/Motiejus/specifications/assignees{/user}","branches_url":"https://api.github.com/repos/Motiejus/specifications/branches{/branch}","tags_url":"https://api.github.com/repos/Motiejus/specifications/tags","blobs_url":"https://api.github.com/repos/Motiejus/specifications/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Motiejus/specifications/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Motiejus/specifications/git/refs{/sha}","trees_url":"https://api.github.com/repos/Motiejus/specifications/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Motiejus/specifications/statuses/{sha}","languages_url":"https://api.github.com/repos/Motiejus/specifications/languages","stargazers_url":"https://api.github.com/repos/Motiejus/specifications/stargazers","contributors_url":"https://api.github.com/repos/Motiejus/specifications/contributors","subscribers_url":"https://api.github.com/repos/Motiejus/specifications/subscribers","subscription_url":"https://api.github.com/repos/Motiejus/specifications/subscription","commits_url":"https://api.github.com/repos/Motiejus/specifications/commits{/sha}","git_commits_url":"https://api.github.com/repos/Motiejus/specifications/git/commits{/sha}","comments_url":"https://api.github.com/repos/Motiejus/specifications/comments{/number}","issue_comment_url":"https://api.github.com/repos/Motiejus/specifications/issues/comments{/number}","contents_url":"https://api.github.com/repos/Motiejus/specifications/contents/{+path}","compare_url":"https://api.github.com/repos/Motiejus/specifications/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Motiejus/specifications/merges","archive_url":"https://api.github.com/repos/Motiejus/specifications/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Motiejus/specifications/downloads","issues_url":"https://api.github.com/repos/Motiejus/specifications/issues{/number}","pulls_url":"https://api.github.com/repos/Motiejus/specifications/pulls{/number}","milestones_url":"https://api.github.com/repos/Motiejus/specifications/milestones{/number}","notifications_url":"https://api.github.com/repos/Motiejus/specifications/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Motiejus/specifications/labels{/name}","releases_url":"https://api.github.com/repos/Motiejus/specifications/releases{/id}","deployments_url":"https://api.github.com/repos/Motiejus/specifications/deployments","created_at":"2016-03-29T07:56:03Z","updated_at":"2016-03-29T07:56:03Z","pushed_at":"2016-03-29T15:53:31Z","git_url":"git://github.com/Motiejus/specifications.git","ssh_url":"git@github.com:Motiejus/specifications.git","clone_url":"https://github.com/Motiejus/specifications.git","svn_url":"https://github.com/Motiejus/specifications","homepage":null,"size":22,"stargazers_count":0,"watchers_count":0,"language":"API Blueprint","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"hexpm:master","ref":"master","sha":"4cde450d3de2d062563f8eb6c7789d4497f27c91","user":{"login":"hexpm","id":6621265,"avatar_url":"https://avatars.githubusercontent.com/u/6621265?v=3","gravatar_id":"","url":"https://api.github.com/users/hexpm","html_url":"https://github.com/hexpm","followers_url":"https://api.github.com/users/hexpm/followers","following_url":"https://api.github.com/users/hexpm/following{/other_user}","gists_url":"https://api.github.com/users/hexpm/gists{/gist_id}","starred_url":"https://api.github.com/users/hexpm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hexpm/subscriptions","organizations_url":"https://api.github.com/users/hexpm/orgs","repos_url":"https://api.github.com/users/hexpm/repos","events_url":"https://api.github.com/users/hexpm/events{/privacy}","received_events_url":"https://api.github.com/users/hexpm/received_events","type":"Organization","site_admin":false},"repo":{"id":47819085,"name":"specifications","full_name":"hexpm/specifications","owner":{"login":"hexpm","id":6621265,"avatar_url":"https://avatars.githubusercontent.com/u/6621265?v=3","gravatar_id":"","url":"https://api.github.com/users/hexpm","html_url":"https://github.com/hexpm","followers_url":"https://api.github.com/users/hexpm/followers","following_url":"https://api.github.com/users/hexpm/following{/other_user}","gists_url":"https://api.github.com/users/hexpm/gists{/gist_id}","starred_url":"https://api.github.com/users/hexpm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hexpm/subscriptions","organizations_url":"https://api.github.com/users/hexpm/orgs","repos_url":"https://api.github.com/users/hexpm/repos","events_url":"https://api.github.com/users/hexpm/events{/privacy}","received_events_url":"https://api.github.com/users/hexpm/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/hexpm/specifications","description":"Specifications for using and implementing Hex protocols","fork":false,"url":"https://api.github.com/repos/hexpm/specifications","forks_url":"https://api.github.com/repos/hexpm/specifications/forks","keys_url":"https://api.github.com/repos/hexpm/specifications/keys{/key_id}","collaborators_url":"https://api.github.com/repos/hexpm/specifications/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/hexpm/specifications/teams","hooks_url":"https://api.github.com/repos/hexpm/specifications/hooks","issue_events_url":"https://api.github.com/repos/hexpm/specifications/issues/events{/number}","events_url":"https://api.github.com/repos/hexpm/specifications/events","assignees_url":"https://api.github.com/repos/hexpm/specifications/assignees{/user}","branches_url":"https://api.github.com/repos/hexpm/specifications/branches{/branch}","tags_url":"https://api.github.com/repos/hexpm/specifications/tags","blobs_url":"https://api.github.com/repos/hexpm/specifications/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/hexpm/specifications/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/hexpm/specifications/git/refs{/sha}","trees_url":"https://api.github.com/repos/hexpm/specifications/git/trees{/sha}","statuses_url":"https://api.github.com/repos/hexpm/specifications/statuses/{sha}","languages_url":"https://api.github.com/repos/hexpm/specifications/languages","stargazers_url":"https://api.github.com/repos/hexpm/specifications/stargazers","contributors_url":"https://api.github.com/repos/hexpm/specifications/contributors","subscribers_url":"https://api.github.com/repos/hexpm/specifications/subscribers","subscription_url":"https://api.github.com/repos/hexpm/specifications/subscription","commits_url":"https://api.github.com/repos/hexpm/specifications/commits{/sha}","git_commits_url":"https://api.github.com/repos/hexpm/specifications/git/commits{/sha}","comments_url":"https://api.github.com/repos/hexpm/specifications/comments{/number}","issue_comment_url":"https://api.github.com/repos/hexpm/specifications/issues/comments{/number}","contents_url":"https://api.github.com/repos/hexpm/specifications/contents/{+path}","compare_url":"https://api.github.com/repos/hexpm/specifications/compare/{base}...{head}","merges_url":"https://api.github.com/repos/hexpm/specifications/merges","archive_url":"https://api.github.com/repos/hexpm/specifications/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/hexpm/specifications/downloads","issues_url":"https://api.github.com/repos/hexpm/specifications/issues{/number}","pulls_url":"https://api.github.com/repos/hexpm/specifications/pulls{/number}","milestones_url":"https://api.github.com/repos/hexpm/specifications/milestones{/number}","notifications_url":"https://api.github.com/repos/hexpm/specifications/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/hexpm/specifications/labels{/name}","releases_url":"https://api.github.com/repos/hexpm/specifications/releases{/id}","deployments_url":"https://api.github.com/repos/hexpm/specifications/deployments","created_at":"2015-12-11T10:02:08Z","updated_at":"2016-03-04T03:14:35Z","pushed_at":"2016-03-29T15:53:32Z","git_url":"git://github.com/hexpm/specifications.git","ssh_url":"git@github.com:hexpm/specifications.git","clone_url":"https://github.com/hexpm/specifications.git","svn_url":"https://github.com/hexpm/specifications","homepage":null,"size":20,"stargazers_count":2,"watchers_count":2,"language":"API Blueprint","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"open_issues_count":2,"forks":2,"open_issues":2,"watchers":2,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/4"},"html":{"href":"https://github.com/hexpm/specifications/pull/4"},"issue":{"href":"https://api.github.com/repos/hexpm/specifications/issues/4"},"comments":{"href":"https://api.github.com/repos/hexpm/specifications/issues/4/comments"},"review_comments":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/4/comments"},"review_comment":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/hexpm/specifications/pulls/4/commits"},"statuses":{"href":"https://api.github.com/repos/hexpm/specifications/statuses/ea75dd0a5d94d060ab2d1063e51bc56b0c10c9fd"}}}}