chain.go

package rpcclient

import (
	"bytes"
	"encoding/hex"
	js "encoding/json"
	
	"github.com/p9c/matrjoska/pkg/btcjson"
	"github.com/p9c/matrjoska/pkg/chainhash"
	"github.com/p9c/matrjoska/pkg/wire"
)

// FutureGetBestBlockHashResult is a future promise to deliver the result of a GetBestBlockAsync RPC invocation (or an
// applicable error).
type FutureGetBestBlockHashResult chan *response

// Receive waits for the response promised by the future and returns the hash of the best block in the longest block
// chain.
func (r FutureGetBestBlockHashResult) Receive() (*chainhash.Hash, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var txHashStr string
	e = js.Unmarshal(res, &txHashStr)
	if e != nil {
		return nil, e
	}
	return chainhash.NewHashFromStr(txHashStr)
}

// GetBestBlockHashAsync 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 GetBestBlockHash for the blocking version and more
// details.
func (c *Client) GetBestBlockHashAsync() FutureGetBestBlockHashResult {
	cmd := btcjson.NewGetBestBlockHashCmd()
	return c.sendCmd(cmd)
}

// GetBestBlockHash returns the hash of the best block in the longest block chain.
func (c *Client) GetBestBlockHash() (*chainhash.Hash, error) {
	return c.GetBestBlockHashAsync().Receive()
}

// FutureGetBlockResult is a future promise to deliver the result of a GetBlockAsync RPC invocation (or an applicable
// error).
type FutureGetBlockResult chan *response

// Receive waits for the response promised by the future and returns the raw block requested from the server given its
// hash.
func (r FutureGetBlockResult) Receive() (*wire.Block, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var blockHex string
	e = js.Unmarshal(res, &blockHex)
	if e != nil {
		return nil, e
	}
	// Decode the serialized block hex to raw bytes.
	serializedBlock, e := hex.DecodeString(blockHex)
	if e != nil {
		return nil, e
	}
	// Deserialize the block and return it.
	var msgBlock wire.Block
	e = msgBlock.Deserialize(bytes.NewReader(serializedBlock))
	if e != nil {
		return nil, e
	}
	return &msgBlock, nil
}

// GetBlockAsync 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 GetBlock for the blocking version and more details.
func (c *Client) GetBlockAsync(blockHash *chainhash.Hash) FutureGetBlockResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetBlockCmd(hash, btcjson.Bool(false), nil)
	return c.sendCmd(cmd)
}

// GetBlock returns a raw block from the server given its hash. GetBlockVerbose to retrieve a data structure with
// information about the block instead.
func (c *Client) GetBlock(blockHash *chainhash.Hash) (*wire.Block, error) {
	return c.GetBlockAsync(blockHash).Receive()
}

// FutureGetBlockVerboseResult is a future promise to deliver the result of a GetBlockVerboseAsync RPC invocation (or an
// applicable error).
type FutureGetBlockVerboseResult chan *response

// Receive waits for the response promised by the future and returns the data structure from the server with information about the requested block.
func (r FutureGetBlockVerboseResult) Receive() (*btcjson.GetBlockVerboseResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal the raw result into a BlockResult.
	var blockResult btcjson.GetBlockVerboseResult
	e = js.Unmarshal(res, &blockResult)
	if e != nil {
		return nil, e
	}
	return &blockResult, nil
}

// GetBlockVerboseAsync 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 GetBlockVerbose for the blocking version and more
// details.
func (c *Client) GetBlockVerboseAsync(blockHash *chainhash.Hash) FutureGetBlockVerboseResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetBlockCmd(hash, btcjson.Bool(true), nil)
	return c.sendCmd(cmd)
}

// GetBlockVerbose returns a data structure from the server with information about a block given its hash. See
// GetBlockVerboseTx to retrieve transaction data structures as well. See GetBlock to retrieve a raw block instead.
func (c *Client) GetBlockVerbose(blockHash *chainhash.Hash) (*btcjson.GetBlockVerboseResult, error) {
	return c.GetBlockVerboseAsync(blockHash).Receive()
}

// GetBlockVerboseTxAsync 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 GetBlockVerboseTx or the blocking version and
// more details.
func (c *Client) GetBlockVerboseTxAsync(blockHash *chainhash.Hash) FutureGetBlockVerboseResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetBlockCmd(hash, btcjson.Bool(true), btcjson.Bool(true))
	return c.sendCmd(cmd)
}

// GetBlockVerboseTx returns a data structure from the server with information about a block and its transactions given
// its hash. See GetBlockVerbose if only transaction hashes are preferred. See GetBlock to retrieve a raw block instead.
func (c *Client) GetBlockVerboseTx(blockHash *chainhash.Hash) (*btcjson.GetBlockVerboseResult, error) {
	return c.GetBlockVerboseTxAsync(blockHash).Receive()
}

// FutureGetBlockCountResult is a future promise to deliver the result of a GetBlockCountAsync RPC invocation (or an
// applicable error).
type FutureGetBlockCountResult chan *response

// Receive waits for the response promised by the future and returns the number of blocks in the longest block chain.
func (r FutureGetBlockCountResult) Receive() (int64, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return 0, e
	}
	// Unmarshal the result as an int64.
	var count int64
	e = js.Unmarshal(res, &count)
	if e != nil {
		return 0, e
	}
	return count, nil
}

// GetBlockCountAsync 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 GetBlockCount for the blocking version and more details.
func (c *Client) GetBlockCountAsync() FutureGetBlockCountResult {
	cmd := btcjson.NewGetBlockCountCmd()
	return c.sendCmd(cmd)
}

// GetBlockCount returns the number of blocks in the longest block chain.
func (c *Client) GetBlockCount() (int64, error) {
	return c.GetBlockCountAsync().Receive()
}

// FutureGetDifficultyResult is a future promise to deliver the result of a GetDifficultyAsync RPC invocation (or an
// applicable error).
type FutureGetDifficultyResult chan *response

// Receive waits for the response promised by the future and returns the proof-of-work difficulty as a multiple of the
// minimum difficulty.
func (r FutureGetDifficultyResult) Receive() (float64, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return 0, e
	}
	// Unmarshal the result as a float64.
	var difficulty float64
	e = js.Unmarshal(res, &difficulty)
	if e != nil {
		return 0, e
	}
	return difficulty, nil
}

// GetDifficultyAsync 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 GetDifficulty for the blocking version and more details.
func (c *Client) GetDifficultyAsync(algo string) FutureGetDifficultyResult {
	cmd := btcjson.NewGetDifficultyCmd(algo)
	return c.sendCmd(cmd)
}

// GetDifficulty returns the proof-of-work difficulty as a multiple of the minimum difficulty.
func (c *Client) GetDifficulty(algo string) (float64, error) {
	return c.GetDifficultyAsync(algo).Receive()
}

// FutureGetBlockChainInfoResult is a promise to deliver the result of a GetBlockChainInfoAsync RPC invocation (or an
// applicable error).
type FutureGetBlockChainInfoResult chan *response

// Receive waits for the response promised by the future and returns chain info result provided by the server.
func (r FutureGetBlockChainInfoResult) Receive() (*btcjson.GetBlockChainInfoResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	var chainInfo btcjson.GetBlockChainInfoResult
	if e := js.Unmarshal(res, &chainInfo); E.Chk(e) {
		return nil, e
	}
	return &chainInfo, nil
}

// GetBlockChainInfoAsync 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. GetBlockChainInfo for the blocking version and more
// details.
func (c *Client) GetBlockChainInfoAsync() FutureGetBlockChainInfoResult {
	cmd := btcjson.NewGetBlockChainInfoCmd()
	return c.sendCmd(cmd)
}

// GetBlockChainInfo returns information related to the processing state of various chain-specific details such as the
// current difficulty from the tip of the main chain.
func (c *Client) GetBlockChainInfo() (*btcjson.GetBlockChainInfoResult, error) {
	return c.GetBlockChainInfoAsync().Receive()
}

// FutureGetBlockHashResult is a future promise to deliver the result of a GetBlockHashAsync RPC invocation (or an
// applicable error).
type FutureGetBlockHashResult chan *response

// Receive waits for the response promised by the future and returns the hash of the block in the best block chain at
// the given height.
func (r FutureGetBlockHashResult) Receive() (*chainhash.Hash, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal the result as a string-encoded sha.
	var txHashStr string
	e = js.Unmarshal(res, &txHashStr)
	if e != nil {
		return nil, e
	}
	return chainhash.NewHashFromStr(txHashStr)
}

// GetBlockHashAsync 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 GetBlockHash for the blocking version and more details.
func (c *Client) GetBlockHashAsync(blockHeight int64) FutureGetBlockHashResult {
	cmd := btcjson.NewGetBlockHashCmd(blockHeight)
	return c.sendCmd(cmd)
}

// GetBlockHash returns the hash of the block in the best block chain at the given height.
func (c *Client) GetBlockHash(blockHeight int64) (*chainhash.Hash, error) {
	return c.GetBlockHashAsync(blockHeight).Receive()
}

// FutureGetBlockHeaderResult is a future promise to deliver the result of a GetBlockHeaderAsync RPC invocation (or an
// applicable error).
type FutureGetBlockHeaderResult chan *response

// Receive waits for the response promised by the future and returns the blockheader requested from the server given its
// hash.
func (r FutureGetBlockHeaderResult) Receive() (*wire.BlockHeader, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var bhHex string
	e = js.Unmarshal(res, &bhHex)
	if e != nil {
		return nil, e
	}
	serializedBH, e := hex.DecodeString(bhHex)
	if e != nil {
		return nil, e
	}
	// Deserialize the blockheader and return it.
	var bh wire.BlockHeader
	e = bh.Deserialize(bytes.NewReader(serializedBH))
	if e != nil {
		return nil, e
	}
	return &bh, e
}

// GetBlockHeaderAsync 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 GetBlockHeader for the blocking version and more
// details.
func (c *Client) GetBlockHeaderAsync(blockHash *chainhash.Hash) FutureGetBlockHeaderResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetBlockHeaderCmd(hash, btcjson.Bool(false))
	return c.sendCmd(cmd)
}

// GetBlockHeader returns the blockheader from the server given its hash. See GetBlockHeaderVerbose to retrieve a data
// structure with information about the block instead.
func (c *Client) GetBlockHeader(blockHash *chainhash.Hash) (*wire.BlockHeader, error) {
	return c.GetBlockHeaderAsync(blockHash).Receive()
}

// FutureGetBlockHeaderVerboseResult is a future promise to deliver the result of a GetBlockAsync RPC invocation (or an
// applicable error).
type FutureGetBlockHeaderVerboseResult chan *response

// Receive waits for the response promised by the future and returns the data structure of the blockheader requested
// from the server given its hash.
func (r FutureGetBlockHeaderVerboseResult) Receive() (*btcjson.GetBlockHeaderVerboseResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var bh btcjson.GetBlockHeaderVerboseResult
	e = js.Unmarshal(res, &bh)
	if e != nil {
		return nil, e
	}
	return &bh, nil
}

// GetBlockHeaderVerboseAsync 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 GetBlockHeader for the blocking version and more
// details.
func (c *Client) GetBlockHeaderVerboseAsync(blockHash *chainhash.Hash) FutureGetBlockHeaderVerboseResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetBlockHeaderCmd(hash, btcjson.Bool(true))
	return c.sendCmd(cmd)
}

// GetBlockHeaderVerbose returns a data structure with information about the blockheader from the server given its hash.
// See GetBlockHeader to retrieve a blockheader instead.
func (c *Client) GetBlockHeaderVerbose(blockHash *chainhash.Hash) (*btcjson.GetBlockHeaderVerboseResult, error) {
	return c.GetBlockHeaderVerboseAsync(blockHash).Receive()
}

// FutureGetMempoolEntryResult is a future promise to deliver the result of a GetMempoolEntryAsync RPC invocation (or an
// applicable error).
type FutureGetMempoolEntryResult chan *response

// Receive waits for the response promised by the future and returns a data structure with information about the
// transaction in the memory pool given its hash.
func (r FutureGetMempoolEntryResult) Receive() (*btcjson.GetMempoolEntryResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal the result as an array of strings.
	var mempoolEntryResult btcjson.GetMempoolEntryResult
	e = js.Unmarshal(res, &mempoolEntryResult)
	if e != nil {
		return nil, e
	}
	return &mempoolEntryResult, nil
}

// GetMempoolEntryAsync 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 GetMempoolEntry for the blocking version and more
// details.
func (c *Client) GetMempoolEntryAsync(txHash string) FutureGetMempoolEntryResult {
	cmd := btcjson.NewGetMempoolEntryCmd(txHash)
	return c.sendCmd(cmd)
}

// GetMempoolEntry returns a data structure with information about the transaction in the memory pool given its hash.
func (c *Client) GetMempoolEntry(txHash string) (*btcjson.GetMempoolEntryResult, error) {
	return c.GetMempoolEntryAsync(txHash).Receive()
}

// FutureGetRawMempoolResult is a future promise to deliver the result of a GetRawMempoolAsync RPC invocation (or an
// applicable error).
type FutureGetRawMempoolResult chan *response

// Receive waits for the response promised by the future and returns the hashes of all transactions in the memory pool.
func (r FutureGetRawMempoolResult) Receive() ([]*chainhash.Hash, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal the result as an array of strings.
	var txHashStrs []string
	e = js.Unmarshal(res, &txHashStrs)
	if e != nil {
		return nil, e
	}
	// Create a slice of ShaHash arrays from the string slice.
	txHashes := make([]*chainhash.Hash, 0, len(txHashStrs))
	for _, hashStr := range txHashStrs {
		txHash, e := chainhash.NewHashFromStr(hashStr)
		if e != nil {
			return nil, e
		}
		txHashes = append(txHashes, txHash)
	}
	return txHashes, nil
}

// GetRawMempoolAsync 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 GetRawMempool for the blocking version and more details.
func (c *Client) GetRawMempoolAsync() FutureGetRawMempoolResult {
	cmd := btcjson.NewGetRawMempoolCmd(btcjson.Bool(false))
	return c.sendCmd(cmd)
}

// GetRawMempool returns the hashes of all transactions in the memory pool. See GetRawMempoolVerbose to retrieve data
// structures with information about the transactions instead.
func (c *Client) GetRawMempool() ([]*chainhash.Hash, error) {
	return c.GetRawMempoolAsync().Receive()
}

// FutureGetRawMempoolVerboseResult is a future promise to deliver the result of a GetRawMempoolVerboseAsync RPC
// invocation (or an applicable error).
type FutureGetRawMempoolVerboseResult chan *response

// Receive waits for the response promised by the future and returns a map of transaction hashes to an associated data
// structure with information about the transaction for all transactions in the memory pool.
func (r FutureGetRawMempoolVerboseResult) Receive() (map[string]btcjson.GetRawMempoolVerboseResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal the result as a map of strings (tx shas) to their detailed results.
	var mempoolItems map[string]btcjson.GetRawMempoolVerboseResult
	e = js.Unmarshal(res, &mempoolItems)
	if e != nil {
		return nil, e
	}
	return mempoolItems, nil
}

// GetRawMempoolVerboseAsync 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 GetRawMempoolVerbose for the blocking version and
// more details.
func (c *Client) GetRawMempoolVerboseAsync() FutureGetRawMempoolVerboseResult {
	cmd := btcjson.NewGetRawMempoolCmd(btcjson.Bool(true))
	return c.sendCmd(cmd)
}

// GetRawMempoolVerbose returns a map of transaction hashes to an associated data structure with information about the
// transaction for all transactions in the memory pool. See GetRawMempool to retrieve only the transaction hashes
// instead.
func (c *Client) GetRawMempoolVerbose() (map[string]btcjson.GetRawMempoolVerboseResult, error) {
	return c.GetRawMempoolVerboseAsync().Receive()
}

// FutureEstimateFeeResult is a future promise to deliver the result of a EstimateFeeAsync RPC invocation (or an
// applicable error).
type FutureEstimateFeeResult chan *response

// Receive waits for the response promised by the future and returns the info provided by the server.
func (r FutureEstimateFeeResult) Receive() (float64, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return -1, e
	}
	// Unmarshal result as a getinfo result object.
	var fee float64
	e = js.Unmarshal(res, &fee)
	if e != nil {
		return -1, e
	}
	return fee, nil
}

// EstimateFeeAsync 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 EstimateFee for the blocking version and more details.
func (c *Client) EstimateFeeAsync(numBlocks int64) FutureEstimateFeeResult {
	cmd := btcjson.NewEstimateFeeCmd(numBlocks)
	return c.sendCmd(cmd)
}

// EstimateFee provides an estimated fee in bitcoins per kilobyte.
func (c *Client) EstimateFee(numBlocks int64) (float64, error) {
	return c.EstimateFeeAsync(numBlocks).Receive()
}

// FutureVerifyChainResult is a future promise to deliver the result of a VerifyChainAsync, VerifyChainLevelAsyncRPC, or
// VerifyChainBlocksAsync invocation (or an applicable error).
type FutureVerifyChainResult chan *response

// Receive waits for the response promised by the future and returns whether or not the chain verified based on the
// check level and number of blocks to verify specified in the original call.
func (r FutureVerifyChainResult) Receive() (bool, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return false, e
	}
	// Unmarshal the result as a boolean.
	var verified bool
	e = js.Unmarshal(res, &verified)
	if e != nil {
		return false, e
	}
	return verified, nil
}

// VerifyChainAsync 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 VerifyChain for the blocking version and more details.
func (c *Client) VerifyChainAsync() FutureVerifyChainResult {
	cmd := btcjson.NewVerifyChainCmd(nil, nil)
	return c.sendCmd(cmd)
}

// VerifyChain requests the server to verify the block chain database using the default check level and number of blocks
// to verify. See VerifyChainLevel and VerifyChainBlocks to override the defaults.
func (c *Client) VerifyChain() (bool, error) {
	return c.VerifyChainAsync().Receive()
}

// VerifyChainLevelAsync 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 VerifyChainLevel for the blocking version and more
// details.
func (c *Client) VerifyChainLevelAsync(checkLevel int32) FutureVerifyChainResult {
	cmd := btcjson.NewVerifyChainCmd(&checkLevel, nil)
	return c.sendCmd(cmd)
}

// VerifyChainLevel requests the server to verify the block chain database using the passed check level and default
// number of blocks to verify. The check level controls how thorough the verification is with higher numbers increasing
// the amount of checks done as consequently how long the verification takes. See VerifyChain to use the default check
// level and VerifyChainBlocks to override the number of blocks to verify.
func (c *Client) VerifyChainLevel(checkLevel int32) (bool, error) {
	return c.VerifyChainLevelAsync(checkLevel).Receive()
}

// VerifyChainBlocksAsync 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 VerifyChainBlocks for the blocking version and
// more details.
func (c *Client) VerifyChainBlocksAsync(checkLevel, numBlocks int32) FutureVerifyChainResult {
	cmd := btcjson.NewVerifyChainCmd(&checkLevel, &numBlocks)
	return c.sendCmd(cmd)
}

// VerifyChainBlocks requests the server to verify the block chain database using the passed check level and number of
// blocks to verify. The check level controls how thorough the verification is with higher numbers increasing the amount
// of checks done as consequently how long the verification takes. The number of blocks refers to the number of blocks
// from the end of the current longest chain. See VerifyChain and VerifyChainLevel to use defaults.
func (c *Client) VerifyChainBlocks(checkLevel, numBlocks int32) (bool, error) {
	return c.VerifyChainBlocksAsync(checkLevel, numBlocks).Receive()
}

// FutureGetTxOutResult is a future promise to deliver the result of a GetTxOutAsync RPC invocation (or an applicable
// error).
type FutureGetTxOutResult chan *response

// Receive waits for the response promised by the future and returns a transaction given its hash.
func (r FutureGetTxOutResult) Receive() (*btcjson.GetTxOutResult, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// take care of the special case where the output has been spent already it should return the string "null"
	if string(res) == "null" {
		return nil, nil
	}
	// Unmarshal result as an gettxout result object.
	var txOutInfo *btcjson.GetTxOutResult
	e = js.Unmarshal(res, &txOutInfo)
	if e != nil {
		return nil, e
	}
	return txOutInfo, nil
}

// GetTxOutAsync 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 GetTxOut for the blocking version and more details.
func (c *Client) GetTxOutAsync(txHash *chainhash.Hash, index uint32, mempool bool) FutureGetTxOutResult {
	hash := ""
	if txHash != nil {
		hash = txHash.String()
	}
	cmd := btcjson.NewGetTxOutCmd(hash, index, &mempool)
	return c.sendCmd(cmd)
}

// GetTxOut returns the transaction output info if it's unspent and nil, otherwise.
func (c *Client) GetTxOut(txHash *chainhash.Hash, index uint32, mempool bool) (*btcjson.GetTxOutResult, error) {
	return c.GetTxOutAsync(txHash, index, mempool).Receive()
}

// FutureRescanBlocksResult is a future promise to deliver the result of a RescanBlocksAsync RPC invocation (or an
// applicable error).
//
// NOTE: This is a btcsuite extension ported from github.com/decred/dcrrpcclient.
type FutureRescanBlocksResult chan *response

// Receive waits for the response promised by the future and returns the discovered rescanblocks data. NOTE: This is a
// btcsuite extension ported from github.com/decred/dcrrpcclient.
func (r FutureRescanBlocksResult) Receive() ([]btcjson.RescannedBlock, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	var rescanBlocksResult []btcjson.RescannedBlock
	e = js.Unmarshal(res, &rescanBlocksResult)
	if e != nil {
		return nil, e
	}
	return rescanBlocksResult, nil
}

// RescanBlocksAsync 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 RescanBlocks for the blocking version and more details.
//
// NOTE: This is a btcsuite extension ported from github.com/decred/dcrrpcclient.
func (c *Client) RescanBlocksAsync(blockHashes []chainhash.Hash) FutureRescanBlocksResult {
	strBlockHashes := make([]string, len(blockHashes))
	for i := range blockHashes {
		strBlockHashes[i] = blockHashes[i].String()
	}
	cmd := btcjson.NewRescanBlocksCmd(strBlockHashes)
	return c.sendCmd(cmd)
}

// RescanBlocks rescans the blocks identified by blockHashes, in order, using the client's loaded transaction filter.
// The blocks do not need to be on the main chain, but they do need to be adjacent to each other.
//
// NOTE: This is a btcsuite extension ported from github.com/decred/dcrrpcclient.
func (c *Client) RescanBlocks(blockHashes []chainhash.Hash) ([]btcjson.RescannedBlock, error) {
	return c.RescanBlocksAsync(blockHashes).Receive()
}

// FutureInvalidateBlockResult is a future promise to deliver the result of a InvalidateBlockAsync RPC invocation (or an
// applicable error).
type FutureInvalidateBlockResult chan *response

// Receive waits for the response promised by the future and returns the raw block requested from the server given its
// hash.
func (r FutureInvalidateBlockResult) Receive() (e error) {
	_, e = receiveFuture(r)
	return e
}

// InvalidateBlockAsync 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 InvalidateBlock for the blocking version and more
// details.
func (c *Client) InvalidateBlockAsync(blockHash *chainhash.Hash) FutureInvalidateBlockResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewInvalidateBlockCmd(hash)
	return c.sendCmd(cmd)
}

// InvalidateBlock invalidates a specific block.
func (c *Client) InvalidateBlock(blockHash *chainhash.Hash) (e error) {
	return c.InvalidateBlockAsync(blockHash).Receive()
}

// FutureGetCFilterResult is a future promise to deliver the result of a GetCFilterAsync RPC invocation (or an
// applicable error).
type FutureGetCFilterResult chan *response

// Receive waits for the response promised by the future and returns the raw filter requested from the server given its
// block hash.
func (r FutureGetCFilterResult) Receive() (*wire.MsgCFilter, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var filterHex string
	e = js.Unmarshal(res, &filterHex)
	if e != nil {
		return nil, e
	}
	// Decode the serialized cf hex to raw bytes.
	serializedFilter, e := hex.DecodeString(filterHex)
	if e != nil {
		return nil, e
	}
	// Assign the filter bytes to the correct field of the wire message. We aren't going to set the block hash or
	// extended flag, since we don't actually get that back in the RPC response.
	var msgCFilter wire.MsgCFilter
	msgCFilter.Data = serializedFilter
	return &msgCFilter, nil
}

// GetCFilterAsync 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 GetCFilter for the blocking version and more details.
func (c *Client) GetCFilterAsync(
	blockHash *chainhash.Hash,
	filterType wire.FilterType,
) FutureGetCFilterResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetCFilterCmd(hash, filterType)
	return c.sendCmd(cmd)
}

// GetCFilter returns a raw filter from the server given its block hash.
func (c *Client) GetCFilter(
	blockHash *chainhash.Hash,
	filterType wire.FilterType,
) (*wire.MsgCFilter, error) {
	return c.GetCFilterAsync(blockHash, filterType).Receive()
}

// FutureGetCFilterHeaderResult is a future promise to deliver the result of a GetCFilterHeaderAsync RPC invocation (or
// an applicable error).
type FutureGetCFilterHeaderResult chan *response

// Receive waits for the response promised by the future and returns the raw filter header requested from the server
// given its block hash.
func (r FutureGetCFilterHeaderResult) Receive() (*wire.MsgCFHeaders, error) {
	res, e := receiveFuture(r)
	if e != nil {
		return nil, e
	}
	// Unmarshal result as a string.
	var headerHex string
	e = js.Unmarshal(res, &headerHex)
	if e != nil {
		return nil, e
	}
	// Assign the decoded header into a hash
	headerHash, e := chainhash.NewHashFromStr(headerHex)
	if e != nil {
		return nil, e
	}
	// Assign the hash to a headers message and return it.
	msgCFHeaders := wire.MsgCFHeaders{PrevFilterHeader: *headerHash}
	return &msgCFHeaders, nil
}

// GetCFilterHeaderAsync 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 GetCFilterHeader for the blocking version and more
// details.
func (c *Client) GetCFilterHeaderAsync(
	blockHash *chainhash.Hash,
	filterType wire.FilterType,
) FutureGetCFilterHeaderResult {
	hash := ""
	if blockHash != nil {
		hash = blockHash.String()
	}
	cmd := btcjson.NewGetCFilterHeaderCmd(hash, filterType)
	return c.sendCmd(cmd)
}

// GetCFilterHeader returns a raw filter header from the server given its block hash.
func (c *Client) GetCFilterHeader(
	blockHash *chainhash.Hash,
	filterType wire.FilterType,
) (*wire.MsgCFHeaders, error) {
	return c.GetCFilterHeaderAsync(blockHash, filterType).Receive()
}