{"action":"created","comment":{"url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/comments/37994997","id":37994997,"diff_hunk":"@@ -9,153 +9,199 @@ http://opensource.org/licenses/MIT.\n \n {% autocrossref %}\n \n-Bitcoin Core provides a large number of Remote Procedure Calls (RPCs)\n-using a [HTTP JSON-RPC version 1.0][] interface. Any program can access\n-the RPCs using JSON-RPC, but Bitcoin Core also provides the\n-`bitcoin-cli` command to wrap the JSON-RPC access for Command Line\n-Interface (CLI) users. Most of the RPC examples in this documentation\n-use `bitcoin-cli` for simplicity, so this subsection describes raw\n-JSON-RPC interface and how the command-line interface translates it.\n-\n-In order to start `bitcoind`, you will need to set a password for\n-JSON-RPC in the `bitcoin.conf` file. See the [Examples\n-Page][devexamples] for details. JSON-RPC starts on port 8332 for mainnet\n-and 18332 for testnet and regtest. By default, `bitcoind` doesn't use a\n-JSON-RPC user, but you can set one (see `bitcoind --help`).\n-\n-The interface is not intended for public access and is only accessible\n-from localhost by default.\n-\n-RPCs are made using the standard JSON-RPC 1.0 syntax, which sends several\n-standard arguments:\n+Bitcoin Core provides a remote procedure call (RPC) interface for various\n+administrative tasks, wallet operations, and queries about network and block\n+chain data.\n+\n+If you start Bitcoin Core using `bitcoin-xt`, the RPC interface is disabled by\n+default. To enable it, set `server=1` in `bitcoin.conf` or supply the `-server`\n+argument when invoking the program.\n+\n+If you start Bitcoin Core using `bitcoind`, the RPC interface is enabled by\n+default. To disable it, set `server=0` in `bitcoin.conf`.\n+\n+The interface requires the user to provide a password for authenticating RPC\n+requests. This password can be set either using the `rpcpassword` property in\n+`bitcoin.conf` or by supplying the `-rpcpassword` program argument. Optionally a\n+username can be set using the `rpcuser` configuration value. See the [Examples\n+Page][devexamples] for more information about setting Bitcoin Core configuration\n+values.\n+\n+Open-source client libraries for the RPC interface are readily available in most\n+modern programming languages, so you probably don't need to write your own from\n+scratch. Bitcoin Core also ships with its own compiled C++ RPC client,\n+`bitcoin-cli`, located in the `bin` directory alongside `bitcoind` and\n+`bitcoin-qt`. The `bitcoin-cli` program can be used as a command-line interface\n+(CLI) to Bitcoin Core or for making RPC calls from applications written in\n+languages lacking a suitable native client. The remainder of this section\n+describes the Bitcoin Core RPC protocol in detail.\n+\n+The Bitcoin Core RPC service listens for HTTP `POST` requests on port 8332 in\n+mainnet mode or 18332 in testnet or regtest mode. The port number can be changed\n+by setting `rpcport` in `bitcoin.conf`. By default the RPC service binds to your\n+server's [localhost](https://en.wikipedia.org/wiki/Localhost) loopback\n+network<!--noref--> interface so it's not accessible from other servers.\n+Authentication is implemented using HTTP [basic\n+authentication](https://en.wikipedia.org/wiki/Basic_access_authentication). RPC\n+HTTP requests must include a `Content-Type` header set to `text/plain` and a\n+`Content-Length` header set to the size of the request body.\n+\n+The format of the request body and response data is based on [version 1.0 of the\n+JSON-RPC specification](http://json-rpc<!--noref-->.org/wiki/specification). Specifically,","path":"_includes/ref/bitcoin-core/rpcs/intro.md","position":61,"original_position":61,"commit_id":"9a0f23416861a82c03831e5e60c7df56ba5568bf","original_commit_id":"9a0f23416861a82c03831e5e60c7df56ba5568bf","user":{"login":"carnesen","id":5756743,"avatar_url":"https://avatars.githubusercontent.com/u/5756743?v=3","gravatar_id":"","url":"https://api.github.com/users/carnesen","html_url":"https://github.com/carnesen","followers_url":"https://api.github.com/users/carnesen/followers","following_url":"https://api.github.com/users/carnesen/following{/other_user}","gists_url":"https://api.github.com/users/carnesen/gists{/gist_id}","starred_url":"https://api.github.com/users/carnesen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carnesen/subscriptions","organizations_url":"https://api.github.com/users/carnesen/orgs","repos_url":"https://api.github.com/users/carnesen/repos","events_url":"https://api.github.com/users/carnesen/events{/privacy}","received_events_url":"https://api.github.com/users/carnesen/received_events","type":"User","site_admin":false},"body":"Roger that. Replaced all []()-style links with external [][]-style ones.","created_at":"2015-08-26T15:20:57Z","updated_at":"2015-08-26T15:20:57Z","html_url":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030#discussion_r37994997","pull_request_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030","_links":{"self":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/comments/37994997"},"html":{"href":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030#discussion_r37994997"},"pull_request":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030"}}},"pull_request":{"url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030","id":43355790,"html_url":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030","diff_url":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030.diff","patch_url":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030.patch","issue_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/1030","number":1030,"state":"open","locked":false,"title":"Polish and expand Bitcoin Core RPC interface intro in developer reference","user":{"login":"carnesen","id":5756743,"avatar_url":"https://avatars.githubusercontent.com/u/5756743?v=3","gravatar_id":"","url":"https://api.github.com/users/carnesen","html_url":"https://github.com/carnesen","followers_url":"https://api.github.com/users/carnesen/followers","following_url":"https://api.github.com/users/carnesen/following{/other_user}","gists_url":"https://api.github.com/users/carnesen/gists{/gist_id}","starred_url":"https://api.github.com/users/carnesen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carnesen/subscriptions","organizations_url":"https://api.github.com/users/carnesen/orgs","repos_url":"https://api.github.com/users/carnesen/repos","events_url":"https://api.github.com/users/carnesen/events{/privacy}","received_events_url":"https://api.github.com/users/carnesen/received_events","type":"User","site_admin":false},"body":"This PR contains a polished and expanded version of the developer reference section that describes the Bitcoin Core RPC interface. Site tests are passing on my laptop and on [Travis CI](https://travis-ci.org/carnesen/bitcoin.org). A preview of the changes can be found here:\r\n\r\nhttp://bitcoin-dot-org.carnesen.com/en/developer-reference#remote-procedure-calls-rpcs\r\n\r\nFor comparison here's that section on the site currently:\r\n\r\nhttps://bitcoin.org/en/developer-reference#remote-procedure-calls-rpcs\r\n\r\nThe changes in this PR are limited to the RPC interface description up to where the \"Quick Reference\" starts.\r\n\r\nFeedback is welcomed, and I'd be happy to explain why I made any of these changes, just let me know.","created_at":"2015-08-26T01:32:23Z","updated_at":"2015-08-26T15:20:57Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ea6d5a9c54f4940006bf8f252134f3ba45fe4e69","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030/commits","review_comments_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030/comments","review_comment_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/comments{/number}","comments_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/1030/comments","statuses_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/statuses/9a0f23416861a82c03831e5e60c7df56ba5568bf","head":{"label":"carnesen:rpc-batch","ref":"rpc-batch","sha":"9a0f23416861a82c03831e5e60c7df56ba5568bf","user":{"login":"carnesen","id":5756743,"avatar_url":"https://avatars.githubusercontent.com/u/5756743?v=3","gravatar_id":"","url":"https://api.github.com/users/carnesen","html_url":"https://github.com/carnesen","followers_url":"https://api.github.com/users/carnesen/followers","following_url":"https://api.github.com/users/carnesen/following{/other_user}","gists_url":"https://api.github.com/users/carnesen/gists{/gist_id}","starred_url":"https://api.github.com/users/carnesen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carnesen/subscriptions","organizations_url":"https://api.github.com/users/carnesen/orgs","repos_url":"https://api.github.com/users/carnesen/repos","events_url":"https://api.github.com/users/carnesen/events{/privacy}","received_events_url":"https://api.github.com/users/carnesen/received_events","type":"User","site_admin":false},"repo":{"id":41101624,"name":"bitcoin.org","full_name":"carnesen/bitcoin.org","owner":{"login":"carnesen","id":5756743,"avatar_url":"https://avatars.githubusercontent.com/u/5756743?v=3","gravatar_id":"","url":"https://api.github.com/users/carnesen","html_url":"https://github.com/carnesen","followers_url":"https://api.github.com/users/carnesen/followers","following_url":"https://api.github.com/users/carnesen/following{/other_user}","gists_url":"https://api.github.com/users/carnesen/gists{/gist_id}","starred_url":"https://api.github.com/users/carnesen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carnesen/subscriptions","organizations_url":"https://api.github.com/users/carnesen/orgs","repos_url":"https://api.github.com/users/carnesen/repos","events_url":"https://api.github.com/users/carnesen/events{/privacy}","received_events_url":"https://api.github.com/users/carnesen/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/carnesen/bitcoin.org","description":"Bitcoin.org website","fork":true,"url":"https://api.github.com/repos/carnesen/bitcoin.org","forks_url":"https://api.github.com/repos/carnesen/bitcoin.org/forks","keys_url":"https://api.github.com/repos/carnesen/bitcoin.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/carnesen/bitcoin.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/carnesen/bitcoin.org/teams","hooks_url":"https://api.github.com/repos/carnesen/bitcoin.org/hooks","issue_events_url":"https://api.github.com/repos/carnesen/bitcoin.org/issues/events{/number}","events_url":"https://api.github.com/repos/carnesen/bitcoin.org/events","assignees_url":"https://api.github.com/repos/carnesen/bitcoin.org/assignees{/user}","branches_url":"https://api.github.com/repos/carnesen/bitcoin.org/branches{/branch}","tags_url":"https://api.github.com/repos/carnesen/bitcoin.org/tags","blobs_url":"https://api.github.com/repos/carnesen/bitcoin.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/carnesen/bitcoin.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/carnesen/bitcoin.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/carnesen/bitcoin.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/carnesen/bitcoin.org/statuses/{sha}","languages_url":"https://api.github.com/repos/carnesen/bitcoin.org/languages","stargazers_url":"https://api.github.com/repos/carnesen/bitcoin.org/stargazers","contributors_url":"https://api.github.com/repos/carnesen/bitcoin.org/contributors","subscribers_url":"https://api.github.com/repos/carnesen/bitcoin.org/subscribers","subscription_url":"https://api.github.com/repos/carnesen/bitcoin.org/subscription","commits_url":"https://api.github.com/repos/carnesen/bitcoin.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/carnesen/bitcoin.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/carnesen/bitcoin.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/carnesen/bitcoin.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/carnesen/bitcoin.org/contents/{+path}","compare_url":"https://api.github.com/repos/carnesen/bitcoin.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/carnesen/bitcoin.org/merges","archive_url":"https://api.github.com/repos/carnesen/bitcoin.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/carnesen/bitcoin.org/downloads","issues_url":"https://api.github.com/repos/carnesen/bitcoin.org/issues{/number}","pulls_url":"https://api.github.com/repos/carnesen/bitcoin.org/pulls{/number}","milestones_url":"https://api.github.com/repos/carnesen/bitcoin.org/milestones{/number}","notifications_url":"https://api.github.com/repos/carnesen/bitcoin.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/carnesen/bitcoin.org/labels{/name}","releases_url":"https://api.github.com/repos/carnesen/bitcoin.org/releases{/id}","created_at":"2015-08-20T14:52:53Z","updated_at":"2015-08-20T14:52:56Z","pushed_at":"2015-08-26T00:45:48Z","git_url":"git://github.com/carnesen/bitcoin.org.git","ssh_url":"git@github.com:carnesen/bitcoin.org.git","clone_url":"https://github.com/carnesen/bitcoin.org.git","svn_url":"https://github.com/carnesen/bitcoin.org","homepage":"https://bitcoin.org/","size":23032,"stargazers_count":0,"watchers_count":0,"language":"HTML","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":"bitcoin-dot-org:master","ref":"master","sha":"57eabd5e368af2dc435d78f3deb4b638dec44b62","user":{"login":"bitcoin-dot-org","id":12837353,"avatar_url":"https://avatars.githubusercontent.com/u/12837353?v=3","gravatar_id":"","url":"https://api.github.com/users/bitcoin-dot-org","html_url":"https://github.com/bitcoin-dot-org","followers_url":"https://api.github.com/users/bitcoin-dot-org/followers","following_url":"https://api.github.com/users/bitcoin-dot-org/following{/other_user}","gists_url":"https://api.github.com/users/bitcoin-dot-org/gists{/gist_id}","starred_url":"https://api.github.com/users/bitcoin-dot-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitcoin-dot-org/subscriptions","organizations_url":"https://api.github.com/users/bitcoin-dot-org/orgs","repos_url":"https://api.github.com/users/bitcoin-dot-org/repos","events_url":"https://api.github.com/users/bitcoin-dot-org/events{/privacy}","received_events_url":"https://api.github.com/users/bitcoin-dot-org/received_events","type":"Organization","site_admin":false},"repo":{"id":2304420,"name":"bitcoin.org","full_name":"bitcoin-dot-org/bitcoin.org","owner":{"login":"bitcoin-dot-org","id":12837353,"avatar_url":"https://avatars.githubusercontent.com/u/12837353?v=3","gravatar_id":"","url":"https://api.github.com/users/bitcoin-dot-org","html_url":"https://github.com/bitcoin-dot-org","followers_url":"https://api.github.com/users/bitcoin-dot-org/followers","following_url":"https://api.github.com/users/bitcoin-dot-org/following{/other_user}","gists_url":"https://api.github.com/users/bitcoin-dot-org/gists{/gist_id}","starred_url":"https://api.github.com/users/bitcoin-dot-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitcoin-dot-org/subscriptions","organizations_url":"https://api.github.com/users/bitcoin-dot-org/orgs","repos_url":"https://api.github.com/users/bitcoin-dot-org/repos","events_url":"https://api.github.com/users/bitcoin-dot-org/events{/privacy}","received_events_url":"https://api.github.com/users/bitcoin-dot-org/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/bitcoin-dot-org/bitcoin.org","description":"Bitcoin.org website","fork":false,"url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org","forks_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/forks","keys_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/teams","hooks_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/hooks","issue_events_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/events{/number}","events_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/events","assignees_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/assignees{/user}","branches_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/branches{/branch}","tags_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/tags","blobs_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/statuses/{sha}","languages_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/languages","stargazers_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/stargazers","contributors_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/contributors","subscribers_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/subscribers","subscription_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/subscription","commits_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/contents/{+path}","compare_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/merges","archive_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/downloads","issues_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues{/number}","pulls_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls{/number}","milestones_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/milestones{/number}","notifications_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/labels{/name}","releases_url":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/releases{/id}","created_at":"2011-08-31T21:58:01Z","updated_at":"2015-08-25T11:38:45Z","pushed_at":"2015-08-26T01:32:24Z","git_url":"git://github.com/bitcoin-dot-org/bitcoin.org.git","ssh_url":"git@github.com:bitcoin-dot-org/bitcoin.org.git","clone_url":"https://github.com/bitcoin-dot-org/bitcoin.org.git","svn_url":"https://github.com/bitcoin-dot-org/bitcoin.org","homepage":"https://bitcoin.org/","size":34852,"stargazers_count":242,"watchers_count":242,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":388,"mirror_url":null,"open_issues_count":34,"forks":388,"open_issues":34,"watchers":242,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030"},"html":{"href":"https://github.com/bitcoin-dot-org/bitcoin.org/pull/1030"},"issue":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/1030"},"comments":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/issues/1030/comments"},"review_comments":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030/comments"},"review_comment":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/pulls/1030/commits"},"statuses":{"href":"https://api.github.com/repos/bitcoin-dot-org/bitcoin.org/statuses/9a0f23416861a82c03831e5e60c7df56ba5568bf"}}}}