operatoroverload/bitcoinlib

C# Bitcoin Library / RPC Wrapper for .Net projects

BitcoinLib

C# Bitcoin, Litecoin and Bitcoin-Clones Library & RPC Wrapper

Features

• Fully compatible and up-to-date with Bitcoin 0.9.1 RPC API.
• Design-by-contract, service-oriented architecture.
• Strongly-typed structures for complex RPC requests and responses.
• Implicit JSON casting for all RPC messages.
• Extended methods for every-day scenarios where the built-in methods fall short.
• Exposure of all RPC API's functionality as well as the extended methods through a single interface.
• Fallback mechanism for timed-out RPC requests.
• Custom RPC exceptions.
• Supports all Bitcoin clones.
• Can operate on unlimited daemons with a single library reference.
• Litecoin integration included.
• Each coin instance can be fully parametrized at run-time and implement its own constants.
• Console and web test clients out of the box with demo methods implemented in them.
• Testnet ready.
• Fully configurable.

Instructions for Bitcoin

• Locate your bitcoin.conf file (in Windows it's under: %AppData%\Roaming\Bitcoin, if it's not there just go ahead and create it) and add these lines:

  • rpcuser = MyRpcUsername
  • rpcpassword = MyRpcPassword
  • daemon=1
  • txindex=1

• Call bitcoind -reindex -txindex -debug=net -printtoconsole and wait until it's finished re-indexing (it might take a while). Append -testnet if you want to run it for Testnet. You need to do this just once.

• Shut down bitcoind and run it again with these arguments: bitcoind -daemon -debug=net -printtoconsole. Append -testnet if you want to run it for Testnet. Wait until it is fully synchronized.

• Edit the .config files in the solution to best fit your needs

  • app.config for the Console test client
  • web.config for the Web test client

  Make sure you also update the bitcoin.conf when you alter the Bitcoin_RpcUsername and Bitcoin_RpcPassword parameters.

• You're good to go.

Instructions for Litecoin and other Bitcoin clones

• Perform the same steps as those mentioned above for Bitcoin.

• Litecoin configuration file is: litecoin.conf under: %AppData%\Roaming\Litecoin and its daemon is: litecoind.

• Each coin can be initialized by its own interface specification:

  • Bitcoin: IBitcoinService BitcoinService = new BitcoinService();
  • Litecoin: ILitecoinService LitecoinService = new LitecoinService();

• Any bitcoin clone can be adopted without any further installation steps with the use of the generic ICryptocoinService:

  • ICryptocoinService cryptocoinService = new CryptocoinService("daemonUrl", "rpcUsername", "rpcPassword");

• Use (ICryptocoinService).Parameters to fully configure each coin pointer at run-time.

License

BitcoinLib is released under the terms of the GPLv3 license. See LICENSE for more information or see http://opensource.org/licenses/GPL-3.0.

Support

Please use GitHub's Issues

Donations

BTC: 17GDskinpoPb4k4Xaaf9R9VpXeXhdzBvd9

Influenced by

• Bitnet, by Konstantin Ineshin (http://bitnet.sourceforge.net)
• BitcoinRpcSharp, by BitKoot (https://github.com/BitKoot/BitcoinRpcSharp)
• Bitcoin-wrapper, by Lars Holdgaard (https://github.com/LarsHoldgaard/bitcoin-wrapper)

Credits

Thanks to everyone who contributed to making this library better: @OperatorOverload, Angelo Leoussis, @makerofthings7, everyone who reported any issues, et al.