#define WALLETMODEL_H
#include <QObject>
-#include <string>
+
+#include "allocators.h" /* for SecureString */
class OptionsModel;
class AddressTableModel;
class TransactionTableModel;
class CWallet;
-struct SendCoinsRecipient
+QT_BEGIN_NAMESPACE
+class QTimer;
+QT_END_NAMESPACE
+
+class SendCoinsRecipient
{
+public:
QString address;
QString label;
qint64 amount;
};
-// Interface to Bitcoin wallet from Qt view code
+/** Interface to Bitcoin wallet from Qt view code. */
class WalletModel : public QObject
{
Q_OBJECT
+
public:
explicit WalletModel(CWallet *wallet, OptionsModel *optionsModel, QObject *parent = 0);
+ ~WalletModel();
- enum StatusCode
+ enum StatusCode // Returned by sendCoins
{
OK,
InvalidAmount,
AmountExceedsBalance,
AmountWithFeeExceedsBalance,
DuplicateAddress,
- TransactionCreationFailed,
+ TransactionCreationFailed, // Error returned when wallet is still locked
TransactionCommitFailed,
- Aborted,
- MiscError
+ Aborted
};
enum EncryptionStatus
TransactionTableModel *getTransactionTableModel();
qint64 getBalance() const;
+ qint64 getStake() const;
qint64 getUnconfirmedBalance() const;
+ qint64 getImmatureBalance() const;
int getNumTransactions() const;
EncryptionStatus getEncryptionStatus() const;
SendCoinsReturn sendCoins(const QList<SendCoinsRecipient> &recipients);
// Wallet encryption
- bool setWalletEncrypted(bool encrypted, const std::string &passphrase);
+ bool setWalletEncrypted(bool encrypted, const SecureString &passphrase);
// Passphrase only needed when unlocking
- bool setWalletLocked(bool locked, const std::string &passPhrase=std::string());
- bool changePassphrase(const std::string &oldPass, const std::string &newPass);
+ bool setWalletLocked(bool locked, const SecureString &passPhrase=SecureString());
+ bool changePassphrase(const SecureString &oldPass, const SecureString &newPass);
+ // Wallet backup
+ bool backupWallet(const QString &filename);
// RAI object for unlocking wallet, returned by requestUnlock()
class UnlockContext
bool isValid() const { return valid; }
- UnlockContext(const UnlockContext& obj)
- { CopyFrom(obj); }
- private:
- UnlockContext& operator=(const UnlockContext& rhs)
- { CopyFrom(rhs); return *this; }
-
+ // Copy operator and constructor transfer the context
+ UnlockContext(const UnlockContext& obj) { CopyFrom(obj); }
+ UnlockContext& operator=(const UnlockContext& rhs) { CopyFrom(rhs); return *this; }
private:
WalletModel *wallet;
bool valid;
AddressTableModel *addressTableModel;
TransactionTableModel *transactionTableModel;
+ // Cache some values to be able to detect changes
qint64 cachedBalance;
+ qint64 cachedStake;
qint64 cachedUnconfirmedBalance;
+ qint64 cachedImmatureBalance;
qint64 cachedNumTransactions;
EncryptionStatus cachedEncryptionStatus;
+ int cachedNumBlocks;
+
+ QTimer *pollTimer;
+
+ void subscribeToCoreSignals();
+ void unsubscribeFromCoreSignals();
+ void checkBalanceChanged();
+
+
+public slots:
+ /* Wallet status might have changed */
+ void updateStatus();
+ /* New transaction, or transaction changed status */
+ void updateTransaction(const QString &hash, int status);
+ /* New, updated or removed address book entry */
+ void updateAddressBook(const QString &address, const QString &label, bool isMine, int status);
+ /* Current, immature or unconfirmed balance might have changed - emit 'balanceChanged' if so */
+ void pollBalanceChanged();
signals:
- void balanceChanged(qint64 balance, qint64 unconfirmedBalance);
+ // Signal that balance in wallet changed
+ void balanceChanged(qint64 balance, qint64 stake, qint64 unconfirmedBalance, qint64 immatureBalance);
+
+ // Number of transactions in wallet changed
void numTransactionsChanged(int count);
+
+ // Encryption status of wallet changed
void encryptionStatusChanged(int status);
+
+ // Signal emitted when wallet needs to be unlocked
+ // It is valid behaviour for listeners to keep the wallet locked after this signal;
+ // this means that the unlocking failed or was cancelled.
void requireUnlock();
// Asynchronous error notification
- void error(const QString &title, const QString &message);
-
-public slots:
-
-private slots:
- void update();
+ void error(const QString &title, const QString &message, bool modal);
};