2015-05-01 08:28:01 +02:00
|
|
|
// Copyright (c) 2014 The btcsuite developers
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
// Use of this source code is governed by an ISC
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
// NOTE: This file is intended to house the RPC commands that are supported by
|
|
|
|
// a wallet server.
|
|
|
|
|
|
|
|
package btcjson
|
|
|
|
|
|
|
|
// AddMultisigAddressCmd defines the addmutisigaddress JSON-RPC command.
|
|
|
|
type AddMultisigAddressCmd struct {
|
|
|
|
NRequired int
|
|
|
|
Keys []string
|
2015-04-23 04:17:29 +02:00
|
|
|
Account *string
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewAddMultisigAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// addmultisigaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewAddMultisigAddressCmd(nRequired int, keys []string, account *string) *AddMultisigAddressCmd {
|
|
|
|
return &AddMultisigAddressCmd{
|
|
|
|
NRequired: nRequired,
|
|
|
|
Keys: keys,
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-09-11 06:10:46 +02:00
|
|
|
// AddWitnessAddressCmd defines the addwitnessaddress JSON-RPC command.
|
|
|
|
type AddWitnessAddressCmd struct {
|
|
|
|
Address string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewAddWitnessAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// addwitnessaddress JSON-RPC command.
|
|
|
|
func NewAddWitnessAddressCmd(address string) *AddWitnessAddressCmd {
|
|
|
|
return &AddWitnessAddressCmd{
|
|
|
|
Address: address,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
// CreateMultisigCmd defines the createmultisig JSON-RPC command.
|
|
|
|
type CreateMultisigCmd struct {
|
|
|
|
NRequired int
|
|
|
|
Keys []string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewCreateMultisigCmd returns a new instance which can be used to issue a
|
|
|
|
// createmultisig JSON-RPC command.
|
|
|
|
func NewCreateMultisigCmd(nRequired int, keys []string) *CreateMultisigCmd {
|
|
|
|
return &CreateMultisigCmd{
|
|
|
|
NRequired: nRequired,
|
|
|
|
Keys: keys,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// DumpPrivKeyCmd defines the dumpprivkey JSON-RPC command.
|
|
|
|
type DumpPrivKeyCmd struct {
|
|
|
|
Address string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewDumpPrivKeyCmd returns a new instance which can be used to issue a
|
|
|
|
// dumpprivkey JSON-RPC command.
|
|
|
|
func NewDumpPrivKeyCmd(address string) *DumpPrivKeyCmd {
|
|
|
|
return &DumpPrivKeyCmd{
|
|
|
|
Address: address,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// EncryptWalletCmd defines the encryptwallet JSON-RPC command.
|
|
|
|
type EncryptWalletCmd struct {
|
|
|
|
Passphrase string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewEncryptWalletCmd returns a new instance which can be used to issue a
|
|
|
|
// encryptwallet JSON-RPC command.
|
|
|
|
func NewEncryptWalletCmd(passphrase string) *EncryptWalletCmd {
|
|
|
|
return &EncryptWalletCmd{
|
|
|
|
Passphrase: passphrase,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-11-26 14:33:48 +01:00
|
|
|
// EstimateSmartFeeMode defines the different fee estimation modes available
|
|
|
|
// for the estimatesmartfee JSON-RPC command.
|
|
|
|
type EstimateSmartFeeMode string
|
|
|
|
|
|
|
|
var (
|
|
|
|
EstimateModeUnset EstimateSmartFeeMode = "UNSET"
|
|
|
|
EstimateModeEconomical EstimateSmartFeeMode = "ECONOMICAL"
|
|
|
|
EstimateModeConservative EstimateSmartFeeMode = "CONSERVATIVE"
|
|
|
|
)
|
|
|
|
|
|
|
|
// EstimateSmartFeeCmd defines the estimatesmartfee JSON-RPC command.
|
|
|
|
type EstimateSmartFeeCmd struct {
|
|
|
|
ConfTarget int64
|
|
|
|
EstimateMode *EstimateSmartFeeMode `jsonrpcdefault:"\"CONSERVATIVE\""`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewEstimateSmartFeeCmd returns a new instance which can be used to issue a
|
|
|
|
// estimatesmartfee JSON-RPC command.
|
|
|
|
func NewEstimateSmartFeeCmd(confTarget int64, mode *EstimateSmartFeeMode) *EstimateSmartFeeCmd {
|
|
|
|
return &EstimateSmartFeeCmd{
|
|
|
|
ConfTarget: confTarget, EstimateMode: mode,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
// EstimateFeeCmd defines the estimatefee JSON-RPC command.
|
|
|
|
type EstimateFeeCmd struct {
|
|
|
|
NumBlocks int64
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewEstimateFeeCmd returns a new instance which can be used to issue a
|
|
|
|
// estimatefee JSON-RPC command.
|
|
|
|
func NewEstimateFeeCmd(numBlocks int64) *EstimateFeeCmd {
|
|
|
|
return &EstimateFeeCmd{
|
|
|
|
NumBlocks: numBlocks,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// EstimatePriorityCmd defines the estimatepriority JSON-RPC command.
|
|
|
|
type EstimatePriorityCmd struct {
|
|
|
|
NumBlocks int64
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewEstimatePriorityCmd returns a new instance which can be used to issue a
|
|
|
|
// estimatepriority JSON-RPC command.
|
|
|
|
func NewEstimatePriorityCmd(numBlocks int64) *EstimatePriorityCmd {
|
|
|
|
return &EstimatePriorityCmd{
|
|
|
|
NumBlocks: numBlocks,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetAccountCmd defines the getaccount JSON-RPC command.
|
|
|
|
type GetAccountCmd struct {
|
|
|
|
Address string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetAccountCmd returns a new instance which can be used to issue a
|
|
|
|
// getaccount JSON-RPC command.
|
|
|
|
func NewGetAccountCmd(address string) *GetAccountCmd {
|
|
|
|
return &GetAccountCmd{
|
|
|
|
Address: address,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetAccountAddressCmd defines the getaccountaddress JSON-RPC command.
|
|
|
|
type GetAccountAddressCmd struct {
|
|
|
|
Account string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetAccountAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// getaccountaddress JSON-RPC command.
|
|
|
|
func NewGetAccountAddressCmd(account string) *GetAccountAddressCmd {
|
|
|
|
return &GetAccountAddressCmd{
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetAddressesByAccountCmd defines the getaddressesbyaccount JSON-RPC command.
|
|
|
|
type GetAddressesByAccountCmd struct {
|
|
|
|
Account string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetAddressesByAccountCmd returns a new instance which can be used to issue
|
|
|
|
// a getaddressesbyaccount JSON-RPC command.
|
|
|
|
func NewGetAddressesByAccountCmd(account string) *GetAddressesByAccountCmd {
|
|
|
|
return &GetAddressesByAccountCmd{
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetBalanceCmd defines the getbalance JSON-RPC command.
|
|
|
|
type GetBalanceCmd struct {
|
2015-04-23 04:17:29 +02:00
|
|
|
Account *string
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetBalanceCmd returns a new instance which can be used to issue a
|
|
|
|
// getbalance JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetBalanceCmd(account *string, minConf *int) *GetBalanceCmd {
|
|
|
|
return &GetBalanceCmd{
|
|
|
|
Account: account,
|
|
|
|
MinConf: minConf,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetNewAddressCmd defines the getnewaddress JSON-RPC command.
|
|
|
|
type GetNewAddressCmd struct {
|
2015-04-23 04:17:29 +02:00
|
|
|
Account *string
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetNewAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// getnewaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetNewAddressCmd(account *string) *GetNewAddressCmd {
|
|
|
|
return &GetNewAddressCmd{
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetRawChangeAddressCmd defines the getrawchangeaddress JSON-RPC command.
|
|
|
|
type GetRawChangeAddressCmd struct {
|
2015-04-23 04:17:29 +02:00
|
|
|
Account *string
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetRawChangeAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// getrawchangeaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetRawChangeAddressCmd(account *string) *GetRawChangeAddressCmd {
|
|
|
|
return &GetRawChangeAddressCmd{
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetReceivedByAccountCmd defines the getreceivedbyaccount JSON-RPC command.
|
|
|
|
type GetReceivedByAccountCmd struct {
|
|
|
|
Account string
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetReceivedByAccountCmd returns a new instance which can be used to issue
|
|
|
|
// a getreceivedbyaccount JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetReceivedByAccountCmd(account string, minConf *int) *GetReceivedByAccountCmd {
|
|
|
|
return &GetReceivedByAccountCmd{
|
|
|
|
Account: account,
|
|
|
|
MinConf: minConf,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetReceivedByAddressCmd defines the getreceivedbyaddress JSON-RPC command.
|
|
|
|
type GetReceivedByAddressCmd struct {
|
|
|
|
Address string
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetReceivedByAddressCmd returns a new instance which can be used to issue
|
|
|
|
// a getreceivedbyaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetReceivedByAddressCmd(address string, minConf *int) *GetReceivedByAddressCmd {
|
|
|
|
return &GetReceivedByAddressCmd{
|
|
|
|
Address: address,
|
|
|
|
MinConf: minConf,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetTransactionCmd defines the gettransaction JSON-RPC command.
|
|
|
|
type GetTransactionCmd struct {
|
|
|
|
Txid string
|
|
|
|
IncludeWatchOnly *bool `jsonrpcdefault:"false"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewGetTransactionCmd returns a new instance which can be used to issue a
|
|
|
|
// gettransaction JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewGetTransactionCmd(txHash string, includeWatchOnly *bool) *GetTransactionCmd {
|
|
|
|
return &GetTransactionCmd{
|
|
|
|
Txid: txHash,
|
|
|
|
IncludeWatchOnly: includeWatchOnly,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-07-24 19:56:24 +02:00
|
|
|
// GetWalletInfoCmd defines the getwalletinfo JSON-RPC command.
|
|
|
|
type GetWalletInfoCmd struct{}
|
|
|
|
|
|
|
|
// NewGetWalletInfoCmd returns a new instance which can be used to issue a
|
|
|
|
// getwalletinfo JSON-RPC command.
|
|
|
|
func NewGetWalletInfoCmd() *GetWalletInfoCmd {
|
|
|
|
return &GetWalletInfoCmd{}
|
|
|
|
}
|
|
|
|
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
// ImportPrivKeyCmd defines the importprivkey JSON-RPC command.
|
|
|
|
type ImportPrivKeyCmd struct {
|
|
|
|
PrivKey string
|
2015-04-23 04:17:29 +02:00
|
|
|
Label *string
|
|
|
|
Rescan *bool `jsonrpcdefault:"true"`
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewImportPrivKeyCmd returns a new instance which can be used to issue a
|
|
|
|
// importprivkey JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewImportPrivKeyCmd(privKey string, label *string, rescan *bool) *ImportPrivKeyCmd {
|
|
|
|
return &ImportPrivKeyCmd{
|
|
|
|
PrivKey: privKey,
|
|
|
|
Label: label,
|
|
|
|
Rescan: rescan,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// KeyPoolRefillCmd defines the keypoolrefill JSON-RPC command.
|
|
|
|
type KeyPoolRefillCmd struct {
|
|
|
|
NewSize *uint `jsonrpcdefault:"100"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewKeyPoolRefillCmd returns a new instance which can be used to issue a
|
|
|
|
// keypoolrefill JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewKeyPoolRefillCmd(newSize *uint) *KeyPoolRefillCmd {
|
|
|
|
return &KeyPoolRefillCmd{
|
|
|
|
NewSize: newSize,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListAccountsCmd defines the listaccounts JSON-RPC command.
|
|
|
|
type ListAccountsCmd struct {
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListAccountsCmd returns a new instance which can be used to issue a
|
|
|
|
// listaccounts JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListAccountsCmd(minConf *int) *ListAccountsCmd {
|
|
|
|
return &ListAccountsCmd{
|
|
|
|
MinConf: minConf,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListAddressGroupingsCmd defines the listaddressgroupings JSON-RPC command.
|
|
|
|
type ListAddressGroupingsCmd struct{}
|
|
|
|
|
|
|
|
// NewListAddressGroupingsCmd returns a new instance which can be used to issue
|
|
|
|
// a listaddressgroupoings JSON-RPC command.
|
|
|
|
func NewListAddressGroupingsCmd() *ListAddressGroupingsCmd {
|
|
|
|
return &ListAddressGroupingsCmd{}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListLockUnspentCmd defines the listlockunspent JSON-RPC command.
|
|
|
|
type ListLockUnspentCmd struct{}
|
|
|
|
|
|
|
|
// NewListLockUnspentCmd returns a new instance which can be used to issue a
|
|
|
|
// listlockunspent JSON-RPC command.
|
|
|
|
func NewListLockUnspentCmd() *ListLockUnspentCmd {
|
|
|
|
return &ListLockUnspentCmd{}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListReceivedByAccountCmd defines the listreceivedbyaccount JSON-RPC command.
|
|
|
|
type ListReceivedByAccountCmd struct {
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
IncludeEmpty *bool `jsonrpcdefault:"false"`
|
|
|
|
IncludeWatchOnly *bool `jsonrpcdefault:"false"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListReceivedByAccountCmd returns a new instance which can be used to issue
|
|
|
|
// a listreceivedbyaccount JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListReceivedByAccountCmd(minConf *int, includeEmpty, includeWatchOnly *bool) *ListReceivedByAccountCmd {
|
|
|
|
return &ListReceivedByAccountCmd{
|
|
|
|
MinConf: minConf,
|
|
|
|
IncludeEmpty: includeEmpty,
|
|
|
|
IncludeWatchOnly: includeWatchOnly,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListReceivedByAddressCmd defines the listreceivedbyaddress JSON-RPC command.
|
|
|
|
type ListReceivedByAddressCmd struct {
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
IncludeEmpty *bool `jsonrpcdefault:"false"`
|
|
|
|
IncludeWatchOnly *bool `jsonrpcdefault:"false"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListReceivedByAddressCmd returns a new instance which can be used to issue
|
|
|
|
// a listreceivedbyaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListReceivedByAddressCmd(minConf *int, includeEmpty, includeWatchOnly *bool) *ListReceivedByAddressCmd {
|
|
|
|
return &ListReceivedByAddressCmd{
|
|
|
|
MinConf: minConf,
|
|
|
|
IncludeEmpty: includeEmpty,
|
|
|
|
IncludeWatchOnly: includeWatchOnly,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListSinceBlockCmd defines the listsinceblock JSON-RPC command.
|
|
|
|
type ListSinceBlockCmd struct {
|
|
|
|
BlockHash *string
|
|
|
|
TargetConfirmations *int `jsonrpcdefault:"1"`
|
|
|
|
IncludeWatchOnly *bool `jsonrpcdefault:"false"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListSinceBlockCmd returns a new instance which can be used to issue a
|
|
|
|
// listsinceblock JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListSinceBlockCmd(blockHash *string, targetConfirms *int, includeWatchOnly *bool) *ListSinceBlockCmd {
|
|
|
|
return &ListSinceBlockCmd{
|
|
|
|
BlockHash: blockHash,
|
|
|
|
TargetConfirmations: targetConfirms,
|
|
|
|
IncludeWatchOnly: includeWatchOnly,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListTransactionsCmd defines the listtransactions JSON-RPC command.
|
|
|
|
type ListTransactionsCmd struct {
|
|
|
|
Account *string
|
|
|
|
Count *int `jsonrpcdefault:"10"`
|
|
|
|
From *int `jsonrpcdefault:"0"`
|
|
|
|
IncludeWatchOnly *bool `jsonrpcdefault:"false"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListTransactionsCmd returns a new instance which can be used to issue a
|
|
|
|
// listtransactions JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListTransactionsCmd(account *string, count, from *int, includeWatchOnly *bool) *ListTransactionsCmd {
|
|
|
|
return &ListTransactionsCmd{
|
|
|
|
Account: account,
|
|
|
|
Count: count,
|
|
|
|
From: from,
|
|
|
|
IncludeWatchOnly: includeWatchOnly,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListUnspentCmd defines the listunspent JSON-RPC command.
|
|
|
|
type ListUnspentCmd struct {
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
MaxConf *int `jsonrpcdefault:"9999999"`
|
|
|
|
Addresses *[]string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewListUnspentCmd returns a new instance which can be used to issue a
|
|
|
|
// listunspent JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewListUnspentCmd(minConf, maxConf *int, addresses *[]string) *ListUnspentCmd {
|
|
|
|
return &ListUnspentCmd{
|
|
|
|
MinConf: minConf,
|
|
|
|
MaxConf: maxConf,
|
|
|
|
Addresses: addresses,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// LockUnspentCmd defines the lockunspent JSON-RPC command.
|
|
|
|
type LockUnspentCmd struct {
|
|
|
|
Unlock bool
|
|
|
|
Transactions []TransactionInput
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewLockUnspentCmd returns a new instance which can be used to issue a
|
|
|
|
// lockunspent JSON-RPC command.
|
|
|
|
func NewLockUnspentCmd(unlock bool, transactions []TransactionInput) *LockUnspentCmd {
|
|
|
|
return &LockUnspentCmd{
|
|
|
|
Unlock: unlock,
|
|
|
|
Transactions: transactions,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// MoveCmd defines the move JSON-RPC command.
|
|
|
|
type MoveCmd struct {
|
|
|
|
FromAccount string
|
|
|
|
ToAccount string
|
|
|
|
Amount float64 // In BTC
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
Comment *string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewMoveCmd returns a new instance which can be used to issue a move JSON-RPC
|
|
|
|
// command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewMoveCmd(fromAccount, toAccount string, amount float64, minConf *int, comment *string) *MoveCmd {
|
|
|
|
return &MoveCmd{
|
|
|
|
FromAccount: fromAccount,
|
|
|
|
ToAccount: toAccount,
|
|
|
|
Amount: amount,
|
|
|
|
MinConf: minConf,
|
|
|
|
Comment: comment,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SendFromCmd defines the sendfrom JSON-RPC command.
|
|
|
|
type SendFromCmd struct {
|
|
|
|
FromAccount string
|
|
|
|
ToAddress string
|
|
|
|
Amount float64 // In BTC
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
Comment *string
|
|
|
|
CommentTo *string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSendFromCmd returns a new instance which can be used to issue a sendfrom
|
|
|
|
// JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewSendFromCmd(fromAccount, toAddress string, amount float64, minConf *int, comment, commentTo *string) *SendFromCmd {
|
|
|
|
return &SendFromCmd{
|
|
|
|
FromAccount: fromAccount,
|
|
|
|
ToAddress: toAddress,
|
|
|
|
Amount: amount,
|
|
|
|
MinConf: minConf,
|
|
|
|
Comment: comment,
|
|
|
|
CommentTo: commentTo,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SendManyCmd defines the sendmany JSON-RPC command.
|
|
|
|
type SendManyCmd struct {
|
|
|
|
FromAccount string
|
|
|
|
Amounts map[string]float64 `jsonrpcusage:"{\"address\":amount,...}"` // In BTC
|
|
|
|
MinConf *int `jsonrpcdefault:"1"`
|
|
|
|
Comment *string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSendManyCmd returns a new instance which can be used to issue a sendmany
|
|
|
|
// JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewSendManyCmd(fromAccount string, amounts map[string]float64, minConf *int, comment *string) *SendManyCmd {
|
|
|
|
return &SendManyCmd{
|
|
|
|
FromAccount: fromAccount,
|
|
|
|
Amounts: amounts,
|
|
|
|
MinConf: minConf,
|
|
|
|
Comment: comment,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SendToAddressCmd defines the sendtoaddress JSON-RPC command.
|
|
|
|
type SendToAddressCmd struct {
|
|
|
|
Address string
|
|
|
|
Amount float64
|
|
|
|
Comment *string
|
|
|
|
CommentTo *string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSendToAddressCmd returns a new instance which can be used to issue a
|
|
|
|
// sendtoaddress JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewSendToAddressCmd(address string, amount float64, comment, commentTo *string) *SendToAddressCmd {
|
|
|
|
return &SendToAddressCmd{
|
|
|
|
Address: address,
|
|
|
|
Amount: amount,
|
|
|
|
Comment: comment,
|
|
|
|
CommentTo: commentTo,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetAccountCmd defines the setaccount JSON-RPC command.
|
|
|
|
type SetAccountCmd struct {
|
|
|
|
Address string
|
|
|
|
Account string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSetAccountCmd returns a new instance which can be used to issue a
|
|
|
|
// setaccount JSON-RPC command.
|
|
|
|
func NewSetAccountCmd(address, account string) *SetAccountCmd {
|
|
|
|
return &SetAccountCmd{
|
|
|
|
Address: address,
|
|
|
|
Account: account,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetTxFeeCmd defines the settxfee JSON-RPC command.
|
|
|
|
type SetTxFeeCmd struct {
|
|
|
|
Amount float64 // In BTC
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSetTxFeeCmd returns a new instance which can be used to issue a settxfee
|
|
|
|
// JSON-RPC command.
|
|
|
|
func NewSetTxFeeCmd(amount float64) *SetTxFeeCmd {
|
|
|
|
return &SetTxFeeCmd{
|
|
|
|
Amount: amount,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignMessageCmd defines the signmessage JSON-RPC command.
|
|
|
|
type SignMessageCmd struct {
|
|
|
|
Address string
|
|
|
|
Message string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSignMessageCmd returns a new instance which can be used to issue a
|
|
|
|
// signmessage JSON-RPC command.
|
|
|
|
func NewSignMessageCmd(address, message string) *SignMessageCmd {
|
|
|
|
return &SignMessageCmd{
|
|
|
|
Address: address,
|
|
|
|
Message: message,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// RawTxInput models the data needed for raw transaction input that is used in
|
|
|
|
// the SignRawTransactionCmd struct.
|
|
|
|
type RawTxInput struct {
|
|
|
|
Txid string `json:"txid"`
|
|
|
|
Vout uint32 `json:"vout"`
|
|
|
|
ScriptPubKey string `json:"scriptPubKey"`
|
|
|
|
RedeemScript string `json:"redeemScript"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// SignRawTransactionCmd defines the signrawtransaction JSON-RPC command.
|
|
|
|
type SignRawTransactionCmd struct {
|
|
|
|
RawTx string
|
|
|
|
Inputs *[]RawTxInput
|
|
|
|
PrivKeys *[]string
|
|
|
|
Flags *string `jsonrpcdefault:"\"ALL\""`
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewSignRawTransactionCmd returns a new instance which can be used to issue a
|
|
|
|
// signrawtransaction JSON-RPC command.
|
|
|
|
//
|
|
|
|
// The parameters which are pointers indicate they are optional. Passing nil
|
|
|
|
// for optional parameters will use the default value.
|
|
|
|
func NewSignRawTransactionCmd(hexEncodedTx string, inputs *[]RawTxInput, privKeys *[]string, flags *string) *SignRawTransactionCmd {
|
|
|
|
return &SignRawTransactionCmd{
|
|
|
|
RawTx: hexEncodedTx,
|
|
|
|
Inputs: inputs,
|
|
|
|
PrivKeys: privKeys,
|
|
|
|
Flags: flags,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// WalletLockCmd defines the walletlock JSON-RPC command.
|
|
|
|
type WalletLockCmd struct{}
|
|
|
|
|
|
|
|
// NewWalletLockCmd returns a new instance which can be used to issue a
|
|
|
|
// walletlock JSON-RPC command.
|
|
|
|
func NewWalletLockCmd() *WalletLockCmd {
|
|
|
|
return &WalletLockCmd{}
|
|
|
|
}
|
|
|
|
|
|
|
|
// WalletPassphraseCmd defines the walletpassphrase JSON-RPC command.
|
|
|
|
type WalletPassphraseCmd struct {
|
|
|
|
Passphrase string
|
|
|
|
Timeout int64
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewWalletPassphraseCmd returns a new instance which can be used to issue a
|
|
|
|
// walletpassphrase JSON-RPC command.
|
|
|
|
func NewWalletPassphraseCmd(passphrase string, timeout int64) *WalletPassphraseCmd {
|
|
|
|
return &WalletPassphraseCmd{
|
|
|
|
Passphrase: passphrase,
|
|
|
|
Timeout: timeout,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// WalletPassphraseChangeCmd defines the walletpassphrase JSON-RPC command.
|
|
|
|
type WalletPassphraseChangeCmd struct {
|
|
|
|
OldPassphrase string
|
|
|
|
NewPassphrase string
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewWalletPassphraseChangeCmd returns a new instance which can be used to
|
|
|
|
// issue a walletpassphrasechange JSON-RPC command.
|
|
|
|
func NewWalletPassphraseChangeCmd(oldPassphrase, newPassphrase string) *WalletPassphraseChangeCmd {
|
|
|
|
return &WalletPassphraseChangeCmd{
|
|
|
|
OldPassphrase: oldPassphrase,
|
|
|
|
NewPassphrase: newPassphrase,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func init() {
|
|
|
|
// The commands in this file are only usable with a wallet server.
|
|
|
|
flags := UFWalletOnly
|
|
|
|
|
|
|
|
MustRegisterCmd("addmultisigaddress", (*AddMultisigAddressCmd)(nil), flags)
|
2017-09-11 06:10:46 +02:00
|
|
|
MustRegisterCmd("addwitnessaddress", (*AddWitnessAddressCmd)(nil), flags)
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
MustRegisterCmd("createmultisig", (*CreateMultisigCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("dumpprivkey", (*DumpPrivKeyCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("encryptwallet", (*EncryptWalletCmd)(nil), flags)
|
2019-11-26 14:33:48 +01:00
|
|
|
MustRegisterCmd("estimatesmartfee", (*EstimateSmartFeeCmd)(nil), flags)
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
MustRegisterCmd("estimatefee", (*EstimateFeeCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("estimatepriority", (*EstimatePriorityCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getaccount", (*GetAccountCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getaccountaddress", (*GetAccountAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getaddressesbyaccount", (*GetAddressesByAccountCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getbalance", (*GetBalanceCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getnewaddress", (*GetNewAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getrawchangeaddress", (*GetRawChangeAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getreceivedbyaccount", (*GetReceivedByAccountCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("getreceivedbyaddress", (*GetReceivedByAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("gettransaction", (*GetTransactionCmd)(nil), flags)
|
2015-07-24 19:56:24 +02:00
|
|
|
MustRegisterCmd("getwalletinfo", (*GetWalletInfoCmd)(nil), flags)
|
Reimagine btcjson package with version 2.
This commit implements a reimagining of the way the btcjson package
functions based upon how the project has evolved and lessons learned while
using it since it was first written. It therefore contains significant
changes to the API. For now, it has been implemented in a v2 subdirectory
to prevent breaking existing callers, but the ultimate goal is to update
all callers to use the new version and then to replace the old API with
the new one.
This also removes the need for the btcws completely since those commands
have been rolled in.
The following is an overview of the changes and some reasoning behind why
they were made:
- The infrastructure has been completely changed to be reflection based instead
of requiring thousands and thousands of lines of manual, and therefore error
prone, marshal/unmarshal code
- This makes it much easier to add new commands without making marshalling
mistakes since it is simply a struct definition and a call to register that
new struct (plus a trivial New<foo>Cmd function and tests, of course)
- It also makes it much easier to gain a lot of information from simply
looking at the struct definition which was previously not possible
such as the order of the parameters, which parameters are required
versus optional, and what the default values for optional parameters
are
- Each command now has usage flags associated with them that can be
queried which are intended to allow classification of the commands such
as for chain server and wallet server and websocket-only
- The help infrastructure has been completely redone to provide automatic
generation with caller provided description map and result types. This
is in contrast to the previous method of providing the help directly
which meant it would end up in the binary of anything that imported the
package
- Many of the structs have been renamed to use the terminology from the
JSON-RPC
specification:
- RawCmd/Message is now only a single struct named Request to reflect the fact
it is a JSON-RPC request
- Error is now called RPCError to reflect the fact it is specifically an RPC
error as opposed to many of the other errors that are possible
- All RPC error codes except the standard JSON-RPC 2.0 errors have been
converted from full structs to only codes since an audit of the codebase
has shown that the messages are overridden the vast majority of the time
with specifics (as they should be) and removing them also avoids the
temptation to return non-specific, and therefore not as helpful, error
messages
- There is now an Error which provides a type assertable error with
error codes so callers can better ascertain failure reasons
programatically
- The ID is no longer a part of the command and is instead specified at the time
the command is marshalled into a JSON-RPC request. This aligns better with
the way JSON-RPC functions since it is the caller who manages the ID that is
sent with any given _request_, not the package
- All <Foo>Cmd structs now treat non-pointers as required fields and pointers as
optional fields
- All New<Foo>Cmd functions now accept the exact number of parameters, with
pointers to the appropriate type for optional parameters
- This is preferrable to the old vararg syntax since it means the code will
fail to compile if the optional arguments are changed now which helps
prevent errors creep in over time from missed modifications to optional args
- All of the connection related code has been completely eliminated since this
package is not intended to used a client, rather it is intended to provide
the infrastructure needed to marshal/unmarshal Bitcoin-specific JSON-RPC
requests and replies from static types
- The btcrpcclient package provides a robust client with connection management
and higher-level types that in turn uses the primitives provided by this
package
- Even if the caller does not wish to use btcrpcclient for some reason, they
should still be responsible for connection management since they might want
to use any number of connection features which the package would not
necessarily support
- Synced a few of the commands that have added new optional fields that
have since been added to Bitcoin Core
- Includes all of the commands and notifications that were previously in
btcws
- Now provides 100% test coverage with parallel tests
- The code is completely golint and go vet clean
This has the side effect of addressing nearly everything in, and therefore
closes #26.
Also fixes #18 and closes #19.
2014-12-31 08:05:03 +01:00
|
|
|
MustRegisterCmd("importprivkey", (*ImportPrivKeyCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("keypoolrefill", (*KeyPoolRefillCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listaccounts", (*ListAccountsCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listaddressgroupings", (*ListAddressGroupingsCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listlockunspent", (*ListLockUnspentCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listreceivedbyaccount", (*ListReceivedByAccountCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listreceivedbyaddress", (*ListReceivedByAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listsinceblock", (*ListSinceBlockCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listtransactions", (*ListTransactionsCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("listunspent", (*ListUnspentCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("lockunspent", (*LockUnspentCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("move", (*MoveCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("sendfrom", (*SendFromCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("sendmany", (*SendManyCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("sendtoaddress", (*SendToAddressCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("setaccount", (*SetAccountCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("settxfee", (*SetTxFeeCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("signmessage", (*SignMessageCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("signrawtransaction", (*SignRawTransactionCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("walletlock", (*WalletLockCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("walletpassphrase", (*WalletPassphraseCmd)(nil), flags)
|
|
|
|
MustRegisterCmd("walletpassphrasechange", (*WalletPassphraseChangeCmd)(nil), flags)
|
|
|
|
}
|