keystore

type Keystore interface {

	// CosignerIndex returns the index at which the keystore signs in a multisig configuration.
	// The returned value is always zero for a singlesig configuration.
	CosignerIndex() int

	// HasSecureOutput returns whether the keystore supports to output an address securely.
	// This is typically done through a screen on the device or through a paired mobile phone.
	HasSecureOutput(*signing.Configuration, coin.Coin) bool

	// OutputAddress outputs the public key at the given configuration for the given coin.
	// Please note that this is only supported if the keystore has a secure output channel.
	OutputAddress(*signing.Configuration, coin.Coin) error

	// ExtendedPublicKey returns the extended public key at the given absolute keypath.
	ExtendedPublicKey(signing.AbsoluteKeypath) (*hdkeychain.ExtendedKey, error)

	// SignTransaction signs the given transaction proposal. Returns ErrSigningAborted if the user
	// aborts.
	SignTransaction(coin.ProposedTransaction) error
}

type Keystores interface {
	// Count returns the number of keystores in the collection.
	Count() int

	// Add adds the given keystore to the collection of keystores.
	Add(Keystore) error

	// Remove removes the given keystore from the collection of keystores.
	Remove(Keystore) error

	// HaveSecureOutput returns whether any of the keystores has a secure output.
	HaveSecureOutput(*signing.Configuration, coin.Coin) bool

	// OutputAddress outputs the address for the given coin with the given configuration on all
	// keystores that have a secure output.
	OutputAddress(*signing.Configuration, coin.Coin) error

	// SignTransaction signs the given proposed transaction on all keystores. Returns
	// ErrSigningAborted if the user aborts.
	SignTransaction(coin.ProposedTransaction) error

	// Configuration returns the configuration at the given path with the given signing threshold.
	Configuration(signing.ScriptType, signing.AbsoluteKeypath, int) (*signing.Configuration, error)
}