/bitcoinpaperwallet

JavaScript Client-Side Bitcoin Wallet Generator

Primary LanguageStandard ML

**** LOOKING FOR THE ZIP FILE TO DOWNLOAD? ************************************
If you're on already at https://github.com/lordhelmut/bitcoinpaperwallet
Then just look for the button that says "Download ZIP". Look to your right -->
*******************************************************************************

*** Paper Wallet for Merchants ***

This project is a fork of bitcoinpaperwallet, which is a fork of bitaddress.org, the original trustworthy
JavaScript powered offline bitcoin address generator. 

This unique paper wallet design is for merchants to display by their point of sale or store windows.
The private key is removed, and cleverly folds over itself to further hide the generated codes.

This generator includes the same pseudo-random key generation as bitaddress.org, as
well as support for creating wallets using "vanity keys", passphrases ("brain wallets")
or even rolling dice or shuffling cards.

As of March 1, 2014, this generator also includes support and designs for making
Litecoin and Dogecoin wallets.

Use the "verify" tab to decrypt a BIP38 password-encrypted wallet, check the
integrity of any private key, or even duplicate an existing wallet by scanning its
QR code.

*** HOW TO USE THIS GENERATOR ***

1) Extract the ZIP file
2) Open up the 'generate-wallet.html' file with your web browser. 
3) If you like you can select a different language or holiday theme
4) Follow the steps for calibrating your printer and then printing
   the front and back of each wallet. Use landscape mode when printing!
   
Rendering and printing seems to work best using: 

   OS X:     Safari or Chrome or Firefox
   Windows:  Chrome or Firefox
   Linux:    Firefox

When using Chrome on Windows, use the Chrome print dialog. Switching to the
Windows system print dialog will produce corrupted/illegible keys.

QR scanning works best using Firefox since Chrome will not access the camera controls
when opening a locally saved HTML file.

*** COMPARED WITH BITADDRESS.ORG and bitcoinpaperwallet.org ***
New design for displaying codes for merchants.

Images and resources have been moved out of the .html file (where they were
base-64 encoded) and into an images directory to make the code easier to review.

All cryptographic functions are verifiabley identical to those in bitaddress.org.
(Run a "diff" between this project and bitaddress.org if you want to be sure.)

*** HOW TO VERIFY THE AUTHENTICITY OF THIS DOWNLOAD ***

After downloading the ZIP package for this generator, you should find a file 
named generate-wallet.html.sig which you can use to:

* Verify that generate-wallet.html hasn't been tampered with, and
* Get proof that it really was authored by Entropy Technology.  
The PGP key can be found at https://www.entropytechnology.com/pgp.asc
  
For example, if you have GPG installed, you should be able cd to the appropriate 
directory and type in these two commands:

  gpg --recv-key 36E1D9B6
  gpg --verify --with-fingerprint generate-wallet.html.sig generate-wallet.html 


If you get warnings like "This key is not certified, there is no indication that
the key belongs to the owner" do not worry, this is normal.

*** THANKS ***

Special thanks to pointbiz/bitaddress.org and Artiom Chilaru/flexlabs.org, 
and Canton Becker for their significant contributions to this software.

Optional tamper-evident hologram tape and/or a live-boot
Ubuntu CD with this software pre-installed can be purchased from bitcoinpaperwallet.com 
to provide additional security against snooping.

*** LICENSES ***

This software may be modified and redistributed as 
per the MIT licenses included in the HTML and JavaScript source. 
 
Notice of Copyrights and Licenses:
---------------------------------------
The bitaddress.org project, software and embedded resources are copyright bitaddress.org. 
The bitaddress.org name and logo are not part of the open source license.

The bitcoinpaperwallet.com logo, hologram sticker design, and folding paper wallet design 
are copyrighted (© Copyright 2014 Canton Becker) and may not be modified or redistributed without permission excepting 
for personal use. 

The Merchant wallet design is free to use under the MIT licenses.

Portions of the all-in-one HTML document contain JavaScript codes that are the copyrights 
of others. The individual copyrights are included throughout the document along with their 
licenses. Included JavaScript libraries are separated with HTML script tags.

Summary of JavaScript functions with a redistributable license:
JavaScript function		License
-------------------		--------------
Array.prototype.map		Public Domain
window.Crypto			BSD License
window.SecureRandom		BSD License
window.EllipticCurve		BSD License
window.BigInteger		BSD License
window.QRCode			MIT License
window.Bitcoin			MIT License

The bitaddress.org software is available under The MIT License (MIT)
Copyright (c) 2011-2012 bitaddress.org

Permission is hereby granted, free of charge, to any person obtaining a copy of this 
software and associated documentation files (the "Software"), to deal in the Software 
without restriction, including without limitation the rights to use, copy, modify, 
merge, publish, distribute, sublicense, and/or sell copies of the Software, and to 
permit persons to whom the Software is furnished to do so, subject to the following 
conditions:

The above copyright notice and this permission notice shall be included in all copies 
or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.