lbcd/examples/btcdwebsockets/README.md
2014-05-09 21:05:01 -05:00

37 lines
951 B
Markdown

btcd Websockets Example
=======================
This example shows how to use the btcrpcclient package to connect to a btcd
RPC server using TLS-secured websockets, register for block connected and block
disconnected notifications, and get the current block count.
This example also sets a timer to shutdown the client after 10 seconds to
demonstrate clean shutdown.
## Running the Example
The first step is to use `go get` to download and install the btcrpcclient
package:
```bash
$ go get github.com/conformal/btcrpcclient
```
Next, modify the `main.go` source to specify the correct RPC username and
password for the RPC server:
```Go
User: "yourrpcuser",
Pass: "yourrpcpass",
```
Finally, navigate to the example's directory and run it with:
```bash
$ cd $GOPATH/src/github.com/conformal/btcrpcclient/examples/btcdwebsockets
$ go run *.go
```
## License
This example is licensed under the [copyfree](http://copyfree.org) ISC License.