2017-07-22 04:53:54 +02:00
|
|
|
// Copyright (c) 2014-2017 The btcsuite developers
|
2014-05-07 18:14:39 +02:00
|
|
|
// Use of this source code is governed by an ISC
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
2017-07-22 04:53:54 +02:00
|
|
|
package rpcclient
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
import (
|
|
|
|
"bytes"
|
|
|
|
"encoding/hex"
|
2014-06-10 02:49:41 +02:00
|
|
|
"encoding/json"
|
2014-07-03 02:33:54 +02:00
|
|
|
|
2018-05-15 05:44:11 +02:00
|
|
|
"github.com/btcsuite/btcd/btcjson"
|
|
|
|
"github.com/btcsuite/btcd/chaincfg/chainhash"
|
|
|
|
"github.com/btcsuite/btcd/wire"
|
|
|
|
"github.com/btcsuite/btcutil"
|
2014-05-07 18:14:39 +02:00
|
|
|
)
|
|
|
|
|
2019-10-30 02:51:59 +01:00
|
|
|
const (
|
|
|
|
// defaultMaxFeeRate is the default maximum fee rate in sat/KB enforced
|
|
|
|
// by bitcoind v0.19.0 or after for transaction broadcast.
|
|
|
|
defaultMaxFeeRate = btcutil.SatoshiPerBitcoin / 10
|
|
|
|
)
|
|
|
|
|
2014-05-07 18:14:39 +02:00
|
|
|
// SigHashType enumerates the available signature hashing types that the
|
|
|
|
// SignRawTransaction function accepts.
|
|
|
|
type SigHashType string
|
|
|
|
|
|
|
|
// Constants used to indicate the signature hash type for SignRawTransaction.
|
|
|
|
const (
|
|
|
|
// SigHashAll indicates ALL of the outputs should be signed.
|
|
|
|
SigHashAll SigHashType = "ALL"
|
|
|
|
|
|
|
|
// SigHashNone indicates NONE of the outputs should be signed. This
|
|
|
|
// can be thought of as specifying the signer does not care where the
|
|
|
|
// bitcoins go.
|
|
|
|
SigHashNone SigHashType = "NONE"
|
|
|
|
|
|
|
|
// SigHashSingle indicates that a SINGLE output should be signed. This
|
|
|
|
// can be thought of specifying the signer only cares about where ONE of
|
|
|
|
// the outputs goes, but not any of the others.
|
|
|
|
SigHashSingle SigHashType = "SINGLE"
|
|
|
|
|
|
|
|
// SigHashAllAnyoneCanPay indicates that signer does not care where the
|
|
|
|
// other inputs to the transaction come from, so it allows other people
|
|
|
|
// to add inputs. In addition, it uses the SigHashAll signing method
|
|
|
|
// for outputs.
|
|
|
|
SigHashAllAnyoneCanPay SigHashType = "ALL|ANYONECANPAY"
|
|
|
|
|
|
|
|
// SigHashNoneAnyoneCanPay indicates that signer does not care where the
|
|
|
|
// other inputs to the transaction come from, so it allows other people
|
|
|
|
// to add inputs. In addition, it uses the SigHashNone signing method
|
|
|
|
// for outputs.
|
|
|
|
SigHashNoneAnyoneCanPay SigHashType = "NONE|ANYONECANPAY"
|
|
|
|
|
2014-06-13 06:00:03 +02:00
|
|
|
// SigHashSingleAnyoneCanPay indicates that signer does not care where
|
|
|
|
// the other inputs to the transaction come from, so it allows other
|
|
|
|
// people to add inputs. In addition, it uses the SigHashSingle signing
|
|
|
|
// method for outputs.
|
2014-05-07 18:14:39 +02:00
|
|
|
SigHashSingleAnyoneCanPay SigHashType = "SINGLE|ANYONECANPAY"
|
|
|
|
)
|
|
|
|
|
|
|
|
// String returns the SighHashType in human-readable form.
|
|
|
|
func (s SigHashType) String() string {
|
|
|
|
return string(s)
|
|
|
|
}
|
|
|
|
|
|
|
|
// FutureGetRawTransactionResult is a future promise to deliver the result of a
|
|
|
|
// GetRawTransactionAsync RPC invocation (or an applicable error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureGetRawTransactionResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns a
|
|
|
|
// transaction given its hash.
|
|
|
|
func (r FutureGetRawTransactionResult) Receive() (*btcutil.Tx, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal result as a string.
|
|
|
|
var txHex string
|
|
|
|
err = json.Unmarshal(res, &txHex)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Decode the serialized transaction hex to raw bytes.
|
|
|
|
serializedTx, err := hex.DecodeString(txHex)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deserialize the transaction and return it.
|
2015-02-05 22:50:03 +01:00
|
|
|
var msgTx wire.MsgTx
|
2014-06-05 05:12:47 +02:00
|
|
|
if err := msgTx.Deserialize(bytes.NewReader(serializedTx)); err != nil {
|
2014-05-07 18:14:39 +02:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return btcutil.NewTx(&msgTx), nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetRawTransactionAsync 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 GetRawTransaction for the blocking version and more details.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (c *Client) GetRawTransactionAsync(txHash *chainhash.Hash) FutureGetRawTransactionResult {
|
2014-05-22 02:53:46 +02:00
|
|
|
hash := ""
|
|
|
|
if txHash != nil {
|
|
|
|
hash = txHash.String()
|
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewGetRawTransactionCmd(hash, btcjson.Int(0))
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetRawTransaction returns a transaction given its hash.
|
|
|
|
//
|
|
|
|
// See GetRawTransactionVerbose to obtain additional information about the
|
|
|
|
// transaction.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (c *Client) GetRawTransaction(txHash *chainhash.Hash) (*btcutil.Tx, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.GetRawTransactionAsync(txHash).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// FutureGetRawTransactionVerboseResult is a future promise to deliver the
|
|
|
|
// result of a GetRawTransactionVerboseAsync RPC invocation (or an applicable
|
|
|
|
// error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureGetRawTransactionVerboseResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns information
|
|
|
|
// about a transaction given its hash.
|
|
|
|
func (r FutureGetRawTransactionVerboseResult) Receive() (*btcjson.TxRawResult, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal result as a gettrawtransaction result object.
|
|
|
|
var rawTxResult btcjson.TxRawResult
|
|
|
|
err = json.Unmarshal(res, &rawTxResult)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
return &rawTxResult, nil
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// GetRawTransactionVerboseAsync 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 GetRawTransactionVerbose for the blocking version and more details.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (c *Client) GetRawTransactionVerboseAsync(txHash *chainhash.Hash) FutureGetRawTransactionVerboseResult {
|
2014-05-22 02:53:46 +02:00
|
|
|
hash := ""
|
|
|
|
if txHash != nil {
|
|
|
|
hash = txHash.String()
|
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewGetRawTransactionCmd(hash, btcjson.Int(1))
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetRawTransactionVerbose returns information about a transaction given
|
|
|
|
// its hash.
|
|
|
|
//
|
|
|
|
// See GetRawTransaction to obtain only the transaction already deserialized.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (c *Client) GetRawTransactionVerbose(txHash *chainhash.Hash) (*btcjson.TxRawResult, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.GetRawTransactionVerboseAsync(txHash).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// FutureDecodeRawTransactionResult is a future promise to deliver the result
|
|
|
|
// of a DecodeRawTransactionAsync RPC invocation (or an applicable error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureDecodeRawTransactionResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns information
|
|
|
|
// about a transaction given its serialized bytes.
|
|
|
|
func (r FutureDecodeRawTransactionResult) Receive() (*btcjson.TxRawResult, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal result as a decoderawtransaction result object.
|
|
|
|
var rawTxResult btcjson.TxRawResult
|
|
|
|
err = json.Unmarshal(res, &rawTxResult)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
return &rawTxResult, nil
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// DecodeRawTransactionAsync 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 DecodeRawTransaction for the blocking version and more details.
|
|
|
|
func (c *Client) DecodeRawTransactionAsync(serializedTx []byte) FutureDecodeRawTransactionResult {
|
|
|
|
txHex := hex.EncodeToString(serializedTx)
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewDecodeRawTransactionCmd(txHex)
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// DecodeRawTransaction returns information about a transaction given its
|
|
|
|
// serialized bytes.
|
|
|
|
func (c *Client) DecodeRawTransaction(serializedTx []byte) (*btcjson.TxRawResult, error) {
|
|
|
|
return c.DecodeRawTransactionAsync(serializedTx).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// FutureCreateRawTransactionResult is a future promise to deliver the result
|
|
|
|
// of a CreateRawTransactionAsync RPC invocation (or an applicable error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureCreateRawTransactionResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns a new
|
|
|
|
// transaction spending the provided inputs and sending to the provided
|
|
|
|
// addresses.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (r FutureCreateRawTransactionResult) Receive() (*wire.MsgTx, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal result as a string.
|
|
|
|
var txHex string
|
|
|
|
err = json.Unmarshal(res, &txHex)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Decode the serialized transaction hex to raw bytes.
|
|
|
|
serializedTx, err := hex.DecodeString(txHex)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deserialize the transaction and return it.
|
2015-02-05 22:50:03 +01:00
|
|
|
var msgTx wire.MsgTx
|
2014-06-05 05:12:47 +02:00
|
|
|
if err := msgTx.Deserialize(bytes.NewReader(serializedTx)); err != nil {
|
2014-05-07 18:14:39 +02:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return &msgTx, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// CreateRawTransactionAsync 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 CreateRawTransaction for the blocking version and more details.
|
2014-05-10 04:24:25 +02:00
|
|
|
func (c *Client) CreateRawTransactionAsync(inputs []btcjson.TransactionInput,
|
2015-10-27 17:34:11 +01:00
|
|
|
amounts map[btcutil.Address]btcutil.Amount, lockTime *int64) FutureCreateRawTransactionResult {
|
2014-05-10 04:24:25 +02:00
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
convertedAmts := make(map[string]float64, len(amounts))
|
2014-05-10 04:24:25 +02:00
|
|
|
for addr, amount := range amounts {
|
2015-01-01 23:34:07 +01:00
|
|
|
convertedAmts[addr.String()] = amount.ToBTC()
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
2015-10-27 17:34:11 +01:00
|
|
|
cmd := btcjson.NewCreateRawTransactionCmd(inputs, convertedAmts, lockTime)
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// CreateRawTransaction returns a new transaction spending the provided inputs
|
|
|
|
// and sending to the provided addresses.
|
2014-05-10 04:24:25 +02:00
|
|
|
func (c *Client) CreateRawTransaction(inputs []btcjson.TransactionInput,
|
2015-10-27 17:34:11 +01:00
|
|
|
amounts map[btcutil.Address]btcutil.Amount, lockTime *int64) (*wire.MsgTx, error) {
|
2014-05-10 04:24:25 +02:00
|
|
|
|
2015-10-27 17:34:11 +01:00
|
|
|
return c.CreateRawTransactionAsync(inputs, amounts, lockTime).Receive()
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// FutureSendRawTransactionResult is a future promise to deliver the result
|
|
|
|
// of a SendRawTransactionAsync RPC invocation (or an applicable error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureSendRawTransactionResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns the result
|
|
|
|
// of submitting the encoded transaction to the server which then relays it to
|
|
|
|
// the network.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (r FutureSendRawTransactionResult) Receive() (*chainhash.Hash, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal result as a string.
|
|
|
|
var txHashStr string
|
|
|
|
err = json.Unmarshal(res, &txHashStr)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2016-08-08 21:16:04 +02:00
|
|
|
return chainhash.NewHashFromStr(txHashStr)
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// SendRawTransactionAsync 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 SendRawTransaction for the blocking version and more details.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SendRawTransactionAsync(tx *wire.MsgTx, allowHighFees bool) FutureSendRawTransactionResult {
|
2014-05-22 02:53:46 +02:00
|
|
|
txHex := ""
|
|
|
|
if tx != nil {
|
|
|
|
// Serialize the transaction and convert to hex string.
|
|
|
|
buf := bytes.NewBuffer(make([]byte, 0, tx.SerializeSize()))
|
|
|
|
if err := tx.Serialize(buf); err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
txHex = hex.EncodeToString(buf.Bytes())
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2019-10-30 02:51:59 +01:00
|
|
|
// Due to differences in the sendrawtransaction API for different
|
|
|
|
// backends, we'll need to inspect our version and construct the
|
|
|
|
// appropriate request.
|
|
|
|
version, err := c.BackendVersion()
|
|
|
|
if err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
|
|
|
|
var cmd *btcjson.SendRawTransactionCmd
|
|
|
|
switch version {
|
|
|
|
// Starting from bitcoind v0.19.0, the MaxFeeRate field should be used.
|
|
|
|
case BitcoindPost19:
|
|
|
|
// Using a 0 MaxFeeRate is interpreted as a maximum fee rate not
|
|
|
|
// being enforced by bitcoind.
|
|
|
|
var maxFeeRate int32
|
|
|
|
if !allowHighFees {
|
|
|
|
maxFeeRate = defaultMaxFeeRate
|
|
|
|
}
|
|
|
|
cmd = btcjson.NewBitcoindSendRawTransactionCmd(txHex, maxFeeRate)
|
|
|
|
|
|
|
|
// Otherwise, use the AllowHighFees field.
|
|
|
|
default:
|
|
|
|
cmd = btcjson.NewSendRawTransactionCmd(txHex, &allowHighFees)
|
|
|
|
}
|
|
|
|
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SendRawTransaction submits the encoded transaction to the server which will
|
|
|
|
// then relay it to the network.
|
2016-08-08 21:16:04 +02:00
|
|
|
func (c *Client) SendRawTransaction(tx *wire.MsgTx, allowHighFees bool) (*chainhash.Hash, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.SendRawTransactionAsync(tx, allowHighFees).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// FutureSignRawTransactionResult is a future promise to deliver the result
|
|
|
|
// of one of the SignRawTransactionAsync family of RPC invocations (or an
|
|
|
|
// applicable error).
|
2014-06-10 02:49:41 +02:00
|
|
|
type FutureSignRawTransactionResult chan *response
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns the
|
|
|
|
// signed transaction as well as whether or not all inputs are now signed.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (r FutureSignRawTransactionResult) Receive() (*wire.MsgTx, bool, error) {
|
2014-06-10 02:49:41 +02:00
|
|
|
res, err := receiveFuture(r)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, false, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
// Unmarshal as a signrawtransaction result.
|
|
|
|
var signRawTxResult btcjson.SignRawTransactionResult
|
|
|
|
err = json.Unmarshal(res, &signRawTxResult)
|
|
|
|
if err != nil {
|
|
|
|
return nil, false, err
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Decode the serialized transaction hex to raw bytes.
|
2014-06-10 02:49:41 +02:00
|
|
|
serializedTx, err := hex.DecodeString(signRawTxResult.Hex)
|
2014-05-07 18:14:39 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, false, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deserialize the transaction and return it.
|
2015-02-05 22:50:03 +01:00
|
|
|
var msgTx wire.MsgTx
|
2014-06-05 05:12:47 +02:00
|
|
|
if err := msgTx.Deserialize(bytes.NewReader(serializedTx)); err != nil {
|
2014-05-07 18:14:39 +02:00
|
|
|
return nil, false, err
|
|
|
|
}
|
|
|
|
|
2014-06-10 02:49:41 +02:00
|
|
|
return &msgTx, signRawTxResult.Complete, nil
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransactionAsync 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 SignRawTransaction for the blocking version and more details.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransactionAsync(tx *wire.MsgTx) FutureSignRawTransactionResult {
|
2014-05-22 02:53:46 +02:00
|
|
|
txHex := ""
|
|
|
|
if tx != nil {
|
|
|
|
// Serialize the transaction and convert to hex string.
|
|
|
|
buf := bytes.NewBuffer(make([]byte, 0, tx.SerializeSize()))
|
|
|
|
if err := tx.Serialize(buf); err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
txHex = hex.EncodeToString(buf.Bytes())
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewSignRawTransactionCmd(txHex, nil, nil, nil)
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction signs inputs for the passed transaction and returns the
|
|
|
|
// signed transaction as well as whether or not all inputs are now signed.
|
|
|
|
//
|
|
|
|
// This function assumes the RPC server already knows the input transactions and
|
|
|
|
// private keys for the passed transaction which needs to be signed and uses the
|
|
|
|
// default signature hash type. Use one of the SignRawTransaction# variants to
|
|
|
|
// specify that information if needed.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction(tx *wire.MsgTx) (*wire.MsgTx, bool, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.SignRawTransactionAsync(tx).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction2Async 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 SignRawTransaction2 for the blocking version and more details.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction2Async(tx *wire.MsgTx, inputs []btcjson.RawTxInput) FutureSignRawTransactionResult {
|
2014-05-22 02:53:46 +02:00
|
|
|
txHex := ""
|
|
|
|
if tx != nil {
|
|
|
|
// Serialize the transaction and convert to hex string.
|
|
|
|
buf := bytes.NewBuffer(make([]byte, 0, tx.SerializeSize()))
|
|
|
|
if err := tx.Serialize(buf); err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
txHex = hex.EncodeToString(buf.Bytes())
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewSignRawTransactionCmd(txHex, &inputs, nil, nil)
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction2 signs inputs for the passed transaction given the list
|
|
|
|
// of information about the input transactions needed to perform the signing
|
|
|
|
// process.
|
|
|
|
//
|
|
|
|
// This only input transactions that need to be specified are ones the
|
|
|
|
// RPC server does not already know. Already known input transactions will be
|
|
|
|
// merged with the specified transactions.
|
|
|
|
//
|
|
|
|
// See SignRawTransaction if the RPC server already knows the input
|
|
|
|
// transactions.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction2(tx *wire.MsgTx, inputs []btcjson.RawTxInput) (*wire.MsgTx, bool, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.SignRawTransaction2Async(tx, inputs).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction3Async 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 SignRawTransaction3 for the blocking version and more details.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction3Async(tx *wire.MsgTx,
|
2014-05-07 18:14:39 +02:00
|
|
|
inputs []btcjson.RawTxInput,
|
|
|
|
privKeysWIF []string) FutureSignRawTransactionResult {
|
|
|
|
|
2014-05-22 02:53:46 +02:00
|
|
|
txHex := ""
|
|
|
|
if tx != nil {
|
|
|
|
// Serialize the transaction and convert to hex string.
|
|
|
|
buf := bytes.NewBuffer(make([]byte, 0, tx.SerializeSize()))
|
|
|
|
if err := tx.Serialize(buf); err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
txHex = hex.EncodeToString(buf.Bytes())
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewSignRawTransactionCmd(txHex, &inputs, &privKeysWIF,
|
|
|
|
nil)
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction3 signs inputs for the passed transaction given the list
|
|
|
|
// of information about extra input transactions and a list of private keys
|
|
|
|
// needed to perform the signing process. The private keys must be in wallet
|
|
|
|
// import format (WIF).
|
|
|
|
//
|
|
|
|
// This only input transactions that need to be specified are ones the
|
|
|
|
// RPC server does not already know. Already known input transactions will be
|
|
|
|
// merged with the specified transactions. This means the list of transaction
|
|
|
|
// inputs can be nil if the RPC server already knows them all.
|
|
|
|
//
|
|
|
|
// NOTE: Unlike the merging functionality of the input transactions, ONLY the
|
|
|
|
// specified private keys will be used, so even if the server already knows some
|
|
|
|
// of the private keys, they will NOT be used.
|
|
|
|
//
|
|
|
|
// See SignRawTransaction if the RPC server already knows the input
|
|
|
|
// transactions and private keys or SignRawTransaction2 if it already knows the
|
|
|
|
// private keys.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction3(tx *wire.MsgTx,
|
2014-05-07 18:14:39 +02:00
|
|
|
inputs []btcjson.RawTxInput,
|
2015-02-05 22:50:03 +01:00
|
|
|
privKeysWIF []string) (*wire.MsgTx, bool, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
return c.SignRawTransaction3Async(tx, inputs, privKeysWIF).Receive()
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction4Async 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 SignRawTransaction4 for the blocking version and more details.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction4Async(tx *wire.MsgTx,
|
2014-05-07 18:14:39 +02:00
|
|
|
inputs []btcjson.RawTxInput, privKeysWIF []string,
|
|
|
|
hashType SigHashType) FutureSignRawTransactionResult {
|
|
|
|
|
2014-05-22 02:53:46 +02:00
|
|
|
txHex := ""
|
|
|
|
if tx != nil {
|
|
|
|
// Serialize the transaction and convert to hex string.
|
|
|
|
buf := bytes.NewBuffer(make([]byte, 0, tx.SerializeSize()))
|
|
|
|
if err := tx.Serialize(buf); err != nil {
|
|
|
|
return newFutureError(err)
|
|
|
|
}
|
|
|
|
txHex = hex.EncodeToString(buf.Bytes())
|
2014-05-07 18:14:39 +02:00
|
|
|
}
|
|
|
|
|
2015-01-01 23:34:07 +01:00
|
|
|
cmd := btcjson.NewSignRawTransactionCmd(txHex, &inputs, &privKeysWIF,
|
|
|
|
btcjson.String(string(hashType)))
|
2014-05-07 18:14:39 +02:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransaction4 signs inputs for the passed transaction using the
|
|
|
|
// the specified signature hash type given the list of information about extra
|
|
|
|
// input transactions and a potential list of private keys needed to perform
|
|
|
|
// the signing process. The private keys, if specified, must be in wallet
|
|
|
|
// import format (WIF).
|
|
|
|
//
|
|
|
|
// The only input transactions that need to be specified are ones the RPC server
|
|
|
|
// does not already know. This means the list of transaction inputs can be nil
|
|
|
|
// if the RPC server already knows them all.
|
|
|
|
//
|
|
|
|
// NOTE: Unlike the merging functionality of the input transactions, ONLY the
|
|
|
|
// specified private keys will be used, so even if the server already knows some
|
|
|
|
// of the private keys, they will NOT be used. The list of private keys can be
|
|
|
|
// nil in which case any private keys the RPC server knows will be used.
|
|
|
|
//
|
|
|
|
// This function should only used if a non-default signature hash type is
|
|
|
|
// desired. Otherwise, see SignRawTransaction if the RPC server already knows
|
|
|
|
// the input transactions and private keys, SignRawTransaction2 if it already
|
|
|
|
// knows the private keys, or SignRawTransaction3 if it does not know both.
|
2015-02-05 22:50:03 +01:00
|
|
|
func (c *Client) SignRawTransaction4(tx *wire.MsgTx,
|
2014-05-07 18:14:39 +02:00
|
|
|
inputs []btcjson.RawTxInput, privKeysWIF []string,
|
2015-02-05 22:50:03 +01:00
|
|
|
hashType SigHashType) (*wire.MsgTx, bool, error) {
|
2014-05-07 18:14:39 +02:00
|
|
|
|
|
|
|
return c.SignRawTransaction4Async(tx, inputs, privKeysWIF,
|
|
|
|
hashType).Receive()
|
|
|
|
}
|
2015-02-22 04:06:06 +01:00
|
|
|
|
|
|
|
// FutureSearchRawTransactionsResult is a future promise to deliver the result
|
|
|
|
// of the SearchRawTransactionsAsync RPC invocation (or an applicable error).
|
|
|
|
type FutureSearchRawTransactionsResult chan *response
|
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns the
|
|
|
|
// found raw transactions.
|
|
|
|
func (r FutureSearchRawTransactionsResult) Receive() ([]*wire.MsgTx, error) {
|
|
|
|
res, err := receiveFuture(r)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal as an array of strings.
|
|
|
|
var searchRawTxnsResult []string
|
|
|
|
err = json.Unmarshal(res, &searchRawTxnsResult)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Decode and deserialize each transaction.
|
|
|
|
msgTxns := make([]*wire.MsgTx, 0, len(searchRawTxnsResult))
|
|
|
|
for _, hexTx := range searchRawTxnsResult {
|
|
|
|
// Decode the serialized transaction hex to raw bytes.
|
|
|
|
serializedTx, err := hex.DecodeString(hexTx)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deserialize the transaction and add it to the result slice.
|
|
|
|
var msgTx wire.MsgTx
|
|
|
|
err = msgTx.Deserialize(bytes.NewReader(serializedTx))
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
msgTxns = append(msgTxns, &msgTx)
|
|
|
|
}
|
|
|
|
|
|
|
|
return msgTxns, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SearchRawTransactionsAsync 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 SearchRawTransactions for the blocking version and more details.
|
2015-11-17 07:17:19 +01:00
|
|
|
func (c *Client) SearchRawTransactionsAsync(address btcutil.Address, skip, count int, reverse bool, filterAddrs []string) FutureSearchRawTransactionsResult {
|
2015-02-22 04:06:06 +01:00
|
|
|
addr := address.EncodeAddress()
|
|
|
|
verbose := btcjson.Int(0)
|
2015-08-23 20:30:13 +02:00
|
|
|
cmd := btcjson.NewSearchRawTransactionsCmd(addr, verbose, &skip, &count,
|
2015-11-17 07:17:19 +01:00
|
|
|
nil, &reverse, &filterAddrs)
|
2015-02-22 04:06:06 +01:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SearchRawTransactions returns transactions that involve the passed address.
|
|
|
|
//
|
|
|
|
// NOTE: Chain servers do not typically provide this capability unless it has
|
|
|
|
// specifically been enabled.
|
|
|
|
//
|
|
|
|
// See SearchRawTransactionsVerbose to retrieve a list of data structures with
|
|
|
|
// information about the transactions instead of the transactions themselves.
|
2015-11-17 07:17:19 +01:00
|
|
|
func (c *Client) SearchRawTransactions(address btcutil.Address, skip, count int, reverse bool, filterAddrs []string) ([]*wire.MsgTx, error) {
|
|
|
|
return c.SearchRawTransactionsAsync(address, skip, count, reverse, filterAddrs).Receive()
|
2015-02-22 04:06:06 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// FutureSearchRawTransactionsVerboseResult is a future promise to deliver the
|
|
|
|
// result of the SearchRawTransactionsVerboseAsync RPC invocation (or an
|
|
|
|
// applicable error).
|
|
|
|
type FutureSearchRawTransactionsVerboseResult chan *response
|
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns the
|
|
|
|
// found raw transactions.
|
2015-08-23 20:30:13 +02:00
|
|
|
func (r FutureSearchRawTransactionsVerboseResult) Receive() ([]*btcjson.SearchRawTransactionsResult, error) {
|
2015-02-22 04:06:06 +01:00
|
|
|
res, err := receiveFuture(r)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal as an array of raw transaction results.
|
2015-08-23 20:30:13 +02:00
|
|
|
var result []*btcjson.SearchRawTransactionsResult
|
2015-02-22 04:06:06 +01:00
|
|
|
err = json.Unmarshal(res, &result)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return result, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SearchRawTransactionsVerboseAsync 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 SearchRawTransactionsVerbose for the blocking version and more details.
|
2015-08-23 20:30:13 +02:00
|
|
|
func (c *Client) SearchRawTransactionsVerboseAsync(address btcutil.Address, skip,
|
2015-11-17 07:17:19 +01:00
|
|
|
count int, includePrevOut, reverse bool, filterAddrs *[]string) FutureSearchRawTransactionsVerboseResult {
|
2015-08-23 20:30:13 +02:00
|
|
|
|
2015-02-22 04:06:06 +01:00
|
|
|
addr := address.EncodeAddress()
|
|
|
|
verbose := btcjson.Int(1)
|
2015-08-23 20:30:13 +02:00
|
|
|
var prevOut *int
|
|
|
|
if includePrevOut {
|
|
|
|
prevOut = btcjson.Int(1)
|
|
|
|
}
|
|
|
|
cmd := btcjson.NewSearchRawTransactionsCmd(addr, verbose, &skip, &count,
|
2015-11-17 07:17:19 +01:00
|
|
|
prevOut, &reverse, filterAddrs)
|
2015-02-22 04:06:06 +01:00
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// SearchRawTransactionsVerbose returns a list of data structures that describe
|
|
|
|
// transactions which involve the passed address.
|
|
|
|
//
|
|
|
|
// NOTE: Chain servers do not typically provide this capability unless it has
|
|
|
|
// specifically been enabled.
|
|
|
|
//
|
|
|
|
// See SearchRawTransactions to retrieve a list of raw transactions instead.
|
2015-08-23 20:30:13 +02:00
|
|
|
func (c *Client) SearchRawTransactionsVerbose(address btcutil.Address, skip,
|
2015-11-17 07:17:19 +01:00
|
|
|
count int, includePrevOut, reverse bool, filterAddrs []string) ([]*btcjson.SearchRawTransactionsResult, error) {
|
2015-08-23 20:30:13 +02:00
|
|
|
|
|
|
|
return c.SearchRawTransactionsVerboseAsync(address, skip, count,
|
2015-11-17 07:17:19 +01:00
|
|
|
includePrevOut, reverse, &filterAddrs).Receive()
|
2015-02-22 04:06:06 +01:00
|
|
|
}
|
2018-01-26 07:20:33 +01:00
|
|
|
|
|
|
|
// FutureDecodeScriptResult is a future promise to deliver the result
|
|
|
|
// of a DecodeScriptAsync RPC invocation (or an applicable error).
|
|
|
|
type FutureDecodeScriptResult chan *response
|
|
|
|
|
|
|
|
// Receive waits for the response promised by the future and returns information
|
|
|
|
// about a script given its serialized bytes.
|
|
|
|
func (r FutureDecodeScriptResult) Receive() (*btcjson.DecodeScriptResult, error) {
|
|
|
|
res, err := receiveFuture(r)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unmarshal result as a decodescript result object.
|
|
|
|
var decodeScriptResult btcjson.DecodeScriptResult
|
|
|
|
err = json.Unmarshal(res, &decodeScriptResult)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return &decodeScriptResult, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// DecodeScriptAsync 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 DecodeScript for the blocking version and more details.
|
|
|
|
func (c *Client) DecodeScriptAsync(serializedScript []byte) FutureDecodeScriptResult {
|
|
|
|
scriptHex := hex.EncodeToString(serializedScript)
|
|
|
|
cmd := btcjson.NewDecodeScriptCmd(scriptHex)
|
|
|
|
return c.sendCmd(cmd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// DecodeScript returns information about a script given its serialized bytes.
|
|
|
|
func (c *Client) DecodeScript(serializedScript []byte) (*btcjson.DecodeScriptResult, error) {
|
|
|
|
return c.DecodeScriptAsync(serializedScript).Receive()
|
|
|
|
}
|