#include <external_signer_scriptpubkeyman.h>

Inheritance diagram for wallet::ExternalSignerScriptPubKeyMan:

Collaboration diagram for wallet::ExternalSignerScriptPubKeyMan:

Public Member Functions
util::Result< void >	DisplayAddress (const CTxDestination &dest, const ExternalSigner &signer) const
	Display address on the device and verify that the returned value matches.

std::optional< common::PSBTError >	FillPSBT (PartiallySignedTransaction &psbt, const PrecomputedTransactionData &txdata, const common::PSBTFillOptions &options, int *n_signed=nullptr) const override
	Adds script and derivation path information to a PSBT, and optionally signs it.

Public Member Functions inherited from wallet::DescriptorScriptPubKeyMan
util::Result< CTxDestination >	GetNewDestination (OutputType type) override

bool	IsMine (const CScript &script) const override

bool	CheckDecryptionKey (const CKeyingMaterial &master_key) override
	Check that the given decryption key is valid for this ScriptPubKeyMan, i.e. it decrypts all of the keys handled by it.

bool	Encrypt (const CKeyingMaterial &master_key, WalletBatch *batch) override
	Encrypt keys and write them to a batch with an active transaction. Update in-memory keys only after the transaction commits.

util::Result< CTxDestination >	GetReservedDestination (OutputType type, bool internal, int64_t &index) override

void	ReturnDestination (int64_t index, bool internal, const CTxDestination &addr) override

bool	TopUp (unsigned int size=0) override
	Fills internal address pool.

std::vector< WalletDestination >	MarkUnusedAddresses (const CScript &script) override
	Mark unused addresses as being used Affects all keys up to and including the one determined by provided script.

bool	IsHDEnabled () const override

bool	HavePrivateKeys () const override

bool	HasPrivKey (const CKeyID &keyid) const EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)

std::optional< CKey >	GetKey (const CKeyID &keyid) const EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)
	Retrieve the particular key if it is available. Returns nullopt if the key is not in the wallet, or if the wallet is locked.

bool	HaveCryptedKeys () const override

unsigned int	GetKeyPoolSize () const override

int64_t	GetTimeFirstKey () const override

std::unique_ptr< CKeyMetadata >	GetMetadata (const CTxDestination &dest) const override

bool	CanGetAddresses (bool internal=false) const override

std::unique_ptr< SigningProvider >	GetSolvingProvider (const CScript &script) const override

bool	CanProvide (const CScript &script, SignatureData &sigdata) override
	Whether this ScriptPubKeyMan can provide a SigningProvider (via GetSolvingProvider) that, combined with sigdata, can produce solving data.

std::unique_ptr< FlatSigningProvider >	GetSigningProvider (const CPubKey &pubkey) const

bool	SignTransaction (CMutableTransaction &tx, const std::map< COutPoint, Coin > &coins, int sighash, std::map< int, bilingual_str > &input_errors) const override
	Creates new signatures and adds them to the transaction.

SigningResult	SignMessage (const std::string &message, const PKHash &pkhash, std::string &str_sig) const override
	Sign a message with the given script.

uint256	GetID () const override

bool	HasWalletDescriptor (const WalletDescriptor &desc) const

util::Result< void >	UpdateWalletDescriptor (WalletDescriptor &descriptor, const FlatSigningProvider &provider)

bool	CanUpdateToWalletDescriptor (const WalletDescriptor &descriptor, std::string &error)

void	WriteDescriptor ()

WalletDescriptor	GetWalletDescriptor () const EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)

std::unordered_set< CScript, SaltedSipHasher >	GetScriptPubKeys () const override
	Returns a set of all the scriptPubKeys that this ScriptPubKeyMan watches.

std::unordered_set< CScript, SaltedSipHasher >	GetScriptPubKeys (int32_t minimum_index) const

int32_t	GetEndRange () const

bool	GetDescriptorString (std::string &out, bool priv) const

void	UpgradeDescriptorCache ()

Public Member Functions inherited from wallet::ScriptPubKeyMan
	ScriptPubKeyMan (WalletStorage &storage)

virtual	~ScriptPubKeyMan ()=default

virtual void	KeepDestination (int64_t index, const OutputType &type)

template<typename... Params>
void	WalletLogPrintf (util::log::FormatString< sizeof...(Params)> wallet_fmt, const Params &... params) const
	Prepends the wallet name in logging output to ease debugging in multi-wallet use cases.

Static Public Member Functions
static std::unique_ptr< ExternalSignerScriptPubKeyMan >	LoadFromStorage (WalletStorage &storage, const uint256 &id, WalletDescriptor &descriptor, int64_t keypool_size, const KeyMap &keys, const CryptedKeyMap &ckeys)

static std::unique_ptr< ExternalSignerScriptPubKeyMan >	CreateNew (WalletStorage &storage, WalletBatch &batch, int64_t keypool_size, std::unique_ptr< Descriptor > desc)

static util::Result< ExternalSigner >	GetExternalSigner ()

Static Public Member Functions inherited from wallet::DescriptorScriptPubKeyMan
static std::unique_ptr< DescriptorScriptPubKeyMan >	LoadFromStorage (WalletStorage &storage, const uint256 &id, WalletDescriptor &descriptor, int64_t keypool_size, const KeyMap &keys, const CryptedKeyMap &ckeys)

static std::unique_ptr< DescriptorScriptPubKeyMan >	CreateFromImport (WalletStorage &storage, WalletDescriptor &descriptor, int64_t keypool_size, const FlatSigningProvider &provider)

static std::unique_ptr< DescriptorScriptPubKeyMan >	CreateFromMigration (WalletStorage &storage, WalletBatch &batch, WalletDescriptor &descriptor, int64_t keypool_size, const FlatSigningProvider &provider)

static std::unique_ptr< DescriptorScriptPubKeyMan >	GenerateNewSingleSig (WalletStorage &storage, WalletBatch &batch, int64_t keypool_size, const CExtKey &master_key, OutputType addr_type, bool internal)

Private Member Functions
	DescriptorScriptPubKeyMan (WalletStorage &storage, const uint256 &id, WalletDescriptor &descriptor, int64_t keypool_size, const KeyMap &keys, const CryptedKeyMap &ckeys)
	Create a DescriptorScriptPubKeyMan from existing data (i.e. during loading)

	DescriptorScriptPubKeyMan (WalletStorage &storage, WalletDescriptor &descriptor, int64_t keypool_size)
	Create a new DescriptorScriptPubKeyMan from a descriptor (e.g. from an import, newly generated)

Additional Inherited Members
Public Attributes inherited from wallet::DescriptorScriptPubKeyMan
RecursiveMutex	cs_desc_man

Public Attributes inherited from wallet::ScriptPubKeyMan
btcsignals::signal< void()>	NotifyCanGetAddressesChanged
	Keypool has new keys.

btcsignals::signal< void(const ScriptPubKeyMan *spkm, int64_t new_birth_time)>	NotifyFirstKeyTimeChanged
	Birth time changed.

Protected Member Functions inherited from wallet::DescriptorScriptPubKeyMan
	DescriptorScriptPubKeyMan (WalletStorage &storage, const uint256 &id, WalletDescriptor &descriptor, int64_t keypool_size, const KeyMap &keys, const CryptedKeyMap &ckeys)
	Create a DescriptorScriptPubKeyMan from existing data (i.e. during loading)

	DescriptorScriptPubKeyMan (WalletStorage &storage, WalletDescriptor &descriptor, int64_t keypool_size)
	Create a new DescriptorScriptPubKeyMan from a descriptor (e.g. from an import, newly generated)

WalletDescriptor m_wallet_descriptor	GUARDED_BY (cs_desc_man)

void	IncIndex () EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)

void	DecIndex () EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)

void	SetRangeEnd (int32_t end) EXCLUSIVE_LOCKS_REQUIRED(cs_desc_man)

bool	TopUpWithDB (WalletBatch &batch, unsigned int size=0)
	Same as 'TopUp' but designed for use within a batch transaction context.

Protected Attributes inherited from wallet::ScriptPubKeyMan
WalletStorage &	m_storage

Detailed Description

Definition at line 16 of file external_signer_scriptpubkeyman.h.

Member Function Documentation

◆ CreateNew()

std::unique_ptr< ExternalSignerScriptPubKeyMan > wallet::ExternalSignerScriptPubKeyMan::CreateNew	(	WalletStorage &	storage,
		WalletBatch &	batch,
		int64_t	keypool_size,
		std::unique_ptr< Descriptor >	desc
	)

static

Definition at line 29 of file external_signer_scriptpubkeyman.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DescriptorScriptPubKeyMan() [1/2]

wallet::DescriptorScriptPubKeyMan::DescriptorScriptPubKeyMan	(	WalletStorage &	storage,
		const uint256 &	id,
		WalletDescriptor &	descriptor,
		int64_t	keypool_size,
		const KeyMap &	keys,
		const CryptedKeyMap &	ckeys
	)

private

Create a DescriptorScriptPubKeyMan from existing data (i.e. during loading)

Definition at line 324 of file scriptpubkeyman.cpp.

◆ DescriptorScriptPubKeyMan() [2/2]

wallet::DescriptorScriptPubKeyMan::DescriptorScriptPubKeyMan	(	WalletStorage &	storage,
		WalletDescriptor &	descriptor,
		int64_t	keypool_size
	)

inlineprivate

Create a new DescriptorScriptPubKeyMan from a descriptor (e.g. from an import, newly generated)

Definition at line 327 of file scriptpubkeyman.h.

◆ DisplayAddress()

util::Result< void > wallet::ExternalSignerScriptPubKeyMan::DisplayAddress	(	const CTxDestination &	dest,
		const ExternalSigner &	signer
	)		const

Display address on the device and verify that the returned value matches.

Returns: nothing or an error message

Definition at line 65 of file external_signer_scriptpubkeyman.cpp.

Here is the call graph for this function:

◆ FillPSBT()

std::optional< PSBTError > wallet::ExternalSignerScriptPubKeyMan::FillPSBT	(	PartiallySignedTransaction &	psbt,
		const PrecomputedTransactionData &	txdata,
		const common::PSBTFillOptions &	options,
		int *	n_signed = `nullptr`
	)		const

overridevirtual

Adds script and derivation path information to a PSBT, and optionally signs it.

Reimplemented from wallet::DescriptorScriptPubKeyMan.

Definition at line 88 of file external_signer_scriptpubkeyman.cpp.

Here is the call graph for this function:

◆ GetExternalSigner()

util::Result< ExternalSigner > wallet::ExternalSignerScriptPubKeyMan::GetExternalSigner ( )

static

Definition at line 54 of file external_signer_scriptpubkeyman.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LoadFromStorage()

std::unique_ptr< ExternalSignerScriptPubKeyMan > wallet::ExternalSignerScriptPubKeyMan::LoadFromStorage	(	WalletStorage &	storage,
		const uint256 &	id,
		WalletDescriptor &	descriptor,
		int64_t	keypool_size,
		const KeyMap &	keys,
		const CryptedKeyMap &	ckeys
	)

static

Definition at line 24 of file external_signer_scriptpubkeyman.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

The documentation for this class was generated from the following files:

src/wallet/external_signer_scriptpubkeyman.h
src/wallet/external_signer_scriptpubkeyman.cpp

Public Member Functions

Static Public Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ CreateNew()

◆ DescriptorScriptPubKeyMan() [1/2]

◆ DescriptorScriptPubKeyMan() [2/2]

◆ DisplayAddress()

◆ FillPSBT()

◆ GetExternalSigner()

◆ LoadFromStorage()