legacyrpc

package
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 3, 2016 License: ISC Imports: 33 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	ErrNeedPositiveAmount = InvalidParameterError{
		errors.New("amount must be positive"),
	}

	ErrNeedBelowMaxAmount = InvalidParameterError{
		errors.New("amount must be below max amount"),
	}

	ErrNeedPositiveSpendLimit = InvalidParameterError{
		errors.New("spend limit must be positive"),
	}

	ErrNeedPositiveMinconf = InvalidParameterError{
		errors.New("minconf must be positive"),
	}

	ErrAddressNotInWallet = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWallet,
		Message: "address not found in wallet",
	}

	ErrAccountNameNotFound = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWalletInvalidAccountName,
		Message: "account name not found",
	}

	ErrUnloadedWallet = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWallet,
		Message: "Request requires a wallet but wallet has not loaded yet",
	}

	ErrWalletUnlockNeeded = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWalletUnlockNeeded,
		Message: "Enter the wallet passphrase with walletpassphrase first",
	}

	ErrNotImportedAccount = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWallet,
		Message: "imported addresses must belong to the imported account",
	}

	ErrNoTransactionInfo = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCNoTxInfo,
		Message: "No information for transaction",
	}

	ErrReservedAccountName = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCInvalidParameter,
		Message: "Account name is reserved by RPC server",
	}

	ErrMainNetSafety = dcrjson.RPCError{
		Code:    dcrjson.ErrRPCWallet,
		Message: "RPC function disabled on MainNet wallets for security purposes",
	}
)

Errors variables that are defined once here to avoid duplication below.

View Source 
var ErrNoAuth = errors.New("no auth")

ErrNoAuth represents an error where authentication could not succeed due to a missing Authorization HTTP header.

Functions

func AccountAddressIndex added in v0.0.10 

func AccountAddressIndex(icmd interface{}, w *wallet.Wallet) (interface{}, error)

AccountAddressIndex returns the current address index for the passed account and branch.

func AccountFetchAddresses added in v0.0.10 

func AccountFetchAddresses(icmd interface{}, w *wallet.Wallet) (interface{}, error)

AccountFetchAddresses returns the all addresses from (start,end] for the passed account and branch.

func AccountSyncAddressIndex added in v0.0.10 

func AccountSyncAddressIndex(icmd interface{}, w *wallet.Wallet) (interface{}, error)

AccountSyncAddressIndex synchronizes the address manager and local address pool for some account and branch to the passed index. If the current pool index is beyond the passed index, an error is returned. If the passed index is the same as the current pool index, nothing is returned. If the syncing is successful, nothing is returned.

func AddMultiSigAddress 

func AddMultiSigAddress(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

AddMultiSigAddress handles an addmultisigaddress request by adding a multisig address to the given wallet.

func AddTicket added in v0.1.2 

func AddTicket(icmd interface{}, w *wallet.Wallet) (interface{}, error)

AddTicket adds a ticket to the stake manager manually.

func Consolidate 

func Consolidate(icmd interface{}, w *wallet.Wallet) (interface{}, error)

Consolidate handles a consolidate request by returning attempting to compress as many inputs as given and then returning the txHash and error.

func CreateMultiSig 

func CreateMultiSig(icmd interface{}, w *wallet.Wallet) (interface{}, error)

CreateMultiSig handles an createmultisig request by returning a multisig address for the given inputs.

func CreateNewAccount 

func CreateNewAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

CreateNewAccount handles a createnewaccount request by creating and returning a new account. If the last account has no transaction history as per BIP 0044 a new account cannot be created so an error will be returned.

func DumpPrivKey 

func DumpPrivKey(icmd interface{}, w *wallet.Wallet) (interface{}, error)

DumpPrivKey handles a dumpprivkey request with the private key for a single address, or an appropiate error if the wallet is locked.

func DumpWallet 

func DumpWallet(icmd interface{}, w *wallet.Wallet) (interface{}, error)

DumpWallet handles a dumpwallet request by returning all private keys in a wallet, or an appropiate error if the wallet is locked. TODO: finish this to match bitcoind by writing the dump to a file.

func GetAccount 

func GetAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetAccount handles a getaccount request by returning the account name associated with a single address.

func GetAccountAddress 

func GetAccountAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetAccountAddress handles a getaccountaddress by returning the most recently-created chained address that has not yet been used (does not yet appear in the blockchain, or any tx that has arrived in the dcrd mempool). If the most recently-requested address has been used, a new address (the next chained address in the keypool) is used. This can fail if the keypool runs out (and will return dcrjson.ErrRPCWalletKeypoolRanOut if that happens).

func GetAddressesByAccount 

func GetAddressesByAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetAddressesByAccount handles a getaddressesbyaccount request by returning all addresses for an account, or an error if the requested account does not exist.

func GetBalance 

func GetBalance(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetBalance handles a getbalance request by returning the balance for an account (wallet), or an error if the requested account does not exist.

func GetBalanceToMaintain 

func GetBalanceToMaintain(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetBalanceToMaintain handles a getbalancetomaintain request by returning the wallet balancetomaintain as a float64.

func GetBestBlock 

func GetBestBlock(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetBestBlock handles a getbestblock request by returning a JSON object with the height and hash of the most recently processed block.

func GetBestBlockHash 

func GetBestBlockHash(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetBestBlockHash handles a getbestblockhash request by returning the hash of the most recently processed block.

func GetBlockCount 

func GetBlockCount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetBlockCount handles a getblockcount request by returning the chain height of the most recently processed block.

func GetGenerate 

func GetGenerate(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetGenerate returns if stake mining is enabled for the wallet.

func GetInfo 

func GetInfo(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

GetInfo handles a getinfo request by returning the a structure containing information about the current state of dcrcwallet. exist.

func GetMasterPubkey 

func GetMasterPubkey(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetMasterPubkey handles a getmasterpubkey request by returning the wallet master pubkey encoded as a string.

func GetMultisigOutInfo 

func GetMultisigOutInfo(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

GetMultisigOutInfo displays information about a given multisignature output.

func GetNewAddress 

func GetNewAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetNewAddress handles a getnewaddress request by returning a new address for an account. If the account does not exist an appropiate error is returned. TODO: Follow BIP 0044 and warn if number of unused addresses exceeds the gap limit.

func GetRawChangeAddress 

func GetRawChangeAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetRawChangeAddress handles a getrawchangeaddress request by creating and returning a new change address for an account.

Note: bitcoind allows specifying the account as an optional parameter, but ignores the parameter.

func GetReceivedByAccount 

func GetReceivedByAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetReceivedByAccount handles a getreceivedbyaccount request by returning the total amount received by addresses of an account.

func GetReceivedByAddress 

func GetReceivedByAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetReceivedByAddress handles a getreceivedbyaddress request by returning the total amount received by a single address.

func GetSeed 

func GetSeed(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetSeed handles a getseed request by returning the wallet seed encoded as a string.

func GetStakeInfo 

func GetStakeInfo(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

GetStakeInfo gets a large amounts of information about the stake environment and a number of statistics about local staking in the wallet. These are better explained one-by-one: 

PoolSize         uint32   Number of live tickets in the ticket pool
Difficulty       int64    Current stake difficulty
AllMempoolTix    uint32   Number of tickets currently in the mempool
OwnMempoolTix    uint32   Number of tickets in mempool that are from
                            this wallet
Immature         uint32   Number of tickets from this wallet that are in the
                         blockchain but which are not yet mature
Live             uint32   Number of mature, active tickets owned by this
                         wallet
ProportionLive   float64  (Live / PoolSize)
Voted            uint32   Number of votes cast by this wallet
TotalSubsidy     int64    Total amount of coins earned by stake mining
Missed           uint32   Number of missed tickets (failing to vote or
                         expired)
ProportionMissed float64  (Missed / (Missed + Voted))
Revoked          uint32   Number of missed tickets that were missed and
                         then revoked

Getting this information is extremely costly as in involves a massive number of chain server calls.

func GetTicketFee 

func GetTicketFee(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetTicketFee gets the currently set price per kb for tickets

func GetTicketMaxPrice 

func GetTicketMaxPrice(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetTicketMaxPrice gets the maximum price the user is willing to pay for a ticket.

func GetTicketVoteBits 

func GetTicketVoteBits(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetTicketVoteBits fetches the per-ticket voteBits for a given ticket from a ticket hash. If the voteBits are unset, it returns the default voteBits. Otherwise, it returns the voteBits it finds. Missing tickets return an error.

func GetTickets 

func GetTickets(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

GetTickets handles a gettickets request by returning the hashes of the tickets currently owned by wallet, encoded as strings.

func GetTicketsVoteBits 

func GetTicketsVoteBits(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetTicketsVoteBits fetches the per-ticket voteBits for a given array of ticket hashes. If the voteBits are unset, it returns the default voteBits. Otherwise, it returns the voteBits it finds. Missing tickets return an error.

func GetTransaction 

func GetTransaction(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetTransaction handles a gettransaction request by returning details about a single transaction saved by wallet.

func GetUnconfirmedBalance 

func GetUnconfirmedBalance(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetUnconfirmedBalance handles a getunconfirmedbalance extension request by returning the current unconfirmed balance of an account.

func GetWalletFee 

func GetWalletFee(icmd interface{}, w *wallet.Wallet) (interface{}, error)

GetWalletFee returns the currently set tx fee for the requested wallet

func HelpNoChainRPC 

func HelpNoChainRPC(icmd interface{}, w *wallet.Wallet) (interface{}, error)

HelpNoChainRPC handles the help request when the RPC server has not been associated with a consensus RPC client. No help messages are included for passthrough requests.

func HelpWithChainRPC 

func HelpWithChainRPC(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

HelpWithChainRPC handles the help request when the RPC server has been associated with a consensus RPC client. The additional RPC client is used to include help messages for methods implemented by the consensus server via RPC passthrough.

func ImportPrivKey 

func ImportPrivKey(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ImportPrivKey handles an importprivkey request by parsing a WIF-encoded private key and adding it to an account.

func ImportScript 

func ImportScript(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

ImportScript imports a redeem script for a P2SH output.

func KeypoolRefill 

func KeypoolRefill(icmd interface{}, w *wallet.Wallet) (interface{}, error)

KeypoolRefill handles the keypoolrefill command. Since we handle the keypool automatically this does nothing since refilling is never manually required.

func ListAccounts 

func ListAccounts(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListAccounts handles a listaccounts request by returning a map of account names to their balances.

func ListAddressTransactions 

func ListAddressTransactions(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListAddressTransactions handles a listaddresstransactions request by returning an array of maps with details of spent and received wallet transactions. The form of the reply is identical to listtransactions, but the array elements are limited to transaction details which are about the addresess included in the request.

func ListAllTransactions 

func ListAllTransactions(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListAllTransactions handles a listalltransactions request by returning a map with details of sent and recevied wallet transactions. This is similar to ListTransactions, except it takes only a single optional argument for the account name and replies with all transactions.

func ListLockUnspent 

func ListLockUnspent(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListLockUnspent handles a listlockunspent request by returning an slice of all locked outpoints.

func ListReceivedByAccount 

func ListReceivedByAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListReceivedByAccount handles a listreceivedbyaccount request by returning a slice of objects, each one containing: 

"account": the receiving account;
"amount": total amount received by the account;
"confirmations": number of confirmations of the most recent transaction.

It takes two parameters: 

"minconf": minimum number of confirmations to consider a transaction -
           default: one;
"includeempty": whether or not to include addresses that have no transactions -
                default: false.

func ListReceivedByAddress 

func ListReceivedByAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListReceivedByAddress handles a listreceivedbyaddress request by returning a slice of objects, each one containing: 

"account": the account of the receiving address;
"address": the receiving address;
"amount": total amount received by the address;
"confirmations": number of confirmations of the most recent transaction.

It takes two parameters: 

"minconf": minimum number of confirmations to consider a transaction -
           default: one;
"includeempty": whether or not to include addresses that have no transactions -
                default: false.

func ListScripts 

func ListScripts(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListScripts handles a listscripts request by returning an array of script details for all scripts in the wallet.

func ListSinceBlock 

func ListSinceBlock(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

ListSinceBlock handles a listsinceblock request by returning an array of maps with details of sent and received wallet transactions since the given block.

func ListTransactions 

func ListTransactions(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListTransactions handles a listtransactions request by returning an array of maps with details of sent and recevied wallet transactions.

func ListUnspent 

func ListUnspent(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListUnspent handles the listunspent command.

func ListUnspentMultisig 

func ListUnspentMultisig(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ListUnspentMultisig handles the listunspentmultisig command.

func LockUnspent 

func LockUnspent(icmd interface{}, w *wallet.Wallet) (interface{}, error)

LockUnspent handles the lockunspent command.

func PurchaseTicket 

func PurchaseTicket(icmd interface{}, w *wallet.Wallet) (interface{}, error)

PurchaseTicket indicates to the wallet that a ticket should be purchased using all currently available funds. If the ticket could not be purchased because there are not enough eligible funds, an error will be returned.

func RedeemMultiSigOut 

func RedeemMultiSigOut(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

RedeemMultiSigOut receives a transaction hash/idx and fetches the first output index or indices with known script hashes from the transaction. It then construct a transaction with a single P2PKH paying to a specified address. It signs any inputs that it can, then provides the raw transaction to the user to export to others to sign.

func RedeemMultiSigOuts 

func RedeemMultiSigOuts(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

RedeemMultisigOuts receives a script hash (in the form of a script hash address), looks up all the unspent outpoints associated with that address, then generates a list of partially signed transactions spending to either an address specified or internal addresses in this wallet.

func RenameAccount 

func RenameAccount(icmd interface{}, w *wallet.Wallet) (interface{}, error)

RenameAccount handles a renameaccount request by renaming an account. If the account does not exist an appropiate error will be returned.

func SendFrom 

func SendFrom(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SendFrom handles a sendfrom RPC request by creating a new transaction spending unspent transaction outputs for a wallet to another payment address. Leftover inputs not sent to the payment address or a fee for the miner are sent back to a new address in the wallet. Upon success, the TxID for the created transaction is returned.

func SendMany 

func SendMany(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SendMany handles a sendmany RPC request by creating a new transaction spending unspent transaction outputs for a wallet to any number of payment addresses. Leftover inputs not sent to the payment address or a fee for the miner are sent back to a new address in the wallet. Upon success, the TxID for the created transaction is returned.

func SendToAddress 

func SendToAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SendToAddress handles a sendtoaddress RPC request by creating a new transaction spending unspent transaction outputs for a wallet to another payment address. Leftover inputs not sent to the payment address or a fee for the miner are sent back to a new address in the wallet. Upon success, the TxID for the created transaction is returned.

func SendToMultiSig 

func SendToMultiSig(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SendToMultiSig handles a sendtomultisig RPC request by creating a new transaction spending amount many funds to an output containing a multi- signature script hash. The function will fail if there isn't at least one public key in the public key list that corresponds to one that is owned locally. Upon successfully sending the transaction to the daemon, the script hash is stored in the transaction manager and the corresponding address specified to be watched by the daemon. The function returns a tx hash, P2SH address, and a multisig script if successful. TODO Use with non-default accounts as well

func SendToSSGen 

func SendToSSGen(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SendToSSGen handles a sendtossgen RPC request by creating a new transaction spending a stake ticket and generating stake rewards. Upon success, the TxID for the created transaction is returned. DECRED TODO: Clean these up

func SendToSSRtx 

func SendToSSRtx(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SendToSSRtx handles a sendtossrtx RPC request by creating a new transaction spending a stake ticket and generating stake rewards. Upon success, the TxID for the created transaction is returned. DECRED TODO: Clean these up

func SendToSStx 

func SendToSStx(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SendToSStx handles a sendtosstx RPC request by creating a new transaction payment addresses. Leftover inputs not sent to the payment address or a fee for the miner are sent back to a new address in the wallet. Upon success, the TxID for the created transaction is returned. DECRED TODO: Clean these up

func SetBalanceToMaintain 

func SetBalanceToMaintain(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetBalanceToMaintain sets the balance to maintain for automatic ticket pur.

func SetGenerate 

func SetGenerate(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetGenerate enables or disables stake mining the wallet (ticket autopurchase, vote generation, and revocation generation). The number of processors may be declared but is ignored (as this is non-PoW work).

func SetTicketFee 

func SetTicketFee(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetTicketFee sets the transaction fee per kilobyte added to tickets.

func SetTicketMaxPrice 

func SetTicketMaxPrice(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetTicketMaxPrice sets the maximum price the user is willing to pay for a ticket.

func SetTicketVoteBits 

func SetTicketVoteBits(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetTicketVoteBits sets the per-ticket voteBits for a given ticket from a ticket hash. Missing tickets return an error.

func SetTxFee 

func SetTxFee(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SetTxFee sets the transaction fee per kilobyte added to transactions.

func SignMessage 

func SignMessage(icmd interface{}, w *wallet.Wallet) (interface{}, error)

SignMessage signs the given message with the private key for the given address

func SignRawTransaction 

func SignRawTransaction(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SignRawTransaction handles the signrawtransaction command.

func SignRawTransactions 

func SignRawTransactions(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

SignRawTransactions handles the signrawtransactions command.

func StakePoolUserInfo added in v0.1.2 

func StakePoolUserInfo(icmd interface{}, w *wallet.Wallet) (interface{}, error)

StakePoolUserInfo returns the ticket information for a given user from the stake pool.

func TicketsForAddress 

func TicketsForAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

TicketsForAddress retrieves all ticket hashes that have the passed voting address. It will only return tickets that are in the mempool or blockchain, and should not return pruned tickets.

func Unimplemented 

func Unimplemented(interface{}, *wallet.Wallet) (interface{}, error)

Unimplemented handles an unimplemented RPC request with the appropiate error.

func Unsupported 

func Unsupported(interface{}, *wallet.Wallet) (interface{}, error)

Unsupported handles a standard bitcoind RPC request which is unsupported by dcrwallet due to design differences.

func UseLogger 

func UseLogger(logger btclog.Logger)

UseLogger sets the package-wide logger. Any calls to this function must be made before a server is created and used (it is not concurrent safe).

func ValidateAddress 

func ValidateAddress(icmd interface{}, w *wallet.Wallet) (interface{}, error)

ValidateAddress handles the validateaddress command.

func VerifyMessage 

func VerifyMessage(icmd interface{}, w *wallet.Wallet) (interface{}, error)

VerifyMessage handles the verifymessage command by verifying the provided compact signature for the given address and message.

func WalletInfo added in v0.0.10 

func WalletInfo(icmd interface{}, w *wallet.Wallet, chainClient *chain.RPCClient) (interface{}, error)

WalletInfo gets the current information about the wallet. If the daemon is connected and fails to ping, the function will still return that the daemon is disconnected.

func WalletIsLocked 

func WalletIsLocked(icmd interface{}, w *wallet.Wallet) (interface{}, error)

WalletIsLocked handles the walletislocked extension request by returning the current lock state (false for unlocked, true for locked) of an account.

func WalletLock 

func WalletLock(icmd interface{}, w *wallet.Wallet) (interface{}, error)

WalletLock handles a walletlock request by locking the all account wallets, returning an error if any wallet is not encrypted (for example, a watching-only wallet).

func WalletPassphrase 

func WalletPassphrase(icmd interface{}, w *wallet.Wallet) (interface{}, error)

WalletPassphrase responds to the walletpassphrase request by unlocking the wallet. The decryption key is saved in the wallet until timeout seconds expires, after which the wallet is locked.

func WalletPassphraseChange 

func WalletPassphraseChange(icmd interface{}, w *wallet.Wallet) (interface{}, error)

WalletPassphraseChange responds to the walletpassphrasechange request by unlocking all accounts with the provided old passphrase, and re-encrypting each private key with an AES key derived from the new passphrase.

If the old passphrase is correct and the passphrase is changed, all wallets will be immediately locked.

Types

type DeserializationError 

type DeserializationError struct {
	// contains filtered or unexported fields
}

DeserializationError describes a failed deserializaion due to bad user input. It corresponds to dcrjson.ErrRPCDeserialization.

type InvalidParameterError 

type InvalidParameterError struct {
	// contains filtered or unexported fields
}

InvalidParameterError describes an invalid parameter passed by the user. It corresponds to dcrjson.ErrRPCInvalidParameter.

type Options 

type Options struct {
	Username string
	Password string

	MaxPOSTClients      int64
	MaxWebsocketClients int64

	UnsafeMainNet bool
}

Options contains the required options for running the legacy RPC server.

type ParseError 

type ParseError struct {
	// contains filtered or unexported fields
}

ParseError describes a failed parse due to bad user input. It corresponds to dcrjson.ErrRPCParse.

type Server 

type Server struct {
	// contains filtered or unexported fields
}

Server holds the items the RPC server may need to access (auth, config, shutdown, etc.)

func NewServer 

func NewServer(opts *Options, walletLoader *wallet.Loader, listeners []net.Listener) *Server

NewServer creates a new server for serving legacy RPC client connections, both HTTP POST and websocket.

func (*Server) PostClientRPC 

func (s *Server) PostClientRPC(w http.ResponseWriter, r *http.Request)

PostClientRPC processes and replies to a JSON-RPC client request.

func (*Server) RegisterWallet 

func (s *Server) RegisterWallet(w *wallet.Wallet)

RegisterWallet associates the legacy RPC server with the wallet. This function must be called before any wallet RPCs can be called by clients.

func (*Server) RequestProcessShutdown 

func (s *Server) RequestProcessShutdown() <-chan struct{}

RequestProcessShutdown returns a channel that is sent to when an authorized client requests remote shutdown.

func (*Server) SetChainServer 

func (s *Server) SetChainServer(chainClient *chain.RPCClient)

SetChainServer sets the chain server client component needed to run a fully functional decred wallet RPC server. This can be called to enable RPC passthrough even before a loaded wallet is set, but the wallet's RPC client is preferred.

func (*Server) Stop 

func (s *Server) Stop()

Stop gracefully shuts down the rpc server by stopping and disconnecting all clients, disconnecting the chain server connection, and closing the wallet's account files. This blocks until shutdown completes.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.