Commit graph

43 commits

Author SHA1 Message Date
David A. Harding
18c2c8dd9f
Add Warning About Handling Private Keys To Transaction Examples 2014-06-10 22:09:48 -04:00
David A. Harding
ba1a33e712
Merge remote-tracking branch 'bitcoin.org/master' into generatingtxes
Conflicts:
	_includes/references.md
2014-06-09 14:04:23 -04:00
David A. Harding
fe16cd7781
Clarification Of PaymentRequestss And Payment Verification
* Clarify a few places where payment request was used instead of
  PaymentRequest.

* Clarify that payment isn't necessarily verified until the merchant
  says so. Suggested by @saivann (thanks!)
2014-06-09 13:44:23 -04:00
David A. Harding
74be6424de
Merge remote-tracking branches 'saivann/generatingtxesbips', 'saivann/generatingtxesresource' and 'saivann/generatingtxestypos' into generatingtxes 2014-06-09 13:23:35 -04:00
David A. Harding
63e838fa8c
Small fixes suggested by @saivann (thanks!) 2014-06-09 13:15:35 -04:00
Saivann
dcb4be8e9b Add BIP71 and BIP72 to autocrossref links 2014-06-08 23:21:26 -04:00
Saivann
0cb0a999f6 Fix various typos or naming inconsistencies 2014-06-08 23:17:04 -04:00
Saivann
f456462265 Move Gavin's Payment Request Generator to the "Examples" page 2014-06-08 23:02:39 -04:00
David A. Harding
abf8ac25d6
Add Note About Tx Fees To All Createrawtransaction Example Calls
Based on feedback from @saivann, this may help remind users that poor
use of createrawtransactions can cost them satoshis.
2014-06-08 19:16:09 -04:00
David A. Harding
96bc22b40c
Add Tx Malleability Warning To Spending Unconfirmed Tx Example
Suggested and written by @saivann, with a revised version being
commited here. Thanks!
2014-06-08 18:53:37 -04:00
David A. Harding
87e31affba
Add Subsection About Wallet Programs, Incl. Hardware Wallets
Describe the essential functions of a wallet program and how multiple
programs can work together to fulfill those functions, as in the case of
a signing-only wallet.
2014-06-07 19:27:49 -04:00
David A. Harding
61f0931b75
Updates Based On Feedback From Mailing List
* Remove the QR Code error corrections subsection.

* Remove the non-example Payment Protocol text from developer examples.

* Update reference links and autocrossrefs to reflect above deletions

* Fix CSS padding problems reported by @saivann

* Remove all HTML comments from autocrossref text to allow easy checking
  for broken link definitions: find _site -name '*.html' | xargs grep '\]\['

* Add PNG versions of guide and example SVG icons.  (optipng run)
2014-06-06 18:46:32 -04:00
David A. Harding
617213a980
Add Disclaimer & Anchor Affordance To Dev Examples 2014-06-02 13:07:27 -04:00
David A. Harding
78b4c5452e
Merge remote-tracking branch 'bitcoin.org/master' into generatingtxes
Conflicts:
	_includes/guide_payment_processing.md
	_less/screen.less
2014-06-02 11:40:38 -04:00
David A. Harding
2e2b0968e7
Add Icons; Update Links
* Add new icons for Developer Guide and Developer Examples so we don't
  keep reusing the book icon.

* Update payment protocol links to point to developer examples when
  appropriate.
2014-06-02 11:30:53 -04:00
David A. Harding
7e8e52b966
Move BIP70 Example To Dev Examples
* Move the extened BIP70 example from the guide to the developer
  examples page.

* Add new text introducing BIP70 to the guide
2014-06-01 20:12:31 -04:00
David A. Harding
4ee31f7347
Merge remote-tracking branch 'origin/standardtxes' 2014-06-01 09:46:12 -04:00
David A. Harding
183afa76c4
Terminology And Key Pool Fixes
Two minor changes suggested by iwilcox on IRC (thanks!):

* s/brute-force find/brute-force/ in HD wallet section

* Correct mistaken assertion that the keypool isn't refreshed until all
  keys are used. If the wallet is unencrypted or unlocked, the keypool
  is refreshed after each time a key is used.
2014-06-01 03:18:50 -04:00
David A. Harding
b55fae9451
Standard Tx Modifications
* Remove contentious sentence about mining non-standard txes possibly
  creating orphaned blocks and loss of block reward.  Suggested by
  @luke-jr (thanks!)

* Remove unnecessary value judgement ("unfortunately") against
  non-standard redeemScripts. Mention that they can be used deliberately
  by someone who wants to easily receive payment to a non-standard
  output script. Suggested by @luke-jr (thanks!)
2014-05-31 10:51:40 -04:00
David A. Harding
f33ea7196a
The "Why" For Standard Transactions, Plus Std Tx Tweaks
Based on a discussion tonight on IRC with comments from @gmaxwell,
bitcoin428, and kadoban.

* Add a new introduction to the Standard Transaction section which
  explains the purpose behind standard transactions so readers
  understand that these aren't limitations for limitation's sake. More
  specifically, note that bug-prevention isn't the only reason for
  standard transactions---thanks to @gmaxwell for explaining the forward
  compatablity reason to me.

* Make it clear that isStandard() only applies to loose transactions and
  that it doesn't apply to txes in blocks.  Thanks to bitcoin428 for
  pointing out this source of confusion.

* Make it cleare that a non-standard redeemScript is a script that would
  not pass isStandard().  Thanks to kadoban for pointing out the absense
  of that information.
2014-05-30 23:18:17 -04:00
David A. Harding
d1b4b08729
Add Developer Examples; Transaction Tutorial
* Add new Developer Examples page

* Add a transaction tutorial describing in detail how to make various
  different transactions.

* Add a new "multicode" CSS class to allow combination of consecutive
  code blocks into a single code block. This lets us use pygments
  highlighting for multiple different types of code within the same
  aparent block of code.

* Get autocrossref to ignore code blocks so we don't need to endcrossref
  every time we encounter a code block. This makes the source much more
  readable and maintainable.
2014-05-29 23:19:57 -04:00
David A. Harding
7595014dd2
Minor Additions: Payment Req Generator & 210,000 Block Halving
Two unrelated minor additions which were requested at nearly the same
time.

* @mikehearn requested we add a link to @gavinandresen's PaymentRequest
  generator. Added to _includes/guide_payment_processing.md with link
  definition in _includes/references.md

* @Burrito-Bazooka requested we mention that the block reward halves
  every 210,000 blocks. Added to _includes/ref_block_chain.md
2014-05-26 21:25:52 -04:00
Mike Gogulski
7cc1f2d0f5 Remove unnecessary value judgment about laundries 2014-05-25 17:08:46 +02:00
David A. Harding
f022b19a50
Update Info About Minimum Fees
* Correct misinformation about the dust limit. Reported by @dbilitch and
  confirmed by @gmaxwell. Thanks!

* Drop reported minimum relay fee from 10,000 to 1,000 satoshis.
2014-05-24 23:50:10 -04:00
David A. Harding
32c8d59f7a
s/getmininginformation/getmininginfo/ 2014-05-23 09:42:27 -04:00
Saivann
6c9cf4f860 Mention that coinbase is the first transaction in a block in "Block Chain" subsection 2014-05-21 23:26:38 -04:00
David A. Harding
68cd5b6ff9
Several Corrections & Clarifications Suggested On IRC
**Suggested by @cbeams:**

_includes/ref_block_chain.md:

    * Mention that coinbase is the first transaction in a block.

**Suggested by @gmaxwell:**

_includes/ref_core_rpcs-abcdefg.md:

    * Mention that you need to unlock your wallet when you run out of
      keys in the keypool.

    * Remove erroneous assertion that txindex=1 would allow
      `getreceivedbyaddress` to check balances of addresses not
      belonging to this wallet.

_includes/ref_transactions.md:

    * Clarify that OP_RETURN scripts aren't usually executed because
      they always return false.

en/developer-reference.md

    * Add a warning about using block chain or mempool data in
      executable context.
2014-05-21 23:08:57 -04:00
David A. Harding
cb5b2206b1
Make Clearer The Benefits Of Hardened Keys And The Absence Of A Master PubKey
As suggested by @gmaxwell (thanks!), I tried to make clearer the benefit
of hardened keys:

* Described hardened keys as a solution in the first sentence of the
  Hardened Keys subsection.

* Reordered the text so that the problem is described before the
  solution, making the presence of a solution clearer.

* Added a prefatory sentence to the description of the two key
  derivation formulas again describing the hardened formula as a
  solution.

As suggested by @vbuterin (thanks!), I added a paragraph describing that
HD wallets don't use normal derivation on the master key so they don't
have an effective master public key. (See end of the diff.)

This is a fairly large diff because of the reordering, but no new
clauses were added besides those described above.
2014-05-20 10:15:23 -04:00
David A. Harding
e21d527523
Fix Formula For Normal HD Key Derivation; Mention Ancestor Key Risk
_includes/guide_wallets.md:

* Fix formula given for normal child key derivation to state that public
  keys must also be provided to the HMAC hash function. This required
  updating both text and images.

* Add one-paragraph warning about ancestor key compromise when the
  ancestor extended public key is compromised along with a descended
  private key.  Update img/dev/en-hd-private-parent-to-private-child.*
  to help illustrate this warning.

en/developer-reference.md:

* Remove %include% of previously-removed file which caused new versions
  of Jekyll to die.
2014-05-17 14:34:28 -04:00
David A. Harding
f59afd8803 Fix Off-By-One Error In HD Wallet Section
Discovered by /u/lifeboatz on Reddit.  Thanks!
2014-05-14 08:48:52 -04:00
Saivann
c7eed3e444 Replace P2PH by P2PKH in devel-docs 2014-05-14 00:21:00 -04:00
David A. Harding
70d871d43e Merge pull request #395 from harding/docsupdate-sigsecurity
Devel Docs: Add Comparison-Based Attacks To Reasons Not To Reuse Keys
2014-05-13 09:12:47 -04:00
David A. Harding
1885c15ba3 Mention Side-Channel Attacks In Addition To Lack-Of-Entropy Attacks 2014-05-11 13:46:03 -04:00
David A. Harding
cc2105debc Add Comparison-Based Attacks To Reasons Not To Reuse Keys
_includes/guide_transactions.md:

* Expand the security part of the Avoiding Key Reuse subsection to also
  describe why creating more than one signature with the same private
  key might be a problem. Based on feedback from @luke-jr. Thanks!
2014-05-11 10:34:43 -04:00
David A. Harding
c59b8e0621 Remove Assertion That Pay-To-Pubkey (Unhashed) Still Used In Coinbase Txes
_includes/guide_transactions.md:

* Assertions that pay-to-public-key (unhashed) was "used in all coinbase
  transactions" and "is more convenient" have been removed: the first
  statement because its provably untrue; the second because it's debatable
  (spending unhashed keys requires fewer bytes, so it might be more
  convenient).  Based on feedback from @TierNolan.  Thanks!
2014-05-11 08:49:05 -04:00
David A. Harding
c1d491ed39 Small Changes To Devel Doc Based On Comments By @luke-jr & @mikehearn
_includes/guide_transactions.md:

* DOS expanded to "denial of service" to improve readability and avoid
  conflation with Disk Operating System. Change based on feedback from
  @luke-jr. Thanks!

_includes/guide_mining.md:

* Dropped assertion that `getblocktemplate` can't reuse an established
  socket. Change based on feedback from @luke-jr. Thanks!

_includes/guide_contracts.md:

* Dropped opening sentences to Contracts section, which were a holdover
  from when contracts was a subsection of Transactions. New opening
  sentence is now similar to the summary sentences which open all other
  sections. Change based on feedback from @mikehearn. Thanks!

* Deleted USA-centric example from second paragraph and merged remaining
  parts of the first two paragraphs into a single opening paragraph with
  no example. Change based on feedback from @mikehearn. Thanks!

* Removed mention of placeholder byte from multisig example. Change
  based on feedback from @mikehearn. Thanks!
2014-05-11 07:27:57 -04:00
David Harding
ffde087f02 Contributions by @harding to devel docs
Thanks also (in alphabetical order) to @cbeams, @mikehearn, and
@tgeller, among others.

The last pre-squash commit was: c2b8d562aa107c7b68c60946cea14cdccc5159ad
2014-05-09 22:13:59 -04:00
instagibbs
82378ddcb4 Contributions by @instagibbs to devel docs
Thanks also (in alphabetical order) to @cbeams, @mikehearn, and
@tgeller, among others.

The last pre-squash commit was: c2b8d562aa107c7b68c60946cea14cdccc5159ad
2014-05-09 22:13:59 -04:00
saivann
46780d3177 Contributions by @saivann to devel docs
Thanks also (in alphabetical order) to @cbeams, @mikehearn, and
@tgeller, among others.

The last pre-squash commit was: c2b8d562aa107c7b68c60946cea14cdccc5159ad
2014-05-09 22:13:59 -04:00
Saivann
2718222c9b new bitcoin.org
implement multilanguage
new improved clients list page
update history and statistics in the "about" page
add "Some things you need to know" page
add "Support Bitcoin" page
add a contextual presentation for each category of users (individuals, organizations, developers and enthusiasts)
add a short and concise "how it works" page
add a "vocabulary" page for Bitcoin technical words definitions
give more visibility for the foundation
new website design and layout
2013-03-18 14:29:59 -04:00
Nils Schneider
5e114f37d6 split content into subpages 2011-09-16 20:39:09 +02:00
Nils Schneider
b70774cee9 use absolute path for logo image 2011-09-16 20:37:12 +02:00
Nils Schneider
4f7ddd71c5 initial framework for subpage navigation 2011-09-16 20:37:12 +02:00