/ doc / release-notes / release-notes-0.4.0.md
release-notes-0.4.0.md
 1  Bitcoin version 0.4.0 is now available for download at:
 2  http://sourceforge.net/projects/bitcoin/files/Bitcoin/bitcoin-0.4.0/
 3  
 4  The main feature in this release is wallet private key encryption;
 5  you can set a passphrase that must be entered before sending coins.
 6  See below for more information; if you decide to encrypt your wallet,
 7  WRITE DOWN YOUR PASSPHRASE AND PUT IT IN A SECURE LOCATION. If you
 8  forget or lose your wallet passphrase, you lose your bitcoins.
 9  Previous versions of bitcoin are unable to read encrypted wallets,
10  and will crash on startup if the wallet is encrypted.
11  
12  Also note: bitcoin version 0.4 uses a newer version of Berkeley DB
13  (bdb version 4.8) than previous versions (bdb 4.7). If you upgrade
14  to version 0.4 and then revert back to an earlier version of bitcoin
15  the it may be unable to start because bdb 4.7 cannot read bdb 4.8
16  "log" files.
17  
18  
19  Notable bug fixes from version 0.3.24:
20  
21  Fix several bitcoin-becomes-unresponsive bugs due to multithreading
22  deadlocks.
23  
24  Optimize database writes for large (lots of inputs) transactions
25  (fixes a potential denial-of-service attack)
26  
27  
28  Wallet Encryption
29  
30  Bitcoin supports native wallet encryption so that people who steal your
31  wallet file don't automatically get access to all of your Bitcoins.
32  In order to enable this feature, choose "Encrypt Wallet" from the
33  Options menu.  You will be prompted to enter a passphrase, which
34  will be used as the key to encrypt your wallet and will be needed
35  every time you wish to send Bitcoins.  If you lose this passphrase,
36  you will lose access to spend all of the bitcoins in your wallet,
37  no one, not even the Bitcoin developers can recover your Bitcoins.
38  This means you are responsible for your own security, store your
39  passphrase in a secure location and do not forget it.
40  
41  Remember that the encryption built into bitcoin only encrypts the
42  actual keys which are required to send your bitcoins, not the full
43  wallet.  This means that someone who steals your wallet file will
44  be able to see all the addresses which belong to you, as well as the
45  relevant transactions, you are only protected from someone spending
46  your coins.
47  
48  It is recommended that you backup your wallet file before you
49  encrypt your wallet.  To do this, close the Bitcoin client and
50  copy the wallet.dat file from ~/.bitcoin/ on Linux, /Users/(user
51  name)/Application Support/Bitcoin/ on Mac OSX, and %APPDATA%/Bitcoin/
52  on Windows (that is /Users/(user name)/AppData/Roaming/Bitcoin on
53  Windows Vista and 7 and /Documents and Settings/(user name)/Application
54  Data/Bitcoin on Windows XP).  Once you have copied that file to a
55  safe location, reopen the Bitcoin client and Encrypt your wallet.
56  If everything goes fine, delete the backup and enjoy your encrypted
57  wallet.  Note that once you encrypt your wallet, you will never be
58  able to go back to a version of the Bitcoin client older than 0.4.
59  
60  Keep in mind that you are always responsible for your own security.
61  All it takes is a slightly more advanced wallet-stealing trojan which
62  installs a keylogger to steal your wallet passphrase as you enter it
63  in addition to your wallet file and you have lost all your Bitcoins.
64  Wallet encryption cannot keep you safe if you do not practice
65  good security, such as running up-to-date antivirus software, only
66  entering your wallet passphrase in the Bitcoin client and using the
67  same passphrase only as your wallet passphrase.
68  
69  See the doc/README file in the bitcoin source for technical details
70  of wallet encryption.