1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2012 The Bitcoin developers
3 // Distributed under the MIT/X11 software license, see the accompanying
4 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 #ifndef BITCOIN_KEYSTORE_H
6 #define BITCOIN_KEYSTORE_H
10 #include <boost/signals2/signal.hpp>
11 #include <boost/variant.hpp>
15 class CNoDestination {
17 friend bool operator==(const CNoDestination &a, const CNoDestination &b) { return true; }
18 friend bool operator<(const CNoDestination &a, const CNoDestination &b) { return true; }
21 /** A txout script template with a specific destination. It is either:
22 * CNoDestination: no destination set
23 * CKeyID: TX_PUBKEYHASH destination
24 * CScriptID: TX_SCRIPTHASH destination
26 * A CTxDestination is the internal data type encoded in a CBitcoinAddress.
28 typedef boost::variant<CNoDestination, CKeyID, CScriptID> CTxDestination;
30 /** A virtual base class for key stores */
34 mutable CCriticalSection cs_KeyStore;
37 virtual ~CKeyStore() {}
39 // Add a key to the store.
40 virtual bool AddKey(const CKey& key) =0;
42 // Check whether a key corresponding to a given address is present in the store.
43 virtual bool HaveKey(const CKeyID &address) const =0;
44 virtual bool GetKey(const CKeyID &address, CKey& keyOut) const =0;
45 virtual void GetKeys(std::set<CKeyID> &setAddress) const =0;
46 virtual bool GetPubKey(const CKeyID &address, CPubKey& vchPubKeyOut) const;
48 // Support for BIP 0013 : see https://en.bitcoin.it/wiki/BIP_0013
49 virtual bool AddCScript(const CScript& redeemScript) =0;
50 virtual bool HaveCScript(const CScriptID &hash) const =0;
51 virtual bool GetCScript(const CScriptID &hash, CScript& redeemScriptOut) const =0;
53 // Support for Watch-only addresses
54 virtual bool AddWatchOnly(const CTxDestination &dest) =0;
55 virtual bool HaveWatchOnly(const CTxDestination &dest) const =0;
57 virtual bool GetSecret(const CKeyID &address, CSecret& vchSecret, bool &fCompressed) const
60 if (!GetKey(address, key))
62 vchSecret = key.GetSecret(fCompressed);
67 typedef std::map<CKeyID, std::pair<CSecret, bool> > KeyMap;
68 typedef std::map<CScriptID, CScript > ScriptMap;
69 typedef std::set<CTxDestination> WatchOnlySet;
71 /** Basic key store, that keeps keys in an address->secret map */
72 class CBasicKeyStore : public CKeyStore
77 WatchOnlySet setWatchOnly;
80 bool AddKey(const CKey& key);
81 bool HaveKey(const CKeyID &address) const
86 result = (mapKeys.count(address) > 0);
90 void GetKeys(std::set<CKeyID> &setAddress) const
95 KeyMap::const_iterator mi = mapKeys.begin();
96 while (mi != mapKeys.end())
98 setAddress.insert((*mi).first);
103 bool GetKey(const CKeyID &address, CKey &keyOut) const
107 KeyMap::const_iterator mi = mapKeys.find(address);
108 if (mi != mapKeys.end())
111 keyOut.SetSecret((*mi).second.first, (*mi).second.second);
117 virtual bool AddCScript(const CScript& redeemScript);
118 virtual bool HaveCScript(const CScriptID &hash) const;
119 virtual bool GetCScript(const CScriptID &hash, CScript& redeemScriptOut) const;
121 virtual bool AddWatchOnly(const CTxDestination &dest);
122 virtual bool HaveWatchOnly(const CTxDestination &dest) const;
125 typedef std::map<CKeyID, std::pair<CPubKey, std::vector<unsigned char> > > CryptedKeyMap;
127 /** Keystore which keeps the private keys encrypted.
128 * It derives from the basic key store, which is used if no encryption is active.
130 class CCryptoKeyStore : public CBasicKeyStore
133 CryptedKeyMap mapCryptedKeys;
135 CKeyingMaterial vMasterKey;
137 // if fUseCrypto is true, mapKeys must be empty
138 // if fUseCrypto is false, vMasterKey must be empty
144 // will encrypt previously unencrypted keys
145 bool EncryptKeys(CKeyingMaterial& vMasterKeyIn);
147 bool Unlock(const CKeyingMaterial& vMasterKeyIn);
150 CCryptoKeyStore() : fUseCrypto(false)
154 bool IsCrypted() const
159 bool IsLocked() const
166 result = vMasterKey.empty();
173 virtual bool AddCryptedKey(const CPubKey &vchPubKey, const std::vector<unsigned char> &vchCryptedSecret);
174 bool AddKey(const CKey& key);
175 bool HaveKey(const CKeyID &address) const
180 return CBasicKeyStore::HaveKey(address);
181 return mapCryptedKeys.count(address) > 0;
185 bool GetKey(const CKeyID &address, CKey& keyOut) const;
186 bool GetPubKey(const CKeyID &address, CPubKey& vchPubKeyOut) const;
187 void GetKeys(std::set<CKeyID> &setAddress) const
191 CBasicKeyStore::GetKeys(setAddress);
195 CryptedKeyMap::const_iterator mi = mapCryptedKeys.begin();
196 while (mi != mapCryptedKeys.end())
198 setAddress.insert((*mi).first);
203 /* Wallet status (encrypted, locked) changed.
204 * Note: Called without locks held.
206 boost::signals2::signal<void (CCryptoKeyStore* wallet)> NotifyStatusChanged;