Bitcoin Wiki - User contributions [en]

Merchant Howto

2015-03-02T04:49:14Z

Haxwell: /* Pre-generating Bitcoin addresses */

{{merge|How to accept Bitcoin, for small businesses}}

Accepting Bitcoins is easy, and there are several ways to do it.

==Manually==
# Download a bitcoin client
# When a customer wants to buy something, send them a Bitcoin address where their payment should be sent.
#* You can do this by clicking "New.." next to your address in the Bitcoin client and sending that address to the customer.
# When payment comes in to that address, send the goods to your customer. Depending on the value of what you're selling, you may wish to wait until the payment shows Confirmed.
# To issue a refund, obtain from the customer the [[Address|bitcoin address]] where the refund payment should be sent. The refund address will likely be different from the address used when the customer sent payment, especially if an [[EWallet]] was used by the customer.

==Automated==
===Pre-generating Bitcoin addresses===
You can accept Bitcoins on your website without needing to use Bitcoin APIs or third party services if you pre-generate a large number of receiving Bitcoin addresses and store them in a database on your web server, and dispense them one-by-one to customers when they are ready to pay. This way, your web server never actually handles the bitcoins - it simply gives out addresses belonging to a wallet you maintain elsewhere. By using a unique address per order, you will always know which payment belongs to which order. [https://www.casascius.com Example of website using this method]

To pre-generate addresses, use a tool such as [[Pywallet]] (which can generate a wallet.dat file) or [[Bitcoin Address Utility]] (which can generate a CSV file). In both cases, you will be generating a list of [[Address|Bitcoin address]]es along with their corresponding [[private key]]s. Only the Bitcoin addresses (not the private keys) should be loaded on the web server.

If you are shipping goods manually, you can use the Bitcoin software to check for incoming payments, or alternately consider using [[Block Explorer]] or [[Abe]] to verify payment when you're about to ship. To make this easy, make your website provide you a full hyperlink that includes the proper receiving address: ht<nowiki>tp://www</nowiki>.blockexplorer.com/address/ADDRESSGOESHERE.

If you are delivering digital goods or services and want to be able to deliver instantly upon payment and/or confirmation, you can use a third-party service such as [[Bitcoin Notify]] to tell your website when a payment has been received. This sort of service requires no significant API implementation - they will simply make a POST to your website or send you an e-mail when a payment has been received on one of your addresses.

If you keep Bitcoins off your web server, this ensures your wallet cannot be stolen if your web server experiences a security intrusion. Your risk becomes limited to the possibility that a successful intruder could add his own addresses to your address pool and steal funds from a few incoming orders until you detect the problem, however, this is a [[Deterministic_wallet|relatively controllable risk]].

===Using offchain payment networks===

[[Off-Chain_Transactions|Off chain]] networks provides various benefits to Bitcoin, such as instant confirmations and protection against double spending.

===Using a third-party plugin===
You can use an existing [[:Category:Shopping Cart Interfaces|shopping cart interface]] from a 3rd party to automatically handle all Bitcoin payments on your website. If you want to develop the system yourself, you can utilize the Bitcoin client's [[API tutorial (JSON-RPC)|JSON-RPC API]] to automatically accept payments.

Things to note if you build it yourself:
# When a customer orders something on your website it records:
#* Bitcoin address that payment should be sent to
#* Order details (delivery address etc.)
#* Customer's refund address (optional - if you wish you can ask for this later, only in cases a refund is required)
#* Payment amount
# When payment arrives, checks that they have paid the correct amount or not, and informs you
#* You dispatch the goods to the customer and mark the order as fulfilled
#* If you cannot dispatch the goods you mark the order as denied and ask the customer for a refund address (unless you already have it from earlier) to send a refund.
# Forwards the funds to bitcoin address of your choice

===If You have a retail business and do not have internet or smart phone===
You can still accept Bitcoin. [https://easybitz.com/merchant] EasyBitz.com has a very simple way to accept bitcoin with just a print out and a phone that gets sms text messages.

[[File:Easybitz bitcoin pointofsale.png|400 px|alt=Accept Bitcoin without internet|EasyBitz ZeroClick System|link=https://easybitz.com/merchant]]

===Businesses that mail invoices===
Does your business send out invoices to customers? Adding one line may make a huge impact for the Bitcoin economy. Perhaps you list it as a payment option just after Visa, MasterCard, and American Express, even if that means your customer must call or e-mail to make a payment. However it is possible to create automated invoices by using known payment systems supporting invoicing, and recurring invoice setup.

==Common Errors==
It has been observed on occasion that a business funnels all its orders through the same Bitcoin address, and asks people to send some BTC, then send email describing the timing and the amount of the transaction to 'claim' it. This is '''not''' secure, since anyone can see the transaction details using a tool such as [[Block Explorer]], and then try to claim someone else's transaction as theirs.

Do not do this. Give each customer a unique Bitcoin address.

==Listing your business on the Bitcoin Trade page==

Anyone can add and update a listing on the [[Trade|trade]] page. Just register if you haven't and add to the appropriate category. If you'ld like assistance, perhaps someone in the [http://webchat.freenode.net/?channels=#bitcoin-marketing #bitcoin-marketing] IRC channel would be willing to assist. If you have a brick and mortar business that accepts bitcoin you can add it to the bitcoin directories. [https://easybitz.com] [http://coinmap.org]

==Services==
* [[File:Bitfavicon.png|20px|link=http://www.bitcoinpaygate.com]] [http://www.bitcoinpaygate.com Bitcoinpaygate] Bitcoin payment processing for the web & in store payments
* [https://bitcoinpay.com BitcoinPay] Merchant solution for Bitcoin specialized in Middle Europe (Germany, Poland, Slovakia, Czech republic)
* [https://www.BitKassa.nl BitKassa] Merchant solution for accepting bitcoins, getting euro's. No fee. The Netherlands.
* [[BitPay]] Merchant solutions for Bitcoin
* [http://www.bitpagos.net BitPagos] Payments Gateway for Latin America
* [https://coinbase.com/merchants Coinbase] Offers payment buttons, pages, iframes, shopping cart integration, subscription/recurring billing, micro-transactions, and cash out to your local currency for 1%.
* [https://cryptopay.me/ Cryptopay] Bitcoin merchant payment processing. UK-based, serving UK and EU clients.
* [http://www.dcpos.com DC POS] A Bitcoin browser-based Point-of-Sale app. It is hardware, OS, wallet, and browser agnostic. 0.5% transaction fee.
* [[Coinify]] Merchant solutions for Bitcoin
* [[File:Easybitz.png|20px|link=https://easybitz.com]] [https://easybitz.com EasyBitz] Bitcoin for Retail worldwide. ZeroClick requires only SMS. POS works on SmartPhones and Tablets. Live Transaction Global Map. No fees.
* [http://www.fraudlabspro.com/ FraudLabs Pro] Fraud screening service for online merchants. Support transactions using Bitcoin as payment method.
* [[File:gocoin-logo.png|20px|link=https://www.gocoin.com]] [[GoCoin]] International Payment Processing for Bitcoin
* [https://gourl.io Gourl.io] Bitcoin Payment Gateway with ready to use php scripts - Pay-Per-Download, Pay-Per-Product, Pay-Per-Registration.
* [[File:MCS_200by200_logo-01.png|20px|link=http://www.mycoinsolution.com]][http://www.mycoinsolution.com My Coin Solution] - Bitcoin consulting services and solutions
* [[File:Coinkite.gif|20px|link=https://coinkite.com]] [https://coinkite.com/faq Coinkite] Full-reserve banking, payment buttons, invoice pages, hardware POS terminals, and Debit-Cards.
* [https://xbterminal.com/ XBTerminal] Brick-and-mortar hardware POS terminals with payment processing integrations.
* [[File:Payful.png|20px|link=http://payful.io]] [http://payful.io Payful] Accept bitcoin - point of sale, shopping cart plugins and API. Supports payment processing in US dollars, Euros and Canadian dollars.
* [http://paysius.com Paysius] Allows merchants to easily and securely accept Bitcoin payments on their website

==See Also==
* [[In-store Transactions]]
* [[:Category:Shopping Cart Interfaces|Shopping Cart Interfaces]]
* [[Securing online services]]
* [[Bitcoin Evolution]] handles sales tracking and order forms; requires Bitcoin client for actual payment
* [[Bitcoin API Services]] an easy solution for securely accepting Bitcoins and updating BTC prices
* [[Converter|Bitcoin Javascript Converter]] displays a price in BTCs after converting from USDs.
* [[How to accept Bitcoin, for small businesses]]
* [[:Category:Marketing|Marketing]]
* [[URI Scheme]]
* [[Promotional graphics]], buttons and logos
* [https://github.com/cryptoapi/Payment-Gateway GoUrl Bitcoin Payment API] open source php payment api on Github.com
* [[Lazy API]] The lazy (and possibly easiest?) way to accept bitcoin payments on your website
* [http://snowcron.com Snowcron] Bitcoin Store Engine: Handles payments, sends your customers information they ordered (reg. codes, passwords...) No web programming required.
[[Category:ECommerce]]

Bitcoind

2015-02-28T17:11:10Z

Haxwell: /* Running */

{{outdated}}
Bitcoind is a program that implements the Bitcoin protocol for command line and remote procedure call (RPC) use. It is also the first Bitcoin [[Clients|client]] in the network's history. It is available under the [http://www.opensource.org/licenses/mit-license.php MIT license] in 32-bit and 64-bit versions for Windows, GNU/Linux-based OSes, and Mac OS X.

Prior to version 0.5, this service-provider client used a wxWidgets GUI as its default GUI. It is now instead bundled with [[Bitcoin-Qt]].

=== Running ===

See [[Running_bitcoind|running bitcoind]] for more detail and an example of the configuration file.

Bitcoind is a headless daemon, and also bundles a testing tool for the same daemon. It provides a JSON-RPC interface, allowing it to be controlled locally or remotely which makes it useful for integration with other software or in larger payment systems. [[Original Bitcoin client/API Calls list|Various commands]] are made available by the API.

To use locally, first start the program in daemon mode:
:bitcoind -daemon

Then you can execute [[Original Bitcoin client/API Calls list|API commands]], e.g.:
:bitcoin-cli getinfo
:bitcoin-cli listtransactions

To stop the bitcoin daemon, execute:
:bitcoin-cli stop

==History of official bitcoind (and predecessor) releases==
{| class="wikitable"
|-
! Version
! Date
! Supported platforms
! Reference
|-
| 0.7.2
| 2012-Dec-14
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=130819.msg1399721#msg1399721 Bitcoin-Qt/bitcoind version 0.7.2 released]</ref>
|-
| 0.5.7
| 2012-Nov-23
|
|
|-
| 0.7.1
| 2012-Oct-19
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=119277.msg1283232#msg1283232 Bitcoin-Qt/bitcoind version 0.7.1 released]</ref>
|-
| 0.7.0
| 2012-Sep-17
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=110243.msg1199467 Bitcoin-Qt/bitcoind version 0.7.0 released]</ref>
|-
| 0.5.6
| 2012-Jul-22
| Windows32 / Linux / MacOS X
|
|-
| 0.4.7
| 2012-Jul-22
| Windows32
|
|-
| 0.6.0.9
| 2012-Jul-08
|
|
|-
| 0.6.3
| 2012-Jun-25
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=89877.msg989356#msg989356 Bitcoin-Qt / bitcoind version 0.6.3 released]</ref>
|-
| 0.6.2
| 2012-May-08
| Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=78829.msg888578#msg888578 Re: Version 0.6.1 release candidate 2]</ref>
|-
| 0.6.1
| 2012-May-04
| Windows32 / Linux / MacOS X
|
|-
| 0.6.0.7
| 2012-May-04
|
|
|-
| 0.5.5
| 2012-May-04
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=79651 Version 0.5.5 and 0.4.6 released]</ref>
|-
| 0.4.6
| 2012-May-04
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=79651 Version 0.5.5 and 0.4.6 released]</ref>
|-
| 0.5.4
| 2012-Apr-15
| Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=76808.0 Version 0.5.4 released]</ref>
|-
| 0.4.5
| 2012-Apr-15
|
|
|-
| 0.6.0
| 2012-Mar-30
| Windows32 / Linux / MacOS X
| <ref>[http://www.bitcoinforum.com/bitcoin-discussion/bitcoin-org-bitcoin-version-0-6-0-released/ bitcoin.org: Bitcoin version 0.6.0 released]</ref>
|-
| 0.5.3.1
| 2012-Mar-17
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=69120.0 URGENT: Windows Bitcoin-Qt update]</ref>
|-
| 0.5.3
| 2012-Mar-14
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=68895.0 Bitcoin-Qt, bitcoind version 0.5.3 released]</ref>
|-
| 0.4.4
| 2012-Mar-14
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=70566.0 bitcoind version 0.4.4 released]</ref>
|-
| 0.5.2
| 2012-Jan-09
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=60146.0 Bitcoin-Qt, bitcoind version 0.5.2 released]</ref>
|-
| 0.4.3
| 2012-Jan-09
| Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=57734.0 bitcoind version 0.4.3 released]</ref>
|-
| 0.5.1
| 2011-Dec-15
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=54717.0 Bitcoin-Qt, bitcoind version 0.5.1 released]</ref>
|-
| 0.4.2
| 2011-Dec-12
|
|
|-
| 0.5.0
| 2011-Nov-21
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=52480.0 Bitcoin-Qt/bitcoind version 0.5.0]</ref>
|-
| 0.4.1
| 2011-Nov-21
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=52503.0 wxBitcoin/bitcoind version 0.4.1]</ref>
|-
| 0.4.0
| 2011-Sep-23
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=45410.0 Bitcoin version 0.4.0 released]</ref>
|-
| 0.3.24
| 2011-Jul-08
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=27187.0 Bitcoin version 0.3.24 released]</ref>
|-
| 0.3.23
| 2011-Jun-13
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=16553.0 Bitcoin version 0.3.23 released]</ref>
|-
| 0.3.22
| 2011-Jun-05
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=12269.0 Bitcoin version 0.3.22]</ref>
|-
| 0.3.21
| 2011-Apr-27
| Windows32 / Linux / MacOS X
| <ref>[http://bitcointalk.org/?topic=6642.0 Bitcoin version 0.3.21]</ref>
|-
| 0.3.20
| 2011-Feb-21
| Windows32 / Linux / MacOS X
| <ref>[http://www.bitcoin.org/smf/index.php?topic=3704.0 Version 0.3.20]</ref>
|-
|0.3.19
|2010-12-12
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=2228.msg29479#msg29479 Added some DoS limits, removed safe mode (0.3.19)]</ref>
|-
|0.3.18
|2010-12-08
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=2162.0 Version 0.3.18]</ref>
|-
|0.3.17
|2010-11-25
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=1946.0 Version 0.3.17]</ref>
|-
|0.3.15
|2010-11-13
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=1780.0 Version 0.3.15]</ref>
|-
|0.3.14
|2010-10-21
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=1528.0 Version 0.3.14]</ref>
|-
|0.3.13
|2010-10-01
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=1327.0 Version 0.3.13, please upgrade]</ref>
|-
|0.3.12
|2010-09-07
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=999.0 Version 0.3.12 is now available.]</ref>
|-
|0.3.11
|2010-08-27
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=941.0 Version 0.3.11 is now available.]</ref>
|-
|0.3.10
|2010-08-15
|Windows32 / Linux32/64 / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=820.msg9452#msg9452 tcatm's 4-way SSE2 for Linux 32/64-bit is in 0.3.10]</ref>
|-
|0.3.8.1
|2010-08-09
|Linux64
|<ref>[https://bitcointalk.org/index.php?topic=765.0 Version 0.3.8.1 update for Linux 64-bit]</ref>
|-
|0.3.8
|2010-08-03
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=696.0 Please upgrade to 0.3.8!]</ref>
|-
|0.3.7
|2010-08-01
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=664.0 0.3.7 Changes]</ref>
|-
|0.3.6
|2010-07-29
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=626.0 *** ALERT *** Upgrade to 0.3.6]</ref>
|-
|0.3.3
|2010-07-25
|Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=570.0 Bitcoin 0.3.3 released -- PLEASE UPGRADE]</ref>
|-
|0.3.2.5
|2010-07-24
|Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=556.0 Version 0.3.2.5 -- please test!]</ref>
|-
|0.3.2
|2010-07-17
|Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=437.0 Bitcoin 0.3.2 released]</ref>
|-
|0.3.1
|2010-07-15
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=383.0 Bitcoin 0.3.1 released]</ref>
|-
|0.3.0
|2010-07-06
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=238.0 Bitcoin 0.3 released!]</ref><ref>[http://sourceforge.net/mailarchive/message.php?msg_id=25686730 Bitcoin 0.3 released!]</ref>
|-
|0.2.0
|2009-12-17 06:52
|Windows XP /Vista / Linux
|<ref>[https://bitcointalk.org/index.php?topic=16.0 Bitcoin 0.2 released!]</ref><ref>[http://sourceforge.net/mailarchive/message.php?msg_id=24205662 Bitcoin 0.2 released]</ref>
|-
|0.1.5
|2009-02-04 19:46
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21500063 Bitcoin v0.1.5 released]</ref>
|-
|0.1.3
|2009-01-12 22:48
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21313152 Bitcoin v0.1.3]</ref>
|-
|0.1.2
|2009-01-11 22:32
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21303153 Bitcoin v0.1.2 now available]</ref>
|-
|0.1.0
|2009-01-09
|Windows NT/2000/XP
|
|}

Up to and including version 0.3.19 is the "Satoshi code". The founder retired from development with end of 2010. [https://bitcointalk.org/index.php?topic=68121.10;wap2/ Here] are three URLs given where you still(!) (2013-01-04) can download one of the [[Satoshi client|"original Satoshi codes"]]. So also this [http://www.antepedia.com/detail/p/237812136.html Bitcoin release history].

==Theory of Operation==

bitcoind is a multithreaded C++ program. It is designed to be portable across Windows, Mac, and Linux systems. The multithreaded aspect leads to some complexity and the use of certain code patterns to deal with concurrency that may be unfamiliar to many programmers. Also, the code is aggressive in the use of C++ constructs, so it will help to be fluent with map, multimap, set, string, vector, iostream, and templates. As is typical of a C++ program, a lot of code tends to end up in the header files so be sure to search both the .cpp and .h files when looking for a function.

The client is oriented around several major operations, which are described in separate detailed articles and summarized in the following sections.

===[[Satoshi Client Initialization and Startup|Initialization and Startup]]===
Upon startup, the client performs various initialization routines including starting multiple threads to handle concurrent operations.

===[[Satoshi Client Node Discovery|Node Discovery]]===
The client uses various techniques to find out about other Bitcoin nodes that are currently connected to the network.

===[[Satoshi Client Node Connectivity|Node Connectivity]]===
The client initiates and maintains connections to other nodes.

===[[Satoshi Client Sockets and Messages|Sockets and Messages]]===
The client processes messages from other nodes and sends messages to other nodes using socket connections.

===[[Satoshi Client Block Exchange|Block Exchange]]===
Nodes advertise their inventory of blocks to each other and exchange blocks to build block chains.

===[[Satoshi Client Transaction Exchange|Transaction Exchange]]===
Nodes exchange and relay transactions with each other. The client associates transactions with bitcoin addresses in the local wallet.

===Wallet Services===
The client can create transactions using the local wallet. The client associates transactions with bitcoin addresses in the local wallet. The client provides a service for managing the local wallet.

===RPC Interface===
The client offers an JSON-RPC interface over HTTP over sockets to perform various operational functions and to manage the local wallet.

===User Interface===
Bitcoind's current user interface is the command line while it used to be based on [http://www.wxwidgets.org wxWidgets]. A graphical user interface is now provided by [[Bitcoin-qt]] in version 0.5+ for the reference client.

==Troubleshooting==

===I get "Error loading blkindex.dat" when I try to run the client===

blkindex.dat is part of the database that stores the local copy of the blockchain which may have become corrupted. Open the Bitcoin data dir:

Windows: %APPDATA%\Bitcoin
Linux: ~/.bitcoin
Mac: ~/Library/Application Support/Bitcoin/

Make a backup of that entire folder, then delete everything EXCEPT wallet.dat. Start bitcoind again and it will download a fresh copy of the blockchain.

==See Also==

* [[Original Bitcoin client/API calls list]]
* [[Protocol specification|Bitcoin network protocol]]
* [[Development process]]
* [[Release process]]
* [[Changelog]]

==External Links==
* [https://github.com/bitcoin/bitcoin/ Bitcoin Client project on Github]

==References==
<references />
`
[[es:Bitcoind]]

[[Category:Nodes]]
[[Category:Wallets]]
[[Category:User Interfaces]]
[[Category:Clients]]
[[Category:Developer]]
[[Category:Technical]]
[[Category:Free Software]]
[[Category:License/MIT-X11]]
[[Category:Open Source]]

Bitcoind

2015-02-28T17:10:08Z

Haxwell: /* Running */

{{outdated}}
Bitcoind is a program that implements the Bitcoin protocol for command line and remote procedure call (RPC) use. It is also the first Bitcoin [[Clients|client]] in the network's history. It is available under the [http://www.opensource.org/licenses/mit-license.php MIT license] in 32-bit and 64-bit versions for Windows, GNU/Linux-based OSes, and Mac OS X.

Prior to version 0.5, this service-provider client used a wxWidgets GUI as its default GUI. It is now instead bundled with [[Bitcoin-Qt]].

=== Running ===

See [[Running_bitcoind|running bitcoind]] for more detail and an example of the configuration file.

Bitcoind is a headless daemon, and also bundles a testing tool for the same daemon. It provides a JSON-RPC interface, allowing it to be controlled locally or remotely which makes it useful for integration with other software or in larger payment systems. [[Original Bitcoin client/API Calls list|Various commands]] are made available by the API.

To use locally, first start the program in daemon mode:
:bitcoind -daemon

Then you can use the same program to execute [[Original Bitcoin client/API Calls list|API commands]], e.g.:
:bitcoin-cli getinfo
:bitcoin-cli listtransactions

To stop the bitcoin daemon, execute:
:bitcoin-cli stop

==History of official bitcoind (and predecessor) releases==
{| class="wikitable"
|-
! Version
! Date
! Supported platforms
! Reference
|-
| 0.7.2
| 2012-Dec-14
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=130819.msg1399721#msg1399721 Bitcoin-Qt/bitcoind version 0.7.2 released]</ref>
|-
| 0.5.7
| 2012-Nov-23
|
|
|-
| 0.7.1
| 2012-Oct-19
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=119277.msg1283232#msg1283232 Bitcoin-Qt/bitcoind version 0.7.1 released]</ref>
|-
| 0.7.0
| 2012-Sep-17
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=110243.msg1199467 Bitcoin-Qt/bitcoind version 0.7.0 released]</ref>
|-
| 0.5.6
| 2012-Jul-22
| Windows32 / Linux / MacOS X
|
|-
| 0.4.7
| 2012-Jul-22
| Windows32
|
|-
| 0.6.0.9
| 2012-Jul-08
|
|
|-
| 0.6.3
| 2012-Jun-25
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=89877.msg989356#msg989356 Bitcoin-Qt / bitcoind version 0.6.3 released]</ref>
|-
| 0.6.2
| 2012-May-08
| Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=78829.msg888578#msg888578 Re: Version 0.6.1 release candidate 2]</ref>
|-
| 0.6.1
| 2012-May-04
| Windows32 / Linux / MacOS X
|
|-
| 0.6.0.7
| 2012-May-04
|
|
|-
| 0.5.5
| 2012-May-04
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=79651 Version 0.5.5 and 0.4.6 released]</ref>
|-
| 0.4.6
| 2012-May-04
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=79651 Version 0.5.5 and 0.4.6 released]</ref>
|-
| 0.5.4
| 2012-Apr-15
| Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=76808.0 Version 0.5.4 released]</ref>
|-
| 0.4.5
| 2012-Apr-15
|
|
|-
| 0.6.0
| 2012-Mar-30
| Windows32 / Linux / MacOS X
| <ref>[http://www.bitcoinforum.com/bitcoin-discussion/bitcoin-org-bitcoin-version-0-6-0-released/ bitcoin.org: Bitcoin version 0.6.0 released]</ref>
|-
| 0.5.3.1
| 2012-Mar-17
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=69120.0 URGENT: Windows Bitcoin-Qt update]</ref>
|-
| 0.5.3
| 2012-Mar-14
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=68895.0 Bitcoin-Qt, bitcoind version 0.5.3 released]</ref>
|-
| 0.4.4
| 2012-Mar-14
| Windows32
| <ref>[https://bitcointalk.org/index.php?topic=70566.0 bitcoind version 0.4.4 released]</ref>
|-
| 0.5.2
| 2012-Jan-09
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=60146.0 Bitcoin-Qt, bitcoind version 0.5.2 released]</ref>
|-
| 0.4.3
| 2012-Jan-09
| Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=57734.0 bitcoind version 0.4.3 released]</ref>
|-
| 0.5.1
| 2011-Dec-15
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=54717.0 Bitcoin-Qt, bitcoind version 0.5.1 released]</ref>
|-
| 0.4.2
| 2011-Dec-12
|
|
|-
| 0.5.0
| 2011-Nov-21
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=52480.0 Bitcoin-Qt/bitcoind version 0.5.0]</ref>
|-
| 0.4.1
| 2011-Nov-21
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=52503.0 wxBitcoin/bitcoind version 0.4.1]</ref>
|-
| 0.4.0
| 2011-Sep-23
| Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=45410.0 Bitcoin version 0.4.0 released]</ref>
|-
| 0.3.24
| 2011-Jul-08
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=27187.0 Bitcoin version 0.3.24 released]</ref>
|-
| 0.3.23
| 2011-Jun-13
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=16553.0 Bitcoin version 0.3.23 released]</ref>
|-
| 0.3.22
| 2011-Jun-05
| Windows32 / Linux / MacOS X
| <ref>[http://forum.bitcoin.org/index.php?topic=12269.0 Bitcoin version 0.3.22]</ref>
|-
| 0.3.21
| 2011-Apr-27
| Windows32 / Linux / MacOS X
| <ref>[http://bitcointalk.org/?topic=6642.0 Bitcoin version 0.3.21]</ref>
|-
| 0.3.20
| 2011-Feb-21
| Windows32 / Linux / MacOS X
| <ref>[http://www.bitcoin.org/smf/index.php?topic=3704.0 Version 0.3.20]</ref>
|-
|0.3.19
|2010-12-12
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=2228.msg29479#msg29479 Added some DoS limits, removed safe mode (0.3.19)]</ref>
|-
|0.3.18
|2010-12-08
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=2162.0 Version 0.3.18]</ref>
|-
|0.3.17
|2010-11-25
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=1946.0 Version 0.3.17]</ref>
|-
|0.3.15
|2010-11-13
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=1780.0 Version 0.3.15]</ref>
|-
|0.3.14
|2010-10-21
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=1528.0 Version 0.3.14]</ref>
|-
|0.3.13
|2010-10-01
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=1327.0 Version 0.3.13, please upgrade]</ref>
|-
|0.3.12
|2010-09-07
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=999.0 Version 0.3.12 is now available.]</ref>
|-
|0.3.11
|2010-08-27
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=941.0 Version 0.3.11 is now available.]</ref>
|-
|0.3.10
|2010-08-15
|Windows32 / Linux32/64 / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=820.msg9452#msg9452 tcatm's 4-way SSE2 for Linux 32/64-bit is in 0.3.10]</ref>
|-
|0.3.8.1
|2010-08-09
|Linux64
|<ref>[https://bitcointalk.org/index.php?topic=765.0 Version 0.3.8.1 update for Linux 64-bit]</ref>
|-
|0.3.8
|2010-08-03
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=696.0 Please upgrade to 0.3.8!]</ref>
|-
|0.3.7
|2010-08-01
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=664.0 0.3.7 Changes]</ref>
|-
|0.3.6
|2010-07-29
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=626.0 *** ALERT *** Upgrade to 0.3.6]</ref>
|-
|0.3.3
|2010-07-25
|Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=570.0 Bitcoin 0.3.3 released -- PLEASE UPGRADE]</ref>
|-
|0.3.2.5
|2010-07-24
|Windows32 / Linux
| <ref>[https://bitcointalk.org/index.php?topic=556.0 Version 0.3.2.5 -- please test!]</ref>
|-
|0.3.2
|2010-07-17
|Windows32 / Linux / MacOS X
| <ref>[https://bitcointalk.org/index.php?topic=437.0 Bitcoin 0.3.2 released]</ref>
|-
|0.3.1
|2010-07-15
|Windows32 / Linux
|<ref>[https://bitcointalk.org/index.php?topic=383.0 Bitcoin 0.3.1 released]</ref>
|-
|0.3.0
|2010-07-06
|Windows32 / Linux / MacOS X
|<ref>[https://bitcointalk.org/index.php?topic=238.0 Bitcoin 0.3 released!]</ref><ref>[http://sourceforge.net/mailarchive/message.php?msg_id=25686730 Bitcoin 0.3 released!]</ref>
|-
|0.2.0
|2009-12-17 06:52
|Windows XP /Vista / Linux
|<ref>[https://bitcointalk.org/index.php?topic=16.0 Bitcoin 0.2 released!]</ref><ref>[http://sourceforge.net/mailarchive/message.php?msg_id=24205662 Bitcoin 0.2 released]</ref>
|-
|0.1.5
|2009-02-04 19:46
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21500063 Bitcoin v0.1.5 released]</ref>
|-
|0.1.3
|2009-01-12 22:48
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21313152 Bitcoin v0.1.3]</ref>
|-
|0.1.2
|2009-01-11 22:32
|Windows NT/2000/XP
|<ref>[http://sourceforge.net/mailarchive/message.php?msg_id=21303153 Bitcoin v0.1.2 now available]</ref>
|-
|0.1.0
|2009-01-09
|Windows NT/2000/XP
|
|}

Up to and including version 0.3.19 is the "Satoshi code". The founder retired from development with end of 2010. [https://bitcointalk.org/index.php?topic=68121.10;wap2/ Here] are three URLs given where you still(!) (2013-01-04) can download one of the [[Satoshi client|"original Satoshi codes"]]. So also this [http://www.antepedia.com/detail/p/237812136.html Bitcoin release history].

==Theory of Operation==

bitcoind is a multithreaded C++ program. It is designed to be portable across Windows, Mac, and Linux systems. The multithreaded aspect leads to some complexity and the use of certain code patterns to deal with concurrency that may be unfamiliar to many programmers. Also, the code is aggressive in the use of C++ constructs, so it will help to be fluent with map, multimap, set, string, vector, iostream, and templates. As is typical of a C++ program, a lot of code tends to end up in the header files so be sure to search both the .cpp and .h files when looking for a function.

The client is oriented around several major operations, which are described in separate detailed articles and summarized in the following sections.

===[[Satoshi Client Initialization and Startup|Initialization and Startup]]===
Upon startup, the client performs various initialization routines including starting multiple threads to handle concurrent operations.

===[[Satoshi Client Node Discovery|Node Discovery]]===
The client uses various techniques to find out about other Bitcoin nodes that are currently connected to the network.

===[[Satoshi Client Node Connectivity|Node Connectivity]]===
The client initiates and maintains connections to other nodes.

===[[Satoshi Client Sockets and Messages|Sockets and Messages]]===
The client processes messages from other nodes and sends messages to other nodes using socket connections.

===[[Satoshi Client Block Exchange|Block Exchange]]===
Nodes advertise their inventory of blocks to each other and exchange blocks to build block chains.

===[[Satoshi Client Transaction Exchange|Transaction Exchange]]===
Nodes exchange and relay transactions with each other. The client associates transactions with bitcoin addresses in the local wallet.

===Wallet Services===
The client can create transactions using the local wallet. The client associates transactions with bitcoin addresses in the local wallet. The client provides a service for managing the local wallet.

===RPC Interface===
The client offers an JSON-RPC interface over HTTP over sockets to perform various operational functions and to manage the local wallet.

===User Interface===
Bitcoind's current user interface is the command line while it used to be based on [http://www.wxwidgets.org wxWidgets]. A graphical user interface is now provided by [[Bitcoin-qt]] in version 0.5+ for the reference client.

==Troubleshooting==

===I get "Error loading blkindex.dat" when I try to run the client===

blkindex.dat is part of the database that stores the local copy of the blockchain which may have become corrupted. Open the Bitcoin data dir:

Windows: %APPDATA%\Bitcoin
Linux: ~/.bitcoin
Mac: ~/Library/Application Support/Bitcoin/

Make a backup of that entire folder, then delete everything EXCEPT wallet.dat. Start bitcoind again and it will download a fresh copy of the blockchain.

==See Also==

* [[Original Bitcoin client/API calls list]]
* [[Protocol specification|Bitcoin network protocol]]
* [[Development process]]
* [[Release process]]
* [[Changelog]]

==External Links==
* [https://github.com/bitcoin/bitcoin/ Bitcoin Client project on Github]

==References==
<references />
`
[[es:Bitcoind]]

[[Category:Nodes]]
[[Category:Wallets]]
[[Category:User Interfaces]]
[[Category:Clients]]
[[Category:Developer]]
[[Category:Technical]]
[[Category:Free Software]]
[[Category:License/MIT-X11]]
[[Category:Open Source]]

User:Haxwell

2014-09-25T12:56:00Z

Haxwell: Created page with "Bitcoin enthusiast living in Denver, CO."

Bitcoin enthusiast living in Denver, CO.