074b2374b8
This commit contains the entire btcrpcclient repository along with several changes needed to move all of the files into the rpcclient directory in order to prepare it for merging. This does NOT update btcd or any of the other packages to use the new location as that will be done separately. - All import paths in the old btcrpcclient files have been changed to the new location - All references to btcrpcclient as the package name have been changed to rpcclient
36 lines
947 B
Markdown
36 lines
947 B
Markdown
btcd Websockets Example
|
|
=======================
|
|
|
|
This example shows how to use the rpcclient 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 rpcclient package:
|
|
|
|
```bash
|
|
$ go get github.com/btcsuite/btcd/rpcclient
|
|
```
|
|
|
|
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/btcsuite/btcd/rpcclient/examples/btcdwebsockets
|
|
$ go run *.go
|
|
```
|
|
|
|
## License
|
|
|
|
This example is licensed under the [copyfree](http://copyfree.org) ISC License.
|