2017-07-22 04:53:54 +02:00
|
|
|
rpcclient
|
|
|
|
=========
|
2014-05-07 18:14:39 +02:00
|
|
|
|
2017-07-22 04:53:54 +02:00
|
|
|
[![Build Status](http://img.shields.io/travis/btcsuite/btcd.svg)](https://travis-ci.org/btcsuite/btcd)
|
2017-05-25 19:42:31 +02:00
|
|
|
[![ISC License](http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)
|
2017-07-22 04:53:54 +02:00
|
|
|
[![GoDoc](https://img.shields.io/badge/godoc-reference-blue.svg)](http://godoc.org/github.com/btcsuite/btcd/rpcclient)
|
2014-05-09 08:16:47 +02:00
|
|
|
|
2017-07-22 04:53:54 +02:00
|
|
|
rpcclient implements a Websocket-enabled Bitcoin JSON-RPC client package written
|
|
|
|
in [Go](http://golang.org/). It provides a robust and easy to use client for
|
|
|
|
interfacing with a Bitcoin RPC server that uses a btcd/bitcoin core compatible
|
|
|
|
Bitcoin JSON-RPC API.
|
2014-05-07 18:14:39 +02:00
|
|
|
|
2014-05-10 09:47:59 +02:00
|
|
|
## Status
|
|
|
|
|
|
|
|
This package is currently under active development. It is already stable and
|
|
|
|
the infrastructure is complete. However, there are still several RPCs left to
|
|
|
|
implement and the API is not stable yet.
|
2014-05-07 18:14:39 +02:00
|
|
|
|
2014-05-10 03:48:05 +02:00
|
|
|
## Documentation
|
2014-05-02 06:18:43 +02:00
|
|
|
|
2017-08-21 22:56:57 +02:00
|
|
|
* [API Reference](http://godoc.org/github.com/btcsuite/btcd/rpcclient)
|
2017-07-22 04:53:54 +02:00
|
|
|
* [btcd Websockets Example](https://github.com/btcsuite/btcd/rpcclient/blob/master/examples/btcdwebsockets)
|
2014-06-06 03:58:47 +02:00
|
|
|
Connects to a btcd RPC server using TLS-secured websockets, registers for
|
|
|
|
block connected and block disconnected notifications, and gets the current
|
|
|
|
block count
|
2017-07-22 04:53:54 +02:00
|
|
|
* [btcwallet Websockets Example](https://github.com/btcsuite/btcd/rpcclient/blob/master/examples/btcwalletwebsockets)
|
2014-06-06 03:58:47 +02:00
|
|
|
Connects to a btcwallet RPC server using TLS-secured websockets, registers for
|
|
|
|
notifications about changes to account balances, and gets a list of unspent
|
|
|
|
transaction outputs (utxos) the wallet can sign
|
2017-07-22 04:53:54 +02:00
|
|
|
* [Bitcoin Core HTTP POST Example](https://github.com/btcsuite/btcd/rpcclient/blob/master/examples/bitcoincorehttp)
|
2014-05-10 03:48:05 +02:00
|
|
|
Connects to a bitcoin core RPC server using HTTP POST mode with TLS disabled
|
|
|
|
and gets the current block count
|
|
|
|
|
2014-05-10 09:47:59 +02:00
|
|
|
## Major Features
|
|
|
|
|
|
|
|
* Supports Websockets (btcd/btcwallet) and HTTP POST mode (bitcoin core)
|
|
|
|
* Provides callback and registration functions for btcd/btcwallet notifications
|
|
|
|
* Supports btcd extensions
|
2014-05-10 22:48:14 +02:00
|
|
|
* Translates to and from higher-level and easier to use Go types
|
|
|
|
* Offers a synchronous (blocking) and asynchronous API
|
2014-05-10 09:47:59 +02:00
|
|
|
* When running in Websockets mode (the default):
|
|
|
|
* Automatic reconnect handling (can be disabled)
|
|
|
|
* Outstanding commands are automatically reissued
|
|
|
|
* Registered notifications are automatically reregistered
|
|
|
|
* Back-off support on reconnect attempts
|
|
|
|
|
2014-05-10 03:48:05 +02:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
```bash
|
2017-07-22 04:53:54 +02:00
|
|
|
$ go get -u github.com/btcsuite/btcd/rpcclient
|
2014-05-10 03:48:05 +02:00
|
|
|
```
|
2014-05-02 06:18:43 +02:00
|
|
|
|
2014-05-07 18:14:39 +02:00
|
|
|
## License
|
|
|
|
|
2017-07-22 04:53:54 +02:00
|
|
|
Package rpcclient is licensed under the [copyfree](http://copyfree.org) ISC
|
2014-05-07 18:14:39 +02:00
|
|
|
License.
|