From 91ad6db171c6d3072c5e0f6de4354a6b1c8297f6 Mon Sep 17 00:00:00 2001
From: JeremyRand <jeremyrand@airmail.cc>
Date: Tue, 19 May 2020 17:28:14 +0000
Subject: [PATCH] rpcclient: Add customcommand example

---
 rpcclient/examples/customcommand/README.md |  32 ++++++
 rpcclient/examples/customcommand/main.go   | 110 +++++++++++++++++++++
 2 files changed, 142 insertions(+)
 create mode 100644 rpcclient/examples/customcommand/README.md
 create mode 100644 rpcclient/examples/customcommand/main.go

diff --git a/rpcclient/examples/customcommand/README.md b/rpcclient/examples/customcommand/README.md
new file mode 100644
index 0000000000..fbeabfe0fa
--- /dev/null
+++ b/rpcclient/examples/customcommand/README.md
@@ -0,0 +1,32 @@
+Namecoin Core Custom Command Example
+====================================
+
+This example shows how to use custom commands with the rpcclient package, by
+implementing the `name_show` command from Namecoin Core.
+
+## 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 of your Namecoin Core node:
+
+```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/customcommand
+$ go run *.go
+```
+
+## License
+
+This example is licensed under the [copyfree](http://copyfree.org) ISC License.
diff --git a/rpcclient/examples/customcommand/main.go b/rpcclient/examples/customcommand/main.go
new file mode 100644
index 0000000000..1e14c06fe4
--- /dev/null
+++ b/rpcclient/examples/customcommand/main.go
@@ -0,0 +1,110 @@
+// Copyright (c) 2014-2017 The btcsuite developers
+// Copyright (c) 2019-2020 The Namecoin developers
+// Use of this source code is governed by an ISC
+// license that can be found in the LICENSE file.
+
+package main
+
+import (
+	"encoding/json"
+	"log"
+
+	"github.com/btcsuite/btcd/btcjson"
+	"github.com/btcsuite/btcd/rpcclient"
+)
+
+// NameShowCmd defines the name_show JSON-RPC command.
+type NameShowCmd struct {
+	Name string
+}
+
+// NameShowResult models the data from the name_show command.
+type NameShowResult struct {
+	Name          string `json:"name"`
+	NameEncoding  string `json:"name_encoding"`
+	NameError     string `json:"name_error"`
+	Value         string `json:"value"`
+	ValueEncoding string `json:"value_encoding"`
+	ValueError    string `json:"value_error"`
+	TxID          string `json:"txid"`
+	Vout          uint32 `json:"vout"`
+	Address       string `json:"address"`
+	IsMine        bool   `json:"ismine"`
+	Height        int32  `json:"height"`
+	ExpiresIn     int32  `json:"expires_in"`
+	Expired       bool   `json:"expired"`
+}
+
+// FutureNameShowResult is a future promise to deliver the result
+// of a NameShowAsync RPC invocation (or an applicable error).
+type FutureNameShowResult chan *rpcclient.Response
+
+// Receive waits for the Response promised by the future and returns detailed
+// information about a name.
+func (r FutureNameShowResult) Receive() (*NameShowResult, error) {
+	res, err := rpcclient.ReceiveFuture(r)
+	if err != nil {
+		return nil, err
+	}
+
+	// Unmarshal result as a name_show result object
+	var nameShow NameShowResult
+	err = json.Unmarshal(res, &nameShow)
+	if err != nil {
+		return nil, err
+	}
+
+	return &nameShow, nil
+}
+
+// NameShowAsync returns an instance of a type that can be used to get the
+// result of the RPC at some future time by invoking the Receive function on
+// the returned instance.
+//
+// See NameShow for the blocking version and more details.
+func NameShowAsync(c *rpcclient.Client, name string) FutureNameShowResult {
+	cmd := &NameShowCmd{
+		Name: name,
+	}
+	return c.SendCmd(cmd)
+}
+
+// NameShow returns detailed information about a name.
+func NameShow(c *rpcclient.Client, name string) (*NameShowResult, error) {
+	return NameShowAsync(c, name).Receive()
+}
+
+func init() {
+	// No special flags for commands in this file.
+	flags := btcjson.UsageFlag(0)
+
+	btcjson.MustRegisterCmd("name_show", (*NameShowCmd)(nil), flags)
+}
+
+func main() {
+	// Connect to local namecoin core RPC server using HTTP POST mode.
+	connCfg := &rpcclient.ConnConfig{
+		Host:         "localhost:8336",
+		User:         "yourrpcuser",
+		Pass:         "yourrpcpass",
+		HTTPPostMode: true, // Namecoin core only supports HTTP POST mode
+		DisableTLS:   true, // Namecoin core does not provide TLS by default
+	}
+	// Notice the notification parameter is nil since notifications are
+	// not supported in HTTP POST mode.
+	client, err := rpcclient.New(connCfg, nil)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer client.Shutdown()
+
+	// Get the current block count.
+	result, err := NameShow(client, "d/namecoin")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	value := result.Value
+
+	log.Printf("Value of d/namecoin: %s", value)
+}