From cdb7f24ef9172a933b2b0f4a0007db51fb2e0c6d Mon Sep 17 00:00:00 2001 From: Saivann Date: Tue, 3 Jun 2014 11:01:41 -0400 Subject: [PATCH 01/14] Fix "Getting started" buttons for rtl layout --- _less/rtl.less | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/_less/rtl.less b/_less/rtl.less index 02dd5978..8aaed5fb 100644 --- a/_less/rtl.less +++ b/_less/rtl.less @@ -184,6 +184,12 @@ h2 .rssicon{ border-right:1px solid #e0e0e0; margin-right:-1px } +.start div div div a, +.start div div div a:link, +.start div div div a:active, +.start div div div a:visited{ + padding:0 8px; +} .foundation-banner a, .foundation-banner a:link, From f13c8ffd5e4343a69a2745bc9e26d1c76b8d6927 Mon Sep 17 00:00:00 2001 From: 2GOOD Date: Wed, 4 Jun 2014 14:29:17 +0300 Subject: [PATCH 02/14] Update community.html --- _templates/community.html | 1 + 1 file changed, 1 insertion(+) diff --git a/_templates/community.html b/_templates/community.html index 3cbc6894..9dc30426 100644 --- a/_templates/community.html +++ b/_templates/community.html @@ -9,6 +9,7 @@ id: community

Icon{% translate forums %}

+ {% if page.lang == 'bg' %}

BitcoinBG.eu

{% endif %} {% if page.lang == 'bg' %}

Hash.bg

{% endif %} {% if page.lang == 'es' %}

ForoBitco.in en Español

{% endif %} {% if page.lang == 'es' %}

Foro Bitcoin en Español

{% endif %} From cd707707780dd902d2712835c69727aba1b87ae8 Mon Sep 17 00:00:00 2001 From: 2GOOD Date: Wed, 4 Jun 2014 14:45:49 +0300 Subject: [PATCH 03/14] Update community.html --- _templates/community.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_templates/community.html b/_templates/community.html index 9dc30426..4d82bedd 100644 --- a/_templates/community.html +++ b/_templates/community.html @@ -9,7 +9,7 @@ id: community

Icon{% translate forums %}

- {% if page.lang == 'bg' %}

BitcoinBG.eu

{% endif %} + {% if page.lang == 'bg' %}

BitcoinBG.eu

{% endif %} {% if page.lang == 'bg' %}

Hash.bg

{% endif %} {% if page.lang == 'es' %}

ForoBitco.in en Español

{% endif %} {% if page.lang == 'es' %}

Foro Bitcoin en Español

{% endif %} From b5d2cbe5ce21b124bb1255352d921f6192ad24c9 Mon Sep 17 00:00:00 2001 From: Saivann Date: Wed, 4 Jun 2014 11:52:42 -0400 Subject: [PATCH 04/14] Use cross-platform ruby mktmpdir in comparelinks.rb --- _contrib/comparelinks.rb | 79 ++++++++++++++++++++-------------------- 1 file changed, 40 insertions(+), 39 deletions(-) diff --git a/_contrib/comparelinks.rb b/_contrib/comparelinks.rb index 8e3b246b..33bbc6a3 100644 --- a/_contrib/comparelinks.rb +++ b/_contrib/comparelinks.rb @@ -3,12 +3,7 @@ ## Example: ruby ./_contrib/comparelinks.rb master newbranch > ../diff -WORKDIR = `mktemp -d` -WORKDIR.gsub!("\n",'') - -at_exit { - `rm -fr "#{WORKDIR}"` -} +require 'tmpdir' def prompt(*args) print(*args) @@ -52,43 +47,49 @@ def fetchlinks() end -# Copy current repository to a temporary directory -`rsync -a ./ "#{WORKDIR}/"` +Dir.mktmpdir{|workdir| -# Build both version of the website and fetch all links -oldlinks = {} -newlinks = {} + WORKDIR=workdir.gsub("\n",'') -Dir.chdir(WORKDIR) do + # Copy current repository to a temporary directory + `rsync -a ./ "#{WORKDIR}/"` - `git checkout #{srcbr}` - `jekyll` - oldlinks = fetchlinks() + # Build both version of the website and fetch all links + oldlinks = {} + newlinks = {} - `git checkout #{dstbr}` - `jekyll` - newlinks = fetchlinks() + Dir.chdir(WORKDIR) do -end + `git checkout #{srcbr}` + `jekyll` + oldlinks = fetchlinks() + + `git checkout #{dstbr}` + `jekyll` + newlinks = fetchlinks() + + end + + # Find added links, removed links + diffaddlinks = [] + diffrmlinks = [] + newlinks.each { |link, etag| + next if oldlinks.has_key?(link) + diffaddlinks.push(link) + } + oldlinks.each { |link, etag| + next if newlinks.has_key?(link) + diffrmlinks.push(link) + } + + # Display resulting diff + diff = '' + if diffaddlinks.length > 0 + diff = diff + "## links added\n\n" + diffaddlinks.join("\n") + "\n\n" + end + if diffrmlinks.length > 0 + diff = diff + "## links removed\n\n" + diffrmlinks.join("\n") + "\n\n" + end + print diff -# Find added links, removed links -diffaddlinks = [] -diffrmlinks = [] -newlinks.each { |link, etag| - next if oldlinks.has_key?(link) - diffaddlinks.push(link) } -oldlinks.each { |link, etag| - next if newlinks.has_key?(link) - diffrmlinks.push(link) -} - -# Display resulting diff -diff = '' -if diffaddlinks.length > 0 - diff = diff + "## links added\n\n" + diffaddlinks.join("\n") + "\n\n" -end -if diffrmlinks.length > 0 - diff = diff + "## links removed\n\n" + diffrmlinks.join("\n") + "\n\n" -end -print diff From 36649a3cb91c7783e2e4fef61a88d0aeb9c137af Mon Sep 17 00:00:00 2001 From: Saivann Date: Wed, 4 Jun 2014 21:23:24 -0400 Subject: [PATCH 05/14] Update de translation --- _translations/de.yml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/_translations/de.yml b/_translations/de.yml index 6cb156eb..ecec8d50 100644 --- a/_translations/de.yml +++ b/_translations/de.yml @@ -218,7 +218,7 @@ de: scaletxt1: "Das Bitcoin Netzwerk kann bereits eine größere Anzahl von Transaktionen pro Sekunde verarbeiten, als es es im Moment der Fall ist. Trotzdem ist es noch nicht so weit, dass es das Niveau großer Kreditkartennetzwerke erreicht. An der Aufhebung aktueller Einschränkungen wird bereits gearbeitet und zukünftige Anforderungen sind bekannt. Seit der Einführung befindet sich alles im Bitcoinnetzwerk in einem ständigen Reife-, Verbesserungs- und Spezialisierungsprozess, und es muss davon ausgegangen werden, dass dieser noch einige Jahre andauert. Mit steigenden Wachstum werden mehr und mehr Nutzer leichtgewichtigere Clients nutzen und größere Netzwerkknoten werden eher zu spezialisierten Diensten. Weitere Informationen finden Sie im Wiki auf der Seite zur Skalierbarkeit." legal: "Rechtliches" islegal: "Ist Bitcoin legal?" - islegaltxt1: "Unserem besten Wissen nach ist Bitcoin, dem Gesetz nach, in keinem Gerichtsstand illegal. Manche Gerichtsstände (wie Argentinien und Russland) jedoch beschränken oder verbieten Fremdwährungen komplett. Andere Gerichtsstände (wie Thailand) können die Lizensierung bestimmer Unternehmen wie Bitcoinbörsen begrenzen." + islegaltxt1: "Unserem besten Wissen nach ist Bitcoin, dem Gesetz nach, in keinem Gerichtsstand illegal. Manche Gerichtsstände (wie Argentinien und Russland) jedoch beschränken oder verbieten Fremdwährungen komplett. Andere Gerichtsstände (wie Thailand) können die Lizensierung bestimmter Unternehmen wie Bitcoinbörsen begrenzen." islegaltxt2: "Aufsichtsbehörden verschiedener Länder unternehmen Schritte, um Einzelpersonen und Firmen Regeln zur Verfügung zu stellen, wie diese neue Technologie in das formelle, regulierte Finanzsystem zu integrieren ist. Zum Beispiel hat das Financial Crimes Enforcement Network (FinCEN), eine Abteilung des Finanzministeriums der Vereinigten Staaten, unverbindliche Leitlinien herausgegeben, wie es bestimmte Aktivitäten virtuelle Währungen betreffend charakterisiert." illegalactivities: "Ist Bitcoin nützlich für illegale Aktivitäten?" illegalactivitiestxt1: "Bitcoin ist Geld, und Geld wurde schon immer für legale und illegale Zwecke genutzt. Bargeld, Kreditkarten und das gewöhnliche Bankensystem übertreffen Bitcoin bei weitem, wenn es um den Nutzen, kriminelle Geschäfte zu finanzieren, geht. Bitcoin könnte den Zahlungsverkehr revolutionieren und es wird häufig angenommen, dass die Vorteile solcher Innovationen ihre möglichen Nachteile in den Schatten stellen." @@ -228,9 +228,9 @@ de: regulatedtxt1: "Das Bitcoin-Protokoll selbst kann nicht modifiziert werden ohne das Zusammenwirken fast all seiner Nutzer, die wählen welche Software sie verwenden. Der Versuch, einer lokalen Authorität spezielle Rechte im globalen Bitcoin-Netzwerk zuzuweisen, wäre nicht praktikabel. Jede wohlhabende Organisation könnte in \"Mining\" Hardware investieren um so die Kontrolle über die Hälfte der Rechenleistung des Netzwerks zu erlangen und in der Lage zu sein neue Transaktionen zu blockieren oder rückgängig zu machen. Jedoch gibt es keine Garantie, dass sie diese Macht behalten könnten, da es nötig wäre ebensoviel wie alle anderen Miner auf der Welt zu investieren." regulatedtxt2: "Es ist jedoch möglich, die Nutzung von Bitcoin in ähnlicher Weise zu regulieren, wie bei jedem anderen Finanzinstrument. Wie der Dollar kann Bitcoin für eine Vielzahl von Zwecken benutzt werden, von denen einige je nach Rechtslage der Länder, entweder als rechtskonform oder nicht rechtskonform angesehen werden können. In dieser Hisicht ist Bitcoin nicht anders als jedes andere Instrument und kann in jedem Land anderen Regelungen unterworfen sein. Die Nutzung von Bitcoin könnte durch restriktive Regelungen auch stark eingeschränkt sein, wodurch es schwer ist vorherzusagen, wie viele Nutzer die Technologie weiter nutzen würden. Eine Regierung, die sich entschließt Bitcoin zu verbieten, würde die Entwicklung von inländischen Unternehmen und Märkten verhindern und die Innovationen in andere Länder verschieben. Die Herausforderung für die Regulatoren ist es, wie immer, effiziente Lösungen zu finden ohne das Wachstum neuer aufstrebender Märkte und Unternehmen zu beeinträchtigen." taxes: "Was ist mit Bitcoin und Steuern?" - taxestxt1: "Bitcoin ist in keinem Land ein anerkanntes gesetzliches Zahlungsmittel, aber oft können Steuerschulden unabhängig vom verwendeten Medium auflaufen. Es gibt eine große Bandbreite von Vorschriften in vielen verschiedenen Ländern, die Einkommens-, Umsatz-, Lohn-, Kapitalertrags-, oder eine andere Form der Steuerschuld bei der Nutzung von Bitcoin hervorrufen können." + taxestxt1: "Bitcoin ist in keinem Gerichtstand als Fiatgeld, das den Status als anerkanntes gesetzliches Zahlungsmittel hat, anerkannt, aber oft können Steuerschulden unabhängig vom verwendeten Medium auflaufen. Es gibt eine große Bandbreite von Vorschriften in vielen verschiedenen Ländern, die Einkommens-, Umsatz-, Lohn-, Kapitalertrags-, oder eine andere Form der Steuerschuld bei der Nutzung von Bitcoin hervorrufen können." consumer: "Was ist mit Bitcoin und Verbraucherschutz?" - consumertxt1: "Bitcoin ermöglicht es Personen, Transaktionen unter ihren eigenen Bedingungen durchzuführen. Jeder Nutzer kann Zahlungen in einer ähnlichen Weise wie bei Bargeld senden und empfangen, aber man kann auch an komplexeren Verträgen teilhaben.\nMehrfache Signaturen ermöglichen es, dass Transaktionen erst dann vom Netzwerk akzeptiert werden, wenn eine bestimmte Anzahl von einer definierten Gruppe von Personen die Transaktion signieren. Dies ermöglicht zukünftig die Entwicklung von innovativen Vermittlungsdiensleistungen. Solche Dienste könnten es Dritten ermöglichen, eine Transaktion zu bestätigen oder abzulehnen im Falle einer Meinungsverschiedenheit zwischen den anderen Parteien, ohne Kontrolle über das Geld zu haben. Im Gegensatz zu Bargeld oder anderen Zahlungsmethoden hinterlässt Bitcoin immer einen öffentlichen Beweis, dass eine Transaktion stattgefunden hat, was unter Umständen in einem Regress gegen Geschäfte mit betrügerischen Praktiken verwendet werden kann.\n " + consumertxt1: "Bitcoin ermöglicht es Personen, Transaktionen unter ihren eigenen Bedingungen durchzuführen. Jeder Nutzer kann Zahlungen in einer ähnlichen Weise wie bei Bargeld senden und empfangen, aber man kann auch an komplexeren Verträgen teilhaben.\nMehrfache Signaturen ermöglichen es, dass Transaktionen erst dann vom Netzwerk akzeptiert werden, wenn eine bestimmte Anzahl von einer definierten Gruppe von Personen die Transaktion signieren. Dies ermöglicht zukünftig die Entwicklung von innovativen Vermittlungsdienstleistungen. Solche Dienste könnten es Dritten ermöglichen, eine Transaktion zu bestätigen oder abzulehnen im Falle einer Meinungsverschiedenheit zwischen den anderen Parteien, ohne Kontrolle über das Geld zu haben. Im Gegensatz zu Bargeld oder anderen Zahlungsmethoden hinterlässt Bitcoin immer einen öffentlichen Beweis, dass eine Transaktion stattgefunden hat, was unter Umständen in einem Regress gegen Geschäfte mit betrügerischen Praktiken verwendet werden kann.\n " consumertxt2: "Normalerweise sind Händler von ihrem Ruf in der Öffentlichkeit abhängig, wenn sie ihre Geschäftstätigkeit fortführen und ihre Mitarbeiter bezahlen wollen, gleichzeitig haben Händler keinen Zugriff auf ähnlich umfangreiche Informationen, wenn diese mit Kunden zu tun haben. Die Art und Weise, wie Bitcoin funktioniert, garantiert sowohl Einzelpersonen und als auch Unternehmen den Schutz vor Rückbuchungsbetrug. Der Kunde hat hingegen die Möglichkeit, nach mehr Absicherung zu verlangen, wenn er einem bestimmten Verkäufer nicht vertraut." economy: "Ökonomie" bitcoinscreated: "Wie werden Bitcoins erzeugt?" @@ -266,7 +266,7 @@ de: bettercurrencytxt1: "Das kann passieren. Vorläufig bleibt Bitcoin die bei weitem populärste dezentralisierte virtuelle Währung, aber es gibt keine Garantie, dass es an dieser Position verbleibt. Es gibt mittlerweile einige andere alternative Währungen, die von Bitcoin inspiriert sind. Es ist jedoch sicher richtig, anzunehmen, dass signifikante Verbesserungen für eine neue Währung nötig wären, um Bitcoin in Bezug auf einen etablierten Markt zu überholen, obwohl dies unvorhersehbar ist. Auch könnte Bitcoin möglicherweise Verbesserungen einer konkurrierenden Währung übernehmen, solange dies keine grundlegenden Teile des Protokolls verändert. " transactions: "Transaktionen" tenminutes: "Wieso muss ich 10 Minuten warten?" - tenminutestxt1: "Mit Bitcoin erhält man eine Zahlung nahezu unverzüglich. Es gibt jedoch eine im Durchschnitt 10-minütige Verzögerung bevor das Netzwerk ihre Transaktion bestätigt, indem sie sie in einen Block einschließt und bevor Sie die erhaltenen Bitcoins ausgeben können. Eine Bestätigung bedeutet, dass es im Netzwerk eine Übereinkunft darüber gibt, dass die Bitcoins, die Sie erhalten haben nicht an jemand anderem gesendet wurden und als ihr Eigentum angesehen werden können. Sobald ihre Transaktion in einem Block eingeschlossen wurde, wird diese fortlaufend von jedem neuen darauf folgenden Block begraben, was die Übereinkunft exponentiell verstärkt und das Risiko verkleinert, dass eine Transaktion rückgängig gemacht werden kann. Jeder Nutzer kann frei bestimmern an welchem Punkt er eine Transaktion als bestätigt betrachtet, aber 6 Bestätigungen werden oft als so sicher angesehen wie das 6-monatige Warten auf eine Kreditkarten-Transaktion" + tenminutestxt1: "Mit Bitcoin erhält man eine Zahlung nahezu unverzüglich. Es gibt jedoch eine im Durchschnitt 10-minütige Verzögerung bevor das Netzwerk ihre Transaktion bestätigt, indem sie sie in einen Block einschließt und bevor Sie die erhaltenen Bitcoins ausgeben können. Eine Bestätigung bedeutet, dass es im Netzwerk eine Übereinkunft darüber gibt, dass die Bitcoins, die Sie erhalten haben nicht an jemand anderem gesendet wurden und als ihr Eigentum angesehen werden können. Sobald ihre Transaktion in einem Block eingeschlossen wurde, wird diese fortlaufend von jedem neuen darauf folgenden Block begraben, was die Übereinkunft exponentiell verstärkt und das Risiko verkleinert, dass eine Transaktion rückgängig gemacht werden kann. Jeder Nutzer kann frei bestimmen an welchem Punkt er eine Transaktion als bestätigt betrachtet, aber 6 Bestätigungen werden oft als so sicher angesehen wie das 6-monatige Warten auf eine Kreditkarten-Transaktion" fee: "Wie groß wird die Transaktionsgebühr sein?" feetxt1: "Die meisten Transaktionen können ohne Gebühren vorgenommen werden, aber die Nutzer sind angehalten, eine kleine freiwillige Gebühr zu bezahlen, um eine schnellere Bestätigung ihrer Transaktionen zu erhalten und die Miner zu entlohnen. Falls Gebühren notwendig sind, dann überschreiten sie generell nicht den Gegenwert von ein paar Cent. Falls notwendig, wird normalerweise Ihr Bitcoin Client versuchen, eine angemessene Gebühr zu schätzen." feetxt2: "Transaktionsgebühren dienen als Schutz gegen Nutzer, die Transaktionen senden, um das Netzwerk zu überlasten. Die genaue Methode, nach der Gebühren funktionieren, wird noch entwickelt und sich über die Zeit ändern. Da die Gebühr in keinen Bezug zur Summe der gesendeten Bitcoins steht, kann sie entweder sehr niedrig (0.0005 BTC für eine Übertragung von 1000 BTC) oder unverhältnismäßig hoch(0.004 BTC für eine Zahlung von 0.02 BTC) sein. Die Gebühr wird durch Eigenschaften wie den Daten der Transaktion und Transaktion-Wiederholung festgelegt. Wenn sie zum Beispiel eine große Zahl von kleinen Summen erhalten, werden Gebühren für das Senden höher sein. Solche Zahlungen sind vergleichbar mit dem Zahlen einer Restaurantrechnung nur mit Cents. Das zügige Ausgeben von kleinen Mengen ihrer Bitcoins kann ebenso eine Gebühr erfordern. Wenn ihre Aktivität dem Muster normaler Transaktionen folgt, sollten die Gebühren sehr niedrig bleiben." @@ -533,9 +533,9 @@ de: irreversible: "Bitcoin-Zahlungen sind nicht umkehrbar" irreversibletxt: "Zahlungen mit Bitcoin können nicht rückgängig gemacht werden, sie können nur durch den Empfänger zurückgezahlt werden. Daher sollten Sie nur mit Personen und Organisationen handeln, die Sie kennen und denen Sie vertrauen. Der Part der Unternehmen besteht darin, die Kontrolle über die Zahlungsaufforderungen zu behalten, die sie ihren Kunden anzeigen. Aber keine Sorge, Bitcoin kann Tippfehler erkennen und in der Regel können Sie kein Geld an eine ungültige Adresse senden. In der Zukunft könnten zusätzliche Dienste vorhanden sein, die mehr Wahlmöglichkeiten und Schutz für Kunden bieten." anonymous: "Bitcoin ist nicht anonym" - anonymoustxt: "Wenn Sie Ihre Privatsphäre mit Bitcoin schützen wollen, ist ein wenig Aufwand erforderlich. Alle Bitcoin-Transkationen sind öffentlich und dauerhaft im Netzwerk gespeichert, was bedeutet, dass jeder den Kontostand und die Transaktionen jeder Bitcoin-Adresse einsehen kann. Die Identität des Besitzers kann aber nicht mit der Bitcoin-Adresse in Verbindung gebracht werden, solange der Besitzer im Rahmen eines Tauschs keine persönlichen Informationen preisgibt. Daher sollte man Bitcoin Adressen nur einmalig verwenden. Denken Sie immer daran, dass es in ihrer Verwantwortung liegt, sich gute Praktiken anzueignen um ihre Privatsphäre schützen zu können. Lesen Sie mehr über den Schutz ihrer Privatsphäre." + anonymoustxt: "Wenn Sie Ihre Privatsphäre mit Bitcoin schützen wollen, ist ein wenig Aufwand erforderlich. Alle Bitcoin-Transkationen sind öffentlich und dauerhaft im Netzwerk gespeichert, was bedeutet, dass jeder den Kontostand und die Transaktionen jeder Bitcoin-Adresse einsehen kann. Die Identität des Besitzers kann aber nicht mit der Bitcoin-Adresse in Verbindung gebracht werden, solange bis der Besitzer Informationen im Rahmen einer Transaktion oder anderweitig preisgibt. Daher sollte man Bitcoin Adressen nur einmalig verwenden. Denken Sie immer daran, dass es in ihrer Verwantwortung liegt, sich gute Praktiken anzueignen um ihre Privatsphäre schützen zu können. Lesen Sie mehr über den Schutz ihrer Privatsphäre." instant: "Sofort-Transaktionen sind weniger sicher" - instanttxt: "Eine Bitcoin-Transaktion ist in der Regel innerhalb weniger Sekunden verteilt und innerhalb von 10 Minuten bestätigt. Innerhalb dieser Zeit gilt die Transaktion als glaubwürdig, aber umkehrbar. Unehrliche Nutzer könnten versuchen zu schummeln. Falls Sie nicht zu lange warten wollen, sollten Sie eine kleine Transaktionsgebühr ansetzen, oder ein System verwenden, welches unsichere Transaktionen erkennt, um die Sicherheit zu erhöhen. Für größere Summen ab 1000€ empfiehlt es sich auf 6 Bestätigungen oder mehr zu warten. Jede Bestätigung verringert das Risiko einer umkehrbaren Bestätigung exponentiell." + instanttxt: "Eine Bitcoin-Transaktion ist in der Regel innerhalb weniger Sekunden verteilt und in den darauf folgenden 10 Minuten beginnt die Bestätigung. Innerhalb dieser Zeit gilt die Transaktion als glaubwürdig, aber umkehrbar. Unehrliche Nutzer könnten versuchen zu schummeln. Falls Sie nicht zu lange warten wollen, sollten Sie eine kleine Transaktionsgebühr ansetzen, oder ein System verwenden, welches unsichere Transaktionen erkennt, um die Sicherheit zu erhöhen. Für größere Summen ab 1000€ empfiehlt es sich auf 6 Bestätigungen oder mehr zu warten. Jede Bestätigung verringert das Risiko einer umkehrbaren Bestätigung exponentiell." experimental: "Bitcoin ist noch experimentell" experimentaltxt: "Bitcoin ist eine experimentelle neue Währung, und wird aktiv weiterentwickelt. Auch wenn es mit steigender Nutzung immer weniger experimentell wird, sollten Sie bedenken, dass Bitcoin eine neue Erfindung ist, die Ideen verfolgt, die vorher nie ausprobiert wurden. Daher kann die Zukunft von niemandem vorhergesagt werden." tax: "Steuern und Regulierung" From 76103c9dd907b23a33a5d85da0eebf4d99b4026c Mon Sep 17 00:00:00 2001 From: Cryptolina Date: Wed, 4 Jun 2014 21:38:35 -0400 Subject: [PATCH 06/14] Create cryptolina MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Carolinas first-ever Bitcoin Expo will be kicked off in Raleigh on August 15 and 16, 2014. Cryptolina will be held at the Raleigh Convention Center. It will serve as a gateway to hundreds of new interested businesses, investors, and enthusiasts. Cryptolina follows successful Bitcoin conferences held in cities throughout the world, including Miami, Hong Kong, Washington, San Francisco, New York City, and Amsterdam. More than 500 new faces of the emerging Bitcoin community are expected to attend, network and discuss this emerging industry behind the digital currency. Cryptolina’s announcement comes on the heels of several positive Bitcoin evaluations including acknowledgement by the Federal Reserve that “Bitcoin does not present a threat to economic activity by disrupting traditional channels of commerce; rather, it could serve as a boon." Cryptolina is being held in Downtown Raleigh in order to capitalize on the flourishing startup scene and exponential growth. Frequently cited as a "New Silicon Valley" of the East Coast, the Research Triangle region is a natural fit due to the high-tech jobs and leading companies. Current issues and events pertaining to Bitcoin technologies, startups, venture capital investment and angel investment will be discussed during multiple panels. In addition to a Bitcoin based business exhibition, there are plans to host nearly two dozen speakers. For additional information regarding the upcoming Cryptolina Bitcoin Expo, contact us at info@cryptolina.com --- _events/cryptolina | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 _events/cryptolina diff --git a/_events/cryptolina b/_events/cryptolina new file mode 100644 index 00000000..246bbdb9 --- /dev/null +++ b/_events/cryptolina @@ -0,0 +1,9 @@ +--- +date: 2014-08-15 +title: "Cryptolina Bitcoin Conference" +venue: "Raleigh Convention Center" +address: "500 S Salisbury Street" +city: "Raleigh, NC" +country: "United States" +link: "http://www.cryptolina.com/" +--- From bb85d1830317fd46b4cb97d5c251a976d083d7a7 Mon Sep 17 00:00:00 2001 From: Jan Vornberger Date: Sat, 24 May 2014 19:22:11 +0200 Subject: [PATCH 07/14] Change Hive to Hive OS X --- _templates/choose-your-wallet.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_templates/choose-your-wallet.html b/_templates/choose-your-wallet.html index 0601c88f..87b1b7f6 100755 --- a/_templates/choose-your-wallet.html +++ b/_templates/choose-your-wallet.html @@ -76,13 +76,13 @@ id: choose-your-wallet
-

Hive

+

Hive OS X

Mac OS X

{% translate wallethive %}

{% translate walletvisit %}

- hiveHive + hiveHive OS X
{% endcase %}
@@ -251,14 +251,14 @@ id: choose-your-wallet
-

Hive

+

Hive OS X

Mac OS X

{% translate wallethive %}

{% translate walletvisit %}

- hiveHive + hiveHive OS X
{% endcase %}
From f65c58cb0e3e7c2bfba9a939aa2cb1ecd2c762f3 Mon Sep 17 00:00:00 2001 From: Jan Vornberger Date: Sat, 24 May 2014 19:52:45 +0200 Subject: [PATCH 08/14] Add Hive Android to wallet page --- _templates/choose-your-wallet.html | 32 ++++++++++++++++++++++++++++++ _translations/en.yml | 1 + 2 files changed, 33 insertions(+) diff --git a/_templates/choose-your-wallet.html b/_templates/choose-your-wallet.html index 87b1b7f6..0356331d 100755 --- a/_templates/choose-your-wallet.html +++ b/_templates/choose-your-wallet.html @@ -30,6 +30,21 @@ id: choose-your-wallet bitcoin walletBitcoin
Wallet
{% case page.lang %} +{% when 'ar' or 'bg' or 'de' or 'es' or 'fa' or 'fr' or 'hu' or 'id' or 'it' or 'nl' or 'pl' or 'pt_BR' or 'ro' or 'ru' or 'sv' or 'tr' or 'zh_CN' or 'zh_TW' %} +{% else %} +
+
+
+

Hive Android

+ Android +

{% translate wallethive-android %}

+

{% translate walletvisit %}

+
+
+ hiveHive
Android +
+{% endcase %} +{% case page.lang %} {% when 'ar' or 'fa' or 'id' or 'nl' or 'pl' or 'tr' or 'zh_TW' %} {% else %}
@@ -304,6 +319,23 @@ id: choose-your-wallet bitcoin walletBitcoin
Wallet
{% case page.lang %} +{% when 'ar' or 'bg' or 'de' or 'es' or 'fa' or 'fr' or 'hu' or 'id' or 'it' or 'nl' or 'pl' or 'pt_BR' or 'ro' or 'ru' or 'sv' or 'tr' or 'zh_CN' or 'zh_TW' %} +{% else %} +
+
+
+
+

Hive Android

+ Android +

{% translate wallethive-android %}

+

{% translate walletvisit %}

+
+
+
+ hiveHive
Android +
+{% endcase %} +{% case page.lang %} {% when 'ar' or 'fa' or 'id' or 'nl' or 'pl' or 'tr' or 'zh_TW' %} {% else %}
diff --git a/_translations/en.yml b/_translations/en.yml index 1381dd6e..4a019067 100644 --- a/_translations/en.yml +++ b/_translations/en.yml @@ -111,6 +111,7 @@ en: walletbitcoinqt: "Bitcoin Core is a full Bitcoin client and builds the backbone of the network. It offers the highest levels of security, privacy, and stability. However, it has fewer features and it takes a lot of space and memory." walletmultibit: "MultiBit is a lightweight client that focuses on being fast and easy to use. It synchronizes with the network and is ready to use in minutes. MultiBit also supports many languages. It is a good choice for non-technical users." wallethive: "Hive is a fast, integrated, user-friendly Bitcoin wallet for Mac OS X. With a focus on usability, Hive is translated into many languages and has apps, making it easy to interact with your favorite Bitcoin services and merchants." + wallethive-android: "Hive is a standalone wallet for Android, which requires no external server or account. It focuses on usability, yet provides a range of advanced features, such as touch-to-pay via NFC or reliable payments via Bluetooth. Hive Android is extensible through plugins." walletarmory: "Armory is an advanced Bitcoin client that expands its features for Bitcoin power users. It offers many backup and encryption features, and it allows secure cold-storage on offline computers." walletelectrum: "Electrum's focus is speed and simplicity, with low resource usage. It uses remote servers that handle the most complicated parts of the Bitcoin system, and it allows you to recover your wallet from a secret phrase." walletbitcoinwallet: "Bitcoin Wallet for Android is easy to use and reliable, while also being secure and fast. Its vision is de-centralization and zero trust: No central service is needed for Bitcoin-related operations. The app is a good choice for non-technical people. It is also available for BlackBerry OS." From 78e6e0291113c8a744c8bccb3449f19da2b7edcf Mon Sep 17 00:00:00 2001 From: Saivann Date: Thu, 5 Jun 2014 12:27:22 -0400 Subject: [PATCH 09/14] Update de translation --- _translations/de.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_translations/de.yml b/_translations/de.yml index ecec8d50..03d7b22f 100644 --- a/_translations/de.yml +++ b/_translations/de.yml @@ -218,7 +218,7 @@ de: scaletxt1: "Das Bitcoin Netzwerk kann bereits eine größere Anzahl von Transaktionen pro Sekunde verarbeiten, als es es im Moment der Fall ist. Trotzdem ist es noch nicht so weit, dass es das Niveau großer Kreditkartennetzwerke erreicht. An der Aufhebung aktueller Einschränkungen wird bereits gearbeitet und zukünftige Anforderungen sind bekannt. Seit der Einführung befindet sich alles im Bitcoinnetzwerk in einem ständigen Reife-, Verbesserungs- und Spezialisierungsprozess, und es muss davon ausgegangen werden, dass dieser noch einige Jahre andauert. Mit steigenden Wachstum werden mehr und mehr Nutzer leichtgewichtigere Clients nutzen und größere Netzwerkknoten werden eher zu spezialisierten Diensten. Weitere Informationen finden Sie im Wiki auf der Seite zur Skalierbarkeit." legal: "Rechtliches" islegal: "Ist Bitcoin legal?" - islegaltxt1: "Unserem besten Wissen nach ist Bitcoin, dem Gesetz nach, in keinem Gerichtsstand illegal. Manche Gerichtsstände (wie Argentinien und Russland) jedoch beschränken oder verbieten Fremdwährungen komplett. Andere Gerichtsstände (wie Thailand) können die Lizensierung bestimmter Unternehmen wie Bitcoinbörsen begrenzen." + islegaltxt1: "Unserem besten Wissen nach ist Bitcoin, dem Gesetz nach, in fast keinem Gerichtsstand illegal. Manche Gerichtsstände (wie Argentinien und Russland) jedoch beschränken oder verbieten Fremdwährungen komplett. Andere Gerichtsstände (wie Thailand) können die Lizensierung bestimmter Unternehmen wie Bitcoinbörsen begrenzen." islegaltxt2: "Aufsichtsbehörden verschiedener Länder unternehmen Schritte, um Einzelpersonen und Firmen Regeln zur Verfügung zu stellen, wie diese neue Technologie in das formelle, regulierte Finanzsystem zu integrieren ist. Zum Beispiel hat das Financial Crimes Enforcement Network (FinCEN), eine Abteilung des Finanzministeriums der Vereinigten Staaten, unverbindliche Leitlinien herausgegeben, wie es bestimmte Aktivitäten virtuelle Währungen betreffend charakterisiert." illegalactivities: "Ist Bitcoin nützlich für illegale Aktivitäten?" illegalactivitiestxt1: "Bitcoin ist Geld, und Geld wurde schon immer für legale und illegale Zwecke genutzt. Bargeld, Kreditkarten und das gewöhnliche Bankensystem übertreffen Bitcoin bei weitem, wenn es um den Nutzen, kriminelle Geschäfte zu finanzieren, geht. Bitcoin könnte den Zahlungsverkehr revolutionieren und es wird häufig angenommen, dass die Vorteile solcher Innovationen ihre möglichen Nachteile in den Schatten stellen." @@ -342,7 +342,7 @@ de: balances: "Kontostände - Blockkette" balancestxt: "Die Blockkette ist ein gemeinsames öffentliches Buchungssystem, auf dem das gesamte Bitcoinnetzwerk basiert. Alle bestätigten Buchungen werden in der Blockkette gespeichert. Auf diese Art können Bitcoin Wallets ihren Kontostand berechnen und neue Transaktionen können nur ausgeführt werden, wenn die Bitcoins dem Sender tatsächlich gehören. Die Integrität und die chronologische Reihenfolge der Blockkette werden durch Kryptographie sichergestellt." transactions: "Transaktionen - privater Schlüssel" - transactionstxt: "Eine Transaktion ist ein Transfer eines Betrags zwischen Bitcoin-Wallets, der in die Blockkette eingetragen wird. Bitcoin-Wallets haben einen geheimen Datenblock der privater Schlüssel oder \"Seed\" genannt wird, welcher verwendet wird, um Transaktionen zu signieren, indem ein mathematischer Beweis erbracht wird, dass sie vom Eigentümer der Wallet kommen. Die Signatur verhindert auch, dass die Transaktion nach dem Absenden von jemandem modifiziert werden kann. Alle Transaktionen werden unter den Nutzern verbreitet und in den folgenden 10 Minuten vom Netzwerk durch einen Prozess namens Mining bestätigt." + transactionstxt: "Eine Transaktion ist ein Transfer eines Betrags zwischen Bitcoin-Wallets, der in die Blockkette eingetragen wird. Bitcoin-Wallets haben einen geheimen Datenblock der privater Schlüssel oder \"Seed\" genannt wird, welcher verwendet wird, um Transaktionen zu signieren, indem ein mathematischer Beweis erbracht wird, dass sie vom Eigentümer der Wallet kommen. Die Signatur verhindert auch, dass die Transaktion nach dem Absenden von jemandem modifiziert werden kann. Alle Transaktionen werden unter den Nutzern verbreitet und innerhalb von 10 Minuten beginnt die Bestätigung durch das Netzwerk mit Hilfe einens Prozess, genannt Mining ." processing: "Verarbeitung - Mining" processingtxt: "Mining ist ein verteiltes Konsens-System das verwendet wird, um wartende Transaktionen zu bestätigen, indem sie in die Blockkette aufgenommen werden. Es erzwingt eine chronologische Reihenfolge der Blockkette, schützt die Neutralität des Netzwerks und ermöglicht verschiedenen Computern, sich über den Status des Systems einig zu sein. Um bestätigt zu werden, müssen Transaktionen in einen Block gepackt werden. Dieser muss sehr strengen kryptographischen Regeln enstprechen, die durch das Netzwerk verifiziert werden. Diese Regeln verhindern, dass vorherige Blöcke modifiziert werden können, denn eine Änderung würde alle folgenden Blöcke ungültig machen. Mining erzeugt auch das Equivalent einer Lotterie mit starker Konkurrenz, die verhindert, dass eine Einzelperson einfach neue aufeinanderfolgende Blöcke in die Blockkette einfügen kann. Auf diese Weise wird sichergestellt, dass keine Einzelpersonen kontrollieren können was in die Blockkette eingefügt wird, oder Teile der Blockkette modifizieren können, um eigene Ausgaben rückgängig zu machen." readmore: "Hinunter in den Kaninchenbau" From 15beb85d71d8b42f4865a3b3997ae30fab82a5c1 Mon Sep 17 00:00:00 2001 From: voffkas Date: Fri, 6 Jun 2014 15:28:41 +0300 Subject: [PATCH 10/14] New Event added - bitcoinconf kiev --- _events/2014-09-26-bitcoinconferencekiev.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 _events/2014-09-26-bitcoinconferencekiev.md diff --git a/_events/2014-09-26-bitcoinconferencekiev.md b/_events/2014-09-26-bitcoinconferencekiev.md new file mode 100644 index 00000000..9d7f2db7 --- /dev/null +++ b/_events/2014-09-26-bitcoinconferencekiev.md @@ -0,0 +1,9 @@ +--- +date: 2014-09-26 +title: "Bitcoin Conference Kiev 2014" +venue: "Kiev Loft" +address: "Degtiarivska, 5" +city: "Kiev" +country: "Ukraine" +link: "http://bitcoinconf.com.ua/en/" +--- \ No newline at end of file From 187ed2562a44d69daaf76278e62934c728ca8cdd Mon Sep 17 00:00:00 2001 From: Saivann Date: Fri, 6 Jun 2014 15:33:16 -0400 Subject: [PATCH 11/14] Improve contributors.rb plugin Validate returned data from GitHub API htmlescape data on the HTML page Drop unnecessary yaml dependency Add more comments in the code Add more aliases in _config.yml Fix vertical-align style --- _config.yml | 7 +++ _less/screen.less | 3 +- _plugins/contributors.rb | 89 ++++++++++++++++++++++++------------- _templates/development.html | 2 +- 4 files changed, 68 insertions(+), 33 deletions(-) diff --git a/_config.yml b/_config.yml index e132fb0f..1851e5be 100644 --- a/_config.yml +++ b/_config.yml @@ -112,6 +112,13 @@ aliases: --author=Satoshi Nakamoto: Satoshi Nakamoto gavinandresen: Gavin Andresen tcatm: Nils Schneider + gmaxwell: Gregory Maxwell + sipa: Pieter Wuille + jgarzik: Jeff Garzik + petertodd: Peter Todd + luke-jr: Luke-Jr + laanwj: Wladimir J. van der Laan + mikehearn: Mike Hearn safe: false server_port: 4000 diff --git a/_less/screen.less b/_less/screen.less index 28304662..0e73695b 100644 --- a/_less/screen.less +++ b/_less/screen.less @@ -961,10 +961,11 @@ table td,table th{ font-size:80%; } .contributors span{ - padding:6px 0; + padding:8px 0; width:170px; overflow:hidden; display:inline-block; + vertical-align:top; } .resources{ diff --git a/_plugins/contributors.rb b/_plugins/contributors.rb index e4dac71a..dea97c23 100644 --- a/_plugins/contributors.rb +++ b/_plugins/contributors.rb @@ -4,56 +4,83 @@ require 'open-uri' require 'json' -require 'yaml' module Jekyll class CategoryGenerator < Generator - def fetch_contributors - page = 1 + + def contributors(aliases) contributors = [] + # Call GitHub API with 100 results per page + page = 1 + data = [] while page < 10 do begin ar = JSON.parse(open("https://api.github.com/repos/bitcoin/bitcoin/contributors?page=#{page}&per_page=100","User-Agent"=>"Ruby/#{RUBY_VERSION}").read) + # Prevent any error to stop the build process, return an empty array instead rescue print 'GitHub API Call Failed!' break end + if !ar.is_a?(Array) + print 'GitHub API Call Failed!' + return contributors + end + if ar.length > 100 + print 'GitHub API exceeding the 100 results limit!' + return contributors + end + # Stop calling GitHub API when no new results are returned break if (ar.length == 0) - contributors.push(*ar) + # Merge contributors into a single array + data.push(*ar) page += 1 end - - contributors.map do |x| - x['name'] = x['login'] unless x.has_key?('name') - x['name'] = x['login'] if x['name'] == "" - - x - end - end - - def merge_contributors(contributors, aliases) - contributors = contributors.map do |c| - c['name'] = aliases[c['name']] if aliases.has_key?(c['name']) - - c - end - - hoaoh = contributors.reduce({}) do |result, item| - result.merge({ item['name'] => [item] }) { |key, old, new| old[0]['contributions'] += new[0]['contributions']; old } - end - - hoaoh.values.map { |sublist| - sublist.reduce({}) do |merged,h| - merged.merge(h) do |key,old,new| (key=='name' ? old : old+new) end + # Loop in returned results array + result = {} + for c in data + # Skip incomplete / invalid data and set contributor's name + next if !c.is_a?(Hash) + next if !c.has_key?('contributions') or !c['contributions'].is_a?(Integer) or c['contributions'] > 1000000 + if c.has_key?('name') and c['name'].is_a?(String) and /^[A-Za-z0-9\-]{1,150}$/.match(c['name']) + name = c['name'] + elsif c.has_key?('login') and c['login'].is_a?(String) and /^[A-Za-z0-9\-]{1,150}$/.match(c['login']) + name = c['login'] + else + next end - }.flatten + # Replace name by its corresponding alias if defined in _config.yml + name = aliases[name] if aliases.has_key?(name) + # Assign variables + x = {} + x['name'] = name + x['contributions'] = c['contributions'] + # Set gravatar_id when available + if c.has_key?('gravatar_id') and c['gravatar_id'].is_a?(String) and /^[A-Za-z0-9\-]{1,150}$/.match(c['gravatar_id']) + x['gravatar_id'] = c['gravatar_id'] + end + # Set login when available + if c.has_key?('login') and c['login'].is_a?(String) and /^[A-Za-z0-9\-]{1,150}$/.match(c['login']) + x['login'] = c['login'] + end + # Add new contributor to the array, or increase contributions if it already exists + if result.has_key?(name) + result[name]['contributions'] += x['contributions'] + else + result[name] = x + end + end + # Generate final ordered contributors array + result.each do |key, value| + contributors.push(value) + end + contributors.sort_by{|c| - c['contributions']} end def generate(site) + # Set site.contributors global variables for liquid/jekyll class << site attr_accessor :contributors - alias contrib_site_payload site_payload def site_payload h = contrib_site_payload @@ -63,8 +90,8 @@ module Jekyll h end end - - site.contributors = merge_contributors(fetch_contributors(), site.config['aliases']).sort_by{|c| - c['contributions']} + # Populate site.contributors array + site.contributors = contributors(site.config['aliases']) end end diff --git a/_templates/development.html b/_templates/development.html index 9fa1caae..bd915b83 100755 --- a/_templates/development.html +++ b/_templates/development.html @@ -77,7 +77,7 @@ id: development
{% for c in site.contributors %} {% if c.gravatar_id %}icon{% else %}icon{% endif %} - {% if c.login %}{{ c.name }} ({{ c.contributions }}){% else %}{{ c.name }} ({{ c.contributions }}){% endif %} + {% if c.login %}{{ c.name | htmlescape }} ({{ c.contributions }}){% else %}{{ c.name | htmlescape }} ({{ c.contributions }}){% endif %} {% endfor %}
From 304c13e606f89b0b7926bfaefa6975d6ff3282d4 Mon Sep 17 00:00:00 2001 From: Saivann Date: Fri, 6 Jun 2014 15:47:06 -0400 Subject: [PATCH 12/14] Fix listtable styles for IE6-7 --- _less/ie.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_less/ie.css b/_less/ie.css index 2b34753d..f10974cb 100644 --- a/_less/ie.css +++ b/_less/ie.css @@ -225,7 +225,7 @@ body{ display:inline; } -.eventtable div div{ +.listtable div div{ zoom:1; display:inline; } From 87e31affba2906d0529aa5a1af24164bffc30172 Mon Sep 17 00:00:00 2001 From: "David A. Harding" Date: Sat, 7 Jun 2014 19:27:49 -0400 Subject: [PATCH 13/14] 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. --- _includes/guide_wallets.md | 256 ++++++++++++++++++++++- _includes/references.md | 2 + img/dev/en-wallets-distributing-only.dot | 50 +++++ img/dev/en-wallets-distributing-only.png | Bin 0 -> 5998 bytes img/dev/en-wallets-distributing-only.svg | 131 ++++++++++++ img/dev/en-wallets-full-service.dot | 30 +++ img/dev/en-wallets-full-service.png | Bin 0 -> 3818 bytes img/dev/en-wallets-full-service.svg | 95 +++++++++ img/dev/en-wallets-signing-only.dot | 50 +++++ img/dev/en-wallets-signing-only.png | Bin 0 -> 6382 bytes img/dev/en-wallets-signing-only.svg | 131 ++++++++++++ 11 files changed, 737 insertions(+), 8 deletions(-) create mode 100644 img/dev/en-wallets-distributing-only.dot create mode 100644 img/dev/en-wallets-distributing-only.png create mode 100644 img/dev/en-wallets-distributing-only.svg create mode 100644 img/dev/en-wallets-full-service.dot create mode 100644 img/dev/en-wallets-full-service.png create mode 100644 img/dev/en-wallets-full-service.svg create mode 100644 img/dev/en-wallets-signing-only.dot create mode 100644 img/dev/en-wallets-signing-only.png create mode 100644 img/dev/en-wallets-signing-only.svg diff --git a/_includes/guide_wallets.md b/_includes/guide_wallets.md index de895156..f645443a 100644 --- a/_includes/guide_wallets.md +++ b/_includes/guide_wallets.md @@ -2,11 +2,251 @@ {% autocrossref %} -Bitcoin wallets at their core are a collection of private keys. These collections are stored digitally in a file, or can even be physically stored on pieces of paper. +A Bitcoin wallet can refer to either a wallet program or a wallet file. +Wallet programs create public keys to receive satoshis and use the +corresponding private keys to spend those satoshis. Wallet files +store private keys and (optionally) other information related to +transactions for the wallet program. + +Wallet programs and wallet files are addressed below in separate +subsections, and this document attempts to always make it clear whether +we're talking about wallet programs or wallet files. {% endautocrossref %} -### Private Key Formats +### Wallet Programs + +{% autocrossref %} + +Permitting receiving and spending of satoshis is the only essential +feature of wallet software---but a particular wallet program doesn't +need to do both things. Two wallet programs can work together, one +program distributing public keys in order to receive satoshis and +another program signing transactions spending those satoshis. + +Wallet programs also need to interact with the peer-to-peer network to +get information from the block chain and to broadcast new transactions. +However, the programs which distribute public keys or sign transactions +don't need to interact with the peer-to-peer network themselves. + +This leaves us with three necessary, but separable, parts of a wallet +system: a public key distribution program, a signing program, and a +networked program. In the subsections below, we will describe common +combinations of these parts. + +{% endautocrossref %} + +#### Full-Service Wallets + +{% autocrossref %} + +The simplest wallet is a program which performs all three functions: it +generates private keys, derives the corresponding public keys, helps +distribute those public keys as necessary, monitors for outputs spent to +those public keys, creates and signs transactions spending those +outputs, and broadcasts the signed transactions. + +![Full-Service Wallets](/img/dev/en-wallets-full-service.svg) + +As of this writing, almost all popular wallets can be used as +full-service wallets. + +The main advantage of full-service wallets is that they are easy to use. +A single program does everything the user needs to receive and spend +satoshis. + +The main disadvantage of full-service wallets is that they store the +private keys on a device connected to the Internet. The compromise of +such devices is a common occurrence, and an Internet connection makes it +easy to transmit private keys from a compromised device to an attacker. + +To help protect against theft, many wallet programs offer users the +option of encrypting the wallet files which contain the private keys. +This protects the private keys when they aren't being used, but it +cannot protect against an attack designed to capture the encryption +key or to read the decrypted keys from memory. + +{% endautocrossref %} + + +#### Signing-Only Wallets + +{% autocrossref %} + +To increase security, private keys can be generated and stored by a +separate wallet program operating in a more secure environment. These +signing-only wallets work in conjunction with a networked wallet which +interacts with the peer-to-peer network. + +Signing-only wallets programs typically use deterministic key creation +(described in a later subsection) to create parent private and public +keys which can create child private and public keys. + +![Signing-Only Wallets](/img/dev/en-wallets-signing-only.svg) + +When first run, the signing-only wallet creates a parent private key and +transfers the corresponding parent public key to the networked wallet. + +The networked wallet uses the parent public key to derive child public +keys, optionally helps distribute them, monitors for outputs spent to +those public keys, creates unsigned transactions spending those outputs, +and transfers the unsigned transactions to the signing-only wallet. + +Often, users are given a chance to review the unsigned transactions' details +(particularly the output details) using the signing-only wallet. + +After the optional review step, the offline wallet uses the parent +private key to derive the appropriate child private keys and signs the +transactions, giving the signed transactions back to the networked wallet. + +The networked wallet then broadcasts the signed transactions to the +peer-to-peer network. + +The following subsections describe the two most common variants of +signing-only wallets: offline wallets and hardware wallets. + +{% endautocrossref %} + +##### Offline Wallets + +{% autocrossref %} + +Several full-service wallets programs will also operate as two separate +wallets: one program instance acting as a signing-only wallet (often called an +"offline wallet") and the other program instance acting as the networked +wallet (often called an "online wallet" or "watching-only wallet"). + +The offline wallet is so named because it is intended to be run on a +device which does not connect to any network, greatly reducing the +number of attack vectors. If this is the case, it is usually up to the +user to handle all data transfer using removable media such as USB +drives. The user's workflow is something like: + +1. (Offline) Disable all network connections on a device and install the wallet + software. Start the wallet software in offline mode to create the + parent private and public keys. Copy the parent public key to + removable media. + +2. (Online) Install the wallet software on another device, this one + connected to the Internet, and import the parent public key from the + removable media. As you would with a full-service wallet, distribute + public keys to receive payment. When ready to spend satoshis, fill in + the output details and save the unsigned transaction generated by the + wallet to removable media. + +3. (Offline) Open the unsigned transaction in the offline instance, + review the output details to make sure they spend the correct + amount to the correct address. This prevents malware on the online + wallet from tricking the user into signing a transaction which pays + an attacker. After review, sign the transaction and save it to + removable media. + +4. (Online) Open the signed transaction in the online instance so it can + broadcast it to the peer-to-peer network. + +The primary advantage of offline wallets is their possibility for +greatly improved security over full-service wallets. As long as the +offline wallet is not compromised (or flawed) and the user reviews all outgoing +transactions before signing, the user's satoshis are safe even if the +online wallet is compromised. + +The primary disadvantage of offline wallets is hassle. For maximum +security, they require the user dedicate a device to only offline tasks. +The offline device must be booted up whenever funds are to be spent, and +the user must physically copy data from the online device to the offline +device and back. + +{% endautocrossref %} + + + +##### Hardware Wallets + +{% autocrossref %} + +Hardware wallets are devices dedicated to running a signing-only wallet. +Their dedication lets them eliminate many of the vulnerabilities +present in operating systems designed for general use, allowing them +to safely communicate directly with other devices so users don't need to +transfer data manually. The user's workflow is something like: + +1. (Hardware) Create parent private and public keys. Connect hardware + wallet to a networked device so it can get the parent public key. + +2. (Networked) As you would with a full-service wallet, distribute + public keys to receive payment. When ready to spend satoshis, fill in + the transaction details, connect the hardware wallet, and click + Spend. The networked wallet will automatically send the transaction + details to the hardware wallet. + +3. (Hardware) Review the transaction details on the hardware wallet's + screen. Some hardware wallets may prompt for a passphrase or PIN + number. The hardware wallet signs the transaction and uploads it to + the networked wallet. + +4. (Networked) The networked wallet receives the signed transaction from + the hardware wallet and broadcasts it to the network. + +The primary advantage of hardware wallets is their possibility for +greatly improved security over full-service wallets with much less +hassle than offline wallets. + +The primary disadvantage of hardware wallets is their hassle. Even +though the hassle is less than that of offline wallets, the user must +still purchase a hardware wallet device and carry it with them whenever +they need to make a transaction using the signing-only wallet. + +An additional (hopefully temporary) disadvantage is that, as of this +writing, very few popular wallet programs support hardware +wallets---although almost all popular wallet programs have announced +their intention to support at least one model of hardware wallet. + +{% endautocrossref %} + + + + +#### Distributing-Only Wallets + +{% autocrossref %} + +Wallet programs which run in difficult-to-secure environments, such as +webservers, can be designed to distribute public keys (including P2PKH +or P2SH addresses) and nothing more. There are two common ways to +design these minimalist wallets: + +![Distributing-Only Wallets](/img/dev/en-wallets-distributing-only.svg) + +* Pre-populate a database with a number of public keys or addresses, and + then distribute on request an output script or address using one of + the database entries. + +* Use a parent public key to create child public keys. To [avoid key + reuse][devguide avoiding key reuse], a method must be used to ensure the same public key isn't + distributed twice. This can be a database entry for each key + distributed or an incrementing pointer to the current child key + index number. + +Neither method adds a significant amount of overhead, especially if a +database is used anyway to associate each incoming payment with a +separate public key for payment tracking. See the [Payment +Processing][devguide payment processing] section for details. + +{% endautocrossref %} + + + +### Wallet Files + +{% autocrossref %} + +Bitcoin wallets at their core are a collection of private keys. These +collections are stored digitally in a file, or can even be physically +stored on pieces of paper. + +{% endautocrossref %} + +#### Private Key Formats {% autocrossref %} @@ -16,7 +256,7 @@ Private keys are what are used to unlock satoshis from a particular address. In {% endautocrossref %} -#### Wallet Import Format (WIF) +##### Wallet Import Format (WIF) {% autocrossref %} @@ -40,7 +280,7 @@ The process is easily reversible, using the Base58 decoding function, and removi {% endautocrossref %} -#### Mini Private Key Format +##### Mini Private Key Format {% autocrossref %} @@ -62,7 +302,7 @@ address utility]. {% endautocrossref %} -### Hierarchical Deterministic Key Creation +#### Hierarchical Deterministic Key Creation + + + +wallet_program + +cluster_distributing + +Distributing-Only Wallet + +cluster_networked + +       Other Wallet(s) + + + +distributing_pub + +Derive +Child +Public +Keys + + + +distributing_distribute + +Distribute +Public +Keys + + + +distributing_pub->distributing_distribute + + + + + + +networked_monitor + +Monitor +For +Outputs + + +distributing_distribute->networked_monitor + + + + + + + + + + +networked_priv + +Create +Parent +Private +Key + + +networked_pub + +Derive +Parent +Public +Key + + +networked_priv->networked_pub + + + + + +networked_pub->distributing_pub + + + + + + + +networked_create + +Create +Unsigned +Txes + + +networked_monitor->networked_create + + + + + +networked_sign + +Sign +Txes + + + +networked_create->networked_sign + + + + +networked_broadcast + +Broadcast +Txes + + + +networked_sign->networked_broadcast + + + + + diff --git a/img/dev/en-wallets-full-service.dot b/img/dev/en-wallets-full-service.dot new file mode 100644 index 00000000..bfad5bbd --- /dev/null +++ b/img/dev/en-wallets-full-service.dot @@ -0,0 +1,30 @@ +digraph wallet_program { +size="6.25"; +rankdir=LR; +//ratio=fill; +splines=true; +fontname=Sans +ranksep=0.3; +penwidth=1.75; + +overlap = false; + +edge [ fontname=Sans, penwidth=1.75, style = "invis" ]; +node [ fontname=Sans, shape = box, penwidth=1.75 ]; + +subgraph cluster_networked { + penwidth=0; + networked_priv [ label = "Create\nPrivate\nKeys" ]; + networked_pub [ label = "Derive\nPublic\nKeys" ]; + networked_distribute [ label = "Distribute\nPublic\nKeys" ]; + networked_monitor [ label = "Monitor\nFor\nOutputs" ]; + networked_create [ label = "Create\nUnsigned\nTxes" ]; + networked_sign [ label = "Sign\nTxes" ]; + networked_broadcast [ label = "Broadcast\nTxes" ]; + + networked_priv -> networked_pub -> networked_distribute -> networked_monitor -> networked_create -> networked_sign -> networked_broadcast [ style = "" ]; + label = " \nFull-Service Wallet" +} + +} + diff --git a/img/dev/en-wallets-full-service.png b/img/dev/en-wallets-full-service.png new file mode 100644 index 0000000000000000000000000000000000000000..afa2a6ebb0db0a5799ac2c3613ae1e60cddd6af7 GIT binary patch literal 3818 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 Q|5;* + + + + + +wallet_program + +cluster_networked + + +Full-Service Wallet + + +networked_priv + +Create +Private +Keys + + +networked_pub + +Derive +Public +Keys + + +networked_priv->networked_pub + + + + +networked_distribute + +Distribute +Public +Keys + + +networked_pub->networked_distribute + + + + +networked_monitor + +Monitor +For +Outputs + + +networked_distribute->networked_monitor + + + + +networked_create + +Create +Unsigned +Txes + + +networked_monitor->networked_create + + + + +networked_sign + +Sign +Txes + + +networked_create->networked_sign + + + + +networked_broadcast + +Broadcast +Txes + + +networked_sign->networked_broadcast + + + + + diff --git a/img/dev/en-wallets-signing-only.dot b/img/dev/en-wallets-signing-only.dot new file mode 100644 index 00000000..166480d1 --- /dev/null +++ b/img/dev/en-wallets-signing-only.dot @@ -0,0 +1,50 @@ +digraph wallet_program { +size="6.25"; +rankdir=LR; +//ratio=fill; +splines=true; +fontname=Sans +ranksep=0.3; +penwidth=1.75; + +overlap = false; + +edge [ fontname=Sans, penwidth=1.75, style = "invis" ]; +node [ fontname=Sans, shape = box, penwidth=1.75 ]; + +subgraph cluster_signing { + penwidth=0; + + signing_priv [ label = "Create\nParent\nPrivate\nKey" ]; + signing_pub [ label = "Derive\nParent\nPublic\nKey" ]; + signing_distribute [ label = "Distribute\nPublic\nKeys", style="invis" ]; + signing_monitor [ label = "Monitor\nFor\nOutputs", style="invis" ]; + signing_create [ label = "Create\nUnsigned\nTxes", style="invis" ]; + signing_sign [ label = "Sign\nTxes" ]; + signing_broadcast [ label = "Broadcast\nTxes", style="invis" ]; + + signing_priv -> signing_pub -> signing_distribute -> signing_monitor -> signing_create -> signing_sign -> signing_broadcast; + label = "Signing-Only Wallet" +} + +subgraph cluster_networked { + penwidth=0; + + networked_priv [ label = "Create\nPrivate\nKeys", style="invis" ]; + networked_pub [ label = "Derive\nChild\nPublic\nKeys" ]; + networked_distribute [ label = "Distribute\nPublic\nKeys" ]; + networked_monitor [ label = "Monitor\nFor\nOutputs" ]; + networked_create [ label = "Create\nUnsigned\nTxes" ]; + networked_sign [ label = "Sign\nTxes", style="invis" ]; + networked_broadcast [ label = "Broadcast\nTxes" ]; + + networked_priv -> networked_pub -> networked_distribute -> networked_monitor -> networked_create -> networked_sign -> networked_broadcast; + label = "Networked Wallet" +} + +signing_priv -> signing_pub [style=""]; +signing_pub -> networked_pub [ constraint = false, style = ""]; +networked_pub -> networked_distribute -> networked_monitor -> networked_create -> signing_sign -> networked_broadcast [style=""]; + +} + diff --git a/img/dev/en-wallets-signing-only.png b/img/dev/en-wallets-signing-only.png new file mode 100644 index 0000000000000000000000000000000000000000..0bbf4246dbf1dff7be7e8f17fd21c22d7dc034bb GIT binary patch literal 6382 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 + + + + + +wallet_program + +cluster_signing + +Signing-Only Wallet + +cluster_networked + +Networked Wallet + + +signing_priv + +Create +Parent +Private +Key + + +signing_pub + +Derive +Parent +Public +Key + + + +signing_priv->signing_pub + + + + + + +networked_pub + +Derive +Child +Public +Keys + + +signing_pub->networked_pub + + + + + + + + +signing_sign + +Sign +Txes + + + + + +networked_broadcast + +Broadcast +Txes + + +signing_sign->networked_broadcast + + + + + + +networked_distribute + +Distribute +Public +Keys + + +networked_pub->networked_distribute + + + + + +networked_monitor + +Monitor +For +Outputs + + +networked_distribute->networked_monitor + + + + + +networked_create + +Create +Unsigned +Txes + + +networked_monitor->networked_create + + + + + +networked_create->signing_sign + + + + + + + + From 63e838fa8c7b3e64f277d73a3c14b049a2a06344 Mon Sep 17 00:00:00 2001 From: "David A. Harding" Date: Mon, 9 Jun 2014 13:14:05 -0400 Subject: [PATCH 14/14] Small fixes suggested by @saivann (thanks!) --- _autocrossref.yaml | 3 +++ _includes/guide_wallets.md | 16 ++++++++++++---- _includes/references.md | 2 +- 3 files changed, 16 insertions(+), 5 deletions(-) diff --git a/_autocrossref.yaml b/_autocrossref.yaml index 627812fd..c34bb6ba 100644 --- a/_autocrossref.yaml +++ b/_autocrossref.yaml @@ -36,6 +36,7 @@ change output: change outputs: change output child key: child keys: child key +child private and public keys: child key child public key: child public keys: child public key coinbase: coinbase transaction @@ -122,7 +123,9 @@ p2pkh: p2sh: p2sh multisig: parent chain code: +parent key: parent private key: +parent private and public keys: parent key parent public key: Payment message: pp payment payment protocol: diff --git a/_includes/guide_wallets.md b/_includes/guide_wallets.md index f645443a..49da269e 100644 --- a/_includes/guide_wallets.md +++ b/_includes/guide_wallets.md @@ -34,6 +34,11 @@ system: a public key distribution program, a signing program, and a networked program. In the subsections below, we will describe common combinations of these parts. +Note: we speak about distributing public keys generically. In many +cases, P2PKH or P2SH hashes will be distributed instead of public keys, +with the actual public keys only being distributed when the outputs +they control are spent. + {% endautocrossref %} #### Full-Service Wallets @@ -219,10 +224,13 @@ design these minimalist wallets: * Pre-populate a database with a number of public keys or addresses, and then distribute on request an output script or address using one of - the database entries. + the database entries. To [avoid key reuse][devguide avoiding key + resuse], webservers should keep track + of used keys and never run out of public keys. This can be made easier + by using parent public keys as suggested in the next method. -* Use a parent public key to create child public keys. To [avoid key - reuse][devguide avoiding key reuse], a method must be used to ensure the same public key isn't +* Use a parent public key to create child public keys. To avoid key + reuse, a method must be used to ensure the same public key isn't distributed twice. This can be a database entry for each key distributed or an incrementing pointer to the current child key index number. @@ -349,7 +357,7 @@ sum divided by a global constant used by all Bitcoin software (*G*): This means that two or more independent programs which agree on a sequence of integers can create a series of unique [child key][]{:#term-child-key}{:.term} pairs from -a single parent key pair without any further communication. +a single [parent key][]{:#term-parent-key}{:.term} pair without any further communication. Moreover, the program which distributes new public keys for receiving payment can do so without any access to the private keys, allowing the public key distribution program to run on a possibly-insecure platform such as diff --git a/_includes/references.md b/_includes/references.md index f85ddfb9..19122917 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -86,6 +86,7 @@ [P2SH]: /en/developer-guide#term-p2sh "A script which Pays To Script Hashes (P2SH), allowing convenient spending of satoshis to an address referencing a script" [P2SH multisig]: /en/developer-guide#term-p2sh-multisig "A multisig script embedded in the redeemScript of a pay-to-script-hash (P2SH) transaction" [parent chain code]: /en/developer-guide#term-parent-chain-code "A chain code which has helped create child public or private keys" +[parent key]: /en/developer-guide#term-parent-key "In HD wallets, a key capable of deriving child keys" [parent private key]: /en/developer-guide#term-parent-private-key "A private key which has created child private keys" [parent public key]: /en/developer-guide#term-parent-public-key "A public key corresponding to a parent private key which has child private keys" [payment protocol]: /en/developer-guide#term-payment-protocol "The protocol defined in BIP70 which lets spenders get signed payment details from receivers" @@ -101,7 +102,6 @@ [private keys]: /en/developer-guide#term-private-key "The private portion of a keypair which can create signatures which other people can verify using the public key" [pubkey hash]: /en/developer-guide#term-pubkey-hash "The hash of a public key which can be included in a P2PKH output" [public key]: /en/developer-guide#term-public-key "The public portion of a keypair which can be safely distributed to other people so they can verify a signature created with the corresponding private key" -[public keys]: /en/developer-guide#term-public-key "The public portion of a keypair which can be safely distributed to other people so they can verify a signature created with the corresponding private key" [pp amount]: /en/developer-guide#term-pp-amount "Part of the Output part of the PaymentDetails part of a payment protocol where receivers can specify the amount of satoshis they want paid to a particular output script" [pp expires]: /en/developer-guide#term-pp-expires "The expires field of a PaymentDetails where the receiver tells the spender when the PaymentDetails expires" [pp memo]: /en/developer-guide#term-pp-memo "The memo fields of PaymentDetails, Payment, and PaymentACK which allow spenders and receivers to send each other memos"